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

オーバーサンプリングとノイズシェーピング SNR 計算ツール

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

スラッグ oversampling-snr。シグマデルタ ADC のオーバーサンプリングとノイズシェーピングによる SNR の改善を計算します。OSR が高くなると得られる有効ビット数を求めます。無料で即時に結果が得られます。

入力

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

oversampling-snr の入力
名前	単位	範囲	既定値	説明
bits数値	bits	1 … 24	12	元の量子化器の分解能
oversamplingRatio数値	なし	1 以上	64	サンプリングレートとナイキストレートの比率
noiseShapingOrder数値	なし	0 … 5	1	ノイズシェーピングループの次数。0 はシェーピングなしの単純なオーバーサンプリングです
signalBandwidth数値	Hz	0.001 以上	24000	コンバーターが出力する帯域で、出力レートの半分：48 kHz オーディオなら 24 kHz。モジュレーターは 2·OSR·f_B で動作します

出力

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

oversampling-snr の出力
フィールド	単位	説明
baseSnr	dB	基本 SNR (ナイキスト)
oversampledSnr主要値	dB	オーバーサンプリング後の SNR
effectiveBits	bits	有効ビット数
snrImprovement	dB	SNR 改善量
modulatorRate	Hz	モジュレーターレート
outOfBandNoise	dB	帯域外ノイズ
foldBands	なし	信号帯域に折り返す帯域

呼び出し方

計算：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": "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"
    }
  ]
}

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

{
  "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 付き。

同じ入力で計算ツールのページを開くオーバーサンプリングとノイズシェーピング SNR 計算ツール、この値で