Seções da documentação

Calculadora de resolução de compartimentos FFT e análise espectral

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

Slug fft-bin-resolution. Calcule a resolução do compartimento de frequência FFT, o intervalo de Nyquist, a duração do registro de tempo e a perda de recorte. Projete parâmetros de análise espectral para sistemas DSP. Resultados gratuitos e instantâneos.

Entradas

Envie cada uma destas em inputs, nas unidades mostradas. A maioria é obrigatória: uma chamada sem alguma delas é recusada (400) e não custa nada; uma entrada que a calculadora dispensa assume o padrão mostrado. Uma entrada fora da sua faixa ainda é calculada e sinalizada na procedência.

Entradas de fft-bin-resolution
Nome	Unidade	Faixa	Padrão	Descrição
sampleRatenúmero	kHz	no mínimo 0.001	44.1	Taxa de amostragem
fftSizenúmero	points	no mínimo 8	1024	Número de pontos da FFT (potência de 2 recomendada)
windowTypenúmero	nenhuma	0 … 2	1	Função de janelaUm de: 0 Retangular · 1 Hann · 2 Blackman
toneFreqnúmero	Hz	no mínimo 0	1000	Um tom a posicionar sobre os bins: quão longe ele cai do centro de um bin define quanto a menos a FFT o lê
sidebandSpacingnúmero	Hz	no mínimo 0.001	100	O espaçamento dos vizinhos a separar do tom, em f₀ ± Δ, ± 2Δ e ± 3Δ: bandas laterais de modulação, bandas laterais de escorregamento de motor, zumbido da rede

Saídas

Devolvidas em values, pelo nome. Um valor ilimitado ou indefinido é null.

Saídas de fft-bin-resolution
Campo	Unidade	Descrição
binResolutionprincipal	Hz	Resolução de bin de frequência
frequencyRange	kHz	Faixa de frequência (Nyquist)
timeRecord	ms	Duração do registro temporal
noiseFloor	dB	Ganho de processamento da FFT
scalloping	dB	Perda por scalloping
toneBin	bins	Posição do tom
toneLevelError	dB	Tom lido a menos em
resolutionBandwidth	Hz	Largura de banda de resolução (6 dB)
sidebandsUnresolved	nenhuma	Bandas laterais não resolvidas

Como chamar

Calcular: uma chamada, a requisição e a resposta completas, e os seus erros.
Lote: esta calculadora com outras, ou uma varredura, em uma requisição.
Resolver para um valor-alvo: o valor de uma entrada que leva uma saída a um alvo.

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

Uma entrada enviada como texto. Nada foi contabilizado.

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

Requisições demais em um minuto, com Retry-After.

As mesmas entradas na página da calculadoraCalculadora de resolução de compartimentos FFT e análise espectral, com estes valores