pyFDN.plot_fdn_parameter#

pyFDN.plot_fdn_parameter(delays, A, b, c, d, *, post_delay_sos=None, post_matrix_sos=None, post_output_sos=None, fs=None, nfft=512, zmin=None, zmax=None, title=None)[source]#

Plot all FDN parameters in one figure.

Extends plot_system_matrix() with the delay lengths and, optionally, any of the three filter hooks, named as pyFDN.process_fdn() and pyFDN.FDNBuild name them:

  • the system matrix blocks A, b, c, d as heatmaps with a shared RdBu color scale;

  • the delays as a bar plot whose bars are aligned with the columns of the feedback matrix A (one bar per delay line);

  • post_delay and post_matrix, the two in-loop hooks, as gain-per-sample curves, as in plot_db_per_sample() – both are per delay line and both act once per round trip, so the two rows are directly comparable;

  • post_output as plain magnitude response in dB.

Bar and curve colors are matched per delay line and encode the delay length (Viridis, short = dark, long = bright).

Parameters:

  • delays (ArrayLike) – Delay lengths in samples, shape (N,).

  • A (ArrayLike) – Feedback matrix, input gains, output gains, direct gains.

  • b (ArrayLike) – Feedback matrix, input gains, output gains, direct gains.

  • c (ArrayLike) – Feedback matrix, input gains, output gains, direct gains.

  • d (ArrayLike) – Feedback matrix, input gains, output gains, direct gains.

  • post_delay_sos (ArrayLike | None) – Per-delay-line SOS banks for the two in-loop hooks, same layout as pyFDN.td.SOSBank: (n_sections, 6, N).

  • post_matrix_sos (ArrayLike | None) – Per-delay-line SOS banks for the two in-loop hooks, same layout as pyFDN.td.SOSBank: (n_sections, 6, N).

  • post_output_sos (ArrayLike | None) – Output EQ as an SOS cascade in scipy format, shape (n_sections, 6) (or (6,) for one section) for a single output, or (n_sections, 6, K) to draw one magnitude curve per output channel.

  • fs (float | None) – Sample rate in Hz. If given, the filter responses are plotted over a logarithmic frequency axis in Hz; otherwise over rad/sample.

  • nfft (int) – Number of frequency points for the filter responses. Default 512.

  • zmin (float | None) – Shared color limits for the heatmaps. If both None, uses (-1, 1).

  • zmax (float | None) – Shared color limits for the heatmaps. If both None, uses (-1, 1).

  • title (str | None) – Figure title.

Returns:

Call .show() to display.

Return type:

Any

On this page