PyOptik 3.1.0__tar.gz → 3.2.0__tar.gz

{pyoptik-3.1.0 → pyoptik-3.2.0}/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.2.0] - 2026-09-16
+
+### Added
+
+- Task-oriented getting-started and material-catalog guides.
+- Executable gallery examples for measured-material import and YAML round
+  trips, Fresnel polarization and Brewster angle, quarter-wave antireflection
+  coatings, dielectric Bragg mirrors, and catalog provenance workflows.
+- Direct README links to the principal guides, examples, and API reference.
+
+### Changed
+
+- Documentation navigation now groups content into Start here, User guide,
+  Learn by example, and Reference sections.
+- The documentation landing page, page titles, API hierarchy, and gallery
+  descriptions now use clearer task-oriented language.
+
 ## [3.1.0] - 2026-09-16
 
 ### Added
@@ -62,5 +79,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   plotting helpers.
 - Retired logo assets.
 
-[Unreleased]: https://github.com/MartinPdeS/PyOptik/compare/v3.1.0...HEAD
+[Unreleased]: https://github.com/MartinPdeS/PyOptik/compare/v3.2.0...HEAD
+[3.2.0]: https://github.com/MartinPdeS/PyOptik/compare/v3.1.0...v3.2.0
 [3.1.0]: https://github.com/MartinPdeS/PyOptik/compare/v3.0.5...v3.1.0

{pyoptik-3.1.0 → pyoptik-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyOptik
-Version: 3.1.0
+Version: 3.2.0
 Summary: A package for refractive index values.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License: MIT License
@@ -96,6 +96,24 @@ catalog interface for the hierarchical `RefractiveIndex.INFO
 The library is designed for optical design, photonics simulations,
 electromagnetic modeling, and experimental data analysis.
 
+Documentation
+-------------
+
+The full documentation is organized by task:
+
+* `Getting started <https://martinpdes.github.io/PyOptik/getting_started.html>`_
+  for installation and a first unit-aware calculation.
+* `Materials and catalog <https://martinpdes.github.io/PyOptik/materials_and_catalog.html>`_
+  for model selection, search, provenance, and cache integrity.
+* `Custom materials <https://martinpdes.github.io/PyOptik/custom_materials.html>`_
+  for arrays, CSV import, coefficients, validation, and YAML export.
+* `Interfaces and thin films <https://martinpdes.github.io/PyOptik/thin_films.html>`_
+  for Fresnel coefficients and coherent multilayer design.
+* `Example gallery <https://martinpdes.github.io/PyOptik/examples.html>`_
+  for complete, executable workflows.
+* `API reference <https://martinpdes.github.io/PyOptik/code.html>`_ for public
+  classes and functions.
+
 Features
 --------
 
@@ -343,6 +361,20 @@ Matplotlib backend before importing plotting code:
    import matplotlib
    matplotlib.use("Agg")
 
+Worked examples
+---------------
+
+The documentation gallery includes downloadable Python scripts and notebooks
+for:
+
+* Sellmeier and tabulated material dispersion;
+* group index and group velocity;
+* importing, interpolating, exporting, and reloading measured optical data;
+* s- and p-polarized Fresnel reflectance and Brewster angle;
+* quarter-wave antireflection coatings;
+* multilayer dielectric Bragg mirrors; and
+* catalog search, canonical source selection, and provenance capture.
+
 Hierarchical material catalog
 -----------------------------
 

{pyoptik-3.1.0 → pyoptik-3.2.0}/PyOptik/__init__.py

@@ -9,13 +9,15 @@ import logging
 logging.getLogger(__name__).addHandler(logging.NullHandler())
 
 
-from .material_type import MaterialType
-from .catalog import MaterialCatalog, MaterialId, MaterialPage, download_snapshot
+from .material_type import MaterialType  # noqa: E402
+from .catalog import MaterialCatalog, MaterialId, MaterialPage, download_snapshot  # noqa: E402
 
-from .material import TabulatedMaterial
-from .material import SellmeierMaterial
-from .material import FormulaDataset, MaterialDocument, MaterialMetadata, TabulatedDataset, parse_material
-from .thin_film import (
+from .material import TabulatedMaterial  # noqa: E402
+from .material import SellmeierMaterial  # noqa: E402
+from .material import (  # noqa: E402
+    FormulaDataset, MaterialDocument, MaterialMetadata, TabulatedDataset, parse_material,
+)
+from .thin_film import (  # noqa: E402
     FresnelResult,
     ThinFilmLayer,
     ThinFilmResult,
@@ -24,7 +26,7 @@ from .thin_film import (
     fresnel_coefficients,
     thin_film_stack,
 )
-from .material import base_class
+from .material import base_class  # noqa: E402
 
 
 TIMEOUT = 10  # Default timeout for requests in seconds

{pyoptik-3.1.0 → pyoptik-3.2.0}/PyOptik/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '3.1.0'
-__version_tuple__ = version_tuple = (3, 1, 0)
+__version__ = version = '3.2.0'
+__version_tuple__ = version_tuple = (3, 2, 0)
 
-__commit_id__ = commit_id = 'g705a5ec86'
+__commit_id__ = commit_id = 'g7c8410160'

{pyoptik-3.1.0 → pyoptik-3.2.0}/PyOptik/directories.py

@@ -54,6 +54,7 @@ user_data_path = _default_user_data_path()
 user_sellmeier_data_path = user_data_path / "sellmeier"
 user_tabulated_data_path = user_data_path / "tabulated"
 
+
 def material_paths(material_type):
     """Return the user data directory for a material type.
 

{pyoptik-3.1.0 → pyoptik-3.2.0}/PyOptik/material/base_class.py

@@ -10,6 +10,7 @@ from TypedUnit import Length, AnyUnit, Time, ureg, validate_units
 
 logger = logging.getLogger(__name__)
 
+
 class BaseMaterial(object):
     """Common interface for refractive-index material models.
 

{pyoptik-3.1.0 → pyoptik-3.2.0}/PyOptik/utils.py

@@ -103,6 +103,6 @@ def download_yml_file(
         except requests.exceptions.HTTPError as e:
             logger.error("HTTP error while downloading %s: %s", url, e)
             raise
-        except Exception as e:
+        except Exception:
             logger.exception("Unexpected error while saving %s to %s", url, file_path)
             raise

{pyoptik-3.1.0 → pyoptik-3.2.0}/PyOptik.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyOptik
-Version: 3.1.0
+Version: 3.2.0
 Summary: A package for refractive index values.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License: MIT License
@@ -96,6 +96,24 @@ catalog interface for the hierarchical `RefractiveIndex.INFO
 The library is designed for optical design, photonics simulations,
 electromagnetic modeling, and experimental data analysis.
 
+Documentation
+-------------
+
+The full documentation is organized by task:
+
+* `Getting started <https://martinpdes.github.io/PyOptik/getting_started.html>`_
+  for installation and a first unit-aware calculation.
+* `Materials and catalog <https://martinpdes.github.io/PyOptik/materials_and_catalog.html>`_
+  for model selection, search, provenance, and cache integrity.
+* `Custom materials <https://martinpdes.github.io/PyOptik/custom_materials.html>`_
+  for arrays, CSV import, coefficients, validation, and YAML export.
+* `Interfaces and thin films <https://martinpdes.github.io/PyOptik/thin_films.html>`_
+  for Fresnel coefficients and coherent multilayer design.
+* `Example gallery <https://martinpdes.github.io/PyOptik/examples.html>`_
+  for complete, executable workflows.
+* `API reference <https://martinpdes.github.io/PyOptik/code.html>`_ for public
+  classes and functions.
+
 Features
 --------
 
@@ -343,6 +361,20 @@ Matplotlib backend before importing plotting code:
    import matplotlib
    matplotlib.use("Agg")
 
+Worked examples
+---------------
+
+The documentation gallery includes downloadable Python scripts and notebooks
+for:
+
+* Sellmeier and tabulated material dispersion;
+* group index and group velocity;
+* importing, interpolating, exporting, and reloading measured optical data;
+* s- and p-polarized Fresnel reflectance and Brewster angle;
+* quarter-wave antireflection coatings;
+* multilayer dielectric Bragg mirrors; and
+* catalog search, canonical source selection, and provenance capture.
+
 Hierarchical material catalog
 -----------------------------
 

{pyoptik-3.1.0 → pyoptik-3.2.0}/PyOptik.egg-info/SOURCES.txt

@@ -42,8 +42,14 @@ conda.recipe/meta.yaml
 docs/Makefile
 docs/make.bat
 docs/examples/README.rst
+docs/examples/catalog/README.rst
+docs/examples/catalog/plot_catalog_search.py
+docs/examples/custom_materials/README.rst
+docs/examples/custom_materials/plot_measured_material.py
 docs/examples/group_properties/README.rst
 docs/examples/group_properties/plot_group_properties.py
+docs/examples/interfaces/README.rst
+docs/examples/interfaces/plot_fresnel_angles.py
 docs/examples/sellmeier/README.rst
 docs/examples/sellmeier/plot_bk7.py
 docs/examples/sellmeier/plot_compare_glasses.py
@@ -53,6 +59,9 @@ docs/examples/tabulated/README.rst
 docs/examples/tabulated/plot_polyethylene.py
 docs/examples/tabulated/plot_silicon_nk.py
 docs/examples/tabulated/plot_silver.py
+docs/examples/thin_films/README.rst
+docs/examples/thin_films/plot_antireflection_coating.py
+docs/examples/thin_films/plot_bragg_mirror.py
 docs/images/example_bk7.png
 docs/images/logo.svg
 docs/source/catalog_browser.rst
@@ -61,7 +70,9 @@ docs/source/conf.py
 docs/source/conventions.rst
 docs/source/custom_materials.rst
 docs/source/examples.rst
+docs/source/getting_started.rst
 docs/source/index.rst
+docs/source/materials_and_catalog.rst
 docs/source/references.rst
 docs/source/sg_execution_times.rst
 docs/source/thin_films.rst

{pyoptik-3.1.0 → pyoptik-3.2.0}/PyOptik.egg-info/scm_file_list.json

@@ -33,8 +33,14 @@
     "conda.recipe/meta.yaml",
     "docs/Makefile",
     "docs/examples/README.rst",
+    "docs/examples/catalog/README.rst",
+    "docs/examples/catalog/plot_catalog_search.py",
+    "docs/examples/custom_materials/README.rst",
+    "docs/examples/custom_materials/plot_measured_material.py",
     "docs/examples/group_properties/README.rst",
     "docs/examples/group_properties/plot_group_properties.py",
+    "docs/examples/interfaces/README.rst",
+    "docs/examples/interfaces/plot_fresnel_angles.py",
     "docs/examples/sellmeier/README.rst",
     "docs/examples/sellmeier/plot_bk7.py",
     "docs/examples/sellmeier/plot_compare_glasses.py",
@@ -44,6 +50,9 @@
     "docs/examples/tabulated/plot_polyethylene.py",
     "docs/examples/tabulated/plot_silicon_nk.py",
     "docs/examples/tabulated/plot_silver.py",
+    "docs/examples/thin_films/README.rst",
+    "docs/examples/thin_films/plot_antireflection_coating.py",
+    "docs/examples/thin_films/plot_bragg_mirror.py",
     "docs/images/example_bk7.png",
     "docs/images/logo.svg",
     "docs/make.bat",
@@ -57,7 +66,9 @@
     "docs/source/conventions.rst",
     "docs/source/custom_materials.rst",
     "docs/source/examples.rst",
+    "docs/source/getting_started.rst",
     "docs/source/index.rst",
+    "docs/source/materials_and_catalog.rst",
     "docs/source/references.rst",
     "docs/source/sg_execution_times.rst",
     "docs/source/thin_films.rst",

{pyoptik-3.1.0 → pyoptik-3.2.0}/PyOptik.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "3.1.0",
+  "tag": "3.2.0",
   "distance": 0,
-  "node": "g705a5ec861bd23f0f24cab4800260b0b528ac4cf",
+  "node": "g7c8410160ff259451a9478f2f563f8a1188e1ed7",
   "dirty": true,
   "branch": "HEAD",
   "node_date": "2026-09-16"

{pyoptik-3.1.0 → pyoptik-3.2.0}/README.rst

@@ -35,6 +35,24 @@ catalog interface for the hierarchical `RefractiveIndex.INFO
 The library is designed for optical design, photonics simulations,
 electromagnetic modeling, and experimental data analysis.
 
+Documentation
+-------------
+
+The full documentation is organized by task:
+
+* `Getting started <https://martinpdes.github.io/PyOptik/getting_started.html>`_
+  for installation and a first unit-aware calculation.
+* `Materials and catalog <https://martinpdes.github.io/PyOptik/materials_and_catalog.html>`_
+  for model selection, search, provenance, and cache integrity.
+* `Custom materials <https://martinpdes.github.io/PyOptik/custom_materials.html>`_
+  for arrays, CSV import, coefficients, validation, and YAML export.
+* `Interfaces and thin films <https://martinpdes.github.io/PyOptik/thin_films.html>`_
+  for Fresnel coefficients and coherent multilayer design.
+* `Example gallery <https://martinpdes.github.io/PyOptik/examples.html>`_
+  for complete, executable workflows.
+* `API reference <https://martinpdes.github.io/PyOptik/code.html>`_ for public
+  classes and functions.
+
 Features
 --------
 
@@ -282,6 +300,20 @@ Matplotlib backend before importing plotting code:
    import matplotlib
    matplotlib.use("Agg")
 
+Worked examples
+---------------
+
+The documentation gallery includes downloadable Python scripts and notebooks
+for:
+
+* Sellmeier and tabulated material dispersion;
+* group index and group velocity;
+* importing, interpolating, exporting, and reloading measured optical data;
+* s- and p-polarized Fresnel reflectance and Brewster angle;
+* quarter-wave antireflection coatings;
+* multilayer dielectric Bragg mirrors; and
+* catalog search, canonical source selection, and provenance capture.
+
 Hierarchical material catalog
 -----------------------------
 

pyoptik-3.2.0/docs/examples/catalog/README.rst

@@ -0,0 +1,6 @@
+Catalog discovery
+=================
+
+Search the local RefractiveIndex.INFO snapshot, filter candidates, and retain
+source provenance alongside calculated results.
+

pyoptik-3.2.0/docs/examples/catalog/plot_catalog_search.py

@@ -0,0 +1,48 @@
+"""
+Search materials and inspect provenance
+=======================================
+
+Find locally available BK7 datasets, inspect their canonical identities, and
+compare representative glass pages at a standard wavelength.
+"""
+
+# %%
+import matplotlib.pyplot as plt
+from TypedUnit import ureg
+
+from PyOptik import MaterialCatalog
+
+
+catalog = MaterialCatalog.from_snapshot()
+matches = catalog.search("BK7", shelf="specs", available=True)
+
+print(f"Found {len(matches)} cached BK7 pages")
+for page in matches[:5]:
+    print(page.id.key, "—", page.description)
+
+# %%
+# Canonical IDs make source selection explicit and reproducible.
+identifiers = [
+    "specs/SCHOTT-optical/N-BK7",
+    "specs/OHARA-optical/S-BSL7",
+]
+wavelength = 587.6 * ureg.nanometer
+labels, indices = [], []
+
+for identifier in identifiers:
+    page = catalog.get(identifier)
+    material = page.load()
+    labels.append(page.id.page)
+    indices.append(float(material.n(wavelength, out_of_range="raise")))
+    print(material.provenance)
+
+# %%
+figure, axis = plt.subplots(figsize=(6, 3.5), layout="constrained")
+axis.bar(labels, indices, color=["tab:blue", "tab:orange"])
+axis.set(
+    ylabel="Refractive index at 587.6 nm",
+    title="Catalog-backed glass comparison",
+    ylim=(1.50, 1.54),
+)
+axis.grid(axis="y", alpha=0.25)
+plt.show()

pyoptik-3.2.0/docs/examples/custom_materials/README.rst

@@ -0,0 +1,6 @@
+Custom materials
+================
+
+Build optical materials from measured arrays, validate their interpolation,
+and round-trip them through PyOptik's YAML representation.
+

pyoptik-3.2.0/docs/examples/custom_materials/plot_measured_material.py

@@ -0,0 +1,54 @@
+"""
+Create and export a measured material
+=====================================
+
+This example builds a complex refractive-index model from measured arrays,
+evaluates the interpolation, and verifies a YAML export/reload round trip.
+"""
+
+# %%
+from tempfile import TemporaryDirectory
+
+import matplotlib.pyplot as plt
+import numpy
+from TypedUnit import ureg
+
+from PyOptik import TabulatedMaterial
+
+
+wavelength_samples = numpy.array([400, 475, 550, 625, 700]) * ureg.nanometer
+measured_n = [1.58, 1.56, 1.545, 1.535, 1.528]
+measured_k = [0.030, 0.018, 0.010, 0.006, 0.004]
+
+material = TabulatedMaterial.from_arrays(
+    "measured-film",
+    wavelength_samples,
+    n=measured_n,
+    k=measured_k,
+    interpolation="pchip",
+    reference="Illustrative ellipsometry dataset",
+    conditions={"temperature": "293 K"},
+)
+
+# %%
+# Exported files use the same validated schema as catalog materials.
+with TemporaryDirectory() as directory:
+    path = material.to_yaml(f"{directory}/measured-film.yml")
+    restored = TabulatedMaterial("measured-film", file_path=path, interpolation="pchip")
+    assert restored.reference == material.reference
+
+# %%
+wavelengths = numpy.linspace(400, 700, 301) * ureg.nanometer
+index = material.compute_refractive_index(wavelengths, out_of_range="raise")
+
+figure, (axis_n, axis_k) = plt.subplots(2, 1, sharex=True, layout="constrained")
+axis_n.plot(wavelengths.magnitude, index.real, label="PCHIP interpolation")
+axis_n.scatter(wavelength_samples.magnitude, measured_n, label="Measurements")
+axis_n.set(ylabel="Refractive index n", title="User-defined optical constants")
+axis_n.legend()
+
+axis_k.plot(wavelengths.magnitude, index.imag, color="tab:red")
+axis_k.scatter(wavelength_samples.magnitude, measured_k, color="tab:red")
+axis_k.set(xlabel="Wavelength [nm]", ylabel="Extinction coefficient k")
+
+plt.show()

pyoptik-3.2.0/docs/examples/interfaces/README.rst

@@ -0,0 +1,6 @@
+Fresnel interfaces
+==================
+
+Explore polarization, characteristic angles, and total internal reflection at
+a single planar interface.
+

pyoptik-3.2.0/docs/examples/interfaces/plot_fresnel_angles.py

@@ -0,0 +1,42 @@
+"""
+Fresnel reflectance versus incidence angle
+==========================================
+
+Compare s and p polarization at an air-to-glass interface and identify the
+Brewster angle where p-polarized reflection vanishes.
+"""
+
+# %%
+import matplotlib.pyplot as plt
+import numpy
+from TypedUnit import ureg
+
+from PyOptik import brewster_angle, fresnel_coefficients
+
+
+angles = numpy.linspace(0, 89, 500) * ureg.degree
+reflectance_s = numpy.array([
+    fresnel_coefficients(1.0, 1.5, angle, polarization="s").reflectance
+    for angle in angles
+])
+reflectance_p = numpy.array([
+    fresnel_coefficients(1.0, 1.5, angle, polarization="p").reflectance
+    for angle in angles
+])
+brewster = brewster_angle(1.0, 1.5).to(ureg.degree).magnitude
+
+# %%
+figure, axis = plt.subplots(layout="constrained")
+axis.plot(angles.magnitude, reflectance_s, label="s polarization")
+axis.plot(angles.magnitude, reflectance_p, label="p polarization")
+axis.axvline(brewster, color="black", linestyle="--", label=f"Brewster: {brewster:.1f}°")
+axis.set(
+    xlabel="Incidence angle [degree]",
+    ylabel="Reflectance",
+    title="Air–glass Fresnel reflectance",
+    xlim=(0, 90),
+    ylim=(0, 1),
+)
+axis.grid(alpha=0.25)
+axis.legend()
+plt.show()

{pyoptik-3.1.0 → pyoptik-3.2.0}/docs/examples/sellmeier/plot_water.py

@@ -7,7 +7,6 @@ This module demonstrates the usage of the PyOptik library to calculate and plot
 """
 
 # %%
-import numpy
 from TypedUnit import ureg
 
 from PyOptik import MaterialCatalog

{pyoptik-3.1.0 → pyoptik-3.2.0}/docs/examples/tabulated/plot_silver.py

@@ -7,7 +7,6 @@ This module demonstrates the usage of the PyOptik library to calculate and plot
 """
 
 # %%
-import numpy
 from TypedUnit import ureg
 
 from PyOptik import MaterialCatalog

pyoptik-3.2.0/docs/examples/thin_films/README.rst

@@ -0,0 +1,6 @@
+Thin-film coatings
+==================
+
+Design coherent antireflection and dielectric-mirror stacks and inspect their
+spectral power response.
+

pyoptik-3.2.0/docs/examples/thin_films/plot_antireflection_coating.py

@@ -0,0 +1,46 @@
+"""
+Quarter-wave antireflection coating
+===================================
+
+Design the ideal single-layer coating for an air-to-glass interface and compare
+its spectrum with the uncoated substrate.
+"""
+
+# %%
+import matplotlib.pyplot as plt
+import numpy
+from TypedUnit import ureg
+
+from PyOptik import ThinFilmLayer, thin_film_stack
+
+
+design_wavelength = 550 * ureg.nanometer
+substrate_index = 1.52
+coating_index = numpy.sqrt(substrate_index)
+coating_thickness = design_wavelength / (4 * coating_index)
+wavelengths = numpy.linspace(350, 900, 600) * ureg.nanometer
+
+uncoated = thin_film_stack(
+    wavelengths,
+    [],
+    substrate_index=substrate_index,
+)
+coated = thin_film_stack(
+    wavelengths,
+    [ThinFilmLayer(coating_index, coating_thickness)],
+    substrate_index=substrate_index,
+)
+
+# %%
+figure, axis = plt.subplots(layout="constrained")
+axis.plot(wavelengths.magnitude, 100 * uncoated.reflectance, label="Uncoated glass")
+axis.plot(wavelengths.magnitude, 100 * coated.reflectance, label="Quarter-wave coating")
+axis.axvline(design_wavelength.magnitude, color="black", linestyle="--", alpha=0.6)
+axis.set(
+    xlabel="Wavelength [nm]",
+    ylabel="Reflectance [%]",
+    title="Single-layer antireflection coating",
+)
+axis.grid(alpha=0.25)
+axis.legend()
+plt.show()

pyoptik-3.2.0/docs/examples/thin_films/plot_bragg_mirror.py

@@ -0,0 +1,50 @@
+"""
+Dielectric Bragg mirror
+=======================
+
+Build an alternating high/low-index quarter-wave stack and observe how adding
+layer pairs increases reflectance around the design wavelength.
+"""
+
+# %%
+import matplotlib.pyplot as plt
+import numpy
+from TypedUnit import ureg
+
+from PyOptik import ThinFilmLayer, thin_film_stack
+
+
+design_wavelength = 800 * ureg.nanometer
+high_index, low_index = 2.25, 1.45
+wavelengths = numpy.linspace(500, 1100, 700) * ureg.nanometer
+
+
+def mirror_layers(pair_count):
+    """Return ``pair_count`` high/low quarter-wave layer pairs."""
+    pair = [
+        ThinFilmLayer(high_index, design_wavelength / (4 * high_index)),
+        ThinFilmLayer(low_index, design_wavelength / (4 * low_index)),
+    ]
+    return pair * pair_count
+
+
+# %%
+figure, axis = plt.subplots(layout="constrained")
+for pair_count in (2, 4, 8):
+    result = thin_film_stack(
+        wavelengths,
+        mirror_layers(pair_count),
+        substrate_index=1.52,
+    )
+    axis.plot(wavelengths.magnitude, 100 * result.reflectance, label=f"{pair_count} pairs")
+
+axis.axvline(design_wavelength.magnitude, color="black", linestyle="--", alpha=0.6)
+axis.set(
+    xlabel="Wavelength [nm]",
+    ylabel="Reflectance [%]",
+    title="Quarter-wave dielectric mirror",
+    ylim=(0, 101),
+)
+axis.grid(alpha=0.25)
+axis.legend()
+plt.show()

{pyoptik-3.1.0 → pyoptik-3.2.0}/docs/source/catalog_browser.rst

@@ -1,5 +1,5 @@
-Terminal catalog browser
-========================
+Catalog browser
+===============
 
 PyOptik includes an optional full-screen terminal interface for exploring a
 downloaded RefractiveIndex.INFO snapshot. It uses Textual and is installed
@@ -39,4 +39,3 @@ field and ``q`` to quit.
 If no snapshot exists, the command reports its expected location and asks you
 to run ``pyoptik setup``. The browser never silently downloads or modifies
 catalog data.
-