PyOptik 1.8.0.post0

A package for refractive index values.

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.

Testing
Package
Meta

Features

• Comprehensive Database Access: Seamlessly import refractive index and extinction coefficient data for a wide range of materials.

• Simulation Ready: Ideal for light-matter interaction simulations, particularly in optics and photonics.

• Simple API: Easy-to-use API that integrates well with other Python libraries.

• Open Source: Fully open-source.

Installation

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:

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:

# Download materials from the 'glasses' category
build_library('glasses')

To download all material categories at once:

# 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:

from PyOptik import MaterialBank

# Print the available materials in a tabulated format
MaterialBank.print_materials()

Simple Usage

After installing PyOptik and building the material library, you can easily access material properties:

from PyOptik import MaterialBank

# Access the refractive index of BK7 glass
bk7 = MaterialBank.BK7
n = bk7.compute_refractive_index(0.55e-6)
print(f"Refractive index at 0.55 µm: {n}")

Example

Here is a quick example demonstrating how to use PyOptik to retrieve and plot the refractive index of a material:

import numpy as np
from PyOptik import MaterialBank

# Define wavelength range
wavelengths = np.linspace(0.3e-6, 2.5e-6, 100)

# Retrieve refractive index for BK7 glass
bk7 = MaterialBank.BK7
n_values = bk7.compute_refractive_index(wavelengths)

# Plot the results
bk7.plot()

This code produces the following figure:

Adding and Removing Custom Materials

You can add a custom material to your library by providing a URL from refractiveindex.info.

Adding a Custom Material:

from PyOptik.utils import download_yml_file
from PyOptik.directories import sellmeier_data_path  # or tabulated_data_path for tabulated elements

download_yml_file(
   filename='test',
   url='https://refractiveindex.info/database/data-nk/main/H2O/Daimon-19.0C.yml',
   location=tabulated_data_path
)

Removing a Material:

You can also remove a material from the library as follows:

from PyOptik.utils import remove_element

remove_element(filename='test', location='any')  # location can be "any", "sellmeier" or "tabulated"

Testing

To test locally after cloning the GitHub repository, install the dependencies and run the tests:

git clone https://github.com/MartinPdeS/PyOptik.git
cd PyOptik
pip install .
pytest

Contributing

PyOptik is open to contributions. Whether you’re fixing bugs, adding new features, or improving documentation, your help is welcome! Please feel free to fork the repository and submit pull requests.

Contact Information

As of 2024, PyOptik is still under development. If you would like to collaborate, it would be a pleasure to hear from you. Contact me at:

Author: Martin Poinsinet de Sivry-Houle

Email: [e-mail]