ドキュメントのセクション

FFT ビン分解能およびスペクトル解析計算ツール

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

スラッグ fft-bin-resolution。FFT 周波数ビンの解像度、ナイキスト範囲、時間レコード長、およびスカラップ損失を計算します。DSP システムのスペクトル解析パラメーターを設計します。無料で即時に結果が得られます。

入力

これらの入力を、表示されている単位ですべて inputs に入れて送ってください。ほとんどは必須で、1 つでも欠けた呼び出しは拒否され（400）、費用はかかりません。省略しても計算できる入力は、表示されている既定値を使います。範囲外の入力も計算され、来歴で示されます。

fft-bin-resolution の入力
名前	単位	範囲	既定値	説明
sampleRate数値	kHz	0.001 以上	44.1	サンプルレート
fftSize数値	points	8 以上	1024	FFT の点数 (2 のべき乗を推奨)
windowType数値	なし	0 … 2	1	窓関数次のいずれか：0 矩形 · 1 ハン · 2 ブラックマン
toneFreq数値	Hz	0 以上	1000	ビン上に置くトーン：ビン中心からのずれで、FFT が読み取るレベルの低下量が決まります
sidebandSpacing数値	Hz	0.001 以上	100	トーンから分離したい隣接成分の間隔 (f₀ ± Δ、± 2Δ、± 3Δ)：変調側波帯、モーターのすべり側波帯、電源ハム

出力

values に名前ごとに返されます。上限がない値や定義されない値は null です。

fft-bin-resolution の出力
フィールド	単位	説明
binResolution主要値	Hz	周波数ビン分解能
frequencyRange	kHz	周波数範囲 (ナイキスト)
timeRecord	ms	レコード長
noiseFloor	dB	FFT 処理利得
scalloping	dB	スカロッピング損失
toneBin	bins	トーン位置
toneLevelError	dB	トーンの読み取り低下量
resolutionBandwidth	Hz	分解能帯域幅 (6 dB)
sidebandsUnresolved	なし	分離できない側波帯

呼び出し方

計算：1 回の呼び出し、リクエストとレスポンスの全体、そのエラー。
バッチ：この計算ツールをほかと組み合わせて、または掃引を、1 リクエストで。
目標値からの逆算：出力を目標値にする入力の値。

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

テキストとして送られた入力。計上はされていません。

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

1 分あたりのリクエストが多すぎます。Retry-After 付き。

同じ入力で計算ツールのページを開くFFT ビン分解能およびスペクトル解析計算ツール、この値で