Abschnitte der Dokumentation

Rechner für differenzielle Vias

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

Slug differential-via. Berechnen Sie die Stub-Resonanz und die Einfügedämpfung eines differenziellen Via-Paars: die Stub-Kerbe, die einen Via-Übergang dominiert, lange bevor Leiter- und dielektrischer Verlust eine Rolle spielen.

Eingaben

Senden Sie jede dieser Eingaben in inputs, in den gezeigten Einheiten. Die meisten sind erforderlich: Ein Aufruf, dem eine davon fehlt, wird abgelehnt (400) und kostet nichts; eine, auf die der Rechner verzichten kann, erhält den gezeigten Standardwert. Eine Eingabe außerhalb ihres Bereichs wird trotzdem berechnet und in der Provenienz markiert.

Eingaben von differential-via
Name	Einheit	Bereich	Standardwert	Beschreibung
barrelDiameterZahl	mm	0.05 … 2	0.25	Enddurchmesser der Hülse
antipadDiameterZahl	mm	0.1 … 5	0.9	Freistellungsöffnung in den Referenzebenen rund um die Durchkontaktierung
viaPitchZahl	mm	0.1 … 5	0.8	Via-Mittenabstand
boardThicknessZahl	mm	0.1 … 10	1.6	Leiterplattendicke
exitDepthZahl	mm	0 … 10	0.4	Tiefe ab der Eintrittsseite, in der das Signal das Via verlässt. Der Rest der Hülse ist Stub.
dielectricConstZahl	keine	mindestens 1	4.2	Dielektrizitätskonstante
lossTangentZahl	keine	mindestens 0.0001	0.02	Verlustfaktor (tan δ)
startFrequencyZahl	GHz	mindestens 0.001	0.1	Bandanfang
stopFrequencyZahl	GHz	mindestens 0.01	20	Bandende

Ausgaben

Zurückgegeben in values, nach Namen. Ein Wert, der unbegrenzt oder nicht definiert ist, ist null.

Ausgaben von differential-via
Feld	Einheit	Beschreibung
stubLength	mm	Stub-Länge
stubResonance	GHz	Erste Stub-Resonanz (unbelastet, obere Schranke)
worstInsertionLossHauptwert	dB	Größte Einfügedämpfung im Band (bei der unbelasteten Resonanz)
worstLossFrequency	GHz	Frequenz der größten Dämpfung
insertionLossAtStop	dB	Einfügedämpfung am Bandende
dielectricLoss	dB	Dielektrischer Verlust am Bandende
conductorLoss	dB	Leiterverlust am Bandende (obere Schranke)
antipadsOverlap	keine	Antipads überlappen sich

Aufruf

Berechnen: ein Aufruf, Anfrage und Antwort vollständig, und seine Fehler.
Batch: dieser Rechner zusammen mit anderen oder ein Sweep, in einer Anfrage.
Nach einem Zielwert auflösen: der Wert einer Eingabe, der eine Ausgabe auf einen Zielwert bringt.

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

Eine als Text gesendete Eingabe. Es wurde nichts gezählt.

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

Zu viele Anfragen in einer Minute, mit Retry-After.

Dieselben Eingaben auf der RechnerseiteRechner für differenzielle Vias, mit diesen Werten