Sections de la documentation

Calculateur de microruban intégré à couplage périphérique

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

Slug edge-coupled-embedded. Calculez l'impédance différentielle et en mode commun pour une paire couplée aux bords sous masque de soudure, revêtement ou préimprégné, avec une permittivité effective distincte par mode, de sorte que l'inclinaison introduite par le couvercle soit visible.

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 edge-coupled-embedded
Nom	Unité	Plage	Valeur par défaut	Description
traceWidthnombre	mm	0.02 … 10	0.2	Largeur de trace
traceSpacingnombre	mm	0.02 … 10	0.2	Espacement des traces (bord à bord)
substrateHeightnombre	mm	au moins 0.02	0.2	Diélectrique entre les traces et le plan de référence situé en dessous
coverThicknessnombre	mm	au moins 0	0.025	Masque de soudure, revêtement ou préimprégné sur les traces. Zéro donne une paire de surface nue.
coverDielectricnombre	aucune	au moins 1	3.5	Constante diélectrique du recouvrement
copperThicknessnombre	μm	au moins 5	35	Épaisseur du cuivre
dielectricConstnombre	aucune	au moins 1	4.2	Constante diélectrique du substrat
frequencynombre	GHz	0.001 … 300	2.4	Utilisée uniquement pour la longueur d'onde guidée du mode différentiel (impair) ; les impédances n'en dépendent pas dans ce modèle

Sorties

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

Sorties de edge-coupled-embedded
Champ	Unité	Description
diffImpedanceprincipale	Ω	Impédance différentielle
commonImpedance	Ω	Impédance en mode commun
oddImpedance	Ω	Impédance en mode impair
evenImpedance	Ω	Impédance en mode pair
uncoupledImpedance	Ω	Trace seule, sans sa voisine
erEffOdd	aucune	Permittivité effective en mode impair
erEffEven	aucune	Permittivité effective en mode pair
propagationDelay	ps/mm	Temps de propagation (mode impair)
propagationDelayEven	ps/mm	Temps de propagation (mode pair)
inValidatedRange	aucune	Dans le domaine validé
guidedWavelength	mm	Longueur d'onde guidée (mode impair)
quarterWavelength	mm	Quart de longueur d'onde (mode impair)

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": "edge-coupled-embedded",
    "inputs": {
      "traceWidth": 0.2,
      "traceSpacing": 0.2,
      "substrateHeight": 0.2,
      "coverThickness": 0.025,
      "coverDielectric": 3.5,
      "copperThickness": 35,
      "dielectricConst": 4.2,
      "frequency": 2.4
    }
  }'

import rftools

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

result = client.calculate("edge-coupled-embedded", {
    "traceWidth": 0.2,
    "traceSpacing": 0.2,
    "substrateHeight": 0.2,
    "coverThickness": 0.025,
    "coverDielectric": 3.5,
    "copperThickness": 35,
    "dielectricConst": 4.2,
    "frequency": 2.4,
})
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": "edge-coupled-embedded",
    "inputs": {
      "traceWidth": 0.2,
      "traceSpacing": 0.2,
      "substrateHeight": 0.2,
      "coverThickness": 0.025,
      "coverDielectric": 3.5,
      "copperThickness": 35,
      "dielectricConst": 4.2,
      "frequency": 2.4
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "edge-coupled-embedded",
	  "inputs": {
	    "traceWidth": 0.2,
	    "traceSpacing": 0.2,
	    "substrateHeight": 0.2,
	    "coverThickness": 0.025,
	    "coverDielectric": 3.5,
	    "copperThickness": 35,
	    "dielectricConst": 4.2,
	    "frequency": 2.4
	  }
	}`)
	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": "edge-coupled-embedded",
  "values": {
    "diffImpedance": 107.4493991345428,
    "commonImpedance": 36.883126735598346,
    "oddImpedance": 53.7246995672714,
    "evenImpedance": 73.76625347119669,
    "uncoupledImpedance": 64.08472525189151,
    "erEffOdd": 3.1222600711428257,
    "erEffEven": 3.4717326408569606,
    "propagationDelay": 5.89405025697189,
    "propagationDelayEven": 6.215161717487868,
    "inValidatedRange": 1,
    "guidedWavelength": 70.69275769642525,
    "quarterWavelength": 17.67318942410631
  },
  "warnings": [
    "The two modes travel at different speeds (0.321 ps/mm apart), so this pair converts differential energy into common mode over length — a stripline pair does not"
  ],
  "errors": [],
  "provenance": {
    "method": "calculator:edge-coupled-embedded",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Filling factors fitted to the layered method-of-moments solver committed in src/lib/pcb/__tests__/solver, which reproduces Hammerstad–Jensen to 0.1% and the fully-embedded limit to 0.005%.",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "traceWidth": {
          "min": 0.02,
          "max": 10,
          "unit": "mm"
        },
        "traceSpacing": {
          "min": 0.02,
          "max": 10,
          "unit": "mm"
        },
        "substrateHeight": {
          "min": 0.02,
          "max": null,
          "unit": "mm"
        },
        "coverThickness": {
          "min": 0,
          "max": null,
          "unit": "mm"
        },
        "coverDielectric": {
          "min": 1,
          "max": null,
          "unit": ""
        },
        "copperThickness": {
          "min": 5,
          "max": null,
          "unit": "μm"
        },
        "dielectricConst": {
          "min": 1,
          "max": null,
          "unit": ""
        },
        "frequency": {
          "min": 0.001,
          "max": 300,
          "unit": "GHz"
        }
      },
      "outside": [],
      "model": {
        "description": "trace width 0.2–4× and spacing 0.1–3× the substrate height",
        "worstCaseError": 0.02,
        "inside": true
      }
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "traceWidth": 0.2,
      "traceSpacing": 0.2,
      "substrateHeight": 0.2,
      "coverThickness": 0.025,
      "coverDielectric": 3.5,
      "copperThickness": 35,
      "dielectricConst": 4.2,
      "frequency": 2.4
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "traceWidth"
      ],
      "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 de microruban intégré à couplage périphérique, avec ces valeurs