Wavefront

class hcipy.optics.Wavefront(electric_field, wavelength=1, input_stokes_vector=None)

Bases: object

A physical wavefront in an optical system.

This represents the state of light to be propagated through the optical system. It can be both an electric field in the scalar approximation (ie. scalar wavefront propgation), a fully polarized wavefront, represented by a Field of Jones vectors, and a potentially partially-polarized wavefront, represented by two Jones vector fields and the Stokes vector corresponding to the Jones vectors (1,0) and (0,1).

Parameters

electric_fieldField: The electric field, either scalar, vectorial or 2-tensorial.
wavelengthscalar: The wavelength of the wavefront.
input_stokes_vectorndarray or None: If a Stokes vector (I, Q, U, V) is given, a partially-polarized wavefront is initialized. If electric_field is scalar, it will be transformed into a tensor field with the correct Jones states. If a tensor-field is given as the electric_field, the electric field will be interpreted as the Jones matrix modifying the input Stokes vector.

Raises

ValueError: When a Stokes vector is supplied but a vector field is given as electric field, or when an input Stokes vector is not supplied, but a 2-tensor field is given as electric field.

Attributes Summary

`I`	The I-component of the Stokes vector as function of 2D position in the plane.
`Q`	The Q-component of the Stokes vector as function of 2D position in the plane.
`U`	The U-component of the Stokes vector as function of 2D position in the plane.
`V`	The V-component of the Stokes vector as function of 2D position in the plane.
`amplitude`	The amplitude of the wavefront as function of 2D position on the plane.
`angle_of_linear_polarization`	The angle of linear polarization.
`degree_of_circular_polarization`	The degree of circular polarization.
`degree_of_linear_polarization`	The degree of linear polarization.
`degree_of_polarization`	The degree of polarization.
`electric_field`	The electric field as function of 2D position on the plane.
`ellipticity`	The ratio of the minor to major axis of the electric field polarization ellipse.
`grid`	The grid on which the electric field is defined.
`imag`	The imaginary part of the wavefront as function of 2D position on the plane.
`input_stokes_vector`	The Stokes vector corresponding to the Jones vectors (1,0) and (0,1).
`intensity`	The total intensity of the wavefront as function of 2D position on the plane.
`is_partially_polarized`	If the wavefront can be partially polarized.
`is_polarized`	If the wavefront can be polarized.
`is_scalar`	If the wavefront uses the scalar approximation.
`phase`	The phase of the wavefront as function of 2D position on the plane.
`power`	The power of each pixel in the wavefront.
`real`	The real part of the wavefront as function of 2D position on the plane.
`stokes_vector`	The Stokes vector.
`total_power`	The total power in this wavefront.
`wavenumber`	The wavenumber of the light.

Methods Summary

copy()

Make a copy of the wavefront.

Attributes Documentation

I: The I-component of the Stokes vector as function of 2D position in the plane.

Q: The Q-component of the Stokes vector as function of 2D position in the plane.

U: The U-component of the Stokes vector as function of 2D position in the plane.

V: The V-component of the Stokes vector as function of 2D position in the plane.

amplitude: The amplitude of the wavefront as function of 2D position on the plane.

angle_of_linear_polarization: The angle of linear polarization.

degree_of_circular_polarization: The degree of circular polarization.

degree_of_linear_polarization: The degree of linear polarization.

degree_of_polarization: The degree of polarization.

electric_field: The electric field as function of 2D position on the plane.

ellipticity: The ratio of the minor to major axis of the electric field polarization ellipse.

grid: The grid on which the electric field is defined.

imag: The imaginary part of the wavefront as function of 2D position on the plane.

input_stokes_vector: The Stokes vector corresponding to the Jones vectors (1,0) and (0,1).

intensity: The total intensity of the wavefront as function of 2D position on the plane.

is_partially_polarized: If the wavefront can be partially polarized.

is_polarized: If the wavefront can be polarized.

is_scalar: If the wavefront uses the scalar approximation.

phase: The phase of the wavefront as function of 2D position on the plane.

power: The power of each pixel in the wavefront.

real: The real part of the wavefront as function of 2D position on the plane.

stokes_vector: The Stokes vector.

total_power: The total power in this wavefront.

wavenumber: The wavenumber of the light.

Methods Documentation

copy(): Make a copy of the wavefront.