Sections de la documentation

Calculateur de courant de fusion PCB Trace

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

Slug fusing-current. Calculez le courant qui fusionnera une trace de PCB à l'aide de l'équation d'Onderdonk. Comprend la correction trapézoïdale du facteur de gravure, le temps de fusion à votre courant de fonctionnement et la marge de sécurité.

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 fusing-current
Nom	Unité	Plage	Valeur par défaut	Description
traceWidthnombre	mm	au moins 0.02	0.5	Largeur à la base de la trace, là où elle rencontre le laminé
copperThicknessnombre	μm	au moins 5	35	Poids du cuivre
durationnombre	s	au moins 0.001	1	Durée de la panne
ambientTempnombre	°C	−55 … 150	25	Température ambiante
etchFactornombre	aucune	0 … 5	0	Profondeur de gravure divisée par l'entaille latérale de chaque côté (IPC-T-50). Un nombre plus élevé signifie des parois latérales plus droites ; entrez 0 pour des parois parfaitement verticales
operatingCurrentnombre	A	au moins 0	5	Facultatif : utilisé pour indiquer le délai de fusion et la marge de sécurité

Sorties

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

Sorties de fusing-current
Champ	Unité	Description
fusingCurrentprincipale	A	Courant de fusion
timeToFuse	s	Temps de fusion au courant de fonctionnement
currentMargin	×	Marge jusqu'à la fusion
crossSectionArea	sq mil	Zone transversale
effectiveWidth	mm	Largeur effective (moyenne)

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": "fusing-current",
    "inputs": {
      "traceWidth": 0.5,
      "copperThickness": 35,
      "duration": 1,
      "ambientTemp": 25,
      "etchFactor": 0,
      "operatingCurrent": 5
    }
  }'

import rftools

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

result = client.calculate("fusing-current", {
    "traceWidth": 0.5,
    "copperThickness": 35,
    "duration": 1,
    "ambientTemp": 25,
    "etchFactor": 0,
    "operatingCurrent": 5,
})
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": "fusing-current",
    "inputs": {
      "traceWidth": 0.5,
      "copperThickness": 35,
      "duration": 1,
      "ambientTemp": 25,
      "etchFactor": 0,
      "operatingCurrent": 5
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "fusing-current",
	  "inputs": {
	    "traceWidth": 0.5,
	    "copperThickness": 35,
	    "duration": 1,
	    "ambientTemp": 25,
	    "etchFactor": 0,
	    "operatingCurrent": 5
	  }
	}`)
	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": "fusing-current",
  "values": {
    "fusingCurrent": 5.052590095074653,
    "crossSectionArea": 27.125054250108505,
    "timeToFuse": 1.0211466667538598,
    "currentMargin": 1.0105180190149308,
    "effectiveWidth": 0.5
  },
  "warnings": [
    "Only 1.01× margin to fusing — this is a survival limit, not a continuous rating. Size continuous current with IPC-2152 instead"
  ],
  "errors": [],
  "provenance": {
    "method": "calculator:fusing-current",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "I. M. Onderdonk, as published in E. R. Stauffacher, \"Short-time Current Carrying Capacity of Copper Wire\", General Electric Review, 1928; IPC-2152 Appendix A",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "traceWidth": {
          "min": 0.02,
          "max": null,
          "unit": "mm"
        },
        "copperThickness": {
          "min": 5,
          "max": null,
          "unit": "μm"
        },
        "duration": {
          "min": 0.001,
          "max": null,
          "unit": "s"
        },
        "ambientTemp": {
          "min": -55,
          "max": 150,
          "unit": "°C"
        },
        "etchFactor": {
          "min": 0,
          "max": 5,
          "unit": ""
        },
        "operatingCurrent": {
          "min": 0,
          "max": null,
          "unit": "A"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "traceWidth": 0.5,
      "copperThickness": 35,
      "duration": 1,
      "ambientTemp": 25,
      "etchFactor": 0,
      "operatingCurrent": 5
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "traceWidth"
      ],
      "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 courant de fusion PCB Trace, avec ces valeurs