Abschnitte der Dokumentation

ADC SNR- und ENOB-Rechner

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

Slug adc-snr. Berechnen Sie das ADC-Signal-Rausch-Verhältnis, ENOB und SFDR mit Apertur-Jitter-Effekten. Analysieren Sie die Konverterleistung für das Datenerfassungsdesign. Kostenlose, sofortige Ergebnisse.

Eingaben

Senden Sie jede dieser Eingaben in inputs, in den gezeigten Einheiten. Die meisten sind erforderlich: Ein Aufruf, dem eine davon fehlt, wird abgelehnt (400) und kostet nichts; eine, auf die der Rechner verzichten kann, erhält den gezeigten Standardwert. Eine Eingabe außerhalb ihres Bereichs wird trotzdem berechnet und in der Provenienz markiert.

Eingaben von adc-snr
Name	Einheit	Bereich	Standardwert	Beschreibung
bitsZahl	bits	1 … 24	12	ADC-Auflösung
inputFreqZahl	MHz	mindestens 0.001	1	Frequenz des analogen Eingangssignals, das abgetastet wird
samplingFreqZahl	MHz	mindestens 0.001	10	ADC-Abtastrate. Jede Nyquist-Zone ist f_s/2 breit; ein Eingang oberhalb von f_s/2 liegt in einer höheren Zone und faltet auf eine Alias-Frequenz unterhalb von f_s/2
jitterZahl	ps	mindestens 0.001	1	RMS-Aperturjitter des ADC-Abtasttakts in Pikosekunden
targetSnrZahl	dB	0 … 200	60	Das Signal-Rausch-Verhältnis, das der Konverter erreichen muss. Der Status schlägt unter 40 dB fehl.

Ausgaben

Zurückgegeben in values, nach Namen. Ein Wert, der unbegrenzt oder nicht definiert ist, ist null.

Ausgaben von adc-snr
Feld	Einheit	Beschreibung
theoreticalSnr	dB	Theoretisches SNR (Quantisierung)
snrWithJitterHauptwert	dB	Effektives SNR (mit Jitter)
enob	bits	Effektive Anzahl von Bits
sfdr	dBc	SFDR (Schätzung)
noisePower	dBFS	Grundrauschen
nyquistZone	keine	Nyquist-Zone
aliasFrequency	MHz	Alias-Frequenz

Aufruf

Berechnen: ein Aufruf, Anfrage und Antwort vollständig, und seine Fehler.
Batch: dieser Rechner zusammen mit anderen oder ein Sweep, in einer Anfrage.
Nach einem Zielwert auflösen: der Wert einer Eingabe, der eine Ausgabe auf einen Zielwert bringt.

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

Eine als Text gesendete Eingabe. Es wurde nichts gezählt.

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

Zu viele Anfragen in einer Minute, mit Retry-After.

Dieselben Eingaben auf der RechnerseiteADC SNR- und ENOB-Rechner, mit diesen Werten