{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Tutorial 1d - Material Database Tutorial\n", "\n", "This tutorial demonstrates how to use the material database in Optiland to compute optical properties, including refractive index and extinction coefficient versus wavelength. In Optiland, materials are properties of surfaces and are used to determine optical behavior at their interfaces. Optiland's material database is built on top of the [refractiveindex.info database](https://refractiveindex.info/).\n", "\n", "We will demonstrate how to generate three material types:\n", "\n", "1. `IdealMaterial`: Fixed refractive index and extinction coefficient.\n", "2. `AbbeMaterial`: Ideal glass parameterized by refractive index at the Fraunhofer d-line (587.56 nm) and the Abbe number. Valid only over the visible spectrum.\n", "3. `Material`: Generic material that provides interface to the [refractiveindex.info database](https://refractiveindex.info/).\n", "\n", "\n", "We will show how to compute the refractive index for various materials, from glasses and chemicals to organic materials and gases." ] }, { "cell_type": "markdown", "metadata": { "tags": [ "nbsphinx-toctree" ] }, "source": [ "### January 2025" ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "execution": { "iopub.execute_input": "2026-03-24T10:12:24.573549Z", "iopub.status.busy": "2026-03-24T10:12:24.573308Z", "iopub.status.idle": "2026-03-24T10:12:27.155942Z", "shell.execute_reply": "2026-03-24T10:12:27.155491Z" } }, "outputs": [], "source": [ "import matplotlib.pyplot as plt\n", "import numpy as np\n", "\n", "from optiland.materials import AbbeMaterial, AbbeMaterialE, IdealMaterial, Material" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## 1. Ideal Material\n", "\n", "The `IdealMaterial` class represents a material with a fixed refractive index and extinction coefficient. This is useful for simulations that require simple, constant parameters." ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "execution": { "iopub.execute_input": "2026-03-24T10:12:27.158263Z", "iopub.status.busy": "2026-03-24T10:12:27.157948Z", "iopub.status.idle": "2026-03-24T10:12:27.161832Z", "shell.execute_reply": "2026-03-24T10:12:27.161472Z" } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Refractive Index at 0.48 µm: 1.5\n", "Extinction Coefficient at 0.48 µm: 0.0\n", "\n", "Refractive Index at 0.55 µm: 1.5\n", "Extinction Coefficient at 0.55 µm: 0.0\n", "\n", "Refractive Index at 0.65 µm: 1.5\n", "Extinction Coefficient at 0.65 µm: 0.0\n", "\n" ] } ], "source": [ "ideal_material = IdealMaterial(n=1.5, k=0)\n", "\n", "wavelengths = [0.48, 0.55, 0.65]\n", "\n", "for wavelength in wavelengths:\n", " print(f\"Refractive Index at {wavelength} µm: {ideal_material.n(wavelength)}\")\n", " print(\n", " f\"Extinction Coefficient at {wavelength} µm: {ideal_material.k(wavelength)}\",\n", " end=\"\\n\\n\",\n", " )" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## 2. Abbe Material\n", "\n", "The `AbbeMaterial` class generates a model optical glass material in the visible spectrum. The material is defined by its refractive index at a reference wavelength and its Abbe number. Optiland supports two distinct definitions:\n", "\n", "1. **Standard d-line ($V_d$)**:\n", " * **Reference ($n_d$):** Helium d-line at **587.56 nm**.\n", " * **Abbe Number ($V_d$):** Calculated using Hydrogen F (486.1 nm) and C (656.3 nm) lines.\n", " * *Models:* \"buchdahl\" (Recommended) and \"polynomial\" (Legacy).\n", "\n", "2. **e-line ($V_e$)**:\n", " * **Reference ($n_e$):** Mercury e-line at **546.07 nm**.\n", " * **Abbe Number ($V_e$):** Calculated using Cadmium F' (**480.0 nm**) and C' (**643.8 nm**) lines.\n", " * *Model:* `AbbeMaterialE` class.\n", "\n", "The extinction coefficient is set to zero for these models but can be overwritten manually." ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "execution": { "iopub.execute_input": "2026-03-24T10:12:27.181652Z", "iopub.status.busy": "2026-03-24T10:12:27.181433Z", "iopub.status.idle": "2026-03-24T10:12:27.295890Z", "shell.execute_reply": "2026-03-24T10:12:27.295542Z" } }, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Create instances of the different Abbe models\n", "\n", "# 1. Buchdahl Model (d-line) - The new recommended default\n", "# Input: Index at 587.56 nm, Abbe number Vd (using F/C lines)\n", "abbe_buchdahl = AbbeMaterial(n=1.5, abbe=65.0, model=\"buchdahl\")\n", "\n", "# 2. Legacy Polynomial Model (d-line)\n", "# Input: Index at 587.56 nm, Abbe number Vd (using F/C lines)\n", "abbe_poly = AbbeMaterial(n=1.5, abbe=65.0, model=\"polynomial\")\n", "\n", "# 3. AbbeMaterialE (e-line)\n", "# Input: Index at 546.07 nm, Abbe number Ve (using F'/C' lines)\n", "# Note: Ve is typically slightly different from Vd for the same physical glass.\n", "abbe_e = AbbeMaterialE(n=1.5, abbe=65.0)\n", "\n", "# Define wavelength range for plotting\n", "wavelengths = np.linspace(0.4, 0.75, 500)\n", "\n", "# Calculate refractive indices\n", "n_buchdahl = abbe_buchdahl.n(wavelengths)\n", "n_poly = abbe_poly.n(wavelengths)\n", "n_e = abbe_e.n(wavelengths)\n", "\n", "# Plot the results\n", "plt.figure(figsize=(10, 6))\n", "plt.plot(wavelengths, n_buchdahl, label='Buchdahl (d-line: 587nm, F/C)', linestyle='-')\n", "plt.plot(wavelengths, n_poly, label='Polynomial (Legacy)', linestyle='--')\n", "plt.plot(wavelengths, n_e, label='Buchdahl (e-line: 546nm, F\\'/C\\')', linestyle='-.')\n", "\n", "plt.xlabel(\"Wavelength (µm)\")\n", "plt.ylabel(\"Refractive Index\")\n", "plt.title(\"Comparison of Abbe Material Models (n=1.5, V=65.0)\")\n", "plt.legend()\n", "plt.grid(alpha=0.25)\n", "plt.show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## 3. Material Class (RefractiveIndex.info Integration)\n", "\n", "The `Material` class connects to refractiveindex.info to access real-world material data. It uses string matching to find the closest match for a given material name." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "#### Example 1: A common glass type" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "execution": { "iopub.execute_input": "2026-03-24T10:12:27.297461Z", "iopub.status.busy": "2026-03-24T10:12:27.297304Z", "iopub.status.idle": "2026-03-24T10:12:27.374255Z", "shell.execute_reply": "2026-03-24T10:12:27.373678Z" } }, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "glass = Material(\"N-SF5\")\n", "\n", "n_sf5 = glass.n(wavelengths)\n", "\n", "plt.plot(wavelengths, n_sf5, \"C1\")\n", "plt.xlabel(\"Wavelength (µm)\")\n", "plt.ylabel(\"Refractive Index\")\n", "plt.title(\"Refractive Index of N-SF5 vs. Wavelength\")\n", "plt.grid(alpha=0.25)\n", "plt.show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Note that you may also pass a reference name to the material, which narrows down the material selection if there are multiple matches for the given material name. The reference can include e.g., the glass manufacturer, the author name, year of publication, etc." ] }, { "cell_type": "code", "execution_count": 5, "metadata": { "execution": { "iopub.execute_input": "2026-03-24T10:12:27.375897Z", "iopub.status.busy": "2026-03-24T10:12:27.375725Z", "iopub.status.idle": "2026-03-24T10:12:27.385113Z", "shell.execute_reply": "2026-03-24T10:12:27.384764Z" } }, "outputs": [], "source": [ "glass = Material(\"N-SF5\", reference=\"Schott\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "#### Example 2: Organic material (DNA)" ] }, { "cell_type": "code", "execution_count": 6, "metadata": { "execution": { "iopub.execute_input": "2026-03-24T10:12:27.386747Z", "iopub.status.busy": "2026-03-24T10:12:27.386588Z", "iopub.status.idle": "2026-03-24T10:12:27.395472Z", "shell.execute_reply": "2026-03-24T10:12:27.395147Z" } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Refractive Index of DNA at 0.26 µm: 1.65214\n" ] } ], "source": [ "DNA = Material(\"DNA\")\n", "\n", "wavelength = 0.26\n", "\n", "# call `.item()` to get the value as a scalar\n", "print(f\"Refractive Index of DNA at {wavelength} µm: {DNA.n(wavelength).item():.5f}\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "#### Example 3: Others materials (AgCl & toluene)" ] }, { "cell_type": "code", "execution_count": 7, "metadata": { "execution": { "iopub.execute_input": "2026-03-24T10:12:27.397033Z", "iopub.status.busy": "2026-03-24T10:12:27.396889Z", "iopub.status.idle": "2026-03-24T10:12:27.417980Z", "shell.execute_reply": "2026-03-24T10:12:27.417469Z" } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Refractive Index of AgCl at 0.55 µm: 2.07748\n", "Refractive Index of toluene at 0.55 µm: 1.50006\n" ] } ], "source": [ "silver_chloride = Material(\"AgCl\")\n", "toluene = Material(\"toluene\")\n", "\n", "wavelength = 0.55\n", "\n", "print(\n", " f\"Refractive Index of AgCl at {wavelength} µm: {silver_chloride.n(wavelength).item():.5f}\",\n", ")\n", "print(\n", " f\"Refractive Index of toluene at {wavelength} µm: {toluene.n(wavelength).item():.5f}\"\n", ")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "#### Example 4: Gases (helium)" ] }, { "cell_type": "code", "execution_count": 8, "metadata": { "execution": { "iopub.execute_input": "2026-03-24T10:12:27.419460Z", "iopub.status.busy": "2026-03-24T10:12:27.419315Z", "iopub.status.idle": "2026-03-24T10:12:27.430951Z", "shell.execute_reply": "2026-03-24T10:12:27.430582Z" } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Refractive Index of He at 0.612 µm: 1.0000344\n" ] } ], "source": [ "he = Material(\"He\")\n", "\n", "wavelength = 0.612\n", "\n", "print(f\"Refractive Index of He at {wavelength} µm: {he.n(wavelength).item():.7f}\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Conclusion:\n", "\n", "This tutorial showcased the key features of the Optiland material database. By leveraging `IdealMaterial`, `AbbeMaterial`, and `Material`, users can simulate a wide variety of optical systems with realistic material properties." ] } ], "metadata": { "kernelspec": { "display_name": ".venv", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.13.2" } }, "nbformat": 4, "nbformat_minor": 2 }