PyOptik 2.0.1__tar.gz → 2.0.2__tar.gz

{pyoptik-2.0.1 → pyoptik-2.0.2}/.github/dependabot.yml

@@ -6,6 +6,6 @@ updates:
     directory: "/"
     target-branch: "master"
     schedule:
-      interval: "weekly"
+      interval: "monthly"
       day: "sunday"
       time: "09:00"

pyoptik-2.0.2/.gitignore

@@ -0,0 +1,29 @@
+
+# Ignore all
+/*
+
+# Except ...
+!.github
+!PyOptik
+!development
+!docs
+!tests
+!.flake8
+!.gitignore
+!.pre-commit-config.yaml
+!LICENSE
+!meta.yaml
+!pyproject.toml
+!README.rst
+!notebook.ipynb
+!CMakeLists.txt
+
+# But ignore docs/build inside docs and code
+docs/build/
+docs/source/gallery/
+
+# Compiled files in the project
+*__pycache__*
+*.DS_Store*
+*.so*
+*.a*

pyoptik-2.0.2/.pre-commit-config.yaml

@@ -0,0 +1,20 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+
+  - repo: https://github.com/psf/black
+    rev: 24.4.2
+    hooks:
+      - id: black
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--select, I, --fix]   # import-order rules + auto-fix
+      - id: ruff-format               # optional (formatter)

{pyoptik-2.0.1 → pyoptik-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyOptik
-Version: 2.0.1
+Version: 2.0.2
 Summary: A package for refractive index values.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License: MIT License
@@ -40,7 +40,7 @@ Requires-Dist: numpy
 Requires-Dist: matplotlib~=3.8
 Requires-Dist: requests~=2.31
 Requires-Dist: pyyaml~=6.0
-Requires-Dist: MPSPlots>=1.6
+Requires-Dist: MPSPlots
 Requires-Dist: tabulate~=0.9
 Requires-Dist: TypedUnit
 Provides-Extra: testing

{pyoptik-2.0.1 → pyoptik-2.0.2}/PyOptik/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '2.0.1'
-__version_tuple__ = version_tuple = (2, 0, 1)
+__version__ = version = '2.0.2'
+__version_tuple__ = version_tuple = (2, 0, 2)
 
-__commit_id__ = commit_id = 'g052103443'
+__commit_id__ = commit_id = 'g356195240'

pyoptik-2.0.2/PyOptik/data/sellmeier/example_sellmeier.yml

@@ -0,0 +1,6 @@
+COMMENTS: 'This is a sample Sellmeier file created for demonstration purposes. '
+DATA:
+- coefficients: 1.86e-06 1.31e-08 -1.37e-11 4.34e-07 0.627 0.17
+  type: formula 1
+  wavelength_range: 0.2 2.0
+REFERENCES: Sample Reference

pyoptik-2.0.2/PyOptik/data/sellmeier/test_sellmeier_file.yml

@@ -0,0 +1,7 @@
+COMMENTS: Dummy comment
+DATA:
+- coefficients: 0 10.6684293 0.301516485 0.0030434748 1.13475115 1.54133408 1104
+  type: formula 2
+  wavelength_range: 1 1.2
+REFERENCES: None
+SPECS: Random specs

pyoptik-2.0.2/PyOptik/data/tabulated/example_tabulated.yml

@@ -0,0 +1,13 @@
+COMMENTS: 'This file contains sample tabulated data for demonstration purposes. '
+DATA:
+- data: '0.1879 0.94 1.337
+
+    0.1916 0.95 1.388
+
+    0.1953 0.97 1.44
+
+    0.1993 0.98 1.493
+
+    0.2033 0.99 1.55'
+  type: tabulated nk
+REFERENCES: Example Reference for Tabulated Data

pyoptik-2.0.2/PyOptik/data/tabulated/test_tabulated_file.yml

@@ -0,0 +1,9 @@
+COMMENTS: Room temperature
+DATA:
+- data: '0.1879 0.94 1.337
+
+    0.1916 0.95 1.388
+
+    0.1953 0.97 1.44'
+  type: tabulated nk
+REFERENCES: Example of tabulated test file

{pyoptik-2.0.1 → pyoptik-2.0.2}/PyOptik/material/sellmeier_class.py

@@ -4,8 +4,7 @@
 import yaml
 import numpy
 import itertools
-from MPSPlots.styles import mps
-import matplotlib.pyplot as plt
+from MPSPlots import helper
 from TypedUnit import Length, RefractiveIndex, validate_units, ureg
 
 from PyOptik.directories import sellmeier_data_path
@@ -148,7 +147,8 @@ class SellmeierMaterial(BaseMaterial):
 
         return n[0] if return_as_scalar else n
 
-    def plot(self, samples: int = 100) -> None:
+    @helper.pre_plot(nrows=1, ncols=1)
+    def plot(self, axes, samples: int = 100) -> None:
         """
         Plots the refractive index as a function of wavelength over a specified range.
 
@@ -171,18 +171,13 @@ class SellmeierMaterial(BaseMaterial):
         # Calculate the refractive index over the wavelength range
         refractive_index = self.compute_refractive_index(wavelength)
 
-        with plt.style.context(mps):
-            fig, ax = plt.subplots()
-
-        ax.set(
+        axes.set(
             ylabel='Refractive Index',
             xlabel=r'Wavelength [$\mu$m]',
             title=f"Refractive Index vs. Wavelength: [{self.filename}]"
         )
-        ax.plot(wavelength.to(ureg.micrometer).magnitude, refractive_index.real, linewidth=2, label='Real Part')
-        ax.legend()
-
-        plt.show()
+        axes.plot(wavelength.to(ureg.micrometer).magnitude, refractive_index.real, linewidth=2, label='Real Part')
+        axes.legend()
 
     def print(self) -> str:
         """

{pyoptik-2.0.1 → pyoptik-2.0.2}/PyOptik/material/tabulated_class.py

@@ -2,10 +2,8 @@
 # -*- coding: utf-8 -*-
 
 import numpy
-from typing import Optional, Union
 import yaml
-import matplotlib.pyplot as plt
-from MPSPlots.styles import mps
+from MPSPlots import helper
 from TypedUnit import Length, validate_units, ureg
 
 from PyOptik.material.base_class import BaseMaterial
@@ -128,7 +126,8 @@ class TabulatedMaterial(BaseMaterial):
 
         return index[0] if return_as_scalar else index
 
-    def plot(self, samples: int = 100) -> None:
+    @helper.pre_plot(nrows=1, ncols=1)
+    def plot(self, axes, samples: int = 100) -> None:
         """
         Plots the tabulated refractive index (n) and absorption (k) as a function of wavelength.
 
@@ -150,18 +149,15 @@ class TabulatedMaterial(BaseMaterial):
 
         n_values, k_values = self.compute_refractive_index(wavelength).real, self.compute_refractive_index(wavelength).imag
 
-        with plt.style.context(mps):
-            _, ax1 = plt.subplots()
-
-        ax1.set(
+        axes.set(
             title=f"Refractive Index and Absorption vs. Wavelength [{self.filename}]",
             xlabel='Wavelength [µm]',
             ylabel='Refractive Index (n)',
         )
 
-        ax1.plot(wavelength.to(ureg.micrometer).magnitude, n_values, 'o-', color='tab:blue', label='n')
+        axes.plot(wavelength.to(ureg.micrometer).magnitude, n_values, 'o-', color='tab:blue', label='n')
 
-        ax2 = ax1.twinx()
+        ax2 = axes.twinx()
 
         ax2.set(
             xlabel='Wavelength [µm]',
@@ -170,8 +166,6 @@ class TabulatedMaterial(BaseMaterial):
 
         ax2.plot(wavelength.to(ureg.micrometer).magnitude, k_values, 'o-', color='tab:red', label='k')
 
-        plt.show()
-
     def print(self) -> str:
         """
         Provides a formal string representation of the TabulatedMaterial object, including key attributes.

{pyoptik-2.0.1 → pyoptik-2.0.2}/PyOptik.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyOptik
-Version: 2.0.1
+Version: 2.0.2
 Summary: A package for refractive index values.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License: MIT License
@@ -40,7 +40,7 @@ Requires-Dist: numpy
 Requires-Dist: matplotlib~=3.8
 Requires-Dist: requests~=2.31
 Requires-Dist: pyyaml~=6.0
-Requires-Dist: MPSPlots>=1.6
+Requires-Dist: MPSPlots
 Requires-Dist: tabulate~=0.9
 Requires-Dist: TypedUnit
 Provides-Extra: testing

{pyoptik-2.0.1 → pyoptik-2.0.2}/PyOptik.egg-info/SOURCES.txt

@@ -1,5 +1,6 @@
 .flake8
 .gitignore
+.pre-commit-config.yaml
 LICENSE
 README.rst
 meta.yaml
@@ -40,6 +41,7 @@ PyOptik/data/sellmeier/crown.yml
 PyOptik/data/sellmeier/ethane.yml
 PyOptik/data/sellmeier/ethanol.yml
 PyOptik/data/sellmeier/ethylene.yml
+PyOptik/data/sellmeier/example_sellmeier.yml
 PyOptik/data/sellmeier/flint.yml
 PyOptik/data/sellmeier/fused_silica.yml
 PyOptik/data/sellmeier/germanium.yml
@@ -53,12 +55,14 @@ PyOptik/data/sellmeier/polystyrene.yml
 PyOptik/data/sellmeier/propanol.yml
 PyOptik/data/sellmeier/pvc.yml
 PyOptik/data/sellmeier/soda_lime_glass.yml
+PyOptik/data/sellmeier/test_sellmeier_file.yml
 PyOptik/data/sellmeier/water.yml
 PyOptik/data/tabulated/aluminium.yml
 PyOptik/data/tabulated/bismuth.yml
 PyOptik/data/tabulated/calcium.yml
 PyOptik/data/tabulated/chromium.yml
 PyOptik/data/tabulated/copper.yml
+PyOptik/data/tabulated/example_tabulated.yml
 PyOptik/data/tabulated/gold.yml
 PyOptik/data/tabulated/iron.yml
 PyOptik/data/tabulated/lead.yml
@@ -72,6 +76,7 @@ PyOptik/data/tabulated/silicon.yml
 PyOptik/data/tabulated/silver.yml
 PyOptik/data/tabulated/sodium.yml
 PyOptik/data/tabulated/tantalum.yml
+PyOptik/data/tabulated/test_tabulated_file.yml
 PyOptik/data/tabulated/titanium.yml
 PyOptik/data/tabulated/tungsten.yml
 PyOptik/data/tabulated/vanadium.yml
@@ -119,7 +124,6 @@ docs/source/references.rst
 docs/source/sg_execution_times.rst
 docs/source/_static/default.css
 docs/source/_static/thumbnail.png
-docs/source/gallery/index.rst
 tests/__init__.py
 tests/test_base_material_decorator.py
 tests/test_group_properties.py

{pyoptik-2.0.1 → pyoptik-2.0.2}/PyOptik.egg-info/requires.txt

@@ -3,7 +3,7 @@ numpy
 matplotlib~=3.8
 requests~=2.31
 pyyaml~=6.0
-MPSPlots>=1.6
+MPSPlots
 tabulate~=0.9
 TypedUnit
 

{pyoptik-2.0.1 → pyoptik-2.0.2}/pyproject.toml

@@ -27,7 +27,7 @@ dependencies = [
     "matplotlib ~=3.8",
     "requests ~=2.31",
     "pyyaml ~=6.0",
-    "MPSPlots >=1.6",
+    "MPSPlots",
     "tabulate ~=0.9",
     "TypedUnit"
 ]

pyoptik-2.0.1/.gitignore

@@ -1,28 +0,0 @@
-# General patterns
-*.DS_store
-*.ipynb_checkpoints*
-*__pycache__*
-*.so
-*.a
-.coverage*
-*.pytest_cache
-htmlcov*
-dist
-build
-*.egg*
-*.whl
-CMakeCache.txt
-CMakeFiles
-install_manifest.txt
-cmake_install.cmake
-wheelhouse
-
-# Docs-specific patterns
-docs/source/gallery/*
-!docs/source/gallery/index.rst
-PyOptik/data/**/test*
-PyOptik/data/**/example*
-
-# Override for documentation_build
-!documentation_build
-!documentation_build/**

pyoptik-2.0.1/docs/source/gallery/index.rst

@@ -1,289 +0,0 @@
-:orphan:
-
-.. _examples_gallery:
-
-Examples Gallery
-================
-
-Welcome to the PyOptik Examples Gallery. Here you will find a collection of examples that demonstrate the versatility and power of PyOptik.
-These examples range from simple introductory use cases to more advanced, application-specific tutorials.
-
-The gallery includes:
-
-- **Basic API Usage**: Learn how to get started with PyOptik, covering fundamental operations and core functionalities of the library.
-
-- **Application Tutorials**: Follow step-by-step guides that show how PyOptik can be used in practical, real-world scenarios, such as:
-
-  - **Simulating Optical Properties**: Understand how to simulate the optical properties of various materials, including refractive index and absorption characteristics.
-
-  - **Fiber Optic Analysis**: See how PyOptik can be utilized for fiber optics simulations, providing insights into light propagation and mode analysis.
-
-  - **Biomedical Imaging Applications**: Discover how PyOptik can be leveraged for imaging purposes, including applications in biomedical optics.
-
-These examples are designed to help users at all levels, whether you are a beginner learning how to use the basic API or an experienced user looking for guidance on more advanced use cases.
-
-Explore the gallery and unlock the potential of PyOptik for your optical simulations and research!
-
-
-.. toctree::
-    :maxdepth: 2
-    :hidden:
-
-    sellmeier/index.rst
-    tabulated/index.rst
-    utils/index.rst
-
-
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbnails">
-
-
-.. raw:: html
-
-    </div>
-
-Examples: Sellmeier Material
-============================
-
-This folder contains examples that demonstrate how to use the `SellmeierMaterial` class from the PyOptik library. These examples illustrate the practical applications of modeling materials using the Sellmeier equation, which is commonly used in optical design to determine the refractive index of various materials.
-
-Contents
---------
-
-- **Basic Sellmeier Calculation**: Shows how to instantiate the `SellmeierMaterial` class and calculate the refractive index for different wavelengths.
-- **Plotting Refractive Index**: Demonstrates how to visualize the refractive index as a function of wavelength using the `plot` method.
-- **Application Example**: Provides an example of how to use the Sellmeier model in a more advanced optical simulation or analysis.
-
-Usage
------
-
-To run these examples, make sure you have installed all required dependencies as outlined in the main `PyOptik` README. Navigate to this folder and execute the Python scripts as follows:
-
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbnails">
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="This module demonstrates the usage of the PyOptik library to calculate and plot the refractive ...">
-
-.. only:: html
-
-  .. image:: /gallery/sellmeier/images/thumb/sphx_glr_plot_bk7_thumb.png
-    :alt:
-
-  :ref:`sphx_glr_gallery_sellmeier_plot_bk7.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Plot the Refractive Index of Optical Material: BK7</div>
-    </div>
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="This module demonstrates the usage of the PyOptik library to calculate and plot the refractive ...">
-
-.. only:: html
-
-  .. image:: /gallery/sellmeier/images/thumb/sphx_glr_plot_silica_thumb.png
-    :alt:
-
-  :ref:`sphx_glr_gallery_sellmeier_plot_silica.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Plot the Refractive Index of Optical Material: Silica</div>
-    </div>
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="This module demonstrates the usage of the PyOptik library to calculate and plot the refractive ...">
-
-.. only:: html
-
-  .. image:: /gallery/sellmeier/images/thumb/sphx_glr_plot_water_thumb.png
-    :alt:
-
-  :ref:`sphx_glr_gallery_sellmeier_plot_water.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Plot the Refractive Index of Optical Material: Water</div>
-    </div>
-
-
-.. raw:: html
-
-    </div>
-
-Examples: Tabulated Material
-============================
-
-This folder contains examples demonstrating how to use the `TabulatedMaterial` class from the PyOptik library.
-These examples illustrate the practical applications of working with tabulated refractive index and absorption data, which is useful for analyzing materials based on empirical measurements.
-
-Contents
---------
-
-- **Basic Tabulated Material Usage**: Shows how to create an instance of the `TabulatedMaterial` class and access the refractive index and absorption values.
-- **Interpolating Refractive Index**: Demonstrates how to interpolate the refractive index and absorption values for a given range of wavelengths.
-- **Visualization Example**: Provides an example of plotting the refractive index and absorption over a range of wavelengths using the `plot` method.
-
-
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbnails">
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="This module demonstrates the usage of the PyOptik library to calculate and plot the refractive ...">
-
-.. only:: html
-
-  .. image:: /gallery/tabulated/images/thumb/sphx_glr_plot_polyethylene_thumb.png
-    :alt:
-
-  :ref:`sphx_glr_gallery_tabulated_plot_polyethylene.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Plot the Refractive Index of Optical Material: Polyethylene</div>
-    </div>
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="This module demonstrates the usage of the PyOptik library to calculate and plot the refractive ...">
-
-.. only:: html
-
-  .. image:: /gallery/tabulated/images/thumb/sphx_glr_plot_silver_thumb.png
-    :alt:
-
-  :ref:`sphx_glr_gallery_tabulated_plot_silver.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Plot the Refractive Index of Optical Material: Silver</div>
-    </div>
-
-
-.. raw:: html
-
-    </div>
-
-Examples: Utility Functions
-===========================
-
-This folder contains examples demonstrating the various utility functions provided by the `PyOptik.utils` module.
-These utilities are designed to facilitate common tasks such as managing directories, downloading necessary data, and creating custom material definitions.
-The examples provided here aim to help you leverage these utilities effectively in your workflows.
-
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbnails">
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to build a material library using the build_library function from...">
-
-.. only:: html
-
-  .. image:: /gallery/utils/images/thumb/sphx_glr_build_library_thumb.png
-    :alt:
-
-  :ref:`sphx_glr_gallery_utils_build_library.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Building database and Printing Materials</div>
-    </div>
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to create a custom Sellmeier YAML file using the create_sellmeier...">
-
-.. only:: html
-
-  .. image:: /gallery/utils/images/thumb/sphx_glr_create_sellmeier_file_thumb.png
-    :alt:
-
-  :ref:`sphx_glr_gallery_utils_create_sellmeier_file.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Example: Create a Custom Sellmeier YAML File</div>
-    </div>
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to create a custom YAML file containing tabulated nk data using t...">
-
-.. only:: html
-
-  .. image:: /gallery/utils/images/thumb/sphx_glr_create_tabulated_file_thumb.png
-    :alt:
-
-  :ref:`sphx_glr_gallery_utils_create_tabulated_file.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Example: Create a Custom Tabulated Data YAML File</div>
-    </div>
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to download a YAML file from a URL using the download_yml_file fu...">
-
-.. only:: html
-
-  .. image:: /gallery/utils/images/thumb/sphx_glr_download_yml_file_thumb.png
-    :alt:
-
-  :ref:`sphx_glr_gallery_utils_download_yml_file.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Example: Download a YAML file</div>
-    </div>
-
-
-.. raw:: html
-
-    </div>
-
-
-.. toctree::
-   :hidden:
-   :includehidden:
-
-
-   /gallery/sellmeier/index.rst
-   /gallery/tabulated/index.rst
-   /gallery/utils/index.rst
-   /gallery/group_properties/index.rst
-
-
-
-.. only:: html
-
- .. rst-class:: sphx-glr-signature
-
-    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_