Abschnitte der Dokumentation

Filterordnungsrechner für digitale Filter

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

Slug digital-filter-order. Berechnen Sie die Mindestfilterreihenfolge für Butterworth-, Chebyshev- und elliptische Designs. Ermitteln Sie die Reihenfolge anhand der Spezifikationen für Durchlassbandwelligkeit und Sperrbanddämpfung. Kostenlose, sofortige Ergebnisse.

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 digital-filter-order
Name	Einheit	Bereich	Standardwert	Beschreibung
passbandFreqZahl	Hz	mindestens 1	1000	Frequenz, bis zu der die Vorgabe für die Welligkeit im Durchlassbereich eingehalten wird
stopbandFreqZahl	Hz	mindestens 1	2000	Frequenz, ab der die Sperrdämpfung erreicht sein muss
passbandRippleZahl	dB	mindestens 0.01	3	Maximal zulässige Restwelligkeit im Durchlassbereich (typischerweise 0,1—3 dB)
stopbandAttenuationZahl	dB	mindestens 1	40	Geforderte Mindestdämpfung im Sperrbereich
toneFreqZahl	Hz	mindestens 0.001	1000	Ein Ton, den das Filter durchlassen muss, während es seine Harmonischen sperrt: der Träger eines Senders, die Netzgrundfrequenz, ein Prüfton
maxHarmonicZahl	keine	1 … 50	5	Die höchste Harmonische des Tons, die der Frequenzplan verfolgt

Ausgaben

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

Ausgaben von digital-filter-order
Feld	Einheit	Beschreibung
butterworthOrderHauptwert	keine	Butterworth-Ordnung
chebyshevOrder	keine	Tschebyscheff-Ordnung
ellipticOrder	keine	Elliptische Ordnung
transitionRatio	keine	Übergangsverhältnis
harmonicsInPassband	keine	Harmonische im Durchlassbereich
harmonicsInTransition	keine	Harmonische im Übergangsbereich
nearestHarmonic	Hz	Niedrigste Harmonische über dem Durchlassbereich
butterworthAttenuation	dB	Butterworth-Dämpfung bei f_h
chebyshevAttenuation	dB	Tschebyscheff-Dämpfung bei f_h

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": "digital-filter-order",
    "inputs": {
      "passbandFreq": 1000,
      "stopbandFreq": 2000,
      "passbandRipple": 3,
      "stopbandAttenuation": 40,
      "toneFreq": 1000,
      "maxHarmonic": 5
    }
  }'

import rftools

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

result = client.calculate("digital-filter-order", {
    "passbandFreq": 1000,
    "stopbandFreq": 2000,
    "passbandRipple": 3,
    "stopbandAttenuation": 40,
    "toneFreq": 1000,
    "maxHarmonic": 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": "digital-filter-order",
    "inputs": {
      "passbandFreq": 1000,
      "stopbandFreq": 2000,
      "passbandRipple": 3,
      "stopbandAttenuation": 40,
      "toneFreq": 1000,
      "maxHarmonic": 5
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "digital-filter-order",
	  "inputs": {
	    "passbandFreq": 1000,
	    "stopbandFreq": 2000,
	    "passbandRipple": 3,
	    "stopbandAttenuation": 40,
	    "toneFreq": 1000,
	    "maxHarmonic": 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": "digital-filter-order",
  "values": {
    "butterworthOrder": 7,
    "chebyshevOrder": 5,
    "ellipticOrder": 3,
    "transitionRatio": 2,
    "harmonicsInPassband": 0,
    "harmonicsInTransition": 0,
    "nearestHarmonic": 2000,
    "butterworthAttenuation": 42.12384131963093,
    "chebyshevAttenuation": 51.1535803101314
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:digital-filter-order",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "passbandFreq": {
          "min": 1,
          "max": null,
          "unit": "Hz"
        },
        "stopbandFreq": {
          "min": 1,
          "max": null,
          "unit": "Hz"
        },
        "passbandRipple": {
          "min": 0.01,
          "max": null,
          "unit": "dB"
        },
        "stopbandAttenuation": {
          "min": 1,
          "max": null,
          "unit": "dB"
        },
        "toneFreq": {
          "min": 0.001,
          "max": null,
          "unit": "Hz"
        },
        "maxHarmonic": {
          "min": 1,
          "max": 50,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "passbandFreq": 1000,
      "stopbandFreq": 2000,
      "passbandRipple": 3,
      "stopbandAttenuation": 40,
      "toneFreq": 1000,
      "maxHarmonic": 5
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "passbandFreq"
      ],
      "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 RechnerseiteFilterordnungsrechner für digitale Filter, mit diesen Werten