searchGlassLibrary

Search glass library for glass material

Since R2026a

collapse all in page

    Syntax

    gmatTbl = searchGlassLibrary
    gmatTbl = searchGlassLibrary(Name=Value)

    Description

    Add-On Required: This feature requires the Optical Design and Simulation Library for Image Processing Toolbox add-on.

    gmatTbl = searchGlassLibrary lists all glasses in the glass library in order of their priority in the glass catalog table stored in the GlassCatalogTable property of the glass library.

    gmatTbl = searchGlassLibrary(Name=Value) specifies search options using one or more name-value arguments. Use this syntax to search the glass material library for a specific type of material based on its glass catalog or its optical properties, such as index of refraction and acceptable wavelengths.

    example

    Examples

    collapse all

    This example uses:

    Open Live Script

    Search the glass library by specifying a name hint for an optical material.

    gmatTbl = searchGlassLibrary(NameHint="F2G")
    gmatTbl=4×6 table
     Name      Catalog       Nd        Vd      WavelengthRange         Material      
    _______    ________    ______    ______    _______________    ___________________

    "F2G12"    "SCHOTT"    1.6207     36.56      400    2500      1×1 opticalMaterial
    "F2"       "SCHOTT"      1.62     36.37      320    2500      1×1 opticalMaterial
    "F2"       "HIKARI"      1.62    36.331      400     700      1×1 opticalMaterial
    "F2"       "CDGM"      1.6129    36.986      365    1014      1×1 opticalMaterial

    Name-Value Arguments

    collapse all

    Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

    Example: searchGlassLibrary(NameHint="F2G") specifies a name hint for an optical material name when searching the glass library.

    Hint for glass material name, specified as a string scalar or character vector. If you specify NameHint as three or fewer characters, searchGlassLibrary searches the glass library for any material names that include the specified string, regardless of case. If you specify a hint of more than three characters, searchGlassLibrary uses an edit-distance metric to find similarly named glasses.

    Range of the index of refraction, specified as a 2-element row vector.

    Range of the Abbe numbers, specified as a 2-element row vector.

    The Abbe number Vd is a measure of dispersion, and is represented by the equation:

    Vd=Nd−1NF−NC.

    nd, nF, and nC are the refractive indices at the Fraunhofer d, F, and C spectral lines, respectively. A higher Abbe number indicates lower dispersion.

    Wavelength range at which the material can be used, specified as a 2-element numeric vector. If WavelengthRange is empty, the function does not consider the wavelength range. If you specify a WavelengthRange, the function includes only glasses whose WavelengthRange column values are within the given range.

    Output Arguments

    collapse all

    Glass material listing, returned as a table. The table stores information about glasses in the glass library. The table contains these columns:

    • Name — Name of the glass

    • CatalogName — Name of the associated glass material catalog

    • Nd — Index of refraction

    • Vd — Abbe number

    • WavelengthRange — Wavelength range at which the material can be used

    • MaterialName — Name of the optical material

    Version History

    Introduced in R2026a

    See Also

    | |