Sections de la documentation

Calculateur d'antenne hélice (mode axial)

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

Slug helical-antenna. Concevez une antenne hélice en mode axial : saisissez la fréquence, le nombre de spires, le diamètre de l'hélice, le pas entre spires et le diamètre du conducteur pour obtenir la directivité, les ouvertures à mi-puissance et entre premiers zéros, le rapport axial, la résistance d'entrée et l'angle de pas selon les formules de Kraus, avec des avertissements hors de leur domaine de validité.

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 helical-antenna
Nom	Unité	Plage	Valeur par défaut	Description
frequencynombre	MHz	1 … 100000	2400	Fréquence de conception (centrale)
turnsnombre	aucune	1 … 100	10	Spires entières ; une fraction est arrondie à la spire la plus proche
diameternombre	mm	0.1 … 10000	40	Diamètre de l'hélice mesuré à l'axe du fil ; circonférence C = πD
spacingnombre	mm	0.1 … 10000	30	Distance axiale entre spires successives (le pas)
conductorDiameternombre	mm	au moins 0.01	2	Diamètre du fil ou du tube. Il n'intervient pas dans les formules de Kraus ; il est transmis au simulateur d'antenne

Sorties

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

Sorties de helical-antenna
Champ	Unité	Description
directivityDbiprincipale	dBi	Directivité (Kraus)
directivity	aucune	Directivité (linéaire)
hpbw	°	Ouverture à mi-puissance
fnbw	°	Ouverture entre premiers zéros
axialRatio	aucune	Rapport axial
inputResistance	Ω	Résistance d'entrée (alimentation axiale)
circumferenceWavelengths	aucune	Circonférence en longueurs d'onde
spacingWavelengths	aucune	Pas en longueurs d'onde
pitchAngle	°	Angle de pas
axialLength	mm	Longueur axiale
wavelength	mm	Longueur d'onde en espace libre

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": "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"
    }
  ]
}

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 d'antenne hélice (mode axial), avec ces valeurs