Secciones de la documentación

Calculadora de Muestreo y Teorema de Nyquist

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

Slug sampling-nyquist. Calcula la frecuencia de muestreo, frecuencia de Nyquist y verifica el cumplimiento del teorema de muestreo.

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 sampling-nyquist
Nombre	Unidad	Rango	Valor predeterminado	Descripción
signalFreqnúmero	Hz	1 … 1000000000	10000	Componente de frecuencia máxima en la señal (o ancho de banda de señal para señales de banda base)
samplingRatenúmero	Sa/s	1 … 1000000000000	44100	Número de muestras tomadas por segundo
adcBitsnúmero	bits	4 … 24	16	Número de bits en el ADC. Cada bit adicional añade unos 6 dB de rango dinámico.
channelsnúmero	ninguna	1 … 32	1	Número de canales ADC paralelos (por ejemplo, 2 para estéreo, 1 para mono)
harmonicOrdernúmero	ninguna	1 … 50	5	El armónico más alto de un tono en el extremo superior de la banda, tal como lo genera la distorsión del convertidor, que sigue el plan de frecuencias; con 1 sigue solo el tono

Salidas

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

Salidas de sampling-nyquist
Campo	Unidad	Descripción
nyquistRate_Hzprincipal	Hz	Tasa de Nyquist
oversamplingRatio	ninguna	Relación de sobremuestreo
aliasFreq_Hz	Hz	Frecuencia alias
dynamicRangeDB	dB	Rango dinámico
snr_dB	dB	SNR ideal
dataRateMbps	Mbps	Velocidad de datos sin procesar
antiAliasingFC_Hz	Hz	fc del filtro antialiasing
aliasesInBand	ninguna	Alias de la señal en la banda
harmonicAliasesInBand	ninguna	Armónicos replegados en la banda
lowestAliasingInput	Hz	Entrada más baja que se repliega en la banda

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": "sampling-nyquist",
    "inputs": {
      "signalFreq": 10000,
      "samplingRate": 44100,
      "adcBits": 16,
      "channels": 1,
      "harmonicOrder": 5
    }
  }'

import rftools

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

result = client.calculate("sampling-nyquist", {
    "signalFreq": 10000,
    "samplingRate": 44100,
    "adcBits": 16,
    "channels": 1,
    "harmonicOrder": 5,
})
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": "sampling-nyquist",
    "inputs": {
      "signalFreq": 10000,
      "samplingRate": 44100,
      "adcBits": 16,
      "channels": 1,
      "harmonicOrder": 5
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "sampling-nyquist",
	  "inputs": {
	    "signalFreq": 10000,
	    "samplingRate": 44100,
	    "adcBits": 16,
	    "channels": 1,
	    "harmonicOrder": 5
	  }
	}`)
	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": "sampling-nyquist",
  "values": {
    "nyquistRate_Hz": 20000,
    "oversamplingRatio": 2.205,
    "aliasFreq_Hz": 0,
    "dynamicRangeDB": 98.0905112030308,
    "snr_dB": 98.0905112030308,
    "dataRateMbps": 0.7056,
    "antiAliasingFC_Hz": 22050,
    "aliasesInBand": 0,
    "harmonicAliasesInBand": 2,
    "lowestAliasingInput": 34100
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:sampling-nyquist",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Nyquist, H. (1928). \"Certain Topics in Telegraph Transmission Theory\". AIEE Transactions. Shannon-Nyquist sampling theorem.",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "signalFreq": {
          "min": 1,
          "max": 1000000000,
          "unit": "Hz"
        },
        "samplingRate": {
          "min": 1,
          "max": 1000000000000,
          "unit": "Sa/s"
        },
        "adcBits": {
          "min": 4,
          "max": 24,
          "unit": "bits"
        },
        "channels": {
          "min": 1,
          "max": 32,
          "unit": ""
        },
        "harmonicOrder": {
          "min": 1,
          "max": 50,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "signalFreq": 10000,
      "samplingRate": 44100,
      "adcBits": 16,
      "channels": 1,
      "harmonicOrder": 5
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "signalFreq"
      ],
      "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 Muestreo y Teorema de Nyquist, con estos valores