Secciones de la documentación

Resolver para un valor objetivo

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

Halla el valor de una entrada de la calculadora que lleva una de sus salidas a un objetivo (el ancho de pista que da 50 Ω, la separación que da una impedancia diferencial objetivo) y lo devuelve junto con el resultado directo exactamente en ese valor. Una sola llamada contabilizada sustituye a las llamadas directas que un cliente gastaría buscando a mano.

Cómo se realiza la búsqueda

La búsqueda recorre los límites declarados de solveFor, acotados por range cuando se indica; una entrada sin límite declarado necesita range. Cuando se indica grid, el value devuelto se redondea al múltiplo de la rejilla más cercano dentro del rango y unrounded lleva la solución exacta; sin grid, value y unrounded son el mismo número. En ambos casos, result (exactamente lo que /calculate devuelve para esas entradas, procedencia incluida) es la ejecución directa de la calculadora exactamente en el value devuelto, de modo que lo que muestra un cliente es un cálculo directo real, nunca la estimación propia del solucionador.

Cuerpo de la solicitud

SolveRequest
Campo	Descripción
slugobligatoriostring	La calculadora.
inputsobligatorioobject of numbers	Todas las entradas excepto solveFor. Un valor dado para solveFor es solo el punto de partida de la búsqueda, que sirve para desempatar entre varias soluciones.
solveForobligatoriostring	Una entrada numérica declarada de la calculadora.
target.outputobligatoriostring	Una clave de salida que devuelve la calculadora.
target.valueobligatorionumber	El valor que debe alcanzar esa salida.
gridnumber	Una rejilla de fabricación positiva; el valor devuelto se redondea a su múltiplo más cercano dentro del rango.
range[number, number]	Acota los límites declarados de solveFor; obligatorio cuando no declara ninguno.

Respuesta

SolveResponse
Campo	Descripción
valuenumber	El valor resuelto, redondeado a grid si se indicó uno.
unroundednumber	La solución exacta, antes del redondeo a la rejilla.
reachedboolean	Si se alcanzó el objetivo; false sigue llevando el valor más cercano encontrado, no una conjetura.
evaluationsinteger	Cuántas evaluaciones directas usó la búsqueda.
warningsstring[]	Los hallazgos propios de la resolución: otra solución en el rango, o un objetivo no alcanzado.
resultobject	Exactamente lo que /calculate devuelve para las entradas con solveFor fijado en value: values, warnings, errors y provenance.
slug, solveFor, target, gridecho	Los campos de la solicitud, tal como se dieron; grid es null cuando no se indicó.

Coste y soluciones múltiples

Coste

Una llamada contabilizada, cobrada como /calculate después de todas las comprobaciones de abajo, y devuelta si el servicio falla después. Un objetivo que la búsqueda no puede alcanzar se responde igualmente con éxito y se cobra igualmente, con reached: false y el valor más cercano encontrado: el cliente pidió algo que el servicio entregó.

Más de una solución

Cuando la salida cruza el objetivo más de una vez dentro del rango, la llamada devuelve el cruce más cercano al valor inicial (el valor del propio cliente para solveFor, o si no, el valor predeterminado de la calculadora) y añade una advertencia que nombra el otro.

Rechazos

Una solicitud que no se puede resolver se rechaza antes de cobrar nada, y param nombra el campo erróneo:

Rechazos de solve
Estado	Cuándo
404	El slug de la calculadora no existe.
400	solveFor no es una de las entradas numéricas declaradas de la calculadora (param: solveFor, con allowed).
400	target.output no es una de las salidas de la calculadora (param: target.output, con allowed).
400	Se indica grid y no es un número finito y positivo, o no tiene ningún múltiplo en el rango.
400	Algún valor dado (una entrada, target.value o un límite del rango) no es finito.
400	solveFor no tiene límite declarado y el cuerpo no da ningún range, o el rango dado queda fuera de los límites declarados o está vacío.
400	Una entrada fija supera un límite que la calculadora impone a su propio tiempo de ejecución, como en /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
    }
  }
}

El ancho de pista que alcanza 50 Ω sobre FR-4 de 1,51 mm, en una rejilla 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"
  ]
}

Una salida indicada como solveFor. No se cobró nada.

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

Un slug que no existe.