Abschnitte der Dokumentation

Kalkulator zur Kühlkörper-Auswahl

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

Slug heatsink-selection. Berechnen Sie den erforderlichen Wärmewiderstand des Kühlkörpers (ΔSA), um eine Geräteverbindung unter ihrer Maximaltemperatur zu halten. Verwenden Sie dies, um einen geeigneten Kühlkörper auszuwählen.

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 heatsink-selection
Name	Einheit	Bereich	Standardwert	Beschreibung
pdZahl	W	mindestens 0.001	5	Verlustleistung im Gerät, das entfernt werden muss
taZahl	°C	−55 … 125	40	Maximale Umgebungstemperatur (Umgebungsluft)
tjMaxZahl	°C	50 … 200	125	Maximal zulässige Sperrschichttemperatur aus dem Gerätedatenblatt
thetaJCZahl	°C/W	mindestens 0	3	Wärmewiderstand von der Verbindungsstelle zum Gehäuse aus dem Gerätedatenblatt
thetaCSZahl	°C/W	mindestens 0	0.5	Wärmewiderstand zwischen Gehäuse und Kühlkörper (thermisches Schnittstellenmaterial)
numLayersZahl	keine	0 … 6	0	Thermische Schichten in Reihe zwischen Gehäuse und Kühlkörper neben θ_CS, etwa ein Isolierpad, ein Wärmeverteiler oder eine Leiterplatte mit thermischen Vias (0–6)
layer1ThetaZahl	°C/W	0 … 100	1	Wärmewiderstand der zusätzlichen Schicht 1, in Reihe zwischen Gehäuse und Kühlkörper
layer2ThetaZahl	°C/W	0 … 100	1	Wärmewiderstand der zusätzlichen Schicht 2, in Reihe zwischen Gehäuse und Kühlkörper
layer3ThetaZahl	°C/W	0 … 100	1	Wärmewiderstand der zusätzlichen Schicht 3, in Reihe zwischen Gehäuse und Kühlkörper
layer4ThetaZahl	°C/W	0 … 100	1	Wärmewiderstand der zusätzlichen Schicht 4, in Reihe zwischen Gehäuse und Kühlkörper
layer5ThetaZahl	°C/W	0 … 100	1	Wärmewiderstand der zusätzlichen Schicht 5, in Reihe zwischen Gehäuse und Kühlkörper
layer6ThetaZahl	°C/W	0 … 100	1	Wärmewiderstand der zusätzlichen Schicht 6, in Reihe zwischen Gehäuse und Kühlkörper

Ausgaben

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

Ausgaben von heatsink-selection
Feld	Einheit	Beschreibung
thetaSARequiredHauptwert	°C/W	Erforderliches θ_SA
tjActual	°C	Aktuelle Kreuzungstemperatur
deltaTJ	°C	Thermischer Spielraum
thetaJS	°C/W	θ Sperrschicht–Kühlkörper
heatsinkTemp	°C	Kühlkörpertemperatur

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": "heatsink-selection",
    "inputs": {
      "pd": 5,
      "ta": 40,
      "tjMax": 125,
      "thetaJC": 3,
      "thetaCS": 0.5,
      "numLayers": 0,
      "layer1Theta": 1,
      "layer2Theta": 1,
      "layer3Theta": 1,
      "layer4Theta": 1,
      "layer5Theta": 1,
      "layer6Theta": 1
    }
  }'

import rftools

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

result = client.calculate("heatsink-selection", {
    "pd": 5,
    "ta": 40,
    "tjMax": 125,
    "thetaJC": 3,
    "thetaCS": 0.5,
    "numLayers": 0,
    "layer1Theta": 1,
    "layer2Theta": 1,
    "layer3Theta": 1,
    "layer4Theta": 1,
    "layer5Theta": 1,
    "layer6Theta": 1,
})
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": "heatsink-selection",
    "inputs": {
      "pd": 5,
      "ta": 40,
      "tjMax": 125,
      "thetaJC": 3,
      "thetaCS": 0.5,
      "numLayers": 0,
      "layer1Theta": 1,
      "layer2Theta": 1,
      "layer3Theta": 1,
      "layer4Theta": 1,
      "layer5Theta": 1,
      "layer6Theta": 1
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "heatsink-selection",
	  "inputs": {
	    "pd": 5,
	    "ta": 40,
	    "tjMax": 125,
	    "thetaJC": 3,
	    "thetaCS": 0.5,
	    "numLayers": 0,
	    "layer1Theta": 1,
	    "layer2Theta": 1,
	    "layer3Theta": 1,
	    "layer4Theta": 1,
	    "layer5Theta": 1,
	    "layer6Theta": 1
	  }
	}`)
	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": "heatsink-selection",
  "values": {
    "thetaSARequired": 13.5,
    "tjActual": 125,
    "deltaTJ": 0,
    "thetaJS": 3.5,
    "heatsinkTemp": 107.5
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:heatsink-selection",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "pd": {
          "min": 0.001,
          "max": null,
          "unit": "W"
        },
        "ta": {
          "min": -55,
          "max": 125,
          "unit": "°C"
        },
        "tjMax": {
          "min": 50,
          "max": 200,
          "unit": "°C"
        },
        "thetaJC": {
          "min": 0,
          "max": null,
          "unit": "°C/W"
        },
        "thetaCS": {
          "min": 0,
          "max": null,
          "unit": "°C/W"
        },
        "numLayers": {
          "min": 0,
          "max": 6,
          "unit": ""
        },
        "layer1Theta": {
          "min": 0,
          "max": 100,
          "unit": "°C/W"
        },
        "layer2Theta": {
          "min": 0,
          "max": 100,
          "unit": "°C/W"
        },
        "layer3Theta": {
          "min": 0,
          "max": 100,
          "unit": "°C/W"
        },
        "layer4Theta": {
          "min": 0,
          "max": 100,
          "unit": "°C/W"
        },
        "layer5Theta": {
          "min": 0,
          "max": 100,
          "unit": "°C/W"
        },
        "layer6Theta": {
          "min": 0,
          "max": 100,
          "unit": "°C/W"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "pd": 5,
      "ta": 40,
      "tjMax": 125,
      "thetaJC": 3,
      "thetaCS": 0.5,
      "numLayers": 0,
      "layer1Theta": 1,
      "layer2Theta": 1,
      "layer3Theta": 1,
      "layer4Theta": 1,
      "layer5Theta": 1,
      "layer6Theta": 1
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "pd"
      ],
      "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 RechnerseiteKalkulator zur Kühlkörper-Auswahl, mit diesen Werten