Abschnitte der Dokumentation

Wirksamkeit der Kabelabschirmung

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

Slug cable-shield-effectiveness. Berechnen Sie die Effektivität der Kabelabschirmung und die Übertragungsimpedanz im Vergleich zur Frequenz. Bewerten Sie die EMI-Leistung von Koaxial- und abgeschirmten Kabeln auf EMV-Konformität.

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 cable-shield-effectiveness
Name	Einheit	Bereich	Standardwert	Beschreibung
shieldResistanceZahl	mΩ/m	mindestens 0.001	10	Pro Meter, aus Kabeldatenblatt
cableLengthZahl	m	mindestens 0.01	2	Kabellänge
frequencyZahl	MHz	mindestens 0.001	10	Frequenz
transferInductanceZahl	nH/m	mindestens 0	0.159155	Pro Meter, aus dem Kabeldatenblatt oder einer Messung der Übertragungsimpedanz. Der Standardwert legt die induktive Eckfrequenz eines Schirms mit 10 mΩ/m auf 10 MHz
lineImpedanceZahl	Ω	mindestens 0.1	50	Wellenwiderstand der Leitung im Schirm, mit dem die eingekoppelte Spannung verglichen wird
targetSEZahl	dB	0 … 120	40	Die Abschirmwirkung, die das Kabel erreichen muss. Der Status schlägt unter 20 dB fehl.

Ausgaben

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

Ausgaben von cable-shield-effectiveness
Feld	Einheit	Beschreibung
shieldingEffectDbHauptwert	dB	Wirksamkeit der Abschirmung
transferImpedance	mΩ	Transferimpedanz

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

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 RechnerseiteWirksamkeit der Kabelabschirmung, mit diesen Werten