PyOptik 3.1.0__tar.gz → 3.2.1__tar.gz

pyoptik-3.2.1/.github/workflows/deploy_documentation.yml

@@ -0,0 +1,56 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: Documentation
+
+on:
+  push:
+    branches: [ "master" ]
+    tags: [ "v*" ]
+  pull_request:
+    branches: [ "master" ]
+
+concurrency:
+  group: documentation-build-${{ github.repository }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+jobs:
+  ManyLinux_x86_64:
+    uses: MartinPdeS/MPSActions/.github/workflows/publish_documentation.yml@v5
+    with:
+      python-version: "3.11"
+      package-name: "PyOptik"
+      apt-package: xvfb jq
+      deploy-pages: ${{ github.event_name == 'push' && (github.ref == 'refs/heads/master' || startsWith(github.ref, 'refs/tags/v')) }}
+
+  deploy_pages:
+    needs: ManyLinux_x86_64
+    if: ${{ github.event_name == 'push' && (github.ref == 'refs/heads/master' || startsWith(github.ref, 'refs/tags/v')) }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Checkout generated documentation
+        uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09
+        with:
+          ref: documentation_page
+
+      - name: Configure GitHub Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload GitHub Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: .
+
+      - name: Deploy GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

{pyoptik-3.1.0 → pyoptik-3.2.1}/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.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyOptik
-Version: 3.1.0
+Version: 3.2.1
 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.1}/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.1}/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.1'
+__version_tuple__ = version_tuple = (3, 2, 1)
 
-__commit_id__ = commit_id = 'g705a5ec86'
+__commit_id__ = commit_id = 'g6f0650682'

{pyoptik-3.1.0 → pyoptik-3.2.1}/PyOptik/catalog.py

@@ -1,6 +1,5 @@
 """Catalog and upstream-identity support for optical material data."""
 
-from __future__ import annotations
 
 from dataclasses import dataclass
 from pathlib import Path
@@ -78,7 +77,7 @@ class MaterialPage:
         if not self.available:
             return None
         try:
-            with self.local_path.open("r") as stream:
+            with self.local_path.open("r", encoding="utf-8") as stream:
                 reference = (yaml.safe_load(stream) or {}).get("REFERENCES")
                 return str(reference) if reference is not None else None
         except (OSError, yaml.YAMLError):
@@ -286,7 +285,7 @@ class MaterialCatalog:
         existing_manifest = None
         if catalog_file.exists() and not force:
             try:
-                with (root / "manifest.json").open("r") as stream:
+                with (root / "manifest.json").open("r", encoding="utf-8") as stream:
                     existing_manifest = json.load(stream)
             except (FileNotFoundError, json.JSONDecodeError):
                 existing_manifest = None
@@ -381,7 +380,7 @@ class MaterialCatalog:
     def load_catalog(self, catalog_file: Path | str) -> None:
         """Load an upstream ``catalog-nk.yml`` file."""
         catalog_file = Path(catalog_file)
-        with catalog_file.open("r") as stream:
+        with catalog_file.open("r", encoding="utf-8") as stream:
             document = yaml.safe_load(stream) or []
         self._pages.clear()
 
@@ -529,7 +528,7 @@ class MaterialCatalog:
         if not self.manifest_path.exists():
             return {"catalog": {}, "pages": {}}
         try:
-            with self.manifest_path.open("r") as stream:
+            with self.manifest_path.open("r", encoding="utf-8") as stream:
                 manifest = json.load(stream)
             manifest.setdefault("catalog", {})
             manifest.setdefault("pages", {})
@@ -542,7 +541,7 @@ class MaterialCatalog:
         """Atomically write the download manifest after a page completes."""
         self.data_root.mkdir(parents=True, exist_ok=True)
         temporary = self.manifest_path.with_suffix(".json.tmp")
-        with temporary.open("w") as stream:
+        with temporary.open("w", encoding="utf-8") as stream:
             json.dump(manifest, stream, indent=2, sort_keys=True)
             stream.write("\n")
         temporary.replace(self.manifest_path)

{pyoptik-3.1.0 → pyoptik-3.2.1}/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.1}/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.1}/PyOptik/material/dataset.py

@@ -1,6 +1,5 @@
 """Typed, validated representations of PyOptik material datasets."""
 
-from __future__ import annotations
 
 from dataclasses import dataclass, field
 from pathlib import Path

{pyoptik-3.1.0 → pyoptik-3.2.1}/PyOptik/thin_film.py

@@ -1,6 +1,5 @@
 """Fresnel interfaces and coherent thin-film transfer-matrix calculations."""
 
-from __future__ import annotations
 
 from dataclasses import dataclass
 from typing import Any, Iterable

{pyoptik-3.1.0 → pyoptik-3.2.1}/PyOptik/tui.py

@@ -1,6 +1,5 @@
 """Optional Textual terminal interface for browsing the material catalog."""
 
-from __future__ import annotations
 
 from pathlib import Path
 

{pyoptik-3.1.0 → pyoptik-3.2.1}/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.1}/PyOptik.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyOptik
-Version: 3.1.0
+Version: 3.2.1
 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.1}/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,12 +70,17 @@ 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
+docs/source/user_guide.rst
 docs/source/_static/default.css
 docs/source/_static/favicon.png
+docs/source/_static/favicon.svg
+docs/source/_static/logo-dark.svg
 docs/source/_static/logo.svg
 docs/source/_static/thumbnail.png
 tests/__init__.py

{pyoptik-3.1.0 → pyoptik-3.2.1}/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,11 +50,16 @@
     "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",
     "docs/source/_static/default.css",
     "docs/source/_static/favicon.png",
+    "docs/source/_static/favicon.svg",
+    "docs/source/_static/logo-dark.svg",
     "docs/source/_static/logo.svg",
     "docs/source/_static/thumbnail.png",
     "docs/source/catalog_browser.rst",
@@ -57,10 +68,13 @@
     "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",
+    "docs/source/user_guide.rst",
     "pyproject.toml",
     "pytest.ini",
     "tests/__init__.py",

pyoptik-3.2.1/PyOptik.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "3.2.1",
+  "distance": 0,
+  "node": "g6f0650682bb62d97e4d26a7dad770bdd207d0f42",
+  "dirty": true,
+  "branch": "HEAD",
+  "node_date": "2026-09-21"
+}

{pyoptik-3.1.0 → pyoptik-3.2.1}/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.1/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.1/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.1/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.1/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.1/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.1/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.1}/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