PyOptik 1.7.2.post0__tar.gz → 1.8.0.post0__tar.gz

{pyoptik-1.7.2.post0 → pyoptik-1.8.0.post0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyOptik
-Version: 1.7.2.post0
+Version: 1.8.0.post0
 Summary: A package for refractive index values.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License: MIT License
@@ -62,7 +62,7 @@ PyOptik
 
 PyOptik is a powerful Python tool designed to import refractive indexes and extinction coefficients for various materials across different wavelengths. The data provided by PyOptik can be used in numerous applications, including simulating light interactions with particles. All data is sourced from the reputable RefractiveIndex.INFO database.
 
-|Logo|
+|logo|
 
 .. list-table::
    :widths: 10 25 25 25
@@ -99,10 +99,67 @@ To install PyOptik, simply use `pip` or `conda`:
    pip install PyOptik
    conda install --channels martinpdes pyoptik
 
+Building the Material Library
+*****************************
+
+PyOptik allows you to build and customize a local material library, importing material data from various categories. You can download the following categories of materials from the RefractiveIndex.INFO database:
+
+- `classics`: Commonly used optical materials.
+- `glasses`: Various types of glass materials.
+- `metals`: Different metal materials for optical simulations.
+- `organics`: Organic materials with optical properties.
+- `others`: Other optical materials.
+- `all`: Download all available categories at once.
+
+To build a material library, use the `build_library` function. This will download and save the material data to your local machine.
+
+**Example: Building the Material Library:**
+
+In this example, we will download the `others` category of materials and remove any previously existing data in that category:
+
+.. code:: python
+
+   from PyOptik.utils import build_library
+
+   # Download the 'others' category and remove previous files
+   build_library('others', remove_previous=True)
+
+**Available Categories:**
+
+To download materials from another category, simply pass the category name as an argument to `build_library`. For example:
+
+.. code:: python
+
+   # Download materials from the 'glasses' category
+   build_library('glasses')
+
+To download all material categories at once:
+
+.. code:: python
+
+   # Download all available material categories
+   build_library('all')
+
+You can also set the `remove_previous` parameter to `True` to remove old data before downloading new material data.
+
+Viewing Available Materials
+***************************
+
+Once you have built the material library, you can view all the available materials using the `MaterialBank` class. This will print a list of materials stored in your local library.
+
+**Example:**
+
+.. code:: python
+
+   from PyOptik import MaterialBank
+
+   # Print the available materials in a tabulated format
+   MaterialBank.print_materials()
+
 Simple Usage
 ************
 
-After installing PyOptik, you can easily access material properties:
+After installing PyOptik and building the material library, you can easily access material properties:
 
 .. code:: python
 
@@ -113,7 +170,6 @@ After installing PyOptik, you can easily access material properties:
    n = bk7.compute_refractive_index(0.55e-6)
    print(f"Refractive index at 0.55 µm: {n}")
 
-
 Example
 *******
 
@@ -136,8 +192,12 @@ Here is a quick example demonstrating how to use PyOptik to retrieve and plot th
 
 This code produces the following figure: |example_bk7|
 
+Adding and Removing Custom Materials
+************************************
+
+You can add a custom material to your library by providing a URL from `refractiveindex.info <https://refractiveindex.info>`_.
 
-You can also add a custom element to your library providing a URL from `refractiveindex.info <https://refractiveindex.info>`_ website.
+**Adding a Custom Material:**
 
 .. code:: python
 
@@ -150,8 +210,9 @@ You can also add a custom element to your library providing a URL from `refracti
       location=tabulated_data_path
    )
 
-Evidently, you can also remove element from the library using as follows:
+**Removing a Material:**
 
+You can also remove a material from the library as follows:
 
 .. code:: python
 
@@ -185,12 +246,10 @@ As of 2024, PyOptik is still under development. If you would like to collaborate
 
 **Email**: `martin.poinsinet.de.sivry@gmail.com <mailto:martin.poinsinet.de.sivry@gmail.com?subject=PyOptik>`_
 
-
-
 .. |python| image:: https://img.shields.io/pypi/pyversions/pyoptik.svg
    :target: https://www.python.org/
 
-.. |Logo| image:: https://github.com/MartinPdeS/PyOptik/raw/master/docs/images/logo.png
+.. |logo| image:: https://github.com/MartinPdeS/PyOptik/raw/master/docs/images/logo.png
 
 .. |example_bk7| image:: https://github.com/MartinPdeS/PyOptik/raw/master/docs/images/example_bk7.png
    :target: https://github.com/MartinPdeS/PyOptik/blob/master/docs/images/example_bk7.png

{pyoptik-1.7.2.post0 → pyoptik-1.8.0.post0}/PyOptik/__init__.py

@@ -5,10 +5,10 @@ except ImportError:
     __version__ = "0.0.0"
 
 
-from .utils import build_default_library
-from .material_bank import _MaterialBank
+from .utils import build_library
+from .material_bank import MaterialBank
 from .material import TabulatedMaterial
 from .material import SellmeierMaterial
 from .material import base_class
 
-MaterialBank = Material = _MaterialBank()
+Material = MaterialBank  # For retro-compatiibility

pyoptik-1.8.0.post0/PyOptik/__main__.py

@@ -0,0 +1,6 @@
+from PyOptik.utils import build_library
+
+
+if __name__ == '__main__':
+    print('Building material library')
+    build_library()

{pyoptik-1.7.2.post0 → pyoptik-1.8.0.post0}/PyOptik/_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '1.7.2.post0'
-__version_tuple__ = version_tuple = (1, 7, 2)
+__version__ = version = '1.8.0.post0'
+__version_tuple__ = version_tuple = (1, 8, 0)

pyoptik-1.8.0.post0/PyOptik/data/classics.yml

@@ -0,0 +1,28 @@
+sellmeier:
+  ZBLAN: https://refractiveindex.info/database/data-nk/glass/misc/ZBLAN/Gan.yml
+  BK7: https://refractiveindex.info/database/data-nk/glass/schott/N-BK7.yml
+  fused_silica: https://refractiveindex.info/database/data-nk/main/SiO2/Malitson.yml
+  BAK1: https://refractiveindex.info/database/data-nk/glass/schott/N-BAK1.yml
+  SF5: https://refractiveindex.info/database/data-nk/glass/schott/N-SF5.yml
+  water: https://refractiveindex.info/database/data-nk/main/H2O/Daimon-19.0C.yml
+  polystyren: https://refractiveindex.info/database/data-nk/organic/(C8H8)n%20-%20polystyrene/Sultanova.yml
+  lithium_niobate: https://refractiveindex.info/database/data-nk/main/LiNbO3/Zelmon-o.yml
+  germanium: https://refractiveindex.info/database/data-nk/main/Ge/Icenogle.yml
+  silicon: https://refractiveindex.info/database/data-nk/main/Si/Salzberg.yml
+  soda_lime_glass: https://refractiveindex.info/database/data-nk/glass/misc/soda-lime/Rubin-clear.yml
+  crown: https://refractiveindex.info/database/data-nk/glass/schott/K7.yml
+  flint: https://refractiveindex.info/database/data-nk/glass/schott/F2.yml
+  argon: https://refractiveindex.info/database/data-nk/main/Ar/Bideau-Mehu.yml
+  air: https://refractiveindex.info/database/data-nk/other/mixed%20gases/air/Ciddor.yml
+  water: https://refractiveindex.info/database/data-nk/main/H2O/Daimon-19.0C.yml
+
+tabulated:
+  silver: https://refractiveindex.info/database/data-nk/main/Ag/Johnson.yml
+  aluminium: https://refractiveindex.info/database/data-nk/main/Al/Rakic.yml
+  gold: https://refractiveindex.info/database/data-nk/main/Au/Johnson.yml
+  calcium: https://refractiveindex.info/database/data-nk/main/Ca/Mathewson.yml
+  copper: https://refractiveindex.info/database/data-nk/main/Cu/Johnson.yml
+  iron: https://refractiveindex.info/database/data-nk/main/Fe/Johnson.yml
+  sodium: https://refractiveindex.info/database/data-nk/main/Na/Smith.yml
+  nickel: https://refractiveindex.info/database/data-nk/main/Ni/Johnson.yml
+  zinc: https://refractiveindex.info/database/data-nk/main/Zn/Werner.yml

pyoptik-1.8.0.post0/PyOptik/data/glasses.yml

@@ -0,0 +1,20 @@
+sellmeier:
+  ZBLAN: https://refractiveindex.info/database/data-nk/glass/misc/ZBLAN/Gan.yml
+  BK7: https://refractiveindex.info/database/data-nk/glass/schott/N-BK7.yml
+  fused_silica: https://refractiveindex.info/database/data-nk/main/SiO2/Malitson.yml
+  BAK1: https://refractiveindex.info/database/data-nk/glass/schott/N-BAK1.yml
+  BAF10: https://refractiveindex.info/database/data-nk/glass/schott/N-BAF10.yml
+  SF5: https://refractiveindex.info/database/data-nk/glass/schott/N-SF5.yml
+  SF10: https://refractiveindex.info/database/data-nk/glass/schott/N-SF10.yml
+  SF11: https://refractiveindex.info/database/data-nk/glass/schott/N-SF11.yml
+  LASF9: https://refractiveindex.info/database/data-nk/glass/schott/N-LASF9.yml
+  FK51A: https://refractiveindex.info/database/data-nk/glass/schott/N-FK51A.yml
+  water: https://refractiveindex.info/database/data-nk/main/H2O/Daimon-19.0C.yml
+  polystyren: https://refractiveindex.info/database/data-nk/organic/(C8H8)n%20-%20polystyrene/Sultanova.yml
+  lithium_niobate: https://refractiveindex.info/database/data-nk/main/LiNbO3/Zelmon-o.yml
+  germanium: https://refractiveindex.info/database/data-nk/main/Ge/Icenogle.yml
+  silicon: https://refractiveindex.info/database/data-nk/main/Si/Salzberg.yml
+  soda_lime_glass: https://refractiveindex.info/database/data-nk/glass/misc/soda-lime/Rubin-clear.yml
+  crown: https://refractiveindex.info/database/data-nk/glass/schott/K7.yml
+  flint: https://refractiveindex.info/database/data-nk/glass/schott/F2.yml
+

pyoptik-1.8.0.post0/PyOptik/data/metals.yml

@@ -0,0 +1,20 @@
+tabulated:
+  silver: https://refractiveindex.info/database/data-nk/main/Ag/Johnson.yml
+  aluminium: https://refractiveindex.info/database/data-nk/main/Al/Rakic.yml
+  gold: https://refractiveindex.info/database/data-nk/main/Au/Johnson.yml
+  calcium: https://refractiveindex.info/database/data-nk/main/Ca/Mathewson.yml
+  copper: https://refractiveindex.info/database/data-nk/main/Cu/Johnson.yml
+  iron: https://refractiveindex.info/database/data-nk/main/Fe/Johnson.yml
+  sodium: https://refractiveindex.info/database/data-nk/main/Na/Smith.yml
+  nickel: https://refractiveindex.info/database/data-nk/main/Ni/Johnson.yml
+  zinc: https://refractiveindex.info/database/data-nk/main/Zn/Werner.yml
+  chromium: https://refractiveindex.info/database/data-nk/main/Cr/Johnson.yml
+  titanium: https://refractiveindex.info/database/data-nk/main/Ti/Johnson.yml
+  tungsten: https://refractiveindex.info/database/data-nk/main/W/Werner.yml
+  lead: https://refractiveindex.info/database/data-nk/main/Pb/Werner.yml
+  bismuth: https://refractiveindex.info/database/data-nk/main/Bi/Werner.yml
+  magnesium: https://refractiveindex.info/database/data-nk/main/Mg/Hagemann.yml
+  paladium: https://refractiveindex.info/database/data-nk/main/Pd/Johnson.yml
+  rhodium: https://refractiveindex.info/database/data-nk/main/Rh/Arndt.yml
+  vanadium: https://refractiveindex.info/database/data-nk/main/V/Johnson.yml
+  tantalum: https://refractiveindex.info/database/data-nk/main/Ta/Werner.yml

pyoptik-1.8.0.post0/PyOptik/data/minimal.yml

@@ -0,0 +1,7 @@
+sellmeier:
+  argon: https://refractiveindex.info/database/data-nk/main/Ar/Bideau-Mehu.yml
+  air: https://refractiveindex.info/database/data-nk/other/mixed%20gases/air/Ciddor.yml
+  water: https://refractiveindex.info/database/data-nk/main/H2O/Daimon-19.0C.yml
+
+tabulated:
+  zinc: https://refractiveindex.info/database/data-nk/main/Zn/Werner.yml

pyoptik-1.8.0.post0/PyOptik/data/organics.yml

@@ -0,0 +1,11 @@
+sellmeier:
+  ethanol: https://refractiveindex.info/database/data-nk/organic/C2H6O%20-%20ethanol/Rheims.yml
+  methanol: https://refractiveindex.info/database/data-nk/organic/CH4O%20-%20methanol/El-Kashef.yml
+  propanol: https://refractiveindex.info/database/data-nk/organic/C3H8O%20-%20propanol/Kozma.yml
+  ethylene: https://refractiveindex.info/database/data-nk/organic/C2H4%20-%20ethylene/Loria.yml
+  acetylene: https://refractiveindex.info/database/data-nk/organic/C2H2%20-%20acetylene/Loria.yml
+  methane: https://refractiveindex.info/database/data-nk/organic/CH4%20-%20methane/Loria.yml
+  ethane: https://refractiveindex.info/database/data-nk/organic/C2H6%20-%20ethane/Loria.yml
+  acetone: https://refractiveindex.info/database/data-nk/organic/C3H6O%20-%20acetone/Rheims.yml
+  glycerol: https://refractiveindex.info/database/data-nk/organic/C3H8O3%20-%20glycerol/Rheims.yml
+

pyoptik-1.8.0.post0/PyOptik/data/others.yml

@@ -0,0 +1,4 @@
+sellmeier:
+  air: https://refractiveindex.info/database/data-nk/other/mixed%20gases/air/Ciddor.yml
+  water: https://refractiveindex.info/database/data-nk/main/H2O/Daimon-19.0C.yml
+  argon: https://refractiveindex.info/database/data-nk/main/Ar/Bideau-Mehu.yml

pyoptik-1.8.0.post0/PyOptik/data/sellmeier/air.yml

@@ -0,0 +1,15 @@
+# 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: "P. E. Ciddor. Refractive index of air: new equations for the visible and near infrared, <a href=\"https://doi.org/10.1364/AO.35.001566\"><i>Appl. Optics</i> <b>35</b>, 1566-1573 (1996)</a><br>[<a href=\"https://github.com/polyanskiy/refractiveindex.info-scripts/blob/master/scripts/Ciddor%201996%20-%20air.py\">Calculation script (Python)</a> - can be used to calculate the refractive index of air for specific values of humidity, temperature, pressure, and CO<sub>2</sub> concentration]"
+COMMENTS: "Standard air: dry air at 15 °C, 101.325 kPa and with 450 ppm CO<sub>2</sub> content."
+DATA:
+  - type: formula 6
+    wavelength_range: 0.23 1.690
+    coefficients: 0 0.05792105 238.0185 0.00167917 57.362
+SPECS:
+    n_is_absolute: true
+    wavelength_is_vacuum: true
+    temperature: 15 °C
+    pressure: 101325 Pa

{pyoptik-1.7.2.post0 → pyoptik-1.8.0.post0}/PyOptik/directories.py

@@ -30,6 +30,8 @@ examples_path = root_path.joinpath('examples')
 sellmeier_data_path = root_path.joinpath('data/sellmeier')
 tabulated_data_path = root_path.joinpath('data/tabulated')
 
+data_path = root_path.joinpath('data')
+
 
 if __name__ == '__main__':
     for path_name in __all__:

{pyoptik-1.7.2.post0 → pyoptik-1.8.0.post0}/PyOptik/material/base_class.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
+from typing import Callable
 from PyOptik.units import Quantity, meter
 import numpy
 import warnings
@@ -28,13 +29,13 @@ class BaseMaterial:
         """
         return self.__str__()
 
-    def _check_wavelength(self, wavelength_range: Quantity) -> None:
+    def _check_wavelength(self, wavelength: Quantity) -> None:
         """
         Checks if a wavelength is within the material's allowable range and raises a warning if it is not.
 
         Parameters
         ----------
-        lambda_um : float
+        wavelength : Quantity
             The wavelength to check, in micrometers.
 
         Raises
@@ -45,29 +46,31 @@ class BaseMaterial:
         if self.wavelength_bound is not None:
             min_value, max_value = self.wavelength_bound
 
-            if numpy.any((wavelength_range < min_value) | (wavelength_range > max_value)):
+            if numpy.any((wavelength < min_value) | (wavelength > max_value)):
                 warnings.warn(
-                    f"Wavelength range goes from {wavelength_range.min().to_compact()} to {wavelength_range.max().to_compact()} "
+                    f"Wavelength range goes from {wavelength.min().to_compact()} to {wavelength.max().to_compact()} "
                     f"which is outside the allowable range of {min_value.to_compact()} to {max_value.to_compact()} µm. "
                     f"[Material: {self.filename}]"
                 )
 
-    def ensure_units(func):
+    def ensure_units(func) -> Callable:
         """
         Decorator to ensure that the wavelength parameter has the correct units.
 
         Parameters
         ----------
-        func : callable
+        func : Callable
             The function to wrap.
 
         Returns
         -------
-        callable
+        Callable
             The wrapped function that ensures wavelength is a Quantity in meters.
         """
         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.')
                 wavelength = numpy.linspace(self.wavelength_bound[0].magnitude, self.wavelength_bound[1].magnitude, 100) * self.wavelength_bound.units
 
             if not isinstance(wavelength, Quantity):

{pyoptik-1.7.2.post0 → pyoptik-1.8.0.post0}/PyOptik/material/sellmeier_class.py

@@ -36,6 +36,7 @@ class SellmeierMaterial(BaseMaterial):
         The formula type to use for refractive index calculation.
     """
     filename: str
+
     coefficients: Optional[numpy.ndarray] = Field(default=None)
     wavelength_bound: Optional[Tuple[float, float]] = Field(default=None)
     reference: Optional[str] = Field(default=None)
@@ -73,12 +74,13 @@ class SellmeierMaterial(BaseMaterial):
         # Extract wavelength range
         if 'wavelength_range' in parsed_yaml['DATA'][0]:
             data_str = parsed_yaml['DATA'][0]['wavelength_range'].split()
+
             self.wavelength_bound = numpy.array([float(val) for val in data_str]) * micrometer
 
         else:
             self.wavelength_bound = None
 
-        # Extract reference
+        # # Extract reference
         self.reference = parsed_yaml.get('REFERENCES', None)
 
     @BaseMaterial.ensure_units
@@ -185,4 +187,4 @@ class SellmeierMaterial(BaseMaterial):
             f"wavelength_range: {self.wavelength_bound},\n"
             f"formula_type: {self.formula_type},\n"
             f"reference: '{self.reference}')"
-        )
+        )

{pyoptik-1.7.2.post0 → pyoptik-1.8.0.post0}/PyOptik/material/tabulated_class.py

@@ -5,7 +5,6 @@ import numpy
 from pydantic.dataclasses import dataclass, Field
 from typing import Optional, Union
 import yaml
-import warnings
 from PyOptik.directories import tabulated_data_path
 from PyOptik.material.base_class import BaseMaterial
 from MPSPlots.styles import mps

pyoptik-1.8.0.post0/PyOptik/material_bank.py

@@ -0,0 +1,184 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+
+import os
+from typing import List
+from PyOptik.material.sellmeier_class import SellmeierMaterial
+from PyOptik.material.tabulated_class import TabulatedMaterial
+from PyOptik.utils import download_yml_file, remove_element
+from PyOptik.directories import tabulated_data_path, sellmeier_data_path
+from tabulate import tabulate
+
+
+class MaterialBankMeta(type):
+    """
+    Metaclass to handle dynamic material lookup for the MaterialBank class.
+    """
+    def __getattr__(cls, material_name: str):
+        """
+        Retrieve a material by name dynamically at the class level.
+
+        Parameters
+        ----------
+        material_name : str
+            The name of the material to retrieve.
+
+        Returns
+        -------
+        Union[SellmeierMaterial, TabulatedMaterial]
+            An instance of the material if found.
+
+        Raises
+        ------
+        FileNotFoundError
+            If the material is not found in either the Sellmeier or Tabulated lists.
+        """
+
+        if material_name in cls.sellmeier():
+            print('--'*50, material_name, material_name.__class__)
+            return SellmeierMaterial(filename=material_name)
+
+        if material_name in cls.tabulated():
+            return TabulatedMaterial(filename=material_name)
+
+        raise FileNotFoundError(f'Material: [{material_name}] could not be found.')
+
+
+class MaterialBank(metaclass=MaterialBankMeta):
+    """
+    A class representing a centralized material bank for common optical materials available in the PyOptik library.
+
+    The `MaterialBank` class provides access to a predefined list of materials used in optical simulations,
+    categorized into Sellmeier and Tabulated materials. It allows users to dynamically retrieve materials
+    based on their names without the need to instantiate the class. The material bank can be expanded
+    or modified by adding or removing materials from the bank, and it provides utilities to fetch material data
+    dynamically when accessed as class attributes.
+
+    Attributes
+    ----------
+    all : list
+        A combined list of all materials, including both Sellmeier and Tabulated materials.
+
+    Usage
+    -----
+    Materials can be accessed directly as class attributes:
+
+    >>> material = MaterialBank
+    >>> bk7_material = material.BK7  # Dynamically retrieves the BK7 material.
+
+    To add a new material to the Sellmeier bank:
+
+    >>> material.add_sellmeier_to_bank("new_material.yml", "http://example.com/material.yml")
+
+    To remove a material from the bank:
+
+    >>> material.remove_item_from_bank("obsolete_material.yml")
+
+    Raises
+    ------
+    FileNotFoundError
+        If a material is not found in either the Sellmeier or Tabulated material lists.
+    """
+
+    @classmethod
+    def sellmeier(cls) -> List[str]:
+        return [
+            os.path.splitext(f)[0] for f in os.listdir(sellmeier_data_path) if os.path.isfile(os.path.join(sellmeier_data_path, f)) and f.endswith('.yml')
+        ]
+
+    @classmethod
+    def tabulated(cls) -> List[str]:
+        return [
+            os.path.splitext(f)[0] for f in os.listdir(tabulated_data_path) if os.path.isfile(os.path.join(tabulated_data_path, f)) and f.endswith('.yml')
+        ]
+
+    @classmethod
+    def all(self) -> List[str]:
+        return self.sellmeier() + self.tabulated()
+
+    @classmethod
+    def print_materials(cls) -> None:
+        """
+        Prints out all the available Sellmeier and Tabulated materials in a tabulated format.
+        """
+        sellmeier_materials = cls.sellmeier()
+        tabulated_materials = cls.tabulated()
+
+        # Create data for the table
+        table_data = []
+        max_len = max(len(sellmeier_materials), len(tabulated_materials))
+        for i in range(max_len):
+            sellmeier = sellmeier_materials[i] if i < len(sellmeier_materials) else ""
+            tabulated = tabulated_materials[i] if i < len(tabulated_materials) else ""
+            table_data.append([sellmeier, tabulated])
+
+        # Define headers
+        headers = ["Sellmeier Materials", "Tabulated Materials"]
+
+        # Print the table using tabulate
+        print(tabulate(table_data, headers=headers, tablefmt="grid"))
+
+    @classmethod
+    def add_sellmeier_to_bank(cls, filename: str, url: str) -> None:
+        """
+        Add a Sellmeier material to the material bank.
+
+        Downloads a YAML file containing the Sellmeier material data from a specified URL and stores it
+        in the Sellmeier materials directory.
+
+        Parameters
+        ----------
+        filename : str
+            The name of the file to be saved in the Sellmeier material bank.
+        url : str
+            The URL from where the material file is downloaded.
+
+        Returns
+        -------
+        None
+        """
+        return download_yml_file(filename=filename, url=url, location=sellmeier_data_path)
+
+    @classmethod
+    def add_tabulated_to_bank(cls, filename: str, url: str) -> None:
+        """
+        Add a Tabulated material to the material bank.
+
+        Downloads a YAML file containing the Tabulated material data from a specified URL and stores it
+        in the Tabulated materials directory.
+
+        Parameters
+        ----------
+        filename : str
+            The name of the file to be saved in the Tabulated material bank.
+        url : str
+            The URL from where the material file is downloaded.
+
+        Returns
+        -------
+        None
+        """
+        return download_yml_file(filename=filename, url=url, location=tabulated_data_path)
+
+    @classmethod
+    def remove_item_from_bank(cls, filename: str, location: str = 'any') -> None:
+        """
+        Remove a material file from the material bank.
+
+        Deletes a material file from either the Sellmeier, Tabulated, or both directories based on the location.
+        If `location` is set to 'any', it will search for the material file in both directories and remove it.
+
+        Parameters
+        ----------
+        filename : str
+            The name of the material file to be removed.
+        location : str, optional
+            The location to search for the material ('sellmeier', 'tabulated', or 'any').
+            Default is 'any'.
+
+        Returns
+        -------
+        None
+        """
+        remove_element(filename=filename, location=location)