Abschnitte der Dokumentation

Thermischer Via-Array-Rechner

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

Slug thermal-via-array. Berechnet den thermischen Widerstand einer Leiterplatte für die Wärmeverteilung von SMD-Gehäusen auf innere Kupferflächen oder Kühlkörper.

Eingaben

Senden Sie jede dieser Eingaben in inputs, in den gezeigten Einheiten. Die meisten sind erforderlich: Ein Aufruf, dem eine davon fehlt, wird abgelehnt (400) und kostet nichts; eine, auf die der Rechner verzichten kann, erhält den gezeigten Standardwert. Eine Eingabe außerhalb ihres Bereichs wird trotzdem berechnet und in der Provenienz markiert.

Eingaben von thermal-via-array
Name	Einheit	Bereich	Standardwert	Beschreibung
numViasZahl	vias	1 … 10000	9	Gesamtzahl der thermischen Vias im Array
viaDiameterZahl	mm	0.05 … 5	0.3	Durchmesser der Via-Bohrung. IPC-7093 empfiehlt 0,2–0,4 mm für thermische Vias.
platingThicknessZahl	μm	1 … 200	25	Dicke der Kupferbeschichtung der Via-Hülse. Typische Leiterplatte: 18–35 μm. Die Hülse ist immer aus Kupfer; eine Füllung nimmt die Bohrung innerhalb der Hülse ein.
pcbThicknessZahl	mm	0.1 … 10	1.6	Leiterplattendicke (Länge des Wärmepfads durch das Via)
copperThermalZahl	W/m·K	mindestens 1	385	Wärmeleitfähigkeit des Via-Füllmaterials. Kupfer: 385, Silber: 430, Wärmeleitepoxid: 1–5. Die beschichtete Hülse ist unabhängig von der Füllung aus Kupfer (385 W/m·K).
drillFillZahl	keine	0 … 1	0	Gefüllter Anteil der Bohrung innerhalb der Metallisierung, von 0 (hohles metallisiertes Via) bis 1 (vollständig mit dem oben gewählten Material gefüllt, standardmäßig Kupfer). Kupfergefüllte Vias bieten die beste thermische Leistung.

Ausgaben

Zurückgegeben in values, nach Namen. Ein Wert, der unbegrenzt oder nicht definiert ist, ist null.

Ausgaben von thermal-via-array
Feld	Einheit	Beschreibung
thetaPerVia	°C/W	Wärmewiderstand pro Via
thetaArrayHauptwert	°C/W	Wärmewiderstand des Arrays
effectiveConductance	W/°C	Effektiver Leitwert

Aufruf

Berechnen: ein Aufruf, Anfrage und Antwort vollständig, und seine Fehler.
Batch: dieser Rechner zusammen mit anderen oder ein Sweep, in einer Anfrage.
Nach einem Zielwert auflösen: der Wert einer Eingabe, der eine Ausgabe auf einen Zielwert bringt.

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

Eine als Text gesendete Eingabe. Es wurde nichts gezählt.

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

Zu viele Anfragen in einer Minute, mit Retry-After.

Dieselben Eingaben auf der RechnerseiteThermischer Via-Array-Rechner, mit diesen Werten