KrakenOS

Manual

  • Provisional Manual
    • Installation And Prerequisites
      • Basic installation paths
      • Running the layout editor
      • Manual source
    • Introduction To Fundamental Lens Design
      • Why “Lens Families” Exist
      • Photographic Lens Families
        • The Double Gauss
        • Tessar
        • Sonnar
        • Cooke Triplet
        • Retrofocus (Inverted Telephoto)
        • Telephoto
        • Petzval
        • Modern Aspheric / Floating-Element Designs
        • Photographic Family Summary
      • Machine Vision Lens Families
        • Fixed-Focal-Length (FFL) Industrial Lenses
        • Retrofocus On Large Sensors
        • Telecentric Lenses
        • Fixed-Magnification Macro / Inspection Lenses
        • Line-Scan Lenses
        • Spectrally Specialized Lenses
        • Machine Vision Family Summary
      • Photography vs. Machine Vision: Side by Side
      • Reading A Prescription In KrakenOS
      • Further Reading
    • Core Model: Surfaces And Systems
      • Surface attributes
      • System methods and state
      • Glass catalogs
    • Classes and Attributes
      • Table 1 — surf class attributes
      • Table 2 — system class implementations and attributes
    • Working with the KrakenOS Library
      • 3.1 Ray generation
      • 3.2 Extraction of ray information
      • 3.3 Generation of the optical system graph
        • Raykeeper introspection
    • Parax Tool
    • PupilCalc Tool
      • Pupil parameters
      • Automatic ray generation
      • 5.1 Atmospheric refraction in PupilCalc
    • Editable Table Workflow
      • Loading versus inserting
      • Insertion point
      • Surface and element clipboard
      • Surface right-click menu
      • Compact prescription columns
      • Optimization cell marker
      • Tolerance Monte Carlo report
      • Prisms and cube beam splitters
      • Tilt and decenter tolerance overlays
      • Validation
    • Non-Sequential-First Design Goals
      • Goal 1: non-sequential tracing is the native model
      • Goal 2: 3D tracing is authoritative; 2D is only a slice
      • Goal 3: object and illumination source are separate scene entities
      • Goal 4: every surface interaction obeys physics law
      • Implementation checklist
    • Tracing And Ray Data
      • Scene-first UI model
      • 2D slices, 3D scenes, and CAD envelopes
      • Sequential tracing special case
      • Non-sequential tracing
      • Scene source records
      • Launch sampling metadata
      • Scene target records
      • Possible next scene workflows
      • Optical STL prism check
      • Face-role metadata check
      • Face-anchor snap-to-ray check
      • Face-fit placement check
      • Path-frame face-fit check
      • Virtual internal plane check
      • Optical-solid hit-sequence check
      • Raykeeper data
      • Inspect Ray / Surface Physics
      • Multicore and batch tracing
    • Zemax Rayfile Sources
      • Import workflow
      • Ray sampling
      • Example saved layout source record
      • Validation
      • Current limitations
      • Beam-splitter imaging example
    • Pupil, Paraxial, And Analysis Tools
      • Paraxial tool
      • PupilCalc
      • Atmospheric refraction
      • Wavefront and aberration tools
        • Zemax Wavefront Map comparison
      • Image-quality maps
    • Gaussian Beam Propagation
      • Input conventions
      • Datasheet diameter/divergence flow
      • Report columns
      • Astigmatic and elliptical beams
      • Phase 8 branch-field propagation
      • Phase 8B oblique astigmatic q baseline
      • Cavity eigenmode flow
      • UI workflow
      • Folded laser scanner example
      • Python example
      • Scope and limitations
      • Source-mode field relevance
    • Beam Splitters
      • Terminology
      • Current capability
      • Split modes
      • UI workflow
      • Path workflow tutorial
      • Two-path doublet example
      • Manual path assignment
      • Path Workbench workflow
      • Separate source and object status
        • Right-angle illumination example
      • Michelson detector/interferogram workflow
      • Twyman-Green example
      • Mach-Zehnder example
      • Automatic path graph
      • Saved metadata
      • Python example
      • Internal branch data
      • Path throughput report
      • Path-filtered detector analyses
        • Concrete DetMap examples
        • Path-analysis validation fixture
      • Phase 2 source and path workflow
      • Future tilted/folded/non-sequential Gaussian optics
    • Diffuse And BRDF Scattering
      • Surface Type
      • Guided Target Sampling
      • Examples
      • pySCATMECH Optional Backend
    • Lens Fabrication Drawings
      • Surface Property Workflow
      • Supported Fields
      • Example In A Layout File
      • Reference Behaviour
    • Display And Viewers
      • 2D display
        • Lens drawing PDF export
      • 3D display
      • CAD/STL optical solids
        • Placement workflow
      • STEP and CAD overlays
    • Handling the 3D Viewer
    • Manual Example Inventory
    • Appendix — Examples
      • 7.1 Example — Ray
      • 7.2 Example — Perfect Lens
      • 7.3 Example — Doublet Lens 3D Color
      • 7.4 Example — Doublet Lens Tilt
      • 7.5 Example — Doublet Lens (Paraxial Calculations)
      • 7.6 Example — Doublet Lens Tilt Nulls
      • 7.7 Example — Doublet Lens NonSec
      • 7.8 Example — Doublet Lens Zernike
      • 7.9 Example — Doublet Lens Tilt NonSec
      • 7.10 Example — Doublet Lens Pupil
      • 7.11 Example — Doublet Lens Commands System
      • 7.12 Example — Doublet Lens Pupil + Seidel
      • 7.13 Example — Doublet Lens Cylinder
      • 7.14 Example — Axicon
      • 7.15 Example — Axicon and Cylinder
      • 7.16 Example — Flat Mirror 45 Deg
      • 7.17 Example — Parabolic Mirror Shift
      • 7.18 Example — Diffraction Grating in Transmission
      • 7.19 Example — Diffraction Grating in Reflection
      • 7.20 Example — Tel 2M Spyder Spot Diagram
      • 7.21 Example — Tel 2M Spyder Spot, M2 Tilt
      • 7.22 Example — Tel 2M Pupila
      • 7.23 Example — Tel 2M Error Map
      • 7.24 Example — Tel 2M Wavefront Fitting
      • 7.25 Example — Tel 2M STL Image Slicer
      • 7.26 Example — Tel 2M Atmospheric-Refraction Corrector
      • 7.27 Example — ExtraShape Micro Lens Array
      • 7.28 Example — ExtraShape Radial Sine
      • 7.29 Example — ExtraShape XY Cosines
      • 7.30 Example — MultiCore
      • 7.31 Example — Solid Objects STL Array
      • 7.32 Example — Source Distribution Function
    • References

Tutorials

  • Tutorials And Case Studies
    • Case Study 1: Turn A Glass Plate Into A 100 mm PCX Lens
      • Goal
      • Build The Starting Plate
      • Make The Front Surface Variable
      • Set The EFFL Target
      • Place The Image Plane Correctly
        • Workflow A: solve image distance after EFFL
        • Workflow B: optimize EFFL and focus together
      • What The User Should See
      • Common Mistakes
    • Case Study 2: Focus A Finite Machine-Vision Lens
      • Goal
      • Load The Finite Lens
      • Make A Bad First Analysis
      • Choose The Right Variable
      • Run The Focus Solve
        • Workflow A: best-focus solve
        • Workflow B: general optimizer
      • Verify The Improvement
      • Check The Wide Field
      • What This Proves
      • Common Mistakes
    • Case Study 3: Gaussian Laser Beam Expander
      • Goal
      • Load The Laser Line
      • Back-Calculated Waist
      • Insert A 3x Keplerian Expander
      • Verify The Expanded Beam
      • Run BField Analysis
      • What This Proves
      • Common Mistakes
    • Case Study 4: Michelson Beam Splitter And Interferogram
      • Goal
      • Load The Michelson Layout
      • Read The Path Labels
      • Use Path View
      • Run Detector Analyses
      • Show The Interferogram
      • Run Branch Field
      • What This Proves
      • Common Mistakes
    • Case Study 5: Mach-Zehnder Two-Output Interferometer
      • Goal
      • Load The Mach-Zehnder Layout
      • Read The Path Labels
      • Use Path View For Each Output
      • Run Detector Analyses
      • Show The Interferogram
      • Run Branch Field
      • Check The Return Output
      • What This Proves
      • Common Mistakes
    • Case Study 6: Source/Object Split Through A Beam Splitter
      • Goal
      • Load The Layout
      • Read The Physical Paths
      • Use Path View
      • Audit Source Illumination
      • Run The Camera Detector Map
      • Run The Python Example
      • What This Proves
      • Common Mistakes
    • Case Study 7: Zemax LED Source To Diffuse Object Imaging
      • Goal
      • Load The Layout
      • Read The Scatter Paths
      • Use Path View
      • Inspect Diffuse / BRDF Settings
      • Audit Source Illumination
      • Run Image-Plane Analyses
      • Run The Python Example
      • What This Proves
      • Common Mistakes
    • Case Study 8: Multi-Source Illumination
      • Goal
      • Load The Layout
      • Read The Layout
      • Inspect Scene Sources
      • Audit Per-Source Throughput
      • Run Detector Analyses
      • Run The Python Example
      • What This Proves
      • Common Mistakes
    • Case Study 9: Tolerance Monte Carlo And Compensators
      • Goal
      • Load The Native-Variable Layout
      • Choose Tolerance Roles
      • Run Monte Carlo
      • Compare The Worst Sample
      • Plot The Worst-Sample Spot Overlay
      • Read The Stack-Up Bars
      • Run Compensator Sweeps
      • Check MTF Impact
      • Run The Python Example
      • What This Proves
      • Common Mistakes
    • Case Study 10: Optical STL Prism And Face Roles
      • Goal
      • Load The Optical STL Prism
      • Read The 2D Trace
      • Assign Optical Faces
      • Inspect Mesh Readiness
      • Verify The Trace Sequence
      • Run The Python Examples And Validators
      • What This Proves
      • Common Mistakes
    • Case Study 11: Cube Beam Splitter CAD And Virtual Plane
      • Goal
      • Load Or Import The Cube Body
      • Observe The Passive CAD Trace
      • Assign External Faces And Build A Virtual Plane
      • Read The Virtual Plane Report
      • Use The Primitive For Splitter Physics Today
      • Check Mesh Readiness
      • Run The Validators
      • What This Proves
      • Common Mistakes
    • Case Study 12: Vendor Prism CAD Import And Face Placement
      • Goal
      • Bundled Vendor Files
      • Load The Vendor CAD Prism
      • Set Source Divergence
      • Inspect The Converted Mesh
      • Assign Optical Face Roles
      • Understand Side Labels, Axis Fits, And Optical Functions
        • Examples From penta.py
      • Orient From The Input Face
      • Off-Center Entrance Points
      • Read The Fitted Layout
      • Chain Another Prism After A Folded Path
      • Roll Reference Faces
      • Single-Face Fold Mirrors
      • Run The Validators
      • What This Proves
      • Common Mistakes
    • Case Study 13: Multi-Element Lens PDF Drawing Export
      • Goal
      • Input The Surface Table
      • Input Drawing Properties
      • Export The PDF
      • Run The Validator
      • What This Proves
      • Important Limitation
    • Case Study 14: 3D Hardware Alignment Workflows
      • Goal
      • Open The 3D Inspector
      • Use The CAD/STL Placement Handler
      • Read Active-Mode Badges
      • Rotate Imported STEP Hardware
      • Carry Imported STEP On The Grid
      • Pick Source Targets From 3D
      • What This Proves
      • Common Mistakes
    • Case Study 15: Cooke Triplet Optimization From A Bad Start
      • Goal
      • Load The Poor Triplet
      • Make The Bad Analysis
      • Understand The Variables
      • Apply The Optimized Prescription
      • Verify The Improvement
      • What This Proves
      • Common Mistakes
    • Case Study 16: One Lens, Many Analyses
      • Goal
      • Load The Analysis Layout
      • Spot: Check Geometric Focus
      • PSF: Convert Samples Into Image Intensity
      • MTF: Read Contrast Versus Spatial Frequency
      • Wavefront: Inspect Pupil Phase
      • Zernike: Decompose The Wavefront
      • What This Proves
    • Case Study 17: Galvo F-Theta Laser Scanner
      • Goal
      • Load The Preset
      • Read The Rows
      • Use The Galvo Scan Overlay
      • Check The Scan Plane
      • Validate The F-Theta Lens Alone
      • Why This Is Non-Sequential-First
      • Common Checks
      • What This Proves
    • Optiland-Inspired Case Study Port Backlog
      • Purpose
      • Already Covered In Current KrakenOS UI Docs
      • High-Value Ports
      • Deferred Or Research-Oriented Ports
      • Recommended Next Port

Knowledge Base

  • Knowledge Base
    • Sub-Pixel Hot-Spot Detection in IR Imaging
      • The mixing model
      • A worked numerical example
      • Why visible-light imaging cannot pull this trick
      • The PSF assist
      • What can break the claim
      • Bottom line: detection vs. characterization
KrakenOS
  • Search

© Copyright 2026, KrakenOS contributors.

Built with Sphinx using a theme provided by Read the Docs.