This is a pre-release version (2.0.0.dev0+git20260907.41eeb59).Go to latest (1.18.0)
{ } Raw JSON

bundles / scipy 2.0.0.dev0+git20260907.41eeb59 / scipy / signal / _filter_design / ellipord

function

scipy.signal._filter_design:ellipord

source: build-install/usr/lib/python3.14/site-packages/scipy/signal/_filter_design.py:4614

Signature

def ellipord(wp, ws, gpass, gstop, analog = False, fs = None)

Summary

Elliptic (Cauer) filter order selection.

Extended Summary

Return the order of the lowest order digital or analog elliptic filter that loses no more than gpass dB in the passband and has at least gstop dB attenuation in the stopband.

Parameters

wp, ws : float

Passband and stopband edge frequencies.

For digital filters, these are in the same units as fs. By default, fs is 2 half-cycles/sample, so these are normalized from 0 to 1, where 1 is the Nyquist frequency. (wp and ws are thus in half-cycles / sample.) For example:

  • Lowpass: wp = 0.2, ws = 0.3

  • Highpass: wp = 0.3, ws = 0.2

  • Bandpass: wp = [0.2, 0.5], ws = [0.1, 0.6]

  • Bandstop: wp = [0.1, 0.6], ws = [0.2, 0.5]

For analog filters, wp and ws are angular frequencies (e.g., rad/s).

gpass : float

The maximum loss in the passband (dB).

gstop : float

The minimum attenuation in the stopband (dB).

analog : bool, optional

When True, return an analog filter, otherwise a digital filter is returned.

fs : float, optional

The sampling frequency of the digital system.

Returns

ord : int

The lowest order for an Elliptic (Cauer) filter that meets specs.

wn : ndarray or float

The Chebyshev natural frequency (the "3dB frequency") for use with ellip to give filter results. If fs is specified, this is in the same units, and fs must also be passed to ellip.

Examples

Design an analog highpass filter such that the passband is within 3 dB above 30 rad/s, while rejecting -60 dB at 10 rad/s. Plot its frequency response, showing the passband and stopband constraints in gray.
from scipy import signal
import matplotlib.pyplot as plt
import numpy as np
✓
N, Wn = signal.ellipord(30, 10, 3, 60, True)
b, a = signal.ellip(N, 3, 60, Wn, 'high', True)
w, h = signal.freqs(b, a, np.logspace(0, 3, 500))
✓
plt.semilogx(w, 20 * np.log10(abs(h)))
plt.title('Elliptical highpass filter fit to constraints')
plt.xlabel('Frequency [rad/s]')
plt.ylabel('Amplitude [dB]')
✗
Text(0, 0.5, 'Amplitude [dB]')
plt.grid(which='both', axis='both')
✓
plt.fill([.1, 10,  10,  .1], [1e4, 1e4, -60, -60], '0.9', lw=0) # stop
plt.fill([30, 30, 1e9, 1e9], [-99,  -3,  -3, -99], '0.9', lw=0) # pass
plt.axis([1, 300, -80, 3])
✗
(np.float64(1.0), np.float64(300.0), np.float64(-80.0), np.float64(3.0))
plt.show()
✓
fig-6cdd2a80f5ab07a4.png

See also

buttord

Find order and critical points from passband and stopband spec

cheb1ord
cheb2ord
ellip

Filter design using order and critical points

iirdesign

General filter design using passband and stopband spec

iirfilter

General filter design using order and critical frequencies

Aliases

  • scipy.signal.ellipord

Referenced by