PyOptik 1.10.7__tar.gz → 1.11.0__tar.gz

{pyoptik-1.10.7 → pyoptik-1.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyOptik
-Version: 1.10.7
+Version: 1.11.0
 Summary: A package for refractive index values.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License: MIT License
@@ -25,13 +25,12 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
         
-Keywords: refracive index,optics
+Keywords: refractive index,optics
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Development Status :: 4 - Beta
 Classifier: Topic :: Scientific/Engineering :: Physics
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Intended Audience :: Science/Research
 Requires-Python: >=3.10
 Description-Content-Type: text/x-rst

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/__init__.py

@@ -13,3 +13,5 @@ from .material import SellmeierMaterial
 from .material import base_class
 
 Material = MaterialBank  # For retro-compatiibility
+
+TIMEOUT = 10 # Default timeout for requests in seconds

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '1.10.7'
-__version_tuple__ = version_tuple = (1, 10, 7)
+__version__ = version = '1.11.0'
+__version_tuple__ = version_tuple = (1, 11, 0)

pyoptik-1.11.0/PyOptik/data/sellmeier/BK7.yml

@@ -0,0 +1,57 @@
+# this file is part of refractiveindex.info database
+# refractiveindex.info database is in the public domain
+# copyright and related rights waived via CC0 1.0
+
+REFERENCES: |
+    <a href="https://refractiveindex.info/download/data/2017/schott_2017-01-20b.agf">SCHOTT Zemax catalog 2017-01-20b</a> (obtained from <a href="https://www.schott.com/en-us/products/optical-glass-p1000267/downloads/">http://www.schott.com</a>)<br>See also <a href="https://refractiveindex.info/download/data/2017/schott_2017-01-20.pdf">SCHOTT glass data sheets</a>
+COMMENTS: |
+    suitable for precision molding        
+DATA:
+  - type: formula 2
+    wavelength_range: 0.31 2.5
+    coefficients: 0 1.18318503 0.00722141956 0.0871756426 0.0268216805 1.03133701 101.702362
+  - type: tabulated k
+    data: |
+        0.310 3.8602E-06
+        0.320 1.4536E-06
+        0.334 3.3459E-07
+        0.350 8.0850E-08
+        0.365 3.1801E-08
+        0.370 2.4996E-08
+        0.380 1.7054E-08
+        0.390 1.2477E-08
+        0.400 1.0227E-08
+        0.405 9.0558E-09
+        0.420 8.0456E-09
+        0.436 8.3521E-09
+        0.460 7.3395E-09
+        0.500 6.3790E-09
+        0.546 5.2218E-09
+        0.580 5.5469E-09
+        0.620 5.9295E-09
+        0.660 6.3120E-09
+        0.700 6.6946E-09
+        1.060 3.3758E-09
+        1.530 1.0336E-07
+        1.970 5.2286E-07
+        2.325 2.6396E-06
+        2.500 6.1794E-06
+PROPERTIES:
+    nd: 1.5164
+    Vd: 64.06
+    glass_code: 516641.243
+    glass_status: standard
+    density:
+      - value: 2433
+    thermal_expansion:
+      - temperature_range: 243 343
+        value: 5.99e-06
+      - temperature_range: 293 573
+        value: 7.32e-06
+    dPgF: -0.0025
+    resistance:
+        climatic: 1.0
+        stain: 0.0
+        acid: 1.0
+        alkali: 2.3
+        phosphate: 2.3

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/directories.py

@@ -1,6 +1,14 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
+"""Convenience paths used throughout the :mod:`PyOptik` package.
+
+This module exposes commonly referenced directories such as the project
+root, documentation and data folders.  It is imported by other modules to
+construct absolute paths in a centralised manner and therefore simplifies
+file handling across the code base.
+"""
+
 from pathlib import Path
 import PyOptik
 

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/libraries/classics.yml

@@ -13,10 +13,11 @@ sellmeier:
   - argon
   - air
   - water
+  - acetone
+  - BK7
 
 tabulated:
   - silicon
-  - BK7
   - silver
   - aluminium
   - gold
@@ -25,4 +26,5 @@ tabulated:
   - iron
   - sodium
   - nickel
-  - zinc
+  - zinc
+  - polyetylene

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/libraries/dielectrics.yml

@@ -15,7 +15,8 @@ sellmeier:
   - soda_lime_glass
   - crown
   - flint
+  - BK7
 
 tabulated:
-  - BK7
+
   - silicon

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/libraries/repertoire.yml

@@ -13,12 +13,12 @@ sellmeier:
   lithium_niobate: https://refractiveindex.info/database/data/main/LiNbO3/nk/Zelmon-o.yml
   germanium: https://refractiveindex.info/database/data/main/Ge/nk/Icenogle.yml
 
+  BK7: https://refractiveindex.info/database/data/specs/schott/optical/P-BK7.yml
   soda_lime_glass: https://refractiveindex.info/database/data/glass/misc/soda-lime/nk/Rubin-clear.yml
   crown: https://refractiveindex.info/database/data/specs/schott/optical/K7.yml
   flint: https://refractiveindex.info/database/data/specs/schott/optical/F2.yml
   argon: https://refractiveindex.info/database/data/main/Ar/nk/Bideau-Mehu.yml
   air: https://refractiveindex.info/database/data/other/mixed%20gases/air/nk/Ciddor.yml
-  water: https://refractiveindex.info/database/data/main/H2O/nk/Daimon-19.0C.yml
 
   ethanol: https://refractiveindex.info/database/data/organic/C2H6O%20-%20ethanol/nk/Rheims.yml
   methanol: https://refractiveindex.info/database/data/organic/CH4O%20-%20methanol/nk/El-Kashef.yml
@@ -38,7 +38,6 @@ tabulated:
   pva: https://refractiveindex.info/database/data/organic/(C2H3Cl)n%20-%20polyvinyl%20chloride/nk/Zhang.yml
   polyetylene: https://refractiveindex.info/database/data/organic/(C2H4)n%20-%20polyethylene/nk/Smith.yml
   silicon: https://refractiveindex.info/database/data/main/Si/nk/Aspnes.yml
-  BK7: https://refractiveindex.info/database/data/glass/optical/BK7/nk/Lane.yml
   silver: https://refractiveindex.info/database/data/main/Ag/nk/Johnson.yml
   aluminium: https://refractiveindex.info/database/data/main/Al/nk/Rakic.yml
   gold: https://refractiveindex.info/database/data/main/Au/nk/Johnson.yml

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/material/base_class.py

@@ -64,23 +64,23 @@ class BaseMaterial:
                 )
 
     def ensure_units(func) -> Callable:
-        """
-        Decorator to ensure that the wavelength parameter has the correct units.
+        """Decorator ensuring the wavelength argument carries units.
 
         Parameters
         ----------
         func : Callable
-            The function to wrap.
+            Function that expects a wavelength :class:`~PyOptik.units.Quantity`.
 
         Returns
         -------
         Callable
-            The wrapped function that ensures wavelength is a Quantity in meters.
+            Wrapped version of ``func`` that accepts numerical wavelengths and
+            converts them to metre-based :class:`~PyOptik.units.Quantity` objects.
         """
         def wrapper(self, wavelength: Quantity = None, *args, **kwargs):
             if wavelength is None:
                 if self.wavelength_bound is None:
-                    raise ValueError('Wavelenght must be provided for computation.')
+                    raise ValueError('Wavelength must be provided for computation.')
                 wavelength = numpy.linspace(self.wavelength_bound[0].magnitude, self.wavelength_bound[1].magnitude, 100) * self.wavelength_bound.units
 
             import PyOptik.units

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/material/sellmeier_class.py

@@ -133,7 +133,7 @@ class SellmeierMaterial(BaseMaterial):
             case 5:  # Formula 5 computation (extended Sellmeier)
                 n = 1 + self.coefficients[0]
                 for (B, C) in zipped_coefficients:
-                    n = B * wavelength.to(micrometer).magnitude**C
+                    n += B * wavelength.to(micrometer).magnitude**C
 
             case 6:
                 n = 1 + self.coefficients[0]

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/material/tabulated_class.py

@@ -74,6 +74,7 @@ class TabulatedMaterial(BaseMaterial):
             raise FileNotFoundError(f"YAML file {file_path} not found.")
 
         with file_path.with_suffix('.yml').open('r') as file:
+            print(file)
             parsed_yaml = yaml.safe_load(file)
 
         try:
@@ -134,10 +135,6 @@ class TabulatedMaterial(BaseMaterial):
         ----------
         wavelength : Optional[Quantity]
             The range of wavelengths to plot, in micrometers. If not provided, the entire tabulated wavelength range is used.
-        title : str, optional
-            Title of the plot.
-        grid : bool, optional
-            Whether to show grid lines on the plot.
 
         Raises
         ------

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/material_bank.py

@@ -127,8 +127,7 @@ class _MaterialBank():
         cls.use_sellmeier = use_sellmeier
 
     def _list_materials(self, material_type: MaterialType) -> List[str]:
-        """create_sellmeier_file
-        Helper method to list materials of a specific type.
+        """Return available material names for a given type.
 
         Parameters
         ----------
@@ -182,8 +181,11 @@ class _MaterialBank():
         return self.sellmeier + self.tabulated
 
     def print_available(cls) -> None:
-        """
-        Prints out all the available Sellmeier and Tabulated materials in a tabulated format.
+        """Display all available materials in a table.
+
+        The method lists both Sellmeier and tabulated materials currently
+        stored in the local database and prints them in two columns using
+        :func:`tabulate.tabulate`.
         """
         sellmeier_materials = cls.sellmeier
         tabulated_materials = cls.tabulated
@@ -226,7 +228,7 @@ class _MaterialBank():
         if material_type not in [MaterialType.SELLMEIER, MaterialType.TABULATED]:
             raise ValueError("Invalid material type. Please choose MaterialType.SELLMEIER or MaterialType.TABULATED.")
 
-        return download_yml_file(filename=filename, url=url, location=material_type)
+        return download_yml_file(filename=filename, url=url, save_location=material_type)
 
     @classmethod
     def add_sellmeier_to_bank(cls, filename: str, url: str) -> None:
@@ -237,7 +239,7 @@ class _MaterialBank():
         return cls.add_material_to_bank(filename=filename, url=url, material_type=MaterialType.TABULATED)
 
     @classmethod
-    def remove_item(cls, filename: str, location: Union[str, MaterialType] = 'any') -> None:
+    def remove_item(cls, filename: str, save_location: Union[str, MaterialType] = 'any') -> None:
         """
         Remove a file associated with a given element name from the specified location.
 
@@ -245,35 +247,35 @@ class _MaterialBank():
         ----------
         filename : str
             The name of the file to remove, without the '.yml' suffix.
-        location : Union[str, MaterialType]
-            The location to search for the file, either 'sellmeier', 'tabulated', 'any', or a MaterialType enum (default is 'any').
+        save_location : Union[str, MaterialType]
+            The save_location to search for the file, either 'sellmeier', 'tabulated', 'any', or a MaterialType enum (default is 'any').
 
         Raises
         ------
         FileNotFoundError
             If the specified file does not exist.
         ValueError
-            If an invalid location is provided.
+            If an invalid save_location is provided.
         """
-        if isinstance(location, MaterialType):
-            location = location.value
+        if isinstance(save_location, MaterialType):
+            save_location = save_location.value
 
-        location = location.lower()
+        save_location = save_location.lower()
 
-        if location not in ['any', 'sellmeier', 'tabulated']:
-            raise ValueError("Invalid location. Please choose 'sellmeier', 'tabulated', or 'any'.")
+        if save_location not in ['any', 'sellmeier', 'tabulated']:
+            raise ValueError("Invalid save_location. Please choose 'sellmeier', 'tabulated', or 'any'.")
 
-        if location in ['any', 'sellmeier']:
+        if save_location in ['any', 'sellmeier']:
             sellmeier_file = data_path / 'sellmeier' / f"{filename}.yml"
             if sellmeier_file.exists():
                 sellmeier_file.unlink()
 
-        if location in ['any', 'tabulated']:
+        if save_location in ['any', 'tabulated']:
             tabulated_file = data_path / 'tabulated' / f"{filename}.yml"
             if tabulated_file.exists():
                 tabulated_file.unlink()
 
-    def clean_data_files(self, regex: str, location: Union[str, MaterialType] = 'any') -> None:
+    def clean_data_files(self, regex: str, save_location: Union[str, MaterialType] = 'any') -> None:
         """
         Remove all files matching the given regex from the specified location.
 
@@ -289,13 +291,13 @@ class _MaterialBank():
         ValueError
             If an invalid location is provided.
         """
-        if isinstance(location, MaterialType):
-            location = location.value
+        if isinstance(save_location, MaterialType):
+            save_location = save_location.value
 
-        location = location.lower()
+        save_location = save_location.lower()
 
-        if location not in ['any', 'sellmeier', 'tabulated']:
-            raise ValueError("Invalid location. Please choose 'sellmeier', 'tabulated', or 'any'.")
+        if save_location not in ['any', 'sellmeier', 'tabulated']:
+            raise ValueError("Invalid save_location. Please choose 'sellmeier', 'tabulated', or 'any'.")
 
         # Compile the regex pattern
         pattern = re.compile(regex)
@@ -308,11 +310,11 @@ class _MaterialBank():
                     file.unlink()
 
         # Remove files from the sellmeier location if specified
-        if location in ['any', 'sellmeier']:
+        if save_location in ['any', 'sellmeier']:
             remove_matching_files(data_path / 'sellmeier')
 
         # Remove files from the tabulated location if specified
-        if location in ['any', 'tabulated']:
+        if save_location in ['any', 'tabulated']:
             remove_matching_files(data_path / 'tabulated')
 
     def build_library(self, library: Union[str, List[str]] = 'classics', remove_previous: bool = False) -> None:
@@ -341,8 +343,8 @@ class _MaterialBank():
         # Remove previous files if the flag is set
         if remove_previous:
             logging.info("Removing previous files from the library.")
-            self.clean_data_files(regex=".*", location="sellmeier")  # Remove all sellmeier files
-            self.clean_data_files(regex=".*", location="tabulated")  # Remove all tabulated files
+            self.clean_data_files(regex=".*", save_location="sellmeier")  # Remove all sellmeier files
+            self.clean_data_files(regex=".*", save_location="tabulated")  # Remove all tabulated files
 
         for lib in libraries_to_download:
             file_path = libraries_path / lib
@@ -353,13 +355,13 @@ class _MaterialBank():
             if data_dict.get('sellmeier', False):
                 for element_name in data_dict['sellmeier']:
                     url = repertoire_dict['sellmeier'][element_name]
-                    download_yml_file(url=url, filename=element_name, location=MaterialType.SELLMEIER)
+                    download_yml_file(url=url, filename=element_name, save_location=MaterialType.SELLMEIER)
 
             # Download new files for tabulated
             if data_dict.get('tabulated', False):
                 for element_name in data_dict['tabulated']:
                     url = repertoire_dict['tabulated'][element_name]
-                    download_yml_file(url=url, filename=element_name, location=MaterialType.TABULATED)
+                    download_yml_file(url=url, filename=element_name, save_location=MaterialType.TABULATED)
 
     def create_sellmeier_file(
             self,
@@ -370,25 +372,29 @@ class _MaterialBank():
             reference: Optional[str] = None,
             comments: Optional[str] = None,
             specs: Optional[dict] = None) -> None:
-        """
-        Creates a YAML file with custom Sellmeier coefficients in the correct format.
+        """Create a custom Sellmeier material definition.
 
         Parameters
         ----------
         filename : str
-            The name of the file to create (without the extension).
+            Name of the output file without extension.
         formula_type : int
-            The type of Sellmeier formula.
-        coefficients :  list[float]
-            A list of coefficients for the Sellmeier equation.
-        wavelength_range : Tuple[float, float]
-            The range of wavelengths, in micrometers.
-        reference : str
-            A reference for the material data.
-        comments : Optional[str]
-            Additional comments about the material.
-        specs : Optional[dict]
-            Additional specifications, such as temperature and whether the wavelength is in a vacuum.
+            Identifier of the Sellmeier formula to use.
+        coefficients : list[float]
+            Coefficients of the selected Sellmeier equation.
+        wavelength_range : tuple[float, float], optional
+            Minimum and maximum wavelength in micrometers.
+        reference : str, optional
+            Reference or citation for the data.
+        comments : str, optional
+            Additional comments stored in the file.
+        specs : dict, optional
+            Extra specifications such as temperature or vacuum information.
+
+        Notes
+        -----
+        The YAML file is written to ``data/sellmeier`` within the package
+        directory.
         """
         reference = 'None' if reference is None else reference
 
@@ -428,19 +434,23 @@ class _MaterialBank():
             data: List[Tuple[float, float, float]],
             reference: Optional[str] = None,
             comments: Optional[str] = None) -> None:
-        """
-        Creates a YAML file with tabulated nk data in the correct format.
+        """Create a tabulated ``n``/``k`` material definition.
 
         Parameters
         ----------
-        filename : str)
-            The name of the file to create (without the extension).
-        data : List[Tuple[float, float, float]])
-            The tabulated nk data.
-        reference : Optional[str])
-            A reference for the material data.
-        comments : Optional[str])
-            Additional comments about the material.
+        filename : str
+            Name of the output file without extension.
+        data : list[tuple[float, float, float]]
+            Sequence of ``(wavelength, n, k)`` tuples.
+        reference : str, optional
+            Reference or citation for the data.
+        comments : str, optional
+            Additional comments stored in the file.
+
+        Notes
+        -----
+        The YAML file is written to ``data/tabulated`` within the package
+        directory.
         """
         reference = 'None' if reference is None else reference
 

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/material_type.py

@@ -5,5 +5,7 @@ from enum import Enum
 
 
 class MaterialType(Enum):
+    """Enumeration of material data representations."""
+
     SELLMEIER = "sellmeier"
     TABULATED = "tabulated"

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik/units.py

@@ -14,15 +14,19 @@ SCALES = ['nano', 'micro', 'milli', '', 'kilo', 'mega']
 
 
 def initialize_registry(ureg: Optional[pint.UnitRegistry] = None) -> None:
-    """
-    Initialize and set up a unit registry. This function also leaks
-    the units into the global namespace for easy access throughout
-    the module.
+    """Initialise the unit registry used by :mod:`PyOptik`.
 
     Parameters
     ----------
-    ureg: Optional[pint.UnitRegistry]
-        A UnitRegistry object to use. If None, the default PintType.ureg will be used.
+    ureg : Optional[pint.UnitRegistry], optional
+        A preconfigured :class:`~pint.UnitRegistry` instance. When ``None`` (the
+        default) a new registry is created and configured.
+
+    Notes
+    -----
+    The registry is configured for matplotlib integration and a number of unit
+    shortcuts (``nano``/``micro``/``milli``/... ``meter``) as well as commonly
+    used units are leaked into the module's global namespace for convenience.
     """
 
     # If no unit registry is provided, use the default

pyoptik-1.11.0/PyOptik/utils.py

@@ -0,0 +1,97 @@
+from PyOptik.directories import sellmeier_data_path, tabulated_data_path
+from PyOptik.material_type import MaterialType
+import requests
+import logging
+from pathlib import Path
+import PyOptik
+import time
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s %(levelname)s %(message)s",
+)
+
+def download_yml_file(
+    url: str,
+    filename: str,
+    save_location: MaterialType,
+    max_retries: int = 5,
+    retry_delay: float = 2.0,
+    backoff_factor: float = 2.0,
+) -> None:
+    """
+    Download a YAML material file from the given URL and save it locally.
+
+    If the file already exists, the function will skip downloading.
+    Retries are performed on connection or timeout errors.
+
+    Parameters
+    ----------
+    url : str
+        Direct link to the YAML file to download.
+    filename : str
+        File name to save (without .yml extension).
+    save_location : MaterialType
+        The target material type (SELLMEIER or TABULATED).
+    max_retries : int, optional
+        Maximum number of retry attempts (default is 3).
+    retry_delay : float, optional
+        Delay (in seconds) between retries (default is 2.0).
+    backoff_factor : float, optional
+        Multiplier applied to delay after each failed attempt (default is 2.0).
+
+    Raises
+    ------
+    ValueError
+        If an invalid MaterialType is passed.
+    requests.exceptions.RequestException
+        For non-retriable HTTP or connection errors.
+    """
+    # Determine save save_location
+    if save_location == MaterialType.SELLMEIER:
+        file_path: Path = sellmeier_data_path / f"{filename}.yml"
+    elif save_location == MaterialType.TABULATED:
+        file_path: Path = tabulated_data_path / f"{filename}.yml"
+    else:
+        raise ValueError(f"Invalid save_location: {save_location}. Must be SELLMEIER or TABULATED.")
+
+    # Skip if already downloaded
+    if file_path.exists():
+        logging.info(f"File already exists: {file_path}. Skipping download.")
+        return
+
+    # Create directory if needed
+    file_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Retry logic
+    attempt = 0
+    delay = retry_delay
+
+    while attempt < max_retries:
+        attempt += 1
+        try:
+            logging.info(f"Attempt {attempt} of {max_retries}: downloading {url}")
+            response = requests.get(url, timeout=PyOptik.TIMEOUT)
+            response.raise_for_status()
+
+            with open(file_path, "wb") as f:
+                f.write(response.content)
+
+            logging.info(f"Successfully downloaded and saved to: {file_path}")
+            return
+
+        except (requests.exceptions.Timeout, requests.exceptions.ConnectionError) as e:
+            logging.warning(f"Download attempt {attempt} failed due to network error: {e}")
+            if attempt < max_retries:
+                logging.info(f"Retrying in {delay:.1f} seconds...")
+                time.sleep(delay)
+                delay *= backoff_factor
+            else:
+                logging.error(f"Exceeded maximum retries for {url}")
+                raise
+        except requests.exceptions.HTTPError as e:
+            logging.error(f"HTTP error while downloading {url}: {e}")
+            raise
+        except Exception as e:
+            logging.error(f"Unexpected error while saving {url} to {file_path}: {e}")
+            raise

{pyoptik-1.10.7 → pyoptik-1.11.0}/PyOptik.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyOptik
-Version: 1.10.7
+Version: 1.11.0
 Summary: A package for refractive index values.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License: MIT License
@@ -25,13 +25,12 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
         
-Keywords: refracive index,optics
+Keywords: refractive index,optics
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Development Status :: 4 - Beta
 Classifier: Topic :: Scientific/Engineering :: Physics
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Intended Audience :: Science/Research
 Requires-Python: >=3.10
 Description-Content-Type: text/x-rst