문서 섹션

계산기를 통한 차등

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

슬러그 differential-via. 차동 비아 쌍의 스터브 공진과 삽입 손실을 계산합니다. 도체 손실과 유전 손실이 문제가 되기 훨씬 전에 비아 전환부를 지배하는 스터브 노치입니다.

입력

이 입력을 표시된 단위로 모두 inputs에 담아 보내세요. 대부분 필수이며, 하나라도 빠진 호출은 거부되고(400) 비용이 들지 않습니다. 생략해도 계산할 수 있는 입력은 표시된 기본값을 사용합니다. 범위 밖의 입력도 계산되며 출처 정보에 표시됩니다.

differential-via의 입력
이름	단위	범위	기본값	설명
barrelDiameter숫자	mm	0.05 … 2	0.25	완성된 배럴 직경
antipadDiameter숫자	mm	0.1 … 5	0.9	비아 주변 기준 평면의 클리어런스 개구부
viaPitch숫자	mm	0.1 … 5	0.8	비아 피치 (중심 간)
boardThickness숫자	mm	0.1 … 10	1.6	보드 두께
exitDepth숫자	mm	0 … 10	0.4	진입면에서 신호가 비아를 빠져나가는 지점까지의 깊이. 나머지 배럴은 스텁입니다.
dielectricConst숫자	없음	1 이상	4.2	유전 상수
lossTangent숫자	없음	0.0001 이상	0.02	손실 탄젠트
startFrequency숫자	GHz	0.001 이상	0.1	대역 하한
stopFrequency숫자	GHz	0.01 이상	20	대역 상한

출력

values에 이름별로 반환됩니다. 상한이 없거나 정의되지 않는 값은 null입니다.

differential-via의 출력
필드	단위	설명
stubLength	mm	스터브 길이
stubResonance	GHz	첫 번째 스텁 공진 (무부하, 상한)
worstInsertionLoss주요 값	dB	대역 내 최악 삽입 손실 (무부하 공진 기준)
worstLossFrequency	GHz	최악 손실 주파수
insertionLossAtStop	dB	대역 상한에서의 삽입 손실
dielectricLoss	dB	대역 상한에서의 유전 손실
conductorLoss	dB	대역 상한에서의 도체 손실 (상한값)
antipadsOverlap	없음	안티패드 오버랩

호출 방법

계산: 호출 한 번, 요청과 응답 전체, 그리고 오류.
배치: 이 계산기를 다른 계산기와 함께, 또는 스윕을, 요청 하나로.
목표값 역산: 출력을 목표값으로 만드는 입력 하나의 값.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "differential-via",
    "inputs": {
      "barrelDiameter": 0.25,
      "antipadDiameter": 0.9,
      "viaPitch": 0.8,
      "boardThickness": 1.6,
      "exitDepth": 0.4,
      "dielectricConst": 4.2,
      "lossTangent": 0.02,
      "startFrequency": 0.1,
      "stopFrequency": 20
    }
  }'

import rftools

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

result = client.calculate("differential-via", {
    "barrelDiameter": 0.25,
    "antipadDiameter": 0.9,
    "viaPitch": 0.8,
    "boardThickness": 1.6,
    "exitDepth": 0.4,
    "dielectricConst": 4.2,
    "lossTangent": 0.02,
    "startFrequency": 0.1,
    "stopFrequency": 20,
})
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": "differential-via",
    "inputs": {
      "barrelDiameter": 0.25,
      "antipadDiameter": 0.9,
      "viaPitch": 0.8,
      "boardThickness": 1.6,
      "exitDepth": 0.4,
      "dielectricConst": 4.2,
      "lossTangent": 0.02,
      "startFrequency": 0.1,
      "stopFrequency": 20
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "differential-via",
	  "inputs": {
	    "barrelDiameter": 0.25,
	    "antipadDiameter": 0.9,
	    "viaPitch": 0.8,
	    "boardThickness": 1.6,
	    "exitDepth": 0.4,
	    "dielectricConst": 4.2,
	    "lossTangent": 0.02,
	    "startFrequency": 0.1,
	    "stopFrequency": 20
	  }
	}`)
	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": "differential-via",
  "values": {
    "stubLength": 1.2000000000000002,
    "stubResonance": 30.475779336627088,
    "antipadsOverlap": 1,
    "insertionLossAtStop": 2.247345403852366,
    "worstInsertionLoss": 2.247345403852366,
    "worstLossFrequency": 20,
    "dielectricLoss": 0.11938454152033894,
    "conductorLoss": 0.01113006904154332
  },
  "warnings": [
    "The planes the via passes through slow the stub, so 30.48 GHz is the unloaded upper bound c/(4·L·√εr): in a field solution of three via geometries the resonance was 8–27 % lower, up to about a quarter. The worst in-band loss is taken at the unloaded resonance."
  ],
  "errors": [],
  "provenance": {
    "method": "calculator:differential-via",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Stub loading from S₂₁ of a shunt admittance; the coaxial conductor loss α_c = R_s(1/a + 1/b)/(2η·ln(b/a)) (Pozar, Microwave Engineering, 4th ed., §2.7); the field solution of openspec fix-calculator-formulas-followup (2026-10-12). A via transition is three-dimensional — see the linked full-wave tool.",
    "assumptions": [
      {
        "code": "no-impedance",
        "text": "No impedance is reported: a via pair's differential impedance depends on the plane pitch and its common-mode impedance on the return path, neither of which is an input."
      },
      {
        "code": "unloaded-stub",
        "text": "The stub resonance and the worst in-band loss use the unloaded velocity c/√εr; the planes slow the wave, so the real resonance is lower."
      },
      {
        "code": "dense-plane-conductor-loss",
        "text": "Conductor loss is the dense-plane upper bound, each barrel inside its own coaxial wall; radial currents in the planes are not modelled."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "barrelDiameter": {
          "min": 0.05,
          "max": 2,
          "unit": "mm"
        },
        "antipadDiameter": {
          "min": 0.1,
          "max": 5,
          "unit": "mm"
        },
        "viaPitch": {
          "min": 0.1,
          "max": 5,
          "unit": "mm"
        },
        "boardThickness": {
          "min": 0.1,
          "max": 10,
          "unit": "mm"
        },
        "exitDepth": {
          "min": 0,
          "max": 10,
          "unit": "mm"
        },
        "dielectricConst": {
          "min": 1,
          "max": null,
          "unit": ""
        },
        "lossTangent": {
          "min": 0.0001,
          "max": null,
          "unit": ""
        },
        "startFrequency": {
          "min": 0.001,
          "max": null,
          "unit": "GHz"
        },
        "stopFrequency": {
          "min": 0.01,
          "max": null,
          "unit": "GHz"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "barrelDiameter": 0.25,
      "antipadDiameter": 0.9,
      "viaPitch": 0.8,
      "boardThickness": 1.6,
      "exitDepth": 0.4,
      "dielectricConst": 4.2,
      "lossTangent": 0.02,
      "startFrequency": 0.1,
      "stopFrequency": 20
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "barrelDiameter"
      ],
      "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가 함께 옵니다.

같은 입력으로 계산기 페이지 열기계산기를 통한 차등, 이 값으로