PyFiberModes 0.15.0__tar.gz → 0.16.0__tar.gz

{pyfibermodes-0.15.0 → pyfibermodes-0.16.0}/.zenodo.json

@@ -9,7 +9,7 @@
   "license": "MIT",
   "upload_type": "software",
   "access_right": "open",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "publication_date": "2026-09-23",
   "keywords": [
     "optical fibers",

{pyfibermodes-0.15.0 → pyfibermodes-0.16.0}/CHANGELOG.md

@@ -6,6 +6,14 @@ use [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.16.0] - 2026-09-23
+
+### Fixed
+
+- Handle expected higher-order mode cutoff in derivative gallery examples by
+  plotting unavailable values as gaps instead of failing the documentation
+  build.
+
 ## [0.15.0] - 2026-09-23
 
 ### Added
@@ -141,7 +149,8 @@ use [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 - Established the current tagged baseline for subsequent documented releases.
 
-[Unreleased]: https://github.com/MartinPdeS/PyFiberModes/compare/v0.15.0...HEAD
+[Unreleased]: https://github.com/MartinPdeS/PyFiberModes/compare/v0.16.0...HEAD
+[0.16.0]: https://github.com/MartinPdeS/PyFiberModes/releases/tag/v0.16.0
 [0.15.0]: https://github.com/MartinPdeS/PyFiberModes/releases/tag/v0.15.0
 [0.14.3]: https://github.com/MartinPdeS/PyFiberModes/releases/tag/v0.14.3
 [0.14.2]: https://github.com/MartinPdeS/PyFiberModes/releases/tag/v0.14.2

{pyfibermodes-0.15.0 → pyfibermodes-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyFiberModes
-Version: 0.15.0
+Version: 0.16.0
 Summary: Guided-mode analysis and design for circular optical fibers.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License:                     GNU GENERAL PUBLIC LICENSE

{pyfibermodes-0.15.0 → pyfibermodes-0.16.0}/PyFiberModes/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.15.0'
-__version_tuple__ = version_tuple = (0, 15, 0)
+__version__ = version = '0.16.0'
+__version_tuple__ = version_tuple = (0, 16, 0)
 
 __commit_id__ = commit_id = None

{pyfibermodes-0.15.0 → pyfibermodes-0.16.0}/PyFiberModes.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyFiberModes
-Version: 0.15.0
+Version: 0.16.0
 Summary: Guided-mode analysis and design for circular optical fibers.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License:                     GNU GENERAL PUBLIC LICENSE

{pyfibermodes-0.15.0 → pyfibermodes-0.16.0}/conda.recipe/meta.yaml

@@ -1,6 +1,6 @@
 package:
   name: pyfibermodes
-  version: 0.15.0
+  version: 0.16.0
 
 source:
   path: ../

{pyfibermodes-0.15.0 → pyfibermodes-0.16.0}/docs/examples/basic/plot_dispersion.py

@@ -7,7 +7,7 @@ Dispersion VS core index
 # %%
 # Imports
 # ~~~~~~~
-from PyFiberModes import FiberFactory, HE11, HE12, HE22
+from PyFiberModes import ConvergenceError, FiberFactory, HE11, HE12, HE22
 import matplotlib.pyplot as plt
 import numpy
 
@@ -34,7 +34,12 @@ ax.set(
 for mode in [HE11, HE12, HE22]:
     data = []
     for fiber in factory:
-        effective_index = fiber.get_dispersion(mode)
+        try:
+            effective_index = fiber.get_dispersion(mode)
+        except ConvergenceError:
+            # Higher-order modes can be unguided below cutoff. Use NaN so the
+            # plot shows a gap without obscuring other guided solutions.
+            effective_index = numpy.nan
         data.append(effective_index)
 
     ax.plot(core_indexes, data, label=str(mode))

{pyfibermodes-0.15.0 → pyfibermodes-0.16.0}/docs/examples/basic/plot_fiber_LP_modes.py

@@ -1,13 +1,13 @@
 """
-Groupe index VS core index
-==========================
+Group index vs core index
+=========================
 """
 
 
 # %%
 # Imports
 # ~~~~~~~
-from PyFiberModes import FiberFactory, HE11, HE12, HE22
+from PyFiberModes import ConvergenceError, FiberFactory, HE11, HE12, HE22
 import matplotlib.pyplot as plt
 import numpy
 
@@ -26,7 +26,7 @@ factory.add_layer(name="cladding", index=1.4444)
 figure, ax = plt.subplots(1, 1)
 
 ax.set(
-    title='Groupe index vs core index',
+    title='Group index vs core index',
     xlabel='Core refractive index',
     ylabel='Group index'
 )
@@ -34,7 +34,12 @@ ax.set(
 for mode in [HE11, HE12, HE22]:
     neff = []
     for fiber in factory:
-        effective_index = fiber.get_group_index(mode)
+        try:
+            effective_index = fiber.get_group_index(mode)
+        except ConvergenceError:
+            # Higher-order modes can be unguided below cutoff. Use NaN so the
+            # plot shows a gap without obscuring other guided solutions.
+            effective_index = numpy.nan
         neff.append(effective_index)
 
     ax.plot(core_indexes, neff, label=str(mode))

{pyfibermodes-0.15.0 → pyfibermodes-0.16.0}/docs/examples/basic/plot_group_index.py

@@ -1,13 +1,13 @@
 """
-Dispersion VS core index
-========================
+Group index vs core index
+=========================
 """
 
 
 # %%
 # Imports
 # ~~~~~~~
-from PyFiberModes import FiberFactory, HE11, HE12, HE22
+from PyFiberModes import ConvergenceError, FiberFactory, HE11, HE12, HE22
 import matplotlib.pyplot as plt
 import numpy
 
@@ -26,7 +26,7 @@ factory.add_layer(name="cladding", index=1.4444)
 figure, ax = plt.subplots(1, 1)
 
 ax.set(
-    title='Groupe index vs core index',
+    title='Group index vs core index',
     xlabel='Core refractive index',
     ylabel='Group index'
 )
@@ -34,7 +34,12 @@ ax.set(
 for mode in [HE11, HE12, HE22]:
     data = []
     for fiber in factory:
-        group_index = fiber.get_group_index(mode=mode)
+        try:
+            group_index = fiber.get_group_index(mode=mode)
+        except ConvergenceError:
+            # Higher-order modes can be unguided below cutoff. Use NaN so the
+            # plot shows a gap without obscuring other guided solutions.
+            group_index = numpy.nan
         data.append(group_index)
 
     ax.plot(core_indexes, data, label=str(mode))

{pyfibermodes-0.15.0 → pyfibermodes-0.16.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "PyFiberModes"
-version = "0.15.0"
+version = "0.16.0"
 description = "Guided-mode analysis and design for circular optical fibers."
 license = {file = "LICENSE"}
 readme = "README.rst"