Secciones de la documentación

Calculadora de Array de Vías Térmicas

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

Slug thermal-via-array. Calcula la resistencia térmica de un array de vías PCB para conducción de calor entre capas.

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 thermal-via-array
Nombre	Unidad	Rango	Valor predeterminado	Descripción
numViasnúmero	vias	1 … 10000	9	Número total de vías térmicas en la matriz
viaDiameternúmero	mm	0.05 … 5	0.3	Diámetro del taladro de la vía. El IPC-7093 recomienda utilizar entre 0,2 y 0,4 mm para las vías térmicas.
platingThicknessnúmero	μm	1 … 200	25	Espesor del chapado de cobre del barril de la vía. PCB típico: 18–35 μm. El barril siempre es de cobre; el relleno ocupa el orificio interior.
pcbThicknessnúmero	mm	0.1 … 10	1.6	Grosor de la placa de circuito impreso (longitud de la ruta térmica de la vía)
copperThermalnúmero	W/m·K	al menos 1	385	Conductividad térmica del material de relleno de la vía. Cobre: 385, plata: 430, epoxi térmico: 1–5. El barril chapado es de cobre (385 W/m·K) sea cual sea el relleno.
drillFillnúmero	ninguna	0 … 1	0	Fracción del taladro, dentro del metalizado, que está rellena, desde 0 (una vía metalizada hueca) hasta 1 (completamente rellena con el material indicado arriba, cobre por defecto). Las vías rellenas de cobre ofrecen el mejor rendimiento térmico.

Salidas

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

Salidas de thermal-via-array
Campo	Unidad	Descripción
thetaPerVia	°C/W	Resistencia por vía
thetaArrayprincipal	°C/W	Resistencia térmica de la matriz
effectiveConductance	W/°C	Conductancia efectiva

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": "thermal-via-array",
    "inputs": {
      "numVias": 9,
      "viaDiameter": 0.3,
      "platingThickness": 25,
      "pcbThickness": 1.6,
      "copperThermal": 385,
      "drillFill": 0
    }
  }'

import rftools

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

result = client.calculate("thermal-via-array", {
    "numVias": 9,
    "viaDiameter": 0.3,
    "platingThickness": 25,
    "pcbThickness": 1.6,
    "copperThermal": 385,
    "drillFill": 0,
})
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": "thermal-via-array",
    "inputs": {
      "numVias": 9,
      "viaDiameter": 0.3,
      "platingThickness": 25,
      "pcbThickness": 1.6,
      "copperThermal": 385,
      "drillFill": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "thermal-via-array",
	  "inputs": {
	    "numVias": 9,
	    "viaDiameter": 0.3,
	    "platingThickness": 25,
	    "pcbThickness": 1.6,
	    "copperThermal": 385,
	    "drillFill": 0
	  }
	}`)
	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": "thermal-via-array",
  "values": {
    "thetaPerVia": 192.41400439917464,
    "thetaArray": 21.379333822130516,
    "effectiveConductance": 0.046774142184208944
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:thermal-via-array",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "numVias": {
          "min": 1,
          "max": 10000,
          "unit": "vias"
        },
        "viaDiameter": {
          "min": 0.05,
          "max": 5,
          "unit": "mm"
        },
        "platingThickness": {
          "min": 1,
          "max": 200,
          "unit": "μm"
        },
        "pcbThickness": {
          "min": 0.1,
          "max": 10,
          "unit": "mm"
        },
        "copperThermal": {
          "min": 1,
          "max": null,
          "unit": "W/m·K"
        },
        "drillFill": {
          "min": 0,
          "max": 1,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "numVias": 9,
      "viaDiameter": 0.3,
      "platingThickness": 25,
      "pcbThickness": 1.6,
      "copperThermal": 385,
      "drillFill": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "numVias"
      ],
      "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 Array de Vías Térmicas, con estos valores