Abschnitte der Dokumentation

Richtkoppler-Rechner — Even- und Odd-Mode-Impedanz gekoppelter Leitungen

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

Slug directional-coupler. Entwerfen Sie einen einstufigen Viertelwellen-Richtkoppler aus gekoppelten Leitungen: die Even- und Odd-Mode-Impedanzen für die benötigte Koppeldämpfung, die Koppellänge, den Verlust im Durchgangspfad und die Isolation, mit einer Warnung, wenn die Kopplung für einen einzelnen kantengekoppelten Abschnitt zu fest ist.

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 directional-coupler
Name	Einheit	Bereich	Standardwert	Beschreibung
couplingZahl	dB	mindestens 0.1	20	Verhältnis der Eingangsleistung zur Leistung am Koppeltor, in dB (bei 10 dB wird ein Zehntel der Leistung ausgekoppelt)
z0Zahl	Ω	mindestens 1	50	Impedanz, auf die jedes Tor angepasst ist
frequencyZahl	GHz	mindestens 0.001	3	Frequenz, bei der der gekoppelte Abschnitt eine Viertelwellenlänge lang ist und die Kopplung ihr Maximum hat
effPermittivityZahl	keine	mindestens 1	2.2	Effektive Permittivität des gekoppelten Abschnitts; in Stripline gleich εr
directivityZahl	dB	mindestens 0	30	Leistung am Koppeltor zur Leistung am isolierten Tor, in dB; bestimmt durch das Layout und den Abgleich der Modengeschwindigkeiten, nicht durch diesen Entwurf
couplingLimitZahl	dB	mindestens 0	8	Stärkere Kopplungen werden markiert: Ein einzelner kantengekoppelter Abschnitt bräuchte dann einen unpraktikabel schmalen Spalt

Ausgaben

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

Ausgaben von directional-coupler
Feld	Einheit	Beschreibung
evenModeImpedanceHauptwert	Ω	Even-Mode-Impedanz
oddModeImpedance	Ω	Odd-Mode-Impedanz
couplingFactor	keine	Spannungskoppelfaktor
throughLoss	dB	Durchgangsverlust (ausgekoppelte Leistung)
isolation	dB	Isolation (I = C + D)
coupledLength	mm	Länge des gekoppelten Abschnitts (λ/4)

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": "directional-coupler",
    "inputs": {
      "coupling": 20,
      "z0": 50,
      "frequency": 3,
      "effPermittivity": 2.2,
      "directivity": 30,
      "couplingLimit": 8
    }
  }'

import rftools

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

result = client.calculate("directional-coupler", {
    "coupling": 20,
    "z0": 50,
    "frequency": 3,
    "effPermittivity": 2.2,
    "directivity": 30,
    "couplingLimit": 8,
})
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": "directional-coupler",
    "inputs": {
      "coupling": 20,
      "z0": 50,
      "frequency": 3,
      "effPermittivity": 2.2,
      "directivity": 30,
      "couplingLimit": 8
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "directional-coupler",
	  "inputs": {
	    "coupling": 20,
	    "z0": 50,
	    "frequency": 3,
	    "effPermittivity": 2.2,
	    "directivity": 30,
	    "couplingLimit": 8
	  }
	}`)
	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": "directional-coupler",
  "values": {
    "evenModeImpedance": 55.27707983925667,
    "oddModeImpedance": 45.22670168666455,
    "couplingFactor": 0.1,
    "throughLoss": 0.04364805402450088,
    "isolation": 50,
    "coupledLength": 16.843336162593108
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:directional-coupler",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Pozar, Microwave Engineering, 4th ed. (2012), §7.1, Eqs. (7.20)–(7.21), and §7.6, Eqs. (7.85)–(7.87)",
    "assumptions": [
      {
        "code": "equal-mode-velocities",
        "text": "The even and odd modes travel at the same phase velocity (TEM, as in stripline); in microstrip they do not, and the directivity is degraded."
      },
      {
        "code": "single-section",
        "text": "One quarter-wave coupled section, so the coupling is exact only at the centre frequency; losses are not modelled."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "coupling": {
          "min": 0.1,
          "max": null,
          "unit": "dB"
        },
        "z0": {
          "min": 1,
          "max": null,
          "unit": "Ω"
        },
        "frequency": {
          "min": 0.001,
          "max": null,
          "unit": "GHz"
        },
        "effPermittivity": {
          "min": 1,
          "max": null,
          "unit": ""
        },
        "directivity": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "couplingLimit": {
          "min": 0,
          "max": null,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "coupling": 20,
      "z0": 50,
      "frequency": 3,
      "effPermittivity": 2.2,
      "directivity": 30,
      "couplingLimit": 8
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "coupling"
      ],
      "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 RechnerseiteRichtkoppler-Rechner — Even- und Odd-Mode-Impedanz gekoppelter Leitungen, mit diesen Werten