DynamicSurfaceAberration

class hcipy.optics.DynamicSurfaceAberration(modes, dynamics, refractive_index)[source]

Bases: OpticalElement

A dynamic surface aberration using state space dynamics.

This class models time-varying surface aberrations using a continuous-time state space model. It wraps a StateSpaceDynamics object and applies phase modulation to wavefronts based on the current state.

Parameters:
modesModeBasis

Spatial modes defining the surface aberration pattern. These represent surface height in meters.

dynamicsStateSpaceDynamics

The state space dynamics object that provides time-varying coefficients.

refractive_indexfloat or callable

Refractive index of the medium. Can be a constant (float) or a callable that takes wavelength and returns refractive index.

Attributes:
modesModeBasis

Spatial modes defining the surface aberration pattern.

dynamicsStateSpaceDynamics

The underlying state space dynamics object.

Attributes Summary

coefficients

Current mode coefficients (y = C @ x).

state

Current internal state vector.

surface_sag

The current surface sag in meters.

t

Current simulation time.

Methods Summary

backward(wavefront)

Propagate wavefront backward through the aberration.

evolve_until(t)

Evolve the state from current time to time t.

forward(wavefront)

Propagate wavefront forward through the aberration.

Attributes Documentation

coefficients

Current mode coefficients (y = C @ x).

state

Current internal state vector.

surface_sag

The current surface sag in meters.

t

Current simulation time.

Methods Documentation

backward(wavefront)[source]

Propagate wavefront backward through the aberration.

Applies inverse phase modulation based on the current state and modes.

Parameters:
wavefrontWavefront

Input wavefront.

Returns:
Wavefront

Modulated wavefront with inverse phase.

evolve_until(t)[source]

Evolve the state from current time to time t.

Parameters:
tfloat

Target time to evolve to.

forward(wavefront)[source]

Propagate wavefront forward through the aberration.

Applies phase modulation based on the current state and modes.

Parameters:
wavefrontWavefront

Input wavefront.

Returns:
Wavefront

Modulated wavefront with applied phase.