Seções da documentação

Calculadora de design de antena Yagi-Uda

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

Slug yagi-antenna. Calcule o comprimento, o ganho, o espaçamento e a impedância dos elementos da antena Yagi-Uda. Projete antenas Yagi direcionais para qualquer frequência. Resultados gratuitos e instantâneos.

Entradas

Envie cada uma destas em inputs, nas unidades mostradas. A maioria é obrigatória: uma chamada sem alguma delas é recusada (400) e não custa nada; uma entrada que a calculadora dispensa assume o padrão mostrado. Uma entrada fora da sua faixa ainda é calculada e sinalizada na procedência.

Entradas de yagi-antenna
Nome	Unidade	Faixa	Padrão	Descrição
frequencynúmero	MHz	1 … 10000	144	Frequência de operação em MHz
numElementsnúmero	nenhuma	2 … 20	5	Número total de elementos, incluindo refletor, elemento excitado e diretores

Descontinuadas, ainda aceitas e ignoradas com um aviso: boomLength (Boom Length, 12 de outubro de 2026).

Saídas

Devolvidas em values, pelo nome. Um valor ilimitado ou indefinido é null.

Saídas de yagi-antenna
Campo	Unidade	Descrição
gainprincipal	dBi	Ganho estimado
driverLength	mm	Comprimento do elemento excitado (dipolo)
reflectorLength	mm	Comprimento do refletor
directorLength	mm	Comprimento do diretor
spacing	mm	Espaçamento entre elementos (0,2λ)
impedance	Ω	Impedância de alimentação (aprox.)
assumedBoomLength	m	Comprimento do boom (espaçamento 0,2λ)

Como chamar

Calcular: uma chamada, a requisição e a resposta completas, e os seus erros.
Lote: esta calculadora com outras, ou uma varredura, em uma requisição.
Resolver para um valor-alvo: o valor de uma entrada que leva uma saída a um alvo.

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

Uma entrada enviada como texto. Nada foi contabilizado.

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

Requisições demais em um minuto, com Retry-After.

As mesmas entradas na página da calculadoraCalculadora de design de antena Yagi-Uda, com estes valores