Secciones de la documentación

Calculadora de Resistencia Térmica de Vías

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

Slug via-thermal-resistance. Calcula la resistencia térmica de vías de cobre para disipar calor en PCBs de potencia.

Entradas

Envíe cada una de estas en inputs, en las unidades indicadas. La mayoría son obligatorias: una llamada a la que le falte una se rechaza (400) y no cuesta nada; una de la que la calculadora puede prescindir toma el valor predeterminado indicado. Una entrada fuera de su rango se calcula igualmente y se marca en la procedencia.

Entradas de via-thermal-resistance
Nombre	Unidad	Rango	Valor predeterminado	Descripción
viaDiameternúmero	mm	0.05 … 6	0.3	Diámetro de vía
platingThicknessnúmero	μm	1 … 100	25	Espesor del metalizado de cobre en las paredes del barril de la vía
boardThicknessnúmero	mm	al menos 0.1	1.6	Grosor de la placa
numViasnúmero	ninguna	1 … 100	4	Número de vías
viaFillnúmero	ninguna	0 … 1	0	Relleno de la víaUno de: 0 Sin relleno (metalizada) · 1 Rellena de cobre
tempRisenúmero	°C	1 … 100	10	Aumento de temperatura permitido del barril de la vía sobre la temperatura ambiente. Solo se usa para la capacidad de corriente según IPC-2221; la resistencia térmica no depende de él.

Salidas

Se devuelven en values, por nombre. Un valor ilimitado o no definido es null.

Salidas de via-thermal-resistance
Campo	Unidad	Descripción
viaResistance	°C/W	Resistencia térmica de vía única
arrayResistanceprincipal	°C/W	Resistencia térmica de la matriz
thermalConductance	W/°C	Conductancia térmica
currentCapacity	mA	Capacidad de corriente (por vía)

Cómo llamarla

Calcular: una llamada, la solicitud y la respuesta completas, y sus errores.
Cálculo por lotes: esta calculadora con otras, o un barrido, en una sola solicitud.
Resolver para un valor objetivo: el valor de una entrada que lleva una salida a un objetivo.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "via-thermal-resistance",
    "inputs": {
      "viaDiameter": 0.3,
      "platingThickness": 25,
      "boardThickness": 1.6,
      "numVias": 4,
      "viaFill": 0,
      "tempRise": 10
    }
  }'

import rftools

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

result = client.calculate("via-thermal-resistance", {
    "viaDiameter": 0.3,
    "platingThickness": 25,
    "boardThickness": 1.6,
    "numVias": 4,
    "viaFill": 0,
    "tempRise": 10,
})
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": "via-thermal-resistance",
    "inputs": {
      "viaDiameter": 0.3,
      "platingThickness": 25,
      "boardThickness": 1.6,
      "numVias": 4,
      "viaFill": 0,
      "tempRise": 10
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "via-thermal-resistance",
	  "inputs": {
	    "viaDiameter": 0.3,
	    "platingThickness": 25,
	    "boardThickness": 1.6,
	    "numVias": 4,
	    "viaFill": 0,
	    "tempRise": 10
	  }
	}`)
	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": "via-thermal-resistance",
  "values": {
    "viaResistance": 192.41400439917464,
    "arrayResistance": 48.10350109979366,
    "thermalConductance": 0.020788507637426196,
    "currentCapacity": 1685.3446055708444
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:via-thermal-resistance",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "IPC-2221A Figure 6-4 (conductor current capacity, and its fit); Fourier conduction for θ",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "viaDiameter": {
          "min": 0.05,
          "max": 6,
          "unit": "mm"
        },
        "platingThickness": {
          "min": 1,
          "max": 100,
          "unit": "μm"
        },
        "boardThickness": {
          "min": 0.1,
          "max": null,
          "unit": "mm"
        },
        "numVias": {
          "min": 1,
          "max": 100,
          "unit": ""
        },
        "viaFill": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "tempRise": {
          "min": 1,
          "max": 100,
          "unit": "°C"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "viaDiameter": 0.3,
      "platingThickness": 25,
      "boardThickness": 1.6,
      "numVias": 4,
      "viaFill": 0,
      "tempRise": 10
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "viaDiameter"
      ],
      "msg": "Input should be a valid number, unable to parse string as a number",
      "input": "abc"
    }
  ]
}

Una entrada enviada como texto. No se contó nada.

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

Demasiadas solicitudes en un minuto, con Retry-After.

Las mismas entradas en la página de la calculadoraCalculadora de Resistencia Térmica de Vías, con estos valores