Sections de la documentation

Calculateur de diviseur de puissance Wilkinson — répartition égale et inégale

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

Slug wilkinson-power-divider. Concevez un diviseur de puissance Wilkinson à deux voies pour tout rapport de puissance : les impédances des bras quart d'onde, la résistance d'isolation, les terminaisons de sortie et leurs transformateurs d'adaptation, et la longueur physique du quart d'onde, chaque ligne étant comparée à la plage d'impédances que votre procédé sait fabriquer.

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 wilkinson-power-divider
Nom	Unité	Plage	Valeur par défaut	Description
z0nombre	Ω	au moins 1	50	Impédance de l'accès d'entrée et du système auquel les sorties sont à nouveau adaptées
powerRationombre	aucune	au moins 0.01	1	Puissance délivrée à l'accès 3 divisée par la puissance délivrée à l'accès 2 ; 1 correspond à une division égale
frequencynombre	GHz	au moins 0.001	2.4	Fréquence à laquelle chaque ligne mesure un quart de longueur d'onde
effPermittivitynombre	aucune	au moins 1	3.3	Permittivité effective des lignes ; 1 pour l'air, εr en ligne triplaque, environ 3,3 pour un microruban 50 Ω sur FR-4. Une seule valeur est utilisée pour toutes les lignes
zMinnombre	Ω	au moins 1	20	Impédance caractéristique la plus faible que le procédé de votre carte permet de réaliser (ligne la plus large réalisable)
zMaxnombre	Ω	au moins 2	150	Impédance caractéristique la plus élevée que le procédé de votre carte permet de réaliser (ligne la plus étroite réalisable)
eSeriesnombre	aucune	0 … 96	0	Arrondit chaque composant à la valeur la plus proche de la série ; la réponse et l'export sont ceux du circuit arrondi.L'une de : 0 Valeurs idéales · 12 E12 (10 %) · 24 E24 (5 %) · 48 E48 (2 %) · 96 E96 (1 %)

Sorties

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

Sorties de wilkinson-power-divider
Champ	Unité	Description
arm2Impedanceprincipale	Ω	Ligne du bras vers l'accès 2 (Z₀₂)
arm3Impedance	Ω	Ligne du bras vers l'accès 3 (Z₀₃)
isolationResistor	Ω	Résistance d'isolation (R)
port2Load	Ω	Terminaison de l'accès 2 (R₂ = Z₀K)
port3Load	Ω	Terminaison de l'accès 3 (R₃ = Z₀/K)
port2Transformer	Ω	Transformateur quart d'onde de l'accès 2 vers Z₀
port3Transformer	Ω	Transformateur quart d'onde de l'accès 3 vers Z₀
port2Share	dB	Puissance vers l'accès 2
port3Share	dB	Puissance vers l'accès 3
quarterWaveLength	mm	Longueur de ligne quart d'onde
isolationBuilt	dB	Isolation réalisée entre accès 2 et 3 à f₀

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": "wilkinson-power-divider",
    "inputs": {
      "z0": 50,
      "powerRatio": 1,
      "frequency": 2.4,
      "effPermittivity": 3.3,
      "zMin": 20,
      "zMax": 150,
      "eSeries": 0
    }
  }'

import rftools

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

result = client.calculate("wilkinson-power-divider", {
    "z0": 50,
    "powerRatio": 1,
    "frequency": 2.4,
    "effPermittivity": 3.3,
    "zMin": 20,
    "zMax": 150,
    "eSeries": 0,
})
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": "wilkinson-power-divider",
    "inputs": {
      "z0": 50,
      "powerRatio": 1,
      "frequency": 2.4,
      "effPermittivity": 3.3,
      "zMin": 20,
      "zMax": 150,
      "eSeries": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "wilkinson-power-divider",
	  "inputs": {
	    "z0": 50,
	    "powerRatio": 1,
	    "frequency": 2.4,
	    "effPermittivity": 3.3,
	    "zMin": 20,
	    "zMax": 150,
	    "eSeries": 0
	  }
	}`)
	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": "wilkinson-power-divider",
  "values": {
    "arm2Impedance": 70.71067811865476,
    "arm3Impedance": 70.71067811865476,
    "isolationResistor": 100,
    "port2Load": 50,
    "port3Load": 50,
    "port2Transformer": 50,
    "port3Transformer": 50,
    "port2Share": -3.010299956639812,
    "port3Share": -3.010299956639812,
    "quarterWaveLength": 17.190657985216998,
    "isolationBuilt": null
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:wilkinson-power-divider",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Pozar, Microwave Engineering, 4th ed. (2012), §7.3, Eqs. (7.37a)–(7.37c)",
    "assumptions": [
      {
        "code": "ideal-tem-lines",
        "text": "The lines are lossless TEM lines, each exactly a quarter wavelength at the centre frequency in the one effective permittivity entered."
      },
      {
        "code": "single-section",
        "text": "One section, matched and isolated only at the centre frequency; junction and resistor parasitics are not modelled."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "z0": {
          "min": 1,
          "max": null,
          "unit": "Ω"
        },
        "powerRatio": {
          "min": 0.01,
          "max": null,
          "unit": ""
        },
        "frequency": {
          "min": 0.001,
          "max": null,
          "unit": "GHz"
        },
        "effPermittivity": {
          "min": 1,
          "max": null,
          "unit": ""
        },
        "zMin": {
          "min": 1,
          "max": null,
          "unit": "Ω"
        },
        "zMax": {
          "min": 2,
          "max": null,
          "unit": "Ω"
        },
        "eSeries": {
          "min": 0,
          "max": 96,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "z0": 50,
      "powerRatio": 1,
      "frequency": 2.4,
      "effPermittivity": 3.3,
      "zMin": 20,
      "zMax": 150,
      "eSeries": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "z0"
      ],
      "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 diviseur de puissance Wilkinson — répartition égale et inégale, avec ces valeurs