Abschnitte der Dokumentation

Wendelantennen-Rechner (Axialmodus)

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

Slug helical-antenna. Entwerfen Sie eine Wendelantenne im Axialmodus: Frequenz, Windungszahl, Wendeldurchmesser, Windungsabstand und Drahtdurchmesser eingeben und Richtfaktor, Halbwerts- und Nullwertsbreite, Achsenverhältnis, Eingangswiderstand und Steigungswinkel nach den Formeln von Kraus erhalten, mit Warnungen außerhalb ihres Gültigkeitsbereichs.

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 helical-antenna
Name	Einheit	Bereich	Standardwert	Beschreibung
frequencyZahl	MHz	1 … 100000	2400	Entwurfs- (Mitten-)Frequenz
turnsZahl	keine	1 … 100	10	Ganze Windungen; ein Bruchteil wird auf die nächste Windung gerundet
diameterZahl	mm	0.1 … 10000	40	Wendeldurchmesser, gemessen bis zur Drahtmitte; Umfang C = πD
spacingZahl	mm	0.1 … 10000	30	Axialer Abstand aufeinanderfolgender Windungen (die Steigung)
conductorDiameterZahl	mm	mindestens 0.01	2	Draht- oder Rohrdurchmesser. Er geht nicht in die Formeln von Kraus ein, wird aber an den Antennensimulator übergeben

Ausgaben

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

Ausgaben von helical-antenna
Feld	Einheit	Beschreibung
directivityDbiHauptwert	dBi	Richtfaktor (Kraus)
directivity	keine	Richtfaktor (linear)
hpbw	°	Halbwertsbreite
fnbw	°	Nullwertsbreite
axialRatio	keine	Achsenverhältnis
inputResistance	Ω	Eingangswiderstand (axiale Speisung)
circumferenceWavelengths	keine	Umfang in Wellenlängen
spacingWavelengths	keine	Windungsabstand in Wellenlängen
pitchAngle	°	Steigungswinkel
axialLength	mm	Axiale Länge
wavelength	mm	Freiraumwellenlänge

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": "helical-antenna",
    "inputs": {
      "frequency": 2400,
      "turns": 10,
      "diameter": 40,
      "spacing": 30,
      "conductorDiameter": 2
    }
  }'

import rftools

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

result = client.calculate("helical-antenna", {
    "frequency": 2400,
    "turns": 10,
    "diameter": 40,
    "spacing": 30,
    "conductorDiameter": 2,
})
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": "helical-antenna",
    "inputs": {
      "frequency": 2400,
      "turns": 10,
      "diameter": 40,
      "spacing": 30,
      "conductorDiameter": 2
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "helical-antenna",
	  "inputs": {
	    "frequency": 2400,
	    "turns": 10,
	    "diameter": 40,
	    "spacing": 30,
	    "conductorDiameter": 2
	  }
	}`)
	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": "helical-antenna",
  "values": {
    "directivityDbi": 15.618038581705719,
    "directivity": 36.45892491084807,
    "hpbw": 33.35393238921151,
    "fnbw": 73.7635043222947,
    "axialRatio": 1.05,
    "inputResistance": 140.84078547515304,
    "circumferenceWavelengths": 1.0060056105368074,
    "spacingWavelengths": 0.2401661485426695,
    "pitchAngle": 13.42704175848521,
    "axialLength": 300,
    "wavelength": 124.91352416666666
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:helical-antenna",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Kraus & Marhefka, Antennas for All Applications, 3rd ed. (2002), ch. 8; Balanis, Antenna Theory, 4th ed. (2016), §10.3.1",
    "assumptions": [
      {
        "code": "kraus-empirical",
        "text": "Directivity, beamwidths, axial ratio and input resistance are Kraus's empirical axial-mode formulas; Kraus's directivity is known to overestimate measured gain (King & Wong, 1980)."
      },
      {
        "code": "axial-feed-ground-plane",
        "text": "The helix is fed axially over a ground plane; the ground plane size and the conductor diameter do not enter the formulas."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "frequency": {
          "min": 1,
          "max": 100000,
          "unit": "MHz"
        },
        "turns": {
          "min": 1,
          "max": 100,
          "unit": ""
        },
        "diameter": {
          "min": 0.1,
          "max": 10000,
          "unit": "mm"
        },
        "spacing": {
          "min": 0.1,
          "max": 10000,
          "unit": "mm"
        },
        "conductorDiameter": {
          "min": 0.01,
          "max": null,
          "unit": "mm"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "frequency": 2400,
      "turns": 10,
      "diameter": 40,
      "spacing": 30,
      "conductorDiameter": 2
    },
    "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 RechnerseiteWendelantennen-Rechner (Axialmodus), mit diesen Werten