Secciones de la documentación

Calculadora de Antena Yagi-Uda

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

Slug yagi-antenna. Diseña antenas Yagi-Uda: calcula longitudes de directores, reflector y dipolo activo para la frecuencia deseada.

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 yagi-antenna
Nombre	Unidad	Rango	Valor predeterminado	Descripción
frequencynúmero	MHz	1 … 10000	144	Frecuencia de operación en MHz
numElementsnúmero	ninguna	2 … 20	5	Número total de elementos, incluidos el reflector, el elemento excitado y los directores

Retiradas, todavía aceptadas e ignoradas con una advertencia: boomLength (Boom Length, 12 de octubre de 2026).

Salidas

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

Salidas de yagi-antenna
Campo	Unidad	Descripción
gainprincipal	dBi	Ganancia estimada
driverLength	mm	Longitud del elemento excitado (dipolo)
reflectorLength	mm	Longitud del reflector
directorLength	mm	Longitud del director
spacing	mm	Separación entre elementos (0,2λ)
impedance	Ω	Impedancia de alimentación (aprox.)
assumedBoomLength	m	Longitud del boom (separación 0.2λ)

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": "yagi-antenna",
    "inputs": {
      "frequency": 144,
      "numElements": 5
    }
  }'

import rftools

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

result = client.calculate("yagi-antenna", {"frequency": 144, "numElements": 5})
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": "yagi-antenna",
    "inputs": {
      "frequency": 144,
      "numElements": 5
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "yagi-antenna",
	  "inputs": {
	    "frequency": 144,
	    "numElements": 5
	  }
	}`)
	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": "yagi-antenna",
  "values": {
    "gain": 8.170599913279624,
    "driverLength": 978.4892726388887,
    "reflectorLength": 1040.946034722222,
    "directorLength": 936.8514312499999,
    "spacing": 416.3784138888889,
    "impedance": 67.16,
    "assumedBoomLength": 1.6655136555555554
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:yagi-antenna",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Antenna Theory: Analysis and Design, 4th ed., Constantine A. Balanis (2016), Chapter 10 — Yagi-Uda array design",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "frequency": {
          "min": 1,
          "max": 10000,
          "unit": "MHz"
        },
        "numElements": {
          "min": 2,
          "max": 20,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "frequency": 144,
      "numElements": 5
    },
    "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 Yagi-Uda, con estos valores