Sections de la documentation

Efficacité du blindage des câbles

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

Slug cable-shield-effectiveness. Calculez l'efficacité du blindage des câbles et l'impédance de transfert en fonction de la fréquence. Évaluez les performances des câbles coaxiaux et blindés en matière de conformité CEM.

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 cable-shield-effectiveness
Nom	Unité	Plage	Valeur par défaut	Description
shieldResistancenombre	mΩ/m	au moins 0.001	10	Par mètre, à partir de la fiche technique du câble
cableLengthnombre	m	au moins 0.01	2	Longueur du câble
frequencynombre	MHz	au moins 0.001	10	Fréquence
transferInductancenombre	nH/m	au moins 0	0.159155	Par mètre, d'après la fiche technique du câble ou une mesure d'impédance de transfert. La valeur par défaut place la fréquence de coupure inductive d'un blindage de 10 mΩ/m à 10 MHz
lineImpedancenombre	Ω	au moins 0.1	50	Impédance caractéristique de la ligne à l'intérieur du blindage, à laquelle la tension couplée est comparée
targetSEnombre	dB	0 … 120	40	L'efficacité de blindage que le câble doit atteindre. L'état passe en dessous de 20 dB.

Sorties

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

Sorties de cable-shield-effectiveness
Champ	Unité	Description
shieldingEffectDbprincipale	dB	Efficacité du blindage
transferImpedance	mΩ	Impédance de transfert

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": "cable-shield-effectiveness",
    "inputs": {
      "shieldResistance": 10,
      "cableLength": 2,
      "frequency": 10,
      "transferInductance": 0.159155,
      "lineImpedance": 50,
      "targetSE": 40
    }
  }'

import rftools

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

result = client.calculate("cable-shield-effectiveness", {
    "shieldResistance": 10,
    "cableLength": 2,
    "frequency": 10,
    "transferInductance": 0.159155,
    "lineImpedance": 50,
    "targetSE": 40,
})
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": "cable-shield-effectiveness",
    "inputs": {
      "shieldResistance": 10,
      "cableLength": 2,
      "frequency": 10,
      "transferInductance": 0.159155,
      "lineImpedance": 50,
      "targetSE": 40
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "cable-shield-effectiveness",
	  "inputs": {
	    "shieldResistance": 10,
	    "cableLength": 2,
	    "frequency": 10,
	    "transferInductance": 0.159155,
	    "lineImpedance": 50,
	    "targetSE": 40
	  }
	}`)
	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": "cable-shield-effectiveness",
  "values": {
    "shieldingEffectDb": 64.9484986639195,
    "transferImpedance": 28.284276304183297
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:cable-shield-effectiveness",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Hähner & Mund, Screening of Cables in the MHz to GHz Frequency Range — Extended Application of a Simple Measuring Method (1998), eqs. 3-1 and 3-2, the method behind IEC 62153-4-4; Vance, IEEE Trans. EMC 17(2), 1975",
    "assumptions": [
      {
        "code": "electrically-short-screen",
        "text": "The screen is electrically short: SE = 20·log₁₀(Z₁/(|Z_T|·l)) holds up to about a sixth of a wavelength, and a longer cable is flagged, not corrected."
      },
      {
        "code": "transfer-impedance-r-plus-jwm",
        "text": "The transfer impedance is R_T + jωM_T; the diffusion term of a solid screen, R₀·γd/sinh(γd), is not modelled, and equals R₀ at low frequency."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "shieldResistance": {
          "min": 0.001,
          "max": null,
          "unit": "mΩ/m"
        },
        "cableLength": {
          "min": 0.01,
          "max": null,
          "unit": "m"
        },
        "frequency": {
          "min": 0.001,
          "max": null,
          "unit": "MHz"
        },
        "transferInductance": {
          "min": 0,
          "max": null,
          "unit": "nH/m"
        },
        "lineImpedance": {
          "min": 0.1,
          "max": null,
          "unit": "Ω"
        },
        "targetSE": {
          "min": 0,
          "max": 120,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "shieldResistance": 10,
      "cableLength": 2,
      "frequency": 10,
      "transferInductance": 0.159155,
      "lineImpedance": 50,
      "targetSE": 40
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "shieldResistance"
      ],
      "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 calculateurEfficacité du blindage des câbles, avec ces valeurs