Abschnitte der Dokumentation

Rechner für die Wirksamkeit der Abschirmung

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

Slug shielding-effectiveness. Berechnen Sie die Wirksamkeit der elektromagnetischen Abschirmung, den Absorptionsverlust, den Reflexionsverlust und die Eindringtiefe. Bewerten Sie Gehäusematerialien mit dem Modell der ebenen Welle nach Ott (2009, Kap. 6) und LearnEMC.

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 shielding-effectiveness
Name	Einheit	Bereich	Standardwert	Beschreibung
frequencyZahl	MHz	mindestens 0.001	1000	Frequenz
thicknessZahl	mm	mindestens 0.001	1	Dicke des Schildes
conductivityZahl	MS/m	mindestens 0.001	59.6	Leitfähigkeit
permeabilityZahl	keine	mindestens 1	1	Relative Permeabilität
targetSEZahl	dB	0 … 200	40	Die Abschirmwirkung, die das Gehäuse 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 shielding-effectiveness
Feld	Einheit	Beschreibung
absorptionLoss	dB	Absorptionsverlust
reflectionLoss	dB	Reflexionsverlust
totalSEHauptwert	dB	Gesamtwirksamkeit der Abschirmung
skinDepth	μm	Tiefe der Haut
thicknessVsSkin	keine	Verhältnis Dicke zu Hauttiefe
multipleReflectionLoss	dB	Mehrfachreflexionskorrektur

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": "shielding-effectiveness",
    "inputs": {
      "frequency": 1000,
      "thickness": 1,
      "conductivity": 59.6,
      "permeability": 1,
      "targetSE": 40
    }
  }'

import rftools

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

result = client.calculate("shielding-effectiveness", {
    "frequency": 1000,
    "thickness": 1,
    "conductivity": 59.6,
    "permeability": 1,
    "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": "shielding-effectiveness",
    "inputs": {
      "frequency": 1000,
      "thickness": 1,
      "conductivity": 59.6,
      "permeability": 1,
      "targetSE": 40
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "shielding-effectiveness",
	  "inputs": {
	    "frequency": 1000,
	    "thickness": 1,
	    "conductivity": 59.6,
	    "permeability": 1,
	    "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": "shielding-effectiveness",
  "values": {
    "absorptionLoss": 4213.250734744303,
    "reflectionLoss": 78.25797678604148,
    "totalSE": 4291.508711530345,
    "skinDepth": 2.0615648545284526,
    "thicknessVsSkin": 485.06841674342223,
    "multipleReflectionLoss": 0
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:shielding-effectiveness",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Ott, Electromagnetic Compatibility Engineering (2009) §6.5; Hubing, LearnEMC, Introduction to Plane-Wave Shielding Theory",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "frequency": {
          "min": 0.001,
          "max": null,
          "unit": "MHz"
        },
        "thickness": {
          "min": 0.001,
          "max": null,
          "unit": "mm"
        },
        "conductivity": {
          "min": 0.001,
          "max": null,
          "unit": "MS/m"
        },
        "permeability": {
          "min": 1,
          "max": null,
          "unit": ""
        },
        "targetSE": {
          "min": 0,
          "max": 200,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "frequency": 1000,
      "thickness": 1,
      "conductivity": 59.6,
      "permeability": 1,
      "targetSE": 40
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "frequency"
      ],
      "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 RechnerseiteRechner für die Wirksamkeit der Abschirmung, mit diesen Werten