Secciones de la documentación

Calculadora de Orden de Filtro Digital

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

Slug digital-filter-order. Calcula el orden mínimo necesario de filtros digitales FIR e IIR para cumplir especificaciones de atenuación.

Entradas

Envíe cada una de estas en inputs, en las unidades indicadas. La mayoría son obligatorias: una llamada a la que le falte una se rechaza (400) y no cuesta nada; una de la que la calculadora puede prescindir toma el valor predeterminado indicado. Una entrada fuera de su rango se calcula igualmente y se marca en la procedencia.

Entradas de digital-filter-order
Nombre	Unidad	Rango	Valor predeterminado	Descripción
passbandFreqnúmero	Hz	al menos 1	1000	Frecuencia a la que se cumple la especificación de rizado en la banda de paso
stopbandFreqnúmero	Hz	al menos 1	2000	Frecuencia a la que debe alcanzarse la atenuación en la banda de rechazo
passbandRipplenúmero	dB	al menos 0.01	3	Rizado máximo admisible en la banda de paso (normalmente de 0,1 a 3 dB)
stopbandAttenuationnúmero	dB	al menos 1	40	Atenuación mínima requerida en la banda de rechazo
toneFreqnúmero	Hz	al menos 0.001	1000	Un tono que el filtro debe dejar pasar mientras rechaza sus armónicos: la portadora de un transmisor, la fundamental de la red, un tono de prueba
maxHarmonicnúmero	ninguna	1 … 50	5	El armónico más alto del tono que sigue el plan de frecuencias

Salidas

Se devuelven en values, por nombre. Un valor ilimitado o no definido es null.

Salidas de digital-filter-order
Campo	Unidad	Descripción
butterworthOrderprincipal	ninguna	Orden de Butterworth
chebyshevOrder	ninguna	Orden de Chebyshev
ellipticOrder	ninguna	Orden elíptico
transitionRatio	ninguna	Relación de transición
harmonicsInPassband	ninguna	Armónicos en la banda de paso
harmonicsInTransition	ninguna	Armónicos en la banda de transición
nearestHarmonic	Hz	Armónico más bajo por encima de la banda de paso
butterworthAttenuation	dB	Atenuación de Butterworth en f_h
chebyshevAttenuation	dB	Atenuación de Chebyshev en f_h

Cómo llamarla

Calcular: una llamada, la solicitud y la respuesta completas, y sus errores.
Cálculo por lotes: esta calculadora con otras, o un barrido, en una sola solicitud.
Resolver para un valor objetivo: el valor de una entrada que lleva una salida a un objetivo.

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

Una entrada enviada como texto. No se contó nada.

{
  "detail": "More than 120 requests in 60 seconds from this address.",
  "errorKind": "rate_limited",
  "limit": 120,
  "windowSeconds": 60,
  "upgradeUrl": "https://rftools.io/pricing/"
}

Demasiadas solicitudes en un minuto, con Retry-After.

Las mismas entradas en la página de la calculadoraCalculadora de Orden de Filtro Digital, con estos valores