Seções da documentação

Resolver para um valor-alvo

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

Encontra o valor de uma entrada da calculadora que leva uma das suas saídas a um alvo (a largura de trilha que dá 50 Ω, o espaçamento que dá uma impedância diferencial alvo) e o devolve com o resultado direto calculado exatamente nesse valor. Uma única chamada contabilizada substitui as chamadas diretas que um cliente gastaria procurando à mão.

Como a busca funciona

A busca percorre os limites declarados de solveFor, estreitados por range quando informado; uma entrada sem limite declarado precisa de range. Quando grid é informado, o value devolvido é arredondado para o múltiplo da grade mais próximo dentro da faixa, e unrounded traz a solução exata; sem grid, value e unrounded são o mesmo número. Em qualquer caso, result (exatamente o que /calculate devolve para essas entradas, procedência incluída) é a execução direta da calculadora exatamente no value devolvido, de modo que o que um cliente mostra é um cálculo direto real, nunca a estimativa do próprio solucionador.

Corpo da requisição

SolveRequest
Campo	Descrição
slugobrigatóriostring	A calculadora.
inputsobrigatórioobject of numbers	Todas as entradas exceto solveFor. Um valor dado para solveFor é apenas o ponto de partida da busca, usado para desempatar entre mais de uma solução.
solveForobrigatóriostring	Uma entrada numérica declarada da calculadora.
target.outputobrigatóriostring	Uma chave de saída que a calculadora devolve.
target.valueobrigatórionumber	O valor que essa saída deve atingir.
gridnumber	Uma grade de fabricação positiva; o valor devolvido é arredondado para o múltiplo mais próximo dentro da faixa.
range[number, number]	Estreita os limites declarados de solveFor; obrigatório quando não há nenhum.

Resposta

SolveResponse
Campo	Descrição
valuenumber	O valor resolvido, arredondado para grid quando informado.
unroundednumber	A solução exata, antes do arredondamento para a grade.
reachedboolean	Se o alvo foi atingido; false ainda traz o valor mais próximo encontrado, não um palpite.
evaluationsinteger	Quantas avaliações diretas a busca usou.
warningsstring[]	As constatações da própria resolução: outra solução na faixa, ou um alvo não atingido.
resultobject	Exatamente o que /calculate devolve para as entradas com solveFor definido como value: values, warnings, errors e provenance.
slug, solveFor, target, gridecho	Os campos da requisição, como foram dados; grid é null quando não foi informado.

Custo e empates

Custo

Uma chamada contabilizada, cobrada como /calculate depois de todas as verificações abaixo, e devolvida se o serviço falhar em seguida. Um alvo que a busca não consegue atingir ainda é respondido com sucesso e ainda é cobrado, com reached: false e o valor mais próximo encontrado: o chamador pediu algo que o serviço entregou.

Mais de uma solução

Quando a saída cruza o alvo mais de uma vez dentro da faixa, a chamada devolve o cruzamento mais próximo do valor inicial (o valor que o próprio chamador deu para solveFor, ou então o padrão da calculadora) e adiciona um aviso que nomeia o outro.

Recusas

Uma requisição que não pode ser resolvida é recusada antes de qualquer cobrança, e param nomeia o campo com problema:

Recusas do solve
Status	Quando
404	O slug da calculadora não existe.
400	solveFor não é uma das entradas numéricas declaradas da calculadora (param: solveFor, com allowed).
400	target.output não é uma das saídas da calculadora (param: target.output, com allowed).
400	grid foi informado e não é um número finito e positivo, ou não tem múltiplo na faixa.
400	Algum valor dado (uma entrada, target.value ou um limite da faixa) não é finito.
400	solveFor não tem limite declarado e o corpo não dá nenhum range, ou a faixa dada está fora dos limites declarados ou é vazia.
400	Uma entrada fixa excede um limite que a calculadora impõe ao próprio tempo de execução, como em /calculate.

curl -X POST https://rftools.io/api/py/v1/calculate/solve \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "microstrip-impedance",
    "inputs": {
      "substrateHeight": 1.51,
      "dielectricConstant": 4.5,
      "copperThickness": 35
    },
    "solveFor": "traceWidth",
    "target": {
      "output": "impedance",
      "value": 50
    },
    "grid": 0.001
  }'

import rftools

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

result = client.solve(
    "microstrip-impedance",
    {
        "substrateHeight": 1.51,
        "dielectricConstant": 4.5,
        "copperThickness": 35,
    },
    "traceWidth", "impedance", 50,
    grid=0.001,
)
print(result.value, result.reached)
print(result.result.values)

const response = await fetch("https://rftools.io/api/py/v1/calculate/solve", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.RFTOOLS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "slug": "microstrip-impedance",
    "inputs": {
      "substrateHeight": 1.51,
      "dielectricConstant": 4.5,
      "copperThickness": 35
    },
    "solveFor": "traceWidth",
    "target": {
      "output": "impedance",
      "value": 50
    },
    "grid": 0.001
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "microstrip-impedance",
	  "inputs": {
	    "substrateHeight": 1.51,
	    "dielectricConstant": 4.5,
	    "copperThickness": 35
	  },
	  "solveFor": "traceWidth",
	  "target": {
	    "output": "impedance",
	    "value": 50
	  },
	  "grid": 0.001
	}`)
	req, err := http.NewRequest("POST", "https://rftools.io/api/py/v1/calculate/solve", 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": "microstrip-impedance",
  "solveFor": "traceWidth",
  "target": {
    "output": "impedance",
    "value": 50
  },
  "grid": 0.001,
  "value": 2.781,
  "unrounded": 2.780720522734193,
  "reached": true,
  "evaluations": 68,
  "warnings": [],
  "result": {
    "slug": "microstrip-impedance",
    "values": {
      "impedance": 49.99705984469245,
      "effectiveDielectric": 3.3944336801230706,
      "propagationDelay": 6.145581196647901,
      "guidedWavelength": 67.79939168226058,
      "quarterWavelength": 16.949847920565144
    },
    "warnings": [],
    "errors": [],
    "provenance": {
      "method": "calculator:microstrip-impedance",
      "version": "api@3f2c1a9b04de",
      "formulaRef": "Hammerstad & Jensen (1980); Wadell, \"Transmission Line Design Handbook\" 1991",
      "assumptions": [
        {
          "code": "quasi-static",
          "text": "Quasi-static: Z₀ and εeff are the Hammerstad–Jensen static values, with no frequency dependence; dispersion is not modelled."
        },
        {
          "code": "bare-microstrip",
          "text": "Bare microstrip: air above the trace, with no soldermask or other cover layer."
        },
        {
          "code": "homogeneous-substrate",
          "text": "One homogeneous, isotropic, non-magnetic substrate of relative permittivity εr over a solid ground plane, both extending well beyond the trace."
        },
        {
          "code": "thickness-effective-width",
          "text": "Copper thickness t is modelled as an effective width increase Δw = (t/π)(1 + ln(2h/t)), applied to both Z₀ and εeff."
        },
        {
          "code": "lossless",
          "text": "Lossless: conductor and dielectric losses are neglected, so Z₀ is real and the propagation delay is √εeff/c."
        }
      ],
      "validRange": {
        "status": "inside",
        "bounds": {
          "traceWidth": {
            "min": 0.01,
            "max": 50,
            "unit": "mm"
          },
          "substrateHeight": {
            "min": 0.05,
            "max": 10,
            "unit": "mm"
          },
          "dielectricConstant": {
            "min": 1,
            "max": 100,
            "unit": ""
          },
          "copperThickness": {
            "min": 1,
            "max": 200,
            "unit": "μm"
          },
          "frequency": {
            "min": 0.001,
            "max": 300,
            "unit": "GHz"
          }
        },
        "outside": [],
        "model": null
      },
      "computedAt": "2026-09-24T14:05:11.004Z",
      "inputs": {
        "traceWidth": 2.781,
        "substrateHeight": 1.51,
        "dielectricConstant": 4.5,
        "copperThickness": 35,
        "frequency": 2.4
      },
      "seed": null,
      "elapsedSeconds": 0.004
    }
  }
}

A largura de trilha que atinge 50 Ω em FR-4 de 1,51 mm, em uma grade de 0,001 mm.

{
  "detail": "'impedance' is not an input of 'microstrip-impedance', so it cannot be solved for. Its inputs: traceWidth, substrateHeight, dielectricConstant, copperThickness, frequency.",
  "errorKind": "invalid_request",
  "param": "solveFor",
  "allowed": [
    "traceWidth",
    "substrateHeight",
    "dielectricConstant",
    "copperThickness",
    "frequency"
  ]
}

Uma saída indicada como solveFor. Nada foi cobrado.

{
  "detail": "Calculator 'microstrip' not found",
  "errorKind": "invalid_request"
}

Um slug que não existe.