Secciones de la documentación

Calculadora de Resolución de Bin FFT

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

Slug fft-bin-resolution. Calcula la resolución espectral, número de bins y ancho de bin de una FFT.

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 fft-bin-resolution
Nombre	Unidad	Rango	Valor predeterminado	Descripción
sampleRatenúmero	kHz	al menos 0.001	44.1	Frecuencia de muestreo
fftSizenúmero	points	al menos 8	1024	Número de puntos FFT (se recomienda una potencia de 2)
windowTypenúmero	ninguna	0 … 2	1	Función de ventanaUno de: 0 Rectangular · 1 Hann · 2 Blackman
toneFreqnúmero	Hz	al menos 0	1000	Un tono que situar sobre los bins: lo lejos que caiga del centro de un bin fija cuánto por debajo lo lee la FFT
sidebandSpacingnúmero	Hz	al menos 0.001	100	La separación de las componentes vecinas que hay que distinguir del tono, en f₀ ± Δ, ± 2Δ y ± 3Δ: bandas laterales de modulación, bandas laterales por deslizamiento del motor, zumbido de red

Salidas

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

Salidas de fft-bin-resolution
Campo	Unidad	Descripción
binResolutionprincipal	Hz	Resolución de bin de frecuencia
frequencyRange	kHz	Rango de frecuencia (Nyquist)
timeRecord	ms	Duración del registro de tiempo
noiseFloor	dB	Ganancia de procesamiento FFT
scalloping	dB	Pérdida de festoneado
toneBin	bins	Posición del tono
toneLevelError	dB	El tono se lee por debajo en
resolutionBandwidth	Hz	Ancho de banda de resolución (6 dB)
sidebandsUnresolved	ninguna	Bandas laterales no resueltas

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": "fft-bin-resolution",
    "inputs": {
      "sampleRate": 44.1,
      "fftSize": 1024,
      "windowType": 1,
      "toneFreq": 1000,
      "sidebandSpacing": 100
    }
  }'

import rftools

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

result = client.calculate("fft-bin-resolution", {
    "sampleRate": 44.1,
    "fftSize": 1024,
    "windowType": 1,
    "toneFreq": 1000,
    "sidebandSpacing": 100,
})
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": "fft-bin-resolution",
    "inputs": {
      "sampleRate": 44.1,
      "fftSize": 1024,
      "windowType": 1,
      "toneFreq": 1000,
      "sidebandSpacing": 100
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "fft-bin-resolution",
	  "inputs": {
	    "sampleRate": 44.1,
	    "fftSize": 1024,
	    "windowType": 1,
	    "toneFreq": 1000,
	    "sidebandSpacing": 100
	  }
	}`)
	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": "fft-bin-resolution",
  "values": {
    "binResolution": 43.06640625,
    "frequencyRange": 22.05,
    "timeRecord": 23.219954648526077,
    "noiseFloor": -27.09269960975831,
    "scalloping": 1.42,
    "toneBin": 23.219954648526077,
    "toneLevelError": 0.27185918276928983,
    "resolutionBandwidth": 86.1328125,
    "sidebandsUnresolved": 0
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:fft-bin-resolution",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "sampleRate": {
          "min": 0.001,
          "max": null,
          "unit": "kHz"
        },
        "fftSize": {
          "min": 8,
          "max": null,
          "unit": "points"
        },
        "windowType": {
          "min": 0,
          "max": 2,
          "unit": ""
        },
        "toneFreq": {
          "min": 0,
          "max": null,
          "unit": "Hz"
        },
        "sidebandSpacing": {
          "min": 0.001,
          "max": null,
          "unit": "Hz"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "sampleRate": 44.1,
      "fftSize": 1024,
      "windowType": 1,
      "toneFreq": 1000,
      "sidebandSpacing": 100
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "sampleRate"
      ],
      "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 Resolución de Bin FFT, con estos valores