Secciones de la documentación

Calculadora de Selección de Disipador

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

Slug heatsink-selection. Determina la resistencia térmica máxima del disipador requerida para mantener una temperatura de unión segura.

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 heatsink-selection
Nombre	Unidad	Rango	Valor predeterminado	Descripción
pdnúmero	W	al menos 0.001	5	Energía disipada en el dispositivo que debe extraerse
tanúmero	°C	−55 … 125	40	Temperatura ambiente máxima (aire circundante)
tjMaxnúmero	°C	50 … 200	125	Temperatura de unión máxima permitida según la hoja de datos del dispositivo
thetaJCnúmero	°C/W	al menos 0	3	Resistencia térmica de la unión a la caja según la hoja de datos del dispositivo
thetaCSnúmero	°C/W	al menos 0	0.5	Resistencia térmica entre la carcasa y el disipador térmico (material de interfaz térmica)
numLayersnúmero	ninguna	0 … 6	0	Capas térmicas en serie entre la carcasa y el disipador, además de θ_CS, como una almohadilla aislante, un esparcidor o una placa con vías térmicas (0–6)
layer1Thetanúmero	°C/W	0 … 100	1	Resistencia térmica de la capa adicional 1, en serie entre la carcasa y el disipador
layer2Thetanúmero	°C/W	0 … 100	1	Resistencia térmica de la capa adicional 2, en serie entre la carcasa y el disipador
layer3Thetanúmero	°C/W	0 … 100	1	Resistencia térmica de la capa adicional 3, en serie entre la carcasa y el disipador
layer4Thetanúmero	°C/W	0 … 100	1	Resistencia térmica de la capa adicional 4, en serie entre la carcasa y el disipador
layer5Thetanúmero	°C/W	0 … 100	1	Resistencia térmica de la capa adicional 5, en serie entre la carcasa y el disipador
layer6Thetanúmero	°C/W	0 … 100	1	Resistencia térmica de la capa adicional 6, en serie entre la carcasa y el disipador

Salidas

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

Salidas de heatsink-selection
Campo	Unidad	Descripción
thetaSARequiredprincipal	°C/W	Necesario θ_SA
tjActual	°C	Temperatura de unión real
deltaTJ	°C	Margen térmico
thetaJS	°C/W	Empalme al disipador de calor θ
heatsinkTemp	°C	Temperatura del disipador

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

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 Selección de Disipador, con estos valores