Abschnitte der Dokumentation

Loop-Antennenrechner

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

Slug loop-antenna. Berechnen Sie den Strahlungswiderstand der Schleifenantenne, den Q-Faktor, die Bandbreite und die Verstärkung. Entwerfen Sie Magnetschleifenantennen für HF- und VHF-Bänder. 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 loop-antenna
Name	Einheit	Bereich	Standardwert	Beschreibung
frequencyZahl	MHz	mindestens 0.1	7	Betriebsfrequenz in MHz
diameterZahl	m	0.01 … 20	1	Durchmesser der Loop-Struktur in Metern
conductorDiamZahl	mm	mindestens 0.1	10	Durchmesser des Leiterrohrs oder Drahtes in mm

Ausgaben

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

Ausgaben von loop-antenna
Feld	Einheit	Beschreibung
circumference	m	Loop-Umfang
radiation_resistanceHauptwert	Ω	Strahlungswiderstand
loss_resistance	Ω	Verlustwiderstand
gain	dBi	Gewinn (kleine Loop)
bandwidth	kHz	-3-dB-Bandbreite
radiationEfficiency	%	Strahlungswirkungsgrad

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": "loop-antenna",
    "inputs": {
      "frequency": 7,
      "diameter": 1,
      "conductorDiam": 10
    }
  }'

import rftools

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

result = client.calculate("loop-antenna", {"frequency": 7, "diameter": 1, "conductorDiam": 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": "loop-antenna",
    "inputs": {
      "frequency": 7,
      "diameter": 1,
      "conductorDiam": 10
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "loop-antenna",
	  "inputs": {
	    "frequency": 7,
	    "diameter": 1,
	    "conductorDiam": 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": "loop-antenna",
  "values": {
    "circumference": 3.141592653589793,
    "radiation_resistance": 0.005715294057365037,
    "loss_resistance": 0.06902634719744663,
    "gain": -9.40432791079153,
    "bandwidth": 4.041376318650862,
    "radiationEfficiency": 7.646733415821401
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:loop-antenna",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Balanis, Antenna Theory, 4th ed.: Chapter 2 (gain = radiation efficiency × directivity); §5.2 (small circular loop, directivity 3/2, R_rad = 320π⁴(A/λ²)²)",
    "assumptions": [
      {
        "code": "small-loop-efficiency",
        "text": "A small loop (circumference well below a tenth of a wavelength): directivity 3/2 and R_rad = 320π⁴(A/λ²)². The gain is that directivity times e = R_rad/(R_rad + R_loss), with the copper skin-effect loss only; a tuning capacitor's loss and nearby ground lower it further."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "frequency": {
          "min": 0.1,
          "max": null,
          "unit": "MHz"
        },
        "diameter": {
          "min": 0.01,
          "max": 20,
          "unit": "m"
        },
        "conductorDiam": {
          "min": 0.1,
          "max": null,
          "unit": "mm"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "frequency": 7,
      "diameter": 1,
      "conductorDiam": 10
    },
    "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 RechnerseiteLoop-Antennenrechner, mit diesen Werten