Abschnitte der Dokumentation

Microstrip-Patch-Antennenrechner

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

Slug patch-antenna. Berechnen Sie die Abmessungen der rechteckigen Mikrostreifen-Patch-Antenne (Breite, Länge) mithilfe des Übertragungsleitungsmodells. Gibt die effektive Dielektrizitätskonstante, die Flankeneinspeisungsimpedanz und die Nennverstärkung für gängige Substrate wie FR4 und Rogers aus.

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 patch-antenna
Name	Einheit	Bereich	Standardwert	Beschreibung
frequencyZahl	GHz	0.1 … 100	2.45	Betriebsfrequenz in GHz
dielectricConstantZahl	keine	1 … 30	4.4	FR4 ≈ 4,4; Rogers RO4003C ≈ 3,55; Luft = 1
substrateHeightZahl	mm	0.1 … 10	1.6	Dicke des dielektrischen Substrats
feedOffsetZahl	mm	0 … 50	0	0 = Speisung an der strahlenden Kante; für 50-Ω-Anpassung einstellen (Einspeisetiefe)

Ausgaben

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

Ausgaben von patch-antenna
Feld	Einheit	Beschreibung
patchWidth_mm	mm	Patch-Breite
patchLength_mmHauptwert	mm	Patch-Länge
effectiveDielectric	keine	Effektive Dielektrizitätskonstante
edgeFeedImpedance_ohm	Ω	Eingangsimpedanz an der Kante
gainDbi	dBi	Nominaler Gewinn
feedResistance_ohm	Ω	Speisewiderstand beim Versatz
insetFeedPosition_mm	mm	Einspeisetiefe für 50 Ω

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": "patch-antenna",
    "inputs": {
      "frequency": 2.45,
      "dielectricConstant": 4.4,
      "substrateHeight": 1.6,
      "feedOffset": 0
    }
  }'

import rftools

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

result = client.calculate("patch-antenna", {
    "frequency": 2.45,
    "dielectricConstant": 4.4,
    "substrateHeight": 1.6,
    "feedOffset": 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": "patch-antenna",
    "inputs": {
      "frequency": 2.45,
      "dielectricConstant": 4.4,
      "substrateHeight": 1.6,
      "feedOffset": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "patch-antenna",
	  "inputs": {
	    "frequency": 2.45,
	    "dielectricConstant": 4.4,
	    "substrateHeight": 1.6,
	    "feedOffset": 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": "patch-antenna",
  "values": {
    "patchWidth_mm": 37.23426118288438,
    "patchLength_mm": 28.809290261854397,
    "effectiveDielectric": 4.080857521554887,
    "edgeFeedImpedance_ohm": 321.2209554654481,
    "gainDbi": 7,
    "feedResistance_ohm": 321.2209554654481,
    "insetFeedPosition_mm": 10.685551977674832
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:patch-antenna",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Balanis, \"Antenna Theory: Analysis and Design\", 4th ed., Chapter 14: slot conductances §14.2, Eqs. (14-12), (14-17) and (14-18a), Examples 14.1–14.3; inset feed §14.2.1, Eq. (14-20a)",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "frequency": {
          "min": 0.1,
          "max": 100,
          "unit": "GHz"
        },
        "dielectricConstant": {
          "min": 1,
          "max": 30,
          "unit": ""
        },
        "substrateHeight": {
          "min": 0.1,
          "max": 10,
          "unit": "mm"
        },
        "feedOffset": {
          "min": 0,
          "max": 50,
          "unit": "mm"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "frequency": 2.45,
      "dielectricConstant": 4.4,
      "substrateHeight": 1.6,
      "feedOffset": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "frequency"
      ],
      "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 RechnerseiteMicrostrip-Patch-Antennenrechner, mit diesen Werten