Seções da documentação

Calculadora de microfita embutida com acoplamento de bordas

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

Slug edge-coupled-embedded. Calcule a impedância diferencial e de modo comum para um par de arestas acopladas sob máscara de solda, revestimento ou pré-impregnação — com uma permissividade efetiva separada por modo, para que a inclinação introduzida pela tampa fique visível.

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 edge-coupled-embedded
Nome	Unidade	Faixa	Padrão	Descrição
traceWidthnúmero	mm	0.02 … 10	0.2	Largura da trilha
traceSpacingnúmero	mm	0.02 … 10	0.2	Espaçamento entre trilhas (borda a borda)
substrateHeightnúmero	mm	no mínimo 0.02	0.2	Dielétrico entre as trilhas e o plano de referência abaixo
coverThicknessnúmero	mm	no mínimo 0	0.025	Máscara de solda, revestimento ou prepreg sobre as trilhas. Zero corresponde a um par de superfície sem cobertura.
coverDielectricnúmero	nenhuma	no mínimo 1	3.5	Constante dielétrica da cobertura
copperThicknessnúmero	μm	no mínimo 5	35	Espessura do cobre
dielectricConstnúmero	nenhuma	no mínimo 1	4.2	Constante dielétrica do substrato
frequencynúmero	GHz	0.001 … 300	2.4	Usada apenas para o comprimento de onda guiado do modo diferencial (ímpar); neste modelo, as impedâncias não dependem dela

Saídas

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

Saídas de edge-coupled-embedded
Campo	Unidade	Descrição
diffImpedanceprincipal	Ω	Impedância diferencial
commonImpedance	Ω	Impedância de modo comum
oddImpedance	Ω	Impedância de modo ímpar
evenImpedance	Ω	Impedância de modo par
uncoupledImpedance	Ω	Trilha isolada, sem o par
erEffOdd	nenhuma	Er efetivo em modo ímpar
erEffEven	nenhuma	Er efetivo em modo par
propagationDelay	ps/mm	Atraso de propagação (modo ímpar)
propagationDelayEven	ps/mm	Atraso de propagação (modo par)
inValidatedRange	nenhuma	Dentro do intervalo validado
guidedWavelength	mm	Comprimento de onda guiado (modo ímpar)
quarterWavelength	mm	Quarto de comprimento de onda (modo ímpar)

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

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 microfita embutida com acoplamento de bordas, com estes valores