Abschnitte der Dokumentation

Balun- und HF-Transformator-Rechner

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

Slug balun-transformer. Berechnen Sie das Windungsverhältnis und die Impedanztransformation eines Baluns für die Anpassung zwischen symmetrischer und unsymmetrischer Speiseleitung. Kostenlose, sofortige Ergebnisse.

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 balun-transformer
Name	Einheit	Bereich	Standardwert	Beschreibung
zSourceZahl	Ω	mindestens 0.1	50	Impedanz der Quelle (Sender/Zuleitung)
zLoadZahl	Ω	mindestens 0.1	200	Lastimpedanz (Antenne/Gerät), auf die transformiert werden soll
frequencyZahl	MHz	mindestens 0.001	100	Mitte des Bandes, das die Impedanzanpassungs-Simulation durchläuft, wenn Sie dieses Design simulieren; dieses Ergebnis ändert sie nicht
bandwidthZahl	MHz	mindestens 0.001	10	Breite des Bandes, das die Impedanzanpassungs-Simulation durchläuft, wenn Sie dieses Design simulieren; dieses Ergebnis ändert sie nicht

Ausgaben

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

Ausgaben von balun-transformer
Feld	Einheit	Beschreibung
turnsRatioHauptwert	:1	Windungsverhältnis (N)
impedanceRatio	:1	Impedanzverhältnis

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": "balun-transformer",
    "inputs": {
      "zSource": 50,
      "zLoad": 200,
      "frequency": 100,
      "bandwidth": 10
    }
  }'

import rftools

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

result = client.calculate("balun-transformer", {"zSource": 50, "zLoad": 200, "frequency": 100, "bandwidth": 10})
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": "balun-transformer",
    "inputs": {
      "zSource": 50,
      "zLoad": 200,
      "frequency": 100,
      "bandwidth": 10
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "balun-transformer",
	  "inputs": {
	    "zSource": 50,
	    "zLoad": 200,
	    "frequency": 100,
	    "bandwidth": 10
	  }
	}`)
	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": "balun-transformer",
  "values": {
    "turnsRatio": 2,
    "impedanceRatio": 4
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:balun-transformer",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Microwave Engineering, 4th ed., David M. Pozar (2011), Chapter 8.5 — Baluns and power dividers",
    "assumptions": [
      {
        "code": "ideal-transformer",
        "text": "Ideal transformer: matched by construction, so its VSWR is 1; core and winding losses are not modelled (a ferrite balun typically loses 0.1-1 dB)."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "zSource": {
          "min": 0.1,
          "max": null,
          "unit": "Ω"
        },
        "zLoad": {
          "min": 0.1,
          "max": null,
          "unit": "Ω"
        },
        "frequency": {
          "min": 0.001,
          "max": null,
          "unit": "MHz"
        },
        "bandwidth": {
          "min": 0.001,
          "max": null,
          "unit": "MHz"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "zSource": 50,
      "zLoad": 200,
      "frequency": 100,
      "bandwidth": 10
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "zSource"
      ],
      "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 RechnerseiteBalun- und HF-Transformator-Rechner, mit diesen Werten