Seções da documentação

Calculadora de indutor espiral planar

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

Slug planar-spiral-inductor. Calcule a indutância espiral plana do PCB usando a folha de corrente de Mohan e os métodos Wheeler modificados para geometrias quadradas, hexagonais, octogonais e circulares.

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 planar-spiral-inductor
Nome	Unidade	Faixa	Padrão	Descrição
outerDiameternúmero	mm	1 … 100	10	Diâmetro externo
innerDiameternúmero	mm	0.5 … 99	4	Diâmetro interno
turnsnúmero	nenhuma	1 … 50	5	Número de voltas
traceWidthnúmero	mm	0.05 … 5	0.3	Largura da trilha
traceSpacingnúmero	mm	0.05 … 5	0.2	Espaçamento entre trilhas
shapenúmero	nenhuma	0 … 3	0	FormaUm de: 0 Quadrado · 1 Hexagonal · 2 Octogonal · 3 Circular
frequencynúmero	MHz	0.01 … 100000	100	Frequência em que Q é avaliado. Não altera nenhum outro resultado. Q não é informado na frequência de autorressonância nem acima dela.

Saídas

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

Saídas de planar-spiral-inductor
Campo	Unidade	Descrição
inductanceprincipal	nH	Indutância (Mohan)
inductanceWheeler	nH	Indutância (Wheeler)
fillRatio	nenhuma	Razão de preenchimento (ρ)
dAvg	mm	Diâmetro médio
totalTraceLength	mm	Comprimento total da trilha
dcResistance	Ω	Resistência DC (cobre de 1 oz)
qFactor	nenhuma	Q na frequência informada
srf	GHz	Frequência de autorressonância

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": "planar-spiral-inductor",
    "inputs": {
      "outerDiameter": 10,
      "innerDiameter": 4,
      "turns": 5,
      "traceWidth": 0.3,
      "traceSpacing": 0.2,
      "shape": 0,
      "frequency": 100
    }
  }'

import rftools

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

result = client.calculate("planar-spiral-inductor", {
    "outerDiameter": 10,
    "innerDiameter": 4,
    "turns": 5,
    "traceWidth": 0.3,
    "traceSpacing": 0.2,
    "shape": 0,
    "frequency": 100,
})
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": "planar-spiral-inductor",
    "inputs": {
      "outerDiameter": 10,
      "innerDiameter": 4,
      "turns": 5,
      "traceWidth": 0.3,
      "traceSpacing": 0.2,
      "shape": 0,
      "frequency": 100
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "planar-spiral-inductor",
	  "inputs": {
	    "outerDiameter": 10,
	    "innerDiameter": 4,
	    "turns": 5,
	    "traceWidth": 0.3,
	    "traceSpacing": 0.2,
	    "shape": 0,
	    "frequency": 100
	  }
	}`)
	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": "planar-spiral-inductor",
  "values": {
    "inductance": 234.02440786124947,
    "inductanceWheeler": 236.20656633482332,
    "fillRatio": 0.42857142857142855,
    "dAvg": 7,
    "totalTraceLength": 140,
    "dcResistance": 0.22988505747126436,
    "qFactor": 116.84778020944951,
    "srf": 0.6016757660809017
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:planar-spiral-inductor",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Mohan et al., \"Simple Accurate Expressions for Planar Spiral Inductances\", IEEE JSSC, vol. 34, no. 10, Oct 1999; Jow & Ghovanloo, \"Design and Optimization of Printed Spiral Coils for Efficient Transcutaneous Inductive Power Transmission\", IEEE TBCAS, vol. 1, no. 3, pp. 193–202, 2007, as restated in Ashoori et al., IEEE EMBC 2011, eqs. 6–12",
    "assumptions": [
      {
        "code": "uncoated-fr4",
        "text": "The parasitic capacitance is Jow & Ghovanloo’s inter-turn model for a spiral with no coating (εr 1 above the traces) on FR-4 (εr 4.4 below), with no ground plane beneath; a plane or a solder-mask coating raises it and lowers the self-resonance."
      },
      {
        "code": "copper-1oz",
        "text": "The traces are 1 oz copper, 35 µm thick, with ρ = 1/58 Ω·mm²/m (IEC 60028) at 20 °C."
      },
      {
        "code": "skin-effect-only",
        "text": "Q includes the skin effect in one skin depth of the trace width and the inter-turn capacitance; proximity effect, substrate loss and radiation are not modelled."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "outerDiameter": {
          "min": 1,
          "max": 100,
          "unit": "mm"
        },
        "innerDiameter": {
          "min": 0.5,
          "max": 99,
          "unit": "mm"
        },
        "turns": {
          "min": 1,
          "max": 50,
          "unit": ""
        },
        "traceWidth": {
          "min": 0.05,
          "max": 5,
          "unit": "mm"
        },
        "traceSpacing": {
          "min": 0.05,
          "max": 5,
          "unit": "mm"
        },
        "shape": {
          "min": 0,
          "max": 3,
          "unit": ""
        },
        "frequency": {
          "min": 0.01,
          "max": 100000,
          "unit": "MHz"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "outerDiameter": 10,
      "innerDiameter": 4,
      "turns": 5,
      "traceWidth": 0.3,
      "traceSpacing": 0.2,
      "shape": 0,
      "frequency": 100
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "outerDiameter"
      ],
      "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 indutor espiral planar, com estes valores