[jtravs]

Problem

prop_2d, spec_1d and spectrogram accept axis={'wavelength','f','omega'} but took
their spectral window only as wavelength_range. A frequency map could not be given a
range in hertz, nor one starting at 0 Hz, which is an infinite wavelength. Every
bandpass= keyword (the accessors, the compressors, time_1d, prop_2d, energy) was
likewise a wavelength range or a ready-made array.

Changes

Plot ranges in the units of the axis.

• prop_2d, spec_1d and spectrogram take spec_range, in m, Hz or rad/s as axis
  says. This is the same name and meaning as get_spectral_density(spec_range=...).
• Without spec_range they show their previous default wavelength range, converted to
  the axis. spec_1d's default is now the named constant
  DEFAULT_SLICE_WAVELENGTH_RANGE.
• style.spectral_limits is replaced by wavelength_to_axis(axis, wavelength_range),
  which returns SI limits on any axis.

prop_2d(run, "f", spec_range=(0.0, 2e15))
prop_2d(run, "omega", spec_range=wavelength_to_axis("omega", (600e-9, 1100e-9)))

Bandpass windows on any axis.

• solprop.processing.Passband(limits, axis="wavelength", width=None) carries its own
  axis and edge width. Every bandpass= keyword accepts it through
  spectra._as_window, so no function gains a keyword.
• bandpass(grid, limits, *, axis=..., width=...) builds the same window; its first
  argument is renamed from wavelength_limits to limits.
• A frequency band may start at zero (a low-pass band). Wavelength limits must be
  positive and frequency limits must not be negative.
• The edge width is in rad/s on every axis, because the taper is drawn on the ω grid.
  Luna's 3-tuple does the same.
• A bare pair is still a wavelength range everywhere. A band's units never follow the
  axis a plot is drawn on, so the same call selects the same light however the result
  is displayed.

energy(run, bandpass=Passband((0.0, 375e12), "f"))
time_1d(run, bandpass=Passband((0.3e15, 0.45e15), "f"))

The design follows Luna.jl's Processing.window_maybe, which accepts a wavelength
2-tuple, a 3-tuple adding an ω edge width, a 4-tuple of taper points, a window vector or
a function. Here the wavelength pair and the array forms carry over unchanged, and the
explicit Passband type replaces meaning-by-tuple-length.

Breaking, with no aliases (nothing is public yet): wavelength_range= on the three plot
functions, style.spectral_limits, and bandpass(..., wavelength_limits=...) as a
keyword. Positional calls to bandpass are unaffected.

Docs

• The user guide (plotting and processing pages) explains both, and their snippets run.
• The changelog has two entries.
• The tutorials and worked examples use the renamed keyword.
• The ten worked examples that call the plots were re-run with poe docs-examples on an
  Apple M5 Max (23.5 min in all), and their output is committed.

Tests

• New tests cover a hertz range on prop_2d and on spectrogram, an angular-frequency
  range on spec_1d, and the default range on a frequency axis.
• wavelength_to_axis: c/λ and 2πc/λ.
• Passband and bandpass(axis=...): f and ω windows equal the wavelength window, a
  zero lower edge, refusals, and an accessor taking a Passband.
• Ran locally: tests/processing, tests/plotting, tests/test_sol.py, the guide
  snippets, and the doctests of the changed modules (756 passed); basedpyright and ruff
  are clean on the changed files. CI runs the full gate.

🤖 Generated with Claude Code

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

[read-the-docs-community]

Documentation build overview

📚 solprop | 🛠️ Build #35425404 | 📁 Comparing 1d4f099 against latest (e1b98e6)

  🔍 Preview build  

73 files changed · ± 73 modified

± Modified

• changelog.html
• genindex.html
• sg_execution_times.html
• _modules/solprop/sol.html
• api/generated/solprop.backends.numba_cpu.pass_timers.html
• api/generated/solprop.plotting.propagation.html
• api/generated/solprop.plotting.spectrograms.html
• api/generated/solprop.plotting.style.html
• api/generated/solprop.processing.compression.html
• api/generated/solprop.processing.fields.html
• and 63 more...

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!