Secciones de la documentación

Calculadora de SNR de Convertidor ADC

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

Slug adc-snr. Calcula el SNR teórico, ENOB y rango dinámico de convertidores analógico-digital (ADC).

Entradas

Envíe cada una de estas en inputs, en las unidades indicadas. La mayoría son obligatorias: una llamada a la que le falte una se rechaza (400) y no cuesta nada; una de la que la calculadora puede prescindir toma el valor predeterminado indicado. Una entrada fuera de su rango se calcula igualmente y se marca en la procedencia.

Entradas de adc-snr
Nombre	Unidad	Rango	Valor predeterminado	Descripción
bitsnúmero	bits	1 … 24	12	Resolución ADC
inputFreqnúmero	MHz	al menos 0.001	1	Frecuencia de la señal analógica de entrada que se está muestreando
samplingFreqnúmero	MHz	al menos 0.001	10	Frecuencia de muestreo del ADC. Cada zona de Nyquist tiene un ancho de f_s/2; una entrada por encima de f_s/2 está en una zona superior y se pliega a un alias por debajo de f_s/2
jitternúmero	ps	al menos 0.001	1	fluctuación de apertura RMS del reloj de muestreo ADC en picosegundos
targetSnrnúmero	dB	0 … 200	60	La relación señal/ruido que debe alcanzar el convertidor. El estado falla por debajo de 40 dB.

Salidas

Se devuelven en values, por nombre. Un valor ilimitado o no definido es null.

Salidas de adc-snr
Campo	Unidad	Descripción
theoreticalSnr	dB	SNR teórico (cuantificación)
snrWithJitterprincipal	dB	SNR efectivo (con fluctuación)
enob	bits	Número efectivo de bits
sfdr	dBc	SFDR (estimación)
noisePower	dBFS	Nivel de ruido
nyquistZone	ninguna	Zona de Nyquist
aliasFrequency	MHz	Frecuencia de alias

Cómo llamarla

Calcular: una llamada, la solicitud y la respuesta completas, y sus errores.
Cálculo por lotes: esta calculadora con otras, o un barrido, en una sola solicitud.
Resolver para un valor objetivo: el valor de una entrada que lleva una salida a un objetivo.

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"
    }
  ]
}

Una entrada enviada como texto. No se contó nada.

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

Demasiadas solicitudes en un minuto, con Retry-After.

Las mismas entradas en la página de la calculadoraCalculadora de SNR de Convertidor ADC, con estos valores