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

PCBビア・スタブ共振計算ツール

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

スラッグ via-stub-resonance。高速PCB設計におけるスタブ共振周波数、信号ノッチ深度、およびバックドリルの利点を介して計算します。スタブの長さを最適化します。無料で即時に結果が得られます。

入力

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

via-stub-resonance の入力
名前	単位	範囲	既定値	説明
pcbThickness数値	mm	0.1 … 10	1.6	基板の総厚
layer数値	なし	1 … 32	4	信号がビアから出る層の番号 (上面を第 1 層として数える)
totalLayers数値	なし	2 … 40	8	PCB 銅層の総数
er数値	なし	1 … 20	4.3	基板の誘電率 (FR4 = 4.3–4.8)
dataRate数値	Gbps	0.1 以上	10	信号の NRZ ビットレート。PAM4 ではビットレートの半分であるシンボルレートを入力します。信号帯域は DC からレートの半分であるナイキスト周波数まで、メインローブはレートそのものまで広がります

出力

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

via-stub-resonance の出力
フィールド	単位	説明
stubLength	mm	ビアスタブ長
resonantFreq主要値	GHz	スタブ共振周波数
notchDepth	dB	ノッチ深さ (概算)
backdrillBenefit	GHz	バックドリル後の周波数
nyquistFreq	GHz	ナイキスト周波数
resonancesInBand	なし	信号帯域内のスタブ共振
resonancesNearBand	なし	メインローブ内の共振

呼び出し方

計算：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": "via-stub-resonance",
    "inputs": {
      "pcbThickness": 1.6,
      "layer": 4,
      "totalLayers": 8,
      "er": 4.3,
      "dataRate": 10
    }
  }'

import rftools

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

result = client.calculate("via-stub-resonance", {
    "pcbThickness": 1.6,
    "layer": 4,
    "totalLayers": 8,
    "er": 4.3,
    "dataRate": 10,
})
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": "via-stub-resonance",
    "inputs": {
      "pcbThickness": 1.6,
      "layer": 4,
      "totalLayers": 8,
      "er": 4.3,
      "dataRate": 10
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "via-stub-resonance",
	  "inputs": {
	    "pcbThickness": 1.6,
	    "layer": 4,
	    "totalLayers": 8,
	    "er": 4.3,
	    "dataRate": 10
	  }
	}`)
	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": "via-stub-resonance",
  "values": {
    "stubLength": 0.8,
    "resonantFreq": 45.17898781603898,
    "notchDepth": -20,
    "backdrillBenefit": 135.53696344811695,
    "nyquistFreq": 5,
    "resonancesInBand": 0,
    "resonancesNearBand": 0
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:via-stub-resonance",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Eric Bogatin, \"Signal and Power Integrity Simplified\" 3rd ed.",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "pcbThickness": {
          "min": 0.1,
          "max": 10,
          "unit": "mm"
        },
        "layer": {
          "min": 1,
          "max": 32,
          "unit": ""
        },
        "totalLayers": {
          "min": 2,
          "max": 40,
          "unit": ""
        },
        "er": {
          "min": 1,
          "max": 20,
          "unit": ""
        },
        "dataRate": {
          "min": 0.1,
          "max": null,
          "unit": "Gbps"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "pcbThickness": 1.6,
      "layer": 4,
      "totalLayers": 8,
      "er": 4.3,
      "dataRate": 10
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

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

同じ入力で計算ツールのページを開くPCBビア・スタブ共振計算ツール、この値で