Sections de la documentation

Concepteur de filtres RC/LC passifs

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

Slug filter-designer. Concevez des filtres à échelle passifs Butterworth et Chebyshev LC jusqu'à 10. Calculez les valeurs des composants pour les topologies passe-bas, passe-haut et passe-bande. Résultats instantanés et gratuits.

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 filter-designer
Nom	Unité	Plage	Valeur par défaut	Description
responseTypenombre	aucune	0 … 1	0	Butterworth est à platitude maximale ; Chebyshev de type I accepte 0,5 dB d'ondulation dans la bande passante en échange d'une pente de coupure plus raideL'une de : 0 Butterworth · 1 Chebyshev (ondulation de 0,5 dB)
filterTypenombre	aucune	0 … 2	0	Type de filtreL'une de : 0 Passe-bas · 1 Passe-haut · 2 Passe-bande
fcnombre	Hz	1 … 1000000000	1000	La fréquence de conception : le point à −3 dB d'un Butterworth, le bord de la bande d'ondulation de 0,5 dB d'un Chebyshev, le centre d'un passe-bande
ordernombre	aucune	1 … 10	2	Ordre du filtre (1 à 10). Les ordres plus élevés donnent une atténuation plus prononcée : n × 20 dB/décade.
impedancenombre	Ω	1 … 10000	50	Impédance source/charge. 50 Ω est la norme pour les systèmes RF ; 600 Ω pour l'audio.
qFactornombre	aucune	0.1 … 100	1	Q élevé = bande passante plus étroite. Utilisé uniquement par le type de filtre passe-bande.
eSeriesnombre	aucune	0 … 96	0	Arrondit chaque composant à la valeur la plus proche de la série ; la réponse et l'export sont ceux du circuit arrondi.L'une de : 0 Valeurs idéales · 12 E12 (10 %) · 24 E24 (5 %) · 48 E48 (2 %) · 96 E96 (1 %)

Sorties

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

Sorties de filter-designer
Champ	Unité	Description
C1_nFprincipale	nF	Élément 1 (C₁)
L1_uH	μH	Élément 2 (L₂)
C3_nF	nF	Élément 3 (C₃)
L4_uH	μH	Élément 4 (L₄)
C5_nF	nF	Élément 5 (C₅)
L6_uH	μH	Élément 6 (L₆)
C7_nF	nF	Élément 7 (C₇)
L8_uH	μH	Élément 8 (L₈)
C9_nF	nF	Élément 9 (C₉)
L10_uH	μH	Élément 10 (L₁₀)
bpL1_uH	μH	Élément 1 (L₁, passe-bande)
bpC2_nF	nF	Élément 2 (C₂, passe-bande)
bpL3_uH	μH	Élément 3 (L₃, passe-bande)
bpC4_nF	nF	Élément 4 (C₄, passe-bande)
bpL5_uH	μH	Élément 5 (L₅, passe-bande)
bpC6_nF	nF	Élément 6 (C₆, passe-bande)
bpL7_uH	μH	Élément 7 (L₇, passe-bande)
bpC8_nF	nF	Élément 8 (C₈, passe-bande)
bpL9_uH	μH	Élément 9 (L₉, passe-bande)
bpC10_nF	nF	Élément 10 (C₁₀, passe-bande)
tau_ns	ns	Constante de temps τ
attenuation_at_2fc	dB	Atténuation à 2 × fc
bandwidth_Hz	Hz	Bande passante
fLow_Hz	Hz	Fréquence basse à −3 dB
fHigh_Hz	Hz	Fréquence haute à −3 dB
maxComponentError	%	Erreur maximale du composant
fcShiftPercent	%	Décalage de la coupure
loadImpedance	Ω	Impédance de charge
cutoffBuilt_Hz	Hz	Coupure réalisée (−3 dB)
fLowBuilt_Hz	Hz	Fréquence basse à −3 dB réalisée
fHighBuilt_Hz	Hz	Fréquence haute à −3 dB réalisée
passbandLoss_dB	dB	Perte maximale en bande passante
stopbandBuilt_dB	dB	Atténuation réalisée en bande d'arrêt

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": "filter-designer",
    "inputs": {
      "responseType": 0,
      "filterType": 0,
      "fc": 1000,
      "order": 2,
      "impedance": 50,
      "qFactor": 1,
      "eSeries": 0
    }
  }'

import rftools

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

result = client.calculate("filter-designer", {
    "responseType": 0,
    "filterType": 0,
    "fc": 1000,
    "order": 2,
    "impedance": 50,
    "qFactor": 1,
    "eSeries": 0,
})
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": "filter-designer",
    "inputs": {
      "responseType": 0,
      "filterType": 0,
      "fc": 1000,
      "order": 2,
      "impedance": 50,
      "qFactor": 1,
      "eSeries": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "filter-designer",
	  "inputs": {
	    "responseType": 0,
	    "filterType": 0,
	    "fc": 1000,
	    "order": 2,
	    "impedance": 50,
	    "qFactor": 1,
	    "eSeries": 0
	  }
	}`)
	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": "filter-designer",
  "values": {
    "C1_nF": 4501.581580785531,
    "L1_uH": 11253.953951963827,
    "C3_nF": 0,
    "L4_uH": 0,
    "C5_nF": 0,
    "L6_uH": 0,
    "C7_nF": 0,
    "L8_uH": 0,
    "C9_nF": 0,
    "L10_uH": 0,
    "bpL1_uH": 0,
    "bpC2_nF": 0,
    "bpL3_uH": 0,
    "bpC4_nF": 0,
    "bpL5_uH": 0,
    "bpC6_nF": 0,
    "bpL7_uH": 0,
    "bpC8_nF": 0,
    "bpL9_uH": 0,
    "bpC10_nF": 0,
    "tau_ns": 0,
    "attenuation_at_2fc": 12.30448921378274,
    "bandwidth_Hz": 0,
    "fLow_Hz": 0,
    "fHigh_Hz": 0,
    "maxComponentError": 0,
    "fcShiftPercent": 0,
    "loadImpedance": 50,
    "cutoffBuilt_Hz": 1000.0000000000002,
    "fLowBuilt_Hz": 0,
    "fHighBuilt_Hz": 0,
    "passbandLoss_dB": 1.4909589106797274,
    "stopbandBuilt_dB": 12.30448921378274
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:filter-designer",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Williams & Taylor, Electronic Filter Design Handbook 4th ed.; Zverev, Handbook of Filter Synthesis",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "responseType": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "filterType": {
          "min": 0,
          "max": 2,
          "unit": ""
        },
        "fc": {
          "min": 1,
          "max": 1000000000,
          "unit": "Hz"
        },
        "order": {
          "min": 1,
          "max": 10,
          "unit": ""
        },
        "impedance": {
          "min": 1,
          "max": 10000,
          "unit": "Ω"
        },
        "qFactor": {
          "min": 0.1,
          "max": 100,
          "unit": ""
        },
        "eSeries": {
          "min": 0,
          "max": 96,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "responseType": 0,
      "filterType": 0,
      "fc": 1000,
      "order": 2,
      "impedance": 50,
      "qFactor": 1,
      "eSeries": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "responseType"
      ],
      "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 calculateurConcepteur de filtres RC/LC passifs, avec ces valeurs