Sections de la documentation

Calculateur d'inducteur en spirale planaire

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

Slug planar-spiral-inductor. Calculez l'inductance en spirale planaire des PCB à l'aide de la feuille de courant de Mohan et des méthodes de Wheeler modifiées pour les géométries carrées, hexagonales, octogonales et circulaires.

Entrées

Envoyez chacune de ces entrées dans inputs, dans les unités indiquées. La plupart sont obligatoires : un appel auquel il en manque une est refusé (400) et ne coûte rien ; une entrée dont le calculateur peut se passer prend la valeur par défaut indiquée. Une entrée hors de sa plage est tout de même calculée et signalée dans la provenance.

Entrées de planar-spiral-inductor
Nom	Unité	Plage	Valeur par défaut	Description
outerDiameternombre	mm	1 … 100	10	Diamètre extérieur
innerDiameternombre	mm	0.5 … 99	4	Diamètre intérieur
turnsnombre	aucune	1 … 50	5	Nombre de spires
traceWidthnombre	mm	0.05 … 5	0.3	Largeur de trace
traceSpacingnombre	mm	0.05 … 5	0.2	Espacement entre traces
shapenombre	aucune	0 … 3	0	FormeL'une de : 0 Carrée · 1 Hexagonale · 2 Octogonale · 3 Circulaire
frequencynombre	MHz	0.01 … 100000	100	Fréquence à laquelle Q est évalué. Elle ne modifie aucun autre résultat. Q n'est pas affiché à la fréquence d'autorésonance ni au-dessus.

Sorties

Renvoyées dans values, par nom. Une valeur non bornée ou non définie vaut null.

Sorties de planar-spiral-inductor
Champ	Unité	Description
inductanceprincipale	nH	Inductance (Mohan)
inductanceWheeler	nH	Inductance (Wheeler)
fillRatio	aucune	Taux de remplissage (ρ)
dAvg	mm	Diamètre moyen
totalTraceLength	mm	Longueur totale de trace
dcResistance	Ω	Résistance en continu (cuivre 1 oz)
qFactor	aucune	Q à la fréquence saisie
srf	GHz	Fréquence d'autorésonance

Comment l'appeler

Calculer : un appel, la requête et la réponse complètes, et ses erreurs.
Calcul par lots : ce calculateur avec d'autres, ou un balayage, en une seule requête.
Résoudre pour une valeur cible : la valeur d'une entrée qui amène une sortie à une cible.

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

Une entrée envoyée sous forme de texte. Rien n'a été décompté.

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

Trop de requêtes en une minute, avec Retry-After.

Les mêmes entrées sur la page du calculateurCalculateur d'inducteur en spirale planaire, avec ces valeurs