Sections de la documentation

Calculateur de coupleur directionnel — impédances de mode pair et impair des lignes couplées

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

Slug directional-coupler. Concevez un coupleur directionnel à lignes couplées quart d'onde à une seule section : les impédances de mode pair et impair pour le couplage voulu, la longueur couplée, la perte sur la voie directe et l'isolation, avec un avertissement lorsque le couplage est trop serré pour une seule section couplée par les bords.

Entrées

Envoyez chacune de ces entrées dans inputs, dans les unités indiquées. La plupart sont obligatoires : un appel auquel il en manque une est refusé (400) et ne coûte rien ; une entrée dont le calculateur peut se passer prend la valeur par défaut indiquée. Une entrée hors de sa plage est tout de même calculée et signalée dans la provenance.

Entrées de directional-coupler
Nom	Unité	Plage	Valeur par défaut	Description
couplingnombre	dB	au moins 0.1	20	Rapport de la puissance d'entrée à la puissance sur l'accès couplé, en dB (10 dB couplent un dixième de la puissance)
z0nombre	Ω	au moins 1	50	Impédance sur laquelle chaque accès est adapté
frequencynombre	GHz	au moins 0.001	3	Fréquence à laquelle la section couplée mesure un quart de longueur d'onde et où le couplage est maximal
effPermittivitynombre	aucune	au moins 1	2.2	Permittivité effective de la section couplée ; égale à εr en ligne triplaque
directivitynombre	dB	au moins 0	30	Puissance sur l'accès couplé rapportée à la puissance sur l'accès isolé, en dB ; fixée par le tracé et l'équilibre des vitesses de mode, pas par ce dimensionnement
couplingLimitnombre	dB	au moins 0	8	Les couplages plus serrés sont signalés : une section unique couplée par les bords exigerait alors un espacement trop étroit pour être réalisable

Sorties

Renvoyées dans values, par nom. Une valeur non bornée ou non définie vaut null.

Sorties de directional-coupler
Champ	Unité	Description
evenModeImpedanceprincipale	Ω	Impédance de mode pair
oddModeImpedance	Ω	Impédance de mode impair
couplingFactor	aucune	Facteur de couplage en tension
throughLoss	dB	Pertes sur la voie directe (puissance prélevée par couplage)
isolation	dB	Isolation (I = C + D)
coupledLength	mm	Longueur couplée (λ/4)

Comment l'appeler

Calculer : un appel, la requête et la réponse complètes, et ses erreurs.
Calcul par lots : ce calculateur avec d'autres, ou un balayage, en une seule requête.
Résoudre pour une valeur cible : la valeur d'une entrée qui amène une sortie à une cible.

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

Une entrée envoyée sous forme de texte. Rien n'a été décompté.

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

Trop de requêtes en une minute, avec Retry-After.

Les mêmes entrées sur la page du calculateurCalculateur de coupleur directionnel — impédances de mode pair et impair des lignes couplées, avec ces valeurs