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

相互変調歪みとIP3計算ツール

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

スラッグ intermodulation-distortion。RFアンプとミキサーのIIP3、OIP3、IM3/IM2製品、およびスプリアスフリーダイナミックレンジを計算します。ツートーンスプリアス周波数を解析します。無料で即時に結果が得られます。

入力

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

intermodulation-distortion の入力
名前	単位	範囲	既定値	説明
outputPower数値	dBm	制限なし	10	トーンあたりの基本出力電力 (dBm)
inputPower数値	dBm	制限なし	0	トーンあたりの入力駆動電力 (dBm)
oip3数値	dBm	制限なし	30	データシートの出力 3 次インターセプトポイント
oip2数値	dBm	制限なし	50	出力 2 次インターセプトポイント。大きいほど IM2 歪みが小さくなります。
freq1数値	MHz	0.1 以上	100	2 トーン解析の 1 つ目のテストトーン周波数
freq2数値	MHz	0.1 以上	101	2 つ目のテストトーン周波数
bandLow数値	MHz	0 以上	88	相互変調積が入ってはならない帯域の下端：受信帯域、または受信中のチャネル
bandHigh数値	MHz	0 以上	108	帯域の上端

出力

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

intermodulation-distortion の出力
フィールド	単位	説明
iip3	dBm	入力 IP3 (IIP3)
im3Power	dBm	IM3 積の電力
im3Ratio主要値	dBc	IM3 対キャリア比
dynamicRange	dB	スプリアスフリー・ダイナミックレンジ
iip2	dBm	入力 IP2 (IIP2)
im2Power	dBm	IM2 積の電力
im2Ratio	dBc	IM2 対キャリア比
im3Low	MHz	IM3 下側 (2f₁−f₂)
im3High	MHz	IM3 上側 (2f₂−f₁)
im2Sum	MHz	IM2 和 (f₁+f₂)
im2Diff	MHz	IM2 差 (\|f₁−f₂\|)
toneSpacing	MHz	トーン間隔
productsInBand	なし	帯域内の相互変調積

呼び出し方

計算：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": "intermodulation-distortion",
    "inputs": {
      "outputPower": 10,
      "inputPower": 0,
      "oip3": 30,
      "oip2": 50,
      "freq1": 100,
      "freq2": 101,
      "bandLow": 88,
      "bandHigh": 108
    }
  }'

import rftools

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

result = client.calculate("intermodulation-distortion", {
    "outputPower": 10,
    "inputPower": 0,
    "oip3": 30,
    "oip2": 50,
    "freq1": 100,
    "freq2": 101,
    "bandLow": 88,
    "bandHigh": 108,
})
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": "intermodulation-distortion",
    "inputs": {
      "outputPower": 10,
      "inputPower": 0,
      "oip3": 30,
      "oip2": 50,
      "freq1": 100,
      "freq2": 101,
      "bandLow": 88,
      "bandHigh": 108
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "intermodulation-distortion",
	  "inputs": {
	    "outputPower": 10,
	    "inputPower": 0,
	    "oip3": 30,
	    "oip2": 50,
	    "freq1": 100,
	    "freq2": 101,
	    "bandLow": 88,
	    "bandHigh": 108
	  }
	}`)
	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": "intermodulation-distortion",
  "values": {
    "iip3": 20,
    "im3Power": -30,
    "im3Ratio": -40,
    "dynamicRange": 122.66666666666666,
    "iip2": 40,
    "im2Power": -30,
    "im2Ratio": -40,
    "im3Low": 99,
    "im3High": 102,
    "im2Sum": 201,
    "im2Diff": 1,
    "toneSpacing": 1,
    "productsInBand": 2
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:intermodulation-distortion",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "RF Microelectronics, 2nd ed., Behzad Razavi (2011), Chapter 2, section 2.2 — Effects of nonlinearity",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "outputPower": {
          "min": null,
          "max": null,
          "unit": "dBm"
        },
        "inputPower": {
          "min": null,
          "max": null,
          "unit": "dBm"
        },
        "oip3": {
          "min": null,
          "max": null,
          "unit": "dBm"
        },
        "oip2": {
          "min": null,
          "max": null,
          "unit": "dBm"
        },
        "freq1": {
          "min": 0.1,
          "max": null,
          "unit": "MHz"
        },
        "freq2": {
          "min": 0.1,
          "max": null,
          "unit": "MHz"
        },
        "bandLow": {
          "min": 0,
          "max": null,
          "unit": "MHz"
        },
        "bandHigh": {
          "min": 0,
          "max": null,
          "unit": "MHz"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "outputPower": 10,
      "inputPower": 0,
      "oip3": 30,
      "oip2": 50,
      "freq1": 100,
      "freq2": 101,
      "bandLow": 88,
      "bandHigh": 108
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "outputPower"
      ],
      "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 付き。

同じ入力で計算ツールのページを開く相互変調歪みとIP3計算ツール、この値で