Secciones de la documentación

Calculadora de antena monopolo / látigo

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

Slug monopole-antenna. Impedancia de entrada, resistencia de radiación y directividad de un monopolo o antena de látigo sobre un plano de tierra a cualquier altura, por el método de la FEM inducida y la teoría de imágenes, más la longitud de cuarto de onda y la inductancia de carga en la base que necesita un látigo corto.

Entradas

Envíe cada una de estas en inputs, en las unidades indicadas. La mayoría son obligatorias: una llamada a la que le falte una se rechaza (400) y no cuesta nada; una de la que la calculadora puede prescindir toma el valor predeterminado indicado. Una entrada fuera de su rango se calcula igualmente y se marca en la procedencia.

Entradas de monopole-antenna
Nombre	Unidad	Rango	Valor predeterminado	Descripción
frequencynúmero	MHz	0.1 … 30000	146	Frecuencia de trabajo
heightnúmero	mm	0.1 … 1000000	500	Altura del elemento vertical sobre el plano de tierra
conductorDiameternúmero	mm	al menos 0.01	2	Diámetro del látigo; fija la reactancia fuera de la resonancia
velocityFactornúmero	ninguna	0.5 … 1	0.95	Solo acorta la longitud de corte de cuarto de onda; el modelo de impedancia usa el espacio libre

Salidas

Se devuelven en values, por nombre. Un valor ilimitado o no definido es null.

Salidas de monopole-antenna
Campo	Unidad	Descripción
inputResistanceprincipal	Ω	Resistencia de entrada
inputReactance	Ω	Reactancia de entrada
radiationResistance	Ω	Resistencia de radiación (máximo de corriente)
directivityDbi	dBi	Directividad
loadingInductance	µH	Inductancia de carga en la base
quarterWaveLength	mm	Longitud de cuarto de onda
electricalHeight	ninguna	Altura eléctrica

Cómo llamarla

Calcular: una llamada, la solicitud y la respuesta completas, y sus errores.
Cálculo por lotes: esta calculadora con otras, o un barrido, en una sola solicitud.
Resolver para un valor objetivo: el valor de una entrada que lleva una salida a un objetivo.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "monopole-antenna",
    "inputs": {
      "frequency": 146,
      "height": 500,
      "conductorDiameter": 2,
      "velocityFactor": 0.95
    }
  }'

import rftools

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

result = client.calculate("monopole-antenna", {
    "frequency": 146,
    "height": 500,
    "conductorDiameter": 2,
    "velocityFactor": 0.95,
})
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": "monopole-antenna",
    "inputs": {
      "frequency": 146,
      "height": 500,
      "conductorDiameter": 2,
      "velocityFactor": 0.95
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "monopole-antenna",
	  "inputs": {
	    "frequency": 146,
	    "height": 500,
	    "conductorDiameter": 2,
	    "velocityFactor": 0.95
	  }
	}`)
	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": "monopole-antenna",
  "values": {
    "inputResistance": 33.84234991550575,
    "inputReactance": 7.140373716590908,
    "radiationResistance": 33.78596454256399,
    "directivityDbi": 5.139463064343217,
    "loadingInductance": 0,
    "quarterWaveLength": 487.6760875,
    "electricalHeight": 0.24350178949465098
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:monopole-antenna",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Balanis, Antenna Theory, 4th ed. (2016), §4.5, §4.7 and §8.5; Stutzman & Thiele, Antenna Theory and Design, 3rd ed. (2012)",
    "assumptions": [
      {
        "code": "perfect-infinite-ground",
        "text": "The ground plane is perfectly conducting and infinite; radials, finite ground planes and lossy earth are not modelled."
      },
      {
        "code": "sinusoidal-current",
        "text": "Induced-EMF model with a sinusoidal current on a thin, lossless wire; the feed gap is not modelled."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "frequency": {
          "min": 0.1,
          "max": 30000,
          "unit": "MHz"
        },
        "height": {
          "min": 0.1,
          "max": 1000000,
          "unit": "mm"
        },
        "conductorDiameter": {
          "min": 0.01,
          "max": null,
          "unit": "mm"
        },
        "velocityFactor": {
          "min": 0.5,
          "max": 1,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "frequency": 146,
      "height": 500,
      "conductorDiameter": 2,
      "velocityFactor": 0.95
    },
    "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"
    }
  ]
}

Una entrada enviada como texto. No se contó nada.

{
  "detail": "More than 120 requests in 60 seconds from this address.",
  "errorKind": "rate_limited",
  "limit": 120,
  "windowSeconds": 60,
  "upgradeUrl": "https://rftools.io/pricing/"
}

Demasiadas solicitudes en un minuto, con Retry-After.

Las mismas entradas en la página de la calculadoraCalculadora de antena monopolo / látigo, con estos valores