Seções da documentação

Calculadora de antena Loop

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

Slug loop-antenna. Calcule a resistência à radiação da antena de loop, o fator Q, a largura de banda e o ganho. Projete antenas de circuito magnético para bandas HF e VHF. 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 loop-antenna
Nome	Unidade	Faixa	Padrão	Descrição
frequencynúmero	MHz	no mínimo 0.1	7	Frequência de operação em MHz
diameternúmero	m	0.01 … 20	1	Diâmetro da estrutura do loop em metros
conductorDiamnúmero	mm	no mínimo 0.1	10	Diâmetro do tubo ou fio condutor em mm

Saídas

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

Saídas de loop-antenna
Campo	Unidade	Descrição
circumference	m	Circunferência do loop
radiation_resistanceprincipal	Ω	Resistência de radiação
loss_resistance	Ω	Resistência de perdas
gain	dBi	Ganho (loop pequeno)
bandwidth	kHz	Largura de banda a -3 dB
radiationEfficiency	%	Eficiência de radiação

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

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 antena Loop, com estes valores