OptiVibe

Find apochromat / secondary-color glass PAIRS - two glasses with matched relative partial dispersion (small |delta-Pg,F|) and well-separated Abbe number (large |delta-Vd|), the doublet condition for cancelling secondary spectrum. Optionally anchor on one named glass to get its best partners; tune with max_delta_pg_f (the partial-dispersion mismatch limit) and min_delta_vd (the minimum Abbe separation). catalog takes one catalog or a comma-separated whitelist such as SCHOTT,OHARA; a name that matches no catalog is refused. By default the known non-lens kinds are left out: exclude lists the kinds to leave out (liquid, adhesive, plastic, gas, birefringent, other), the result counts them in left_out, and exclude="" searches every row. An anchor glass is never left out by catalog or exclude. Results are ordered by score, a heuristic prefilter, and cut at limit; a smaller max_delta_pg_f brings low secondary-colour pairs to the top. Each pair also carries secondary_per_focal, power_sum and petzval_per_power for a thin cemented doublet of the pair; read caveat in the result. Gotcha: an ambiguous bare anchor name returns an ambiguous_glass candidate list - qualify the catalog. See find_glasses to window-search single glasses. See lookup_glass for one glass's full data.

Narrow the glass catalog to candidates in a property window - by Abbe number (vd_min/max), relative partial dispersion (pg_f_min/max), refractive index (nd_min/max), or raw delta-Pg,F (delta_pg_f_min/max) - the glass-selection step for chromatic / apochromat (secondary-color) design. At least one window bound is required. catalog takes one catalog or a comma-separated whitelist such as SCHOTT,OHARA; a name that matches no catalog is refused. By default the known non-lens kinds are left out: exclude lists the kinds to leave out (liquid, adhesive, plastic, gas, birefringent, other), the result counts them in left_out, and exclude="" searches every row. Matches are ordered by sort (vd, nd, pg_f or delta_pg_f; default vd, order=descending reverses; sort=pg_f_anomaly ranks by pg_f minus the normal line 0.6438 - 0.001682*vd, null when either is null, window pg_f_anomaly_min/max; a truncated list carries truncated_note saying what is hidden and how to see it) and cut at limit; matched counts the glasses in the window that are not left out, so truncated means only the first limit of matched are listed. Gotcha: a glass whose computed field is out-of-band (null) never matches that window, and the delta-Pg,F bounds are raw manufacturer data (unvalidated); a stored delta-Pg,F beyond +-0.1 reads as null. See find_glass_pair for matched apochromat pairs. See lookup_glass for one glass's full data.

Get a glass's optical data by name - refractive index Nd, Abbe number Vd, cardinal-line indices, and relative partial dispersion Pg,F (with manufacturer delta-Pg,F), plus per-field validity flags. Pass an optional wavelength in um for the index at that wavelength. Gotcha: a bare name that collides across catalogs returns an ambiguous_glass candidate list (qualify it), an out-of-band wavelength is refused rather than extrapolated, and an in-band wavelength with no computable index returns a typed index_unavailable envelope - never a silent value. WHICH DOOR: glass by NAME comes here, and asking here for an intent gets you nothing. Glass by property goes to find_glasses. A matched pair for an intent ('a crown for this achromat') goes to find_glass_pair. This lookup takes no engine seat.

Resolve a typed operand from design intent - pass an exact 4-letter code (e.g. EFFL, OPGT) for its definition, or a natural phrase ("effective focal length", "hold one operand above another") to get ranked candidate operands. Each candidate carries its description, units, and sign_convention (the constraint direction). An empty param_cells with param_cells_known false means the catalog records no cell layout for that code (not that the operand has none); with param_cells_known true the catalog records that the operand has no parameter cells; the Surf/param cells of a range operand are verified by engine read-back, never assumed. Defaults to the merit-function catalog; pass domain="tolerance" to resolve tolerance codes instead (tilt/decenter resolve to a FAMILY that differs by mechanism - surface vs element vs coordinate-break - so read each candidate's category and precondition_class and pick the code; a cb_required code with no coordinate-break surface will not bite). Gotcha: do NOT trust the top candidate blindly - within the arithmetic/relational family (DIFF, DIVI, OPGT, OPLT, EQUA, ...) the rank-1 hit can be a plausible-but-wrong sibling, so read the candidate descriptions and sign_convention and pick the code yourself. RESOLVE CODES HERE, BETWEEN CALLS: read the descriptions AND the sign_convention before you pass a code anywhere; never trust the rank-1 hit blindly -- inside an operator family it can be confidently wrong. A merit-function operand comes from this door. TOLERANCE CODES (TDE) NEED domain="tolerance": that selects the structured tolerance catalog (ranked codes + category/precondition_class + units, the same code-not-phrase grounding as merit). WITHOUT domain="tolerance" this door mis-routes a tolerance ask -- it defaults to the merit catalog and returns confidently WRONG merit operands (TOLR/VOLU/EQUA). Always pass domain="tolerance" for a tolerance code. This lookup takes no engine seat. See search_reference for chapter context and open-ended ma…

Search the OpticStudio manual for concepts, procedures and terminology and get back ranked text snippets, each with a page + section citation. Send a short keyword query: 1-4 distinctive terms or a heading-like phrase (e.g. 'ray aiming', 'thickness solves'), not a full question. Results report match_mode: 'and' when every term matched, 'or' for a looser any-term match worth discounting. If a whitespace-separated query term never occurs in the manual as that literal token or phrase, the search answers no match and lists the term in absent_terms - drop or rephrase it and retry. Gotcha: this is prose search, not the operand index. See lookup_operand for an exact 4-letter operand code or an intent->operand mapping.