Seções da documentação

Calculadora térmica Via Array

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

Slug thermal-via-array. Calcule a resistência térmica de um PCB térmico via matriz para propagação de calor de pacotes SMD para planos internos de cobre ou dissipadores de calor.

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 thermal-via-array
Nome	Unidade	Faixa	Padrão	Descrição
numViasnúmero	vias	1 … 10000	9	Número total de vias térmicas na matriz
viaDiameternúmero	mm	0.05 … 5	0.3	Diâmetro do furo da via. A IPC-7093 recomenda 0,2–0,4 mm para vias térmicas.
platingThicknessnúmero	μm	1 … 200	25	Espessura da metalização de cobre do cilindro da via. PCB típica: 18–35 μm. O cilindro é sempre de cobre; o preenchimento ocupa o furo dentro dele.
pcbThicknessnúmero	mm	0.1 … 10	1.6	Espessura do PCB (comprimento do caminho térmico da via)
copperThermalnúmero	W/m·K	no mínimo 1	385	Condutividade térmica do material de preenchimento da via. Cobre: 385, prata: 430, epóxi térmico: 1–5. O cilindro metalizado é de cobre (385 W/m·K), qualquer que seja o preenchimento.
drillFillnúmero	nenhuma	0 … 1	0	Fração do furo dentro da metalização que é preenchida, de 0 (via metalizada oca) a 1 (totalmente preenchida com o material acima, cobre por padrão). Vias preenchidas com cobre oferecem o melhor desempenho térmico.

Saídas

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

Saídas de thermal-via-array
Campo	Unidade	Descrição
thetaPerVia	°C/W	Resistência por via
thetaArrayprincipal	°C/W	Resistência térmica da matriz
effectiveConductance	W/°C	Condutância efetiva

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

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 térmica Via Array, com estes valores