Sections de la documentation

Calculateur de chute de tension et de puissance Via

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

Slug via-voltage-drop. Calculez la résistance en courant continu, la chute de tension et la dissipation de puissance des trous traversants plaqués avec compensation de température et réseaux de circuits parallèles.

Entrées

Envoyez chacune de ces entrées dans inputs, dans les unités indiquées. La plupart sont obligatoires : un appel auquel il en manque une est refusé (400) et ne coûte rien ; une entrée dont le calculateur peut se passer prend la valeur par défaut indiquée. Une entrée hors de sa plage est tout de même calculée et signalée dans la provenance.

Entrées de via-voltage-drop
Nom	Unité	Plage	Valeur par défaut	Description
drillDiameternombre	mm	0.1 … 1	0.3	Diamètre de perçage
platingThicknessnombre	µm	12 … 50	25	Épaisseur de métallisation
viaLengthnombre	mm	0.1 … 6	1.6	Longueur du via (épaisseur de la carte)
currentnombre	A	0.001 … 50	1	Courant
temperaturenombre	°C	−40 … 125	25	Température de fonctionnement
numViasnombre	aucune	1 … 100	1	Nombre de vias en parallèle

Sorties

Renvoyées dans values, par nom. Une valeur non bornée ou non définie vaut null.

Sorties de via-voltage-drop
Champ	Unité	Description
rSingleMOhm	mΩ	Résistance d'un seul via
rTotalMOhm	mΩ	Résistance totale (en parallèle)
vDropMVprincipale	mV	Chute de tension
pDissipationMW	mW	Puissance dissipée
areaMm2	mm²	Section transversale du via
deltaT	°C	Échauffement du fût (à mi-longueur, au-dessus des pastilles)
thetaVia	°C/W	Résistance thermique

Comment l'appeler

Calculer : un appel, la requête et la réponse complètes, et ses erreurs.
Calcul par lots : ce calculateur avec d'autres, ou un balayage, en une seule requête.
Résoudre pour une valeur cible : la valeur d'une entrée qui amène une sortie à une cible.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "via-voltage-drop",
    "inputs": {
      "drillDiameter": 0.3,
      "platingThickness": 25,
      "viaLength": 1.6,
      "current": 1,
      "temperature": 25,
      "numVias": 1
    }
  }'

import rftools

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

result = client.calculate("via-voltage-drop", {
    "drillDiameter": 0.3,
    "platingThickness": 25,
    "viaLength": 1.6,
    "current": 1,
    "temperature": 25,
    "numVias": 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": "via-voltage-drop",
    "inputs": {
      "drillDiameter": 0.3,
      "platingThickness": 25,
      "viaLength": 1.6,
      "current": 1,
      "temperature": 25,
      "numVias": 1
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "via-voltage-drop",
	  "inputs": {
	    "drillDiameter": 0.3,
	    "platingThickness": 25,
	    "viaLength": 1.6,
	    "current": 1,
	    "temperature": 25,
	    "numVias": 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": "via-voltage-drop",
  "values": {
    "rSingleMOhm": 1.3023284782838458,
    "rTotalMOhm": 1.3023284782838458,
    "vDropMV": 1.3023284782838458,
    "pDissipationMW": 1.3023284782838458,
    "areaMm2": 0.021598449493429827,
    "deltaT": 0.03132327969370978,
    "thetaVia": 192.41400439917456
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:via-voltage-drop",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Resistance R = ρL/A with ρ₂₀ = 1/58 Ω·mm²/m (IEC 60028); self-heating: Incropera, DeWitt, Bergman & Lavine, Fundamentals of Heat and Mass Transfer, 7th ed., section 3.5 (one-dimensional conduction with uniform generation)",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "drillDiameter": {
          "min": 0.1,
          "max": 1,
          "unit": "mm"
        },
        "platingThickness": {
          "min": 12,
          "max": 50,
          "unit": "µm"
        },
        "viaLength": {
          "min": 0.1,
          "max": 6,
          "unit": "mm"
        },
        "current": {
          "min": 0.001,
          "max": 50,
          "unit": "A"
        },
        "temperature": {
          "min": -40,
          "max": 125,
          "unit": "°C"
        },
        "numVias": {
          "min": 1,
          "max": 100,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "drillDiameter": 0.3,
      "platingThickness": 25,
      "viaLength": 1.6,
      "current": 1,
      "temperature": 25,
      "numVias": 1
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "drillDiameter"
      ],
      "msg": "Input should be a valid number, unable to parse string as a number",
      "input": "abc"
    }
  ]
}

Une entrée envoyée sous forme de texte. Rien n'a été décompté.

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

Trop de requêtes en une minute, avec Retry-After.

Les mêmes entrées sur la page du calculateurCalculateur de chute de tension et de puissance Via, avec ces valeurs