{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Tutorial 1c: Materials, Catalogs and Databases\n", "\n", "Consolidating basic material queries, built-in catalogs, material registries, search policies, and custom glass definitions.\n" ] }, { "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 \u00b5m: 1.5\n", "Extinction Coefficient at 0.48 \u00b5m: 0.0\n", "\n", "Refractive Index at 0.55 \u00b5m: 1.5\n", "Extinction Coefficient at 0.55 \u00b5m: 0.0\n", "\n", "Refractive Index at 0.65 \u00b5m: 1.5\n", "Extinction Coefficient at 0.65 \u00b5m: 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} \u00b5m: {ideal_material.n(wavelength)}\")\n", " print(\n", " f\"Extinction Coefficient at {wavelength} \u00b5m: {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 (\u00b5m)\")\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 (\u00b5m)\")\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 \u00b5m: 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} \u00b5m: {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 \u00b5m: 2.07748\n", "Refractive Index of toluene at 0.55 \u00b5m: 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} \u00b5m: {silver_chloride.n(wavelength).item():.5f}\",\n", ")\n", "print(\n", " f\"Refractive Index of toluene at {wavelength} \u00b5m: {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 \u00b5m: 1.0000344\n" ] } ], "source": [ "he = Material(\"He\")\n", "\n", "wavelength = 0.612\n", "\n", "print(f\"Refractive Index of He at {wavelength} \u00b5m: {he.n(wavelength).item():.7f}\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Conclusion\n", "\n", "This tutorial covered the three core material types in Optiland:\n", "\n", "- **`IdealMaterial`** \u2014 fixed refractive index and extinction coefficient; useful for simple,\n", " constant-parameter simulations.\n", "- **`AbbeMaterial` / `AbbeMaterialE`** \u2014 model optical glass from nd and Abbe number; supports\n", " Buchdahl (recommended) and polynomial dispersion models for d-line and e-line conventions.\n", "- **`Material`** \u2014 interface to the 3,200-entry refractiveindex.info database; accepts an optional\n", " `reference=` hint to disambiguate when multiple entries share the same name.\n", "\n", "**Next step:** :doc:`Tutorial_1g_Material_Catalog_and_Registry` dives into the catalog and registry\n", "layer \u2014 manufacturer-scoped lookup, `MatchPolicy`, `MaterialCatalog`, `MaterialRegistry`, user\n", "catalogs, and `MaterialSpec` for deterministic surface assignment." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "---\n", "## Part 2: Material Catalog And Registry\n", "\n" ] }, { "cell_type": "markdown", "id": "b2c3d4e5", "metadata": {}, "source": [ "## 1. Concept: From flat database to structured catalog\n", "\n", "Older versions of Optiland performed material lookups by scanning a single flat CSV \u2014 fast, but fragile\n", "when the same glass name appeared in multiple manufacturer databases.\n", "\n", "The catalog/registry system solves this with three layered components:\n", "\n", "| Component | Role |\n", "|---|---|\n", "| `MaterialRegistry` | Process-wide singleton; owns built-in CSV + all user-registered entries |\n", "| `MaterialCatalog` | High-level discovery and search API for a single manufacturer catalog |\n", "| `MatchPolicy` | Enum controlling fuzzy-match behaviour (WARN / BEST / STRICT) |\n", "| `MaterialSpec` | Frozen, hashable parameter bundle for deterministic surface assignment |" ] }, { "cell_type": "code", "execution_count": 1, "id": "c3d4e5f6", "metadata": {}, "outputs": [], "source": [ "from optiland.materials import (\n", " MaterialCatalog,\n", " MaterialRegistry,\n", " MaterialSpec,\n", " MatchPolicy,\n", ")" ] }, { "cell_type": "markdown", "id": "d4e5f6a7", "metadata": {}, "source": [ "## 2. Built-in catalogs\n", "\n", "`MaterialCatalog.available()` returns the list of glass manufacturer catalogs bundled with Optiland.\n", "These correspond to the `glass/` group in the refractiveindex.info database." ] }, { "cell_type": "code", "execution_count": 2, "id": "e5f6a7b8", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "14 glass catalogs available:\n", "['ami', 'barberini', 'cdgm', 'corning', 'hikari', 'hoya', 'lightpath', 'lzos', 'misc', 'nsg', 'ohara', 'schott', 'sumita', 'vitron']\n" ] } ], "source": [ "catalogs = MaterialCatalog.available()\n", "print(f\"{len(catalogs)} glass catalogs available:\")\n", "print(catalogs)" ] }, { "cell_type": "code", "execution_count": 3, "id": "f6a7b8c9", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Schott catalog: 171 glasses\n", "First 15: ['AF32ECO', 'B270', 'BAFN6', 'BK7G18', 'BOROFLOAT33', 'D263TECO', 'F2', 'F2G12', 'F2HT', 'F5', 'FK3', 'FK5HTi', 'IRG22', 'IRG23', 'IRG24']\n" ] } ], "source": [ "# List all glasses in the Schott catalog\n", "schott = MaterialCatalog(\"schott\")\n", "schott_glasses = schott.list()\n", "print(f\"Schott catalog: {len(schott_glasses)} glasses\")\n", "print(\"First 15:\", schott_glasses[:15])" ] }, { "cell_type": "markdown", "id": "a7b8c9d0", "metadata": {}, "source": [ "## 3. Looking up a material by name\n", "\n", "`MaterialCatalog.get()` returns a `Material` instance ready for use in an optical system.\n", "You can also use `MaterialCatalog.search()` for fuzzy name matching within a catalog." ] }, { "cell_type": "code", "execution_count": 4, "id": "b8c9d0e1", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Material(name='N-BK7', catalog='schott', \u03bb=[0.30\u00b5m, 2.50\u00b5m])\n", "n at 587.6 nm (d-line): 1.51680\n", "n at 486.1 nm (F-line): 1.52238\n", "n at 656.3 nm (C-line): 1.51432\n" ] } ], "source": [ "# Exact lookup\n", "nbk7 = schott.get(\"N-BK7\")\n", "print(nbk7)\n", "print(f\"n at 587.6 nm (d-line): {nbk7.n(0.5876).item():.5f}\")\n", "print(f\"n at 486.1 nm (F-line): {nbk7.n(0.4861).item():.5f}\")\n", "print(f\"n at 656.3 nm (C-line): {nbk7.n(0.6563).item():.5f}\")" ] }, { "cell_type": "code", "execution_count": 5, "id": "c9d0e1f2", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Search 'bk7' in Schott: ['BK7G18', 'N-BK7', 'N-BK7HT', 'N-BK7HTi', 'P-BK7']\n" ] } ], "source": [ "# Fuzzy search \u2014 returns a ranked list of matching glass names\n", "results = schott.search(\"bk7\", n=5)\n", "print(\"Search 'bk7' in Schott:\", results)" ] }, { "cell_type": "markdown", "id": "d0e1f2a3", "metadata": {}, "source": [ "## 4. MatchPolicy: controlling catalog search behaviour\n", "\n", "`MatchPolicy` controls what happens when the glass name is not an exact match:\n", "\n", "| Policy | Behaviour |\n", "|---|---|\n", "| `WARN` (default) | Return best match; emit `OptilandMaterialWarning` |\n", "| `BEST` | Return best match silently |\n", "| `STRICT` | Raise `ValueError` on any non-exact match |\n", "\n", "Always use `MatchPolicy.STRICT` in production scripts to catch typos early." ] }, { "cell_type": "code", "execution_count": 6, "id": "e1f2a3b4", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "BEST : Material(name='N-BK7', catalog='schott', \u03bb=[0.30\u00b5m, 2.50\u00b5m])\n", "STRICT: Material(name='N-BK7', catalog='schott', \u03bb=[0.30\u00b5m, 2.50\u00b5m])\n", "Caught expected error: No matches found for material 'N-BK77' in catalog 'schott'\n" ] } ], "source": [ "from optiland.materials import Material\n", "\n", "# BEST: silent best match\n", "mat_best = Material(\"N-BK7\", catalog=\"schott\", match_policy=MatchPolicy.BEST)\n", "print(\"BEST :\", mat_best)\n", "\n", "# STRICT: exact match only \u2014 raises ValueError if not found\n", "mat_strict = Material(\"N-BK7\", catalog=\"schott\", match_policy=MatchPolicy.STRICT)\n", "print(\"STRICT:\", mat_strict)\n", "\n", "# STRICT with a typo \u2014 will raise ValueError\n", "try:\n", " bad = Material(\"N-BK77\", catalog=\"schott\", match_policy=MatchPolicy.STRICT)\n", "except ValueError as exc:\n", " print(\"Caught expected error:\", exc)" ] }, { "cell_type": "markdown", "id": "f2a3b4c5", "metadata": {}, "source": [ "## 5. Creating a user catalog\n", "\n", "Register custom materials for the current session via `MaterialRegistry.instance().register()`.\n", "The data dict follows the refractiveindex.info YAML schema \u2014 the simplest form is a tabulated\n", "refractive index table." ] }, { "cell_type": "code", "execution_count": 7, "id": "a3b4c5d6", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Material(name='LabCrown-1', catalog='internal', \u03bb=[0.40\u00b5m, 0.70\u00b5m])\n", "n at 550 nm: 1.5190\n" ] } ], "source": [ "# Define a custom glass using Sellmeier-style tabulated data\n", "custom_glass_data = {\n", " \"REFERENCE\": \"Internal Lab, 2025\",\n", " \"DATA\": [\n", " {\n", " \"type\": \"tabulated n\",\n", " \"data\": \"0.40 1.535\\n0.45 1.528\\n0.50 1.523\\n0.55 1.519\\n0.60 1.516\\n0.65 1.514\\n0.70 1.512\\n\",\n", " }\n", " ],\n", "}\n", "\n", "registry = MaterialRegistry.instance()\n", "registry.register(\"LabCrown-1\", \"internal\", custom_glass_data)\n", "\n", "# Retrieve from the custom catalog\n", "lab_glass = MaterialCatalog(\"internal\").get(\"LabCrown-1\", match_policy=MatchPolicy.STRICT)\n", "print(lab_glass)\n", "print(f\"n at 550 nm: {lab_glass.n(0.55).item():.4f}\")" ] }, { "cell_type": "markdown", "id": "b4c5d6e7", "metadata": {}, "source": [ "**Persistent registration:** Place `.yml` files under `~/.optiland/catalogs//`.\n", "They are auto-discovered on the next process start and work with the same API." ] }, { "cell_type": "markdown", "id": "c5d6e7f8", "metadata": {}, "source": [ "## 6. Using catalog materials in a lens system\n", "\n", "Surfaces accept a material name string (convenience) or a `Material` instance.\n", "For deterministic, catalog-scoped assignment use `MaterialSpec.to_material()`." ] }, { "cell_type": "code", "execution_count": 8, "id": "d6e7f8a9", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "\u2552\u2550\u2550\u2550\u2550\u2564\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2564\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2564\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2564\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2564\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2564\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2564\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2555\n", "\u2502 \u2502 Type \u2502 Comment \u2502 Radius \u2502 Thickness \u2502 Material \u2502 Conic \u2502 Semi-aperture \u2502\n", "\u255e\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2561\n", "\u2502 0 \u2502 Planar \u2502 \u2502 inf \u2502 inf \u2502 Air \u2502 0 \u2502 12.5 \u2502\n", "\u2502 1 \u2502 Stop - Standard \u2502 \u2502 61.5 \u2502 6 \u2502 N-BK7 \u2502 0 \u2502 12.5 \u2502\n", "\u2502 2 \u2502 Standard \u2502 \u2502 -44.6 \u2502 2.5 \u2502 N-F2 \u2502 0 \u2502 12.0845 \u2502\n", "\u2502 3 \u2502 Standard \u2502 \u2502 -129 \u2502 88.912 \u2502 Air \u2502 0 \u2502 11.9656 \u2502\n", "\u2502 4 \u2502 Planar \u2502 \u2502 inf \u2502 nan \u2502 Air \u2502 0 \u2502 0 \u2502\n", "\u2558\u2550\u2550\u2550\u2550\u2567\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2567\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2567\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2567\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2567\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2567\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2567\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255b\n", "\n", "\n", "EFL: 92.88 mm\n" ] } ], "source": [ "from optiland.optic import Optic\n", "\n", "# Resolve materials deterministically via MaterialSpec\n", "mat_crown = MaterialSpec(name=\"N-BK7\", catalog=\"schott\", match_policy=MatchPolicy.STRICT).to_material()\n", "mat_flint = MaterialSpec(name=\"N-F2\", catalog=\"schott\", match_policy=MatchPolicy.STRICT).to_material()\n", "\n", "# Build a cemented doublet\n", "doublet = Optic(name=\"Cemented Doublet\")\n", "doublet.surfaces.add(index=0, radius=float(\"inf\"), thickness=float(\"inf\"))\n", "doublet.surfaces.add(index=1, radius=61.5, thickness=6.0, material=mat_crown, is_stop=True)\n", "doublet.surfaces.add(index=2, radius=-44.6, thickness=2.5, material=mat_flint)\n", "doublet.surfaces.add(index=3, radius=-129.0, thickness=0.0)\n", "doublet.surfaces.add(index=4) # image plane\n", "doublet.set_aperture(aperture_type=\"EPD\", value=25.0)\n", "doublet.fields.set_type(\"angle\")\n", "doublet.fields.add(y=0.0)\n", "doublet.wavelengths.add(value=0.5876, is_primary=True)\n", "doublet.updater.image_solve()\n", "\n", "doublet.info()\n", "print(f\"\\nEFL: {doublet.paraxial.f2():.2f} mm\")" ] }, { "cell_type": "markdown", "id": "e7f8a9b0", "metadata": {}, "source": [ "## 7. Grouping and filtering\n", "\n", "The `glasses_selection()` utility from `optiland.materials.material_utils` returns all glasses\n", "whose dispersion data spans a given wavelength range \u2014 ideal for seeding a `GlassExpert` run.\n", "For Abbe number filtering, query the registry DataFrame directly." ] }, { "cell_type": "code", "execution_count": null, "id": "f8a9b0c1", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Schott glasses valid from 400\u2013700 nm: 161\n", "Sample: ['AF32ECO', 'BAFN6', 'BK7G18', 'BOROFLOAT33', 'D263TECO', 'F2', 'F2G12', 'F2HT']\n" ] } ], "source": [ "from optiland.materials import glasses_selection, get_nd_vd\n", "\n", "# All Schott glasses valid across the visible spectrum\n", "visible_schott = glasses_selection(0.4, 0.7, catalogs=[\"schott\"])\n", "print(f\"Schott glasses valid from 400-700 nm: {len(visible_schott)}\")\n", "print(\"Sample:\", visible_schott[:8])" ] }, { "cell_type": "code", "execution_count": null, "id": "a9b0c1d2", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Crown glasses (nd 1.45\u20131.70, Vd > 50): 59\n", "['AF32ECO', 'BK7G18', 'D263TECO', 'FK3', 'FK5HTi', 'K10', 'K5G20', 'K7', 'LAK9G15', 'LAKL12']\n" ] } ], "source": [ "# Filter to crown glasses: Vd > 50, nd between 1.45 and 1.70\n", "crown_glasses = [\n", " g for g in visible_schott\n", " if (\n", " (nd_vd := get_nd_vd(g)) != (0, 0) # skip glasses without SPECS data\n", " and 1.45 <= nd_vd[0] <= 1.70\n", " and nd_vd[1] > 50\n", " )\n", "]\n", "print(f\"Crown glasses (nd 1.45-1.70, Vd > 50): {len(crown_glasses)}\")\n", "print(crown_glasses[:10])" ] }, { "cell_type": "code", "execution_count": 11, "id": "b0c1d2e3", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "(
,\n", " )" ] }, "execution_count": 11, "metadata": {}, "output_type": "execute_result" }, { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "from optiland.materials import plot_glass_map\n", "\n", "# Plot the glass map for visible Schott glasses, highlighting the crowns\n", "plot_glass_map(visible_schott, highlights=crown_glasses, title=\"Schott Glass Map (crowns highlighted)\")" ] }, { "cell_type": "markdown", "id": "c1d2e3f4", "metadata": {}, "source": [ "## Conclusion\n", "\n", "In this tutorial you learned how to:\n", "\n", "- Use `MaterialCatalog.available()` to discover bundled glass catalogs\n", "- Look up and fuzzy-search glasses within a manufacturer catalog\n", "- Control match behaviour with `MatchPolicy.WARN / BEST / STRICT`\n", "- Register custom materials programmatically via `MaterialRegistry`\n", "- Assign catalog materials to surfaces using `MaterialSpec` for deterministic, typo-safe design\n", "- Filter glasses by wavelength range and nd/Vd using `glasses_selection` and `get_nd_vd`\n", "\n", "The next step is **Tutorial 5c** (Glass Expert optimization) which uses these same catalog tools\n", "to solve the categorical glass selection problem automatically." ] } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "name": "python" } }, "nbformat": 4, "nbformat_minor": 2 }