Seções da documentação

Calculadora ADC SNR e ENOB

POSThttps://rftools.io/api/py/v1/calculate

Slug adc-snr. Calcule a relação sinal/ruído do ADC, ENOB e SFDR com efeitos de variação de abertura. Analise o desempenho do conversor para o projeto de aquisição de dados. Resultados gratuitos e instantâneos.

Entradas

Envie cada uma destas em inputs, nas unidades mostradas. A maioria é obrigatória: uma chamada sem alguma delas é recusada (400) e não custa nada; uma entrada que a calculadora dispensa assume o padrão mostrado. Uma entrada fora da sua faixa ainda é calculada e sinalizada na procedência.

Entradas de adc-snr
Nome	Unidade	Faixa	Padrão	Descrição
bitsnúmero	bits	1 … 24	12	Resolução ADC
inputFreqnúmero	MHz	no mínimo 0.001	1	Frequência do sinal analógico de entrada que está sendo amostrado
samplingFreqnúmero	MHz	no mínimo 0.001	10	Taxa de amostragem do ADC. Cada zona de Nyquist tem largura f_s/2; uma entrada acima de f_s/2 está numa zona superior e se dobra para um alias abaixo de f_s/2
jitternúmero	ps	no mínimo 0.001	1	Jitter de abertura RMS do clock de amostragem do ADC, em picossegundos
targetSnrnúmero	dB	0 … 200	60	A relação sinal/ruído que o conversor deve alcançar. O status falha abaixo de 40 dB.

Saídas

Devolvidas em values, pelo nome. Um valor ilimitado ou indefinido é null.

Saídas de adc-snr
Campo	Unidade	Descrição
theoreticalSnr	dB	SNR teórico (quantização)
snrWithJitterprincipal	dB	SNR efetivo (com Jitter)
enob	bits	Número efetivo de bits
sfdr	dBc	SFDR (estimativa)
noisePower	dBFS	Piso de ruído
nyquistZone	nenhuma	Zona de Nyquist
aliasFrequency	MHz	Frequência de alias

Como chamar

Calcular: uma chamada, a requisição e a resposta completas, e os seus erros.
Lote: esta calculadora com outras, ou uma varredura, em uma requisição.
Resolver para um valor-alvo: o valor de uma entrada que leva uma saída a um alvo.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "adc-snr",
    "inputs": {
      "bits": 12,
      "inputFreq": 1,
      "samplingFreq": 10,
      "jitter": 1,
      "targetSnr": 60
    }
  }'

import rftools

client = rftools.Client()  # reads RFTOOLS_API_KEY, or the key `rftools login` saved

result = client.calculate("adc-snr", {
    "bits": 12,
    "inputFreq": 1,
    "samplingFreq": 10,
    "jitter": 1,
    "targetSnr": 60,
})
print(result.values)
print(result.warnings, result.provenance.formula_ref)

const response = await fetch("https://rftools.io/api/py/v1/calculate", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.RFTOOLS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "slug": "adc-snr",
    "inputs": {
      "bits": 12,
      "inputFreq": 1,
      "samplingFreq": 10,
      "jitter": 1,
      "targetSnr": 60
    }
  }),
});
console.log(response.status, await response.json());

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{
	  "slug": "adc-snr",
	  "inputs": {
	    "bits": 12,
	    "inputFreq": 1,
	    "samplingFreq": 10,
	    "jitter": 1,
	    "targetSnr": 60
	  }
	}`)
	req, err := http.NewRequest("POST", "https://rftools.io/api/py/v1/calculate", bytes.NewReader(body))
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("RFTOOLS_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

application/json

{
  "slug": "adc-snr",
  "values": {
    "theoreticalSnr": 74.0081115499123,
    "snrWithJitter": 74.00379894617443,
    "enob": 11.999283692024052,
    "sfdr": 111.01216732486844,
    "noisePower": -74.00379894617443,
    "nyquistZone": 1,
    "aliasFrequency": 1
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:adc-snr",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Nyquist zones and alias: Kester, Analog Devices MT-002, Rev. A (10/08), Figure 5",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "bits": {
          "min": 1,
          "max": 24,
          "unit": "bits"
        },
        "inputFreq": {
          "min": 0.001,
          "max": null,
          "unit": "MHz"
        },
        "samplingFreq": {
          "min": 0.001,
          "max": null,
          "unit": "MHz"
        },
        "jitter": {
          "min": 0.001,
          "max": null,
          "unit": "ps"
        },
        "targetSnr": {
          "min": 0,
          "max": 200,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "bits": 12,
      "inputFreq": 1,
      "samplingFreq": 10,
      "jitter": 1,
      "targetSnr": 60
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "bits"
      ],
      "msg": "Input should be a valid number, unable to parse string as a number",
      "input": "abc"
    }
  ]
}

Uma entrada enviada como texto. Nada foi contabilizado.

{
  "detail": "More than 120 requests in 60 seconds from this address.",
  "errorKind": "rate_limited",
  "limit": 120,
  "windowSeconds": 60,
  "upgradeUrl": "https://rftools.io/pricing/"
}

Requisições demais em um minuto, com Retry-After.

As mesmas entradas na página da calculadoraCalculadora ADC SNR e ENOB, com estes valores