optiland.wavefront.reference_geometry

Reference Geometry Module

This module defines the geometry for the reference surface used in wavefront analysis. It supports both spherical (focal) and planar (afocal) references.

Kramer Harrison, 2026

Classes

PlanarReference(point, normal)	Planar reference geometry (for afocal systems).
ReferenceGeometry()	Abstract base class for reference geometries.
SphericalReference(center, radius)	Spherical reference geometry (for focal systems).

class PlanarReference(point: tuple[float, float, float], normal: tuple[float, float, float])

Planar reference geometry (for afocal systems).

Parameters:

• point – (x, y, z) point on the plane.

• normal – (nx, ny, nz) normal vector of the plane.

path_length(rays: RealRaysT, n_medium: float) → BEArrayT

Calculates optical path length from ray positions to the reference.

Parameters:

• rays – The rays at the image surface (containing x, y, z, L, M, N).

• n_medium – The refractive index of the medium.

Returns:

The optical path length correction.

property radius: float

The radius of the reference geometry (inf for plane).

class ReferenceGeometry

Abstract base class for reference geometries.

abstract path_length(rays: RealRaysT, n_medium: float) → BEArrayT

Calculates optical path length from ray positions to the reference.

Parameters:

• rays – The rays at the image surface (containing x, y, z, L, M, N).

• n_medium – The refractive index of the medium.

Returns:

The optical path length correction.

abstract property radius: float

The radius of the reference geometry (inf for plane).

class SphericalReference(center: tuple[float, float, float], radius: float)

Spherical reference geometry (for focal systems).

Parameters:

• center – (x, y, z) coordinates of the sphere center.

• radius – Radius of the sphere.

path_length(rays: RealRaysT, n_medium: float) → BEArrayT

Calculates optical path length from ray positions to the reference.

Parameters:

• rays – The rays at the image surface (containing x, y, z, L, M, N).

• n_medium – The refractive index of the medium.

Returns:

The optical path length correction.

property radius: float

The radius of the reference geometry (inf for plane).