Secciones de la documentación

Calculadora de SNR por Sobremuestreo

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

Slug oversampling-snr. Calcula la mejora de SNR y ENOB efectivo obtenidos mediante sobremuestreo y promediado de señales.

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 oversampling-snr
Nombre	Unidad	Rango	Valor predeterminado	Descripción
bitsnúmero	bits	1 … 24	12	Resolución del cuantificador subyacente
oversamplingRationúmero	ninguna	al menos 1	64	Relación entre la frecuencia de muestreo y la tasa de Nyquist
noiseShapingOrdernúmero	ninguna	0 … 5	1	Orden del lazo de conformación del ruido; 0 es sobremuestreo simple sin conformación
signalBandwidthnúmero	Hz	al menos 0.001	24000	La banda que entrega el convertidor, la mitad de su velocidad de salida: 24 kHz para audio a 48 kHz. El modulador funciona a 2·OSR·f_B

Salidas

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

Salidas de oversampling-snr
Campo	Unidad	Descripción
baseSnr	dB	SNR básico (Nyquist)
oversampledSnrprincipal	dB	SNR sobremuestreado
effectiveBits	bits	Bits efectivos
snrImprovement	dB	Mejora de SNR
modulatorRate	Hz	Frecuencia del modulador
outOfBandNoise	dB	Ruido fuera de la banda
foldBands	ninguna	Bandas replegadas sobre la banda de señal

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": "oversampling-snr",
    "inputs": {
      "bits": 12,
      "oversamplingRatio": 64,
      "noiseShapingOrder": 1,
      "signalBandwidth": 24000
    }
  }'

import rftools

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

result = client.calculate("oversampling-snr", {
    "bits": 12,
    "oversamplingRatio": 64,
    "noiseShapingOrder": 1,
    "signalBandwidth": 24000,
})
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": "oversampling-snr",
    "inputs": {
      "bits": 12,
      "oversamplingRatio": 64,
      "noiseShapingOrder": 1,
      "signalBandwidth": 24000
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "oversampling-snr",
	  "inputs": {
	    "bits": 12,
	    "oversamplingRatio": 64,
	    "noiseShapingOrder": 1,
	    "signalBandwidth": 24000
	  }
	}`)
	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": "oversampling-snr",
  "values": {
    "baseSnr": 74.0081115499123,
    "oversampledSnr": 123.02172586274287,
    "effectiveBits": 20.14098512088826,
    "snrImprovement": 49.01361431283057,
    "modulatorRate": 3072000,
    "outOfBandNoise": 52.0244102542922,
    "foldBands": 32
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:oversampling-snr",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "bits": {
          "min": 1,
          "max": 24,
          "unit": "bits"
        },
        "oversamplingRatio": {
          "min": 1,
          "max": null,
          "unit": ""
        },
        "noiseShapingOrder": {
          "min": 0,
          "max": 5,
          "unit": ""
        },
        "signalBandwidth": {
          "min": 0.001,
          "max": null,
          "unit": "Hz"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "bits": 12,
      "oversamplingRatio": 64,
      "noiseShapingOrder": 1,
      "signalBandwidth": 24000
    },
    "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 por Sobremuestreo, con estos valores