StokesVector class

class pySCATMECH.mueller.StokesVector(*x)

Bases: ndarray

A class for handling Stokes vectors

Parameters:

x (4-element list or array of float or int, optional) – Default is zero Stokes vector

DOCP()

Return the degree of circular polarization.

Returns:

DOCP – The degree of circular polarization

Return type:

float

DOLP()

Return the degree of linear polarization.

Returns:

DOLP – The degree of linear polarization

Return type:

float

DOP()

Return the degree of polarization.

Returns:

DOP – The degree of polarization

Return type:

float

JonesVector()

Return a Jones vector associated with the polarized part of the Stokes vector.

Returns:

j – A Jones vector that, if converted to a Stokes vector, yields the polarized part of the Stokes vector.

Return type:

2 element np.array

delta()

Return the phase difference between the two components.

Returns:

delta – The phase difference between the two components (s and p) in radians. Uses the polarized part of the Stokes vector.

Return type:

float

eccentricity()

Return the eccentricity.

Returns:

eccentricity – The eccentricity

Return type:

float

ellipticity()

Return the ellipticity of the field (ratio of minor to major axes).

Returns:

e – The ellipticity of the field (ratio of the minor to major axes of the polarization ellipse.

Return type:

float

eta()

Return the principal angle of the polarization ellipse

Returns:

eta – The principal angle of the polarization ellipse

Return type:

float

intensity()

Return the intensity.

Returns:

I – The intensity

Return type:

float

normalized()

Return normalized Stokes vector.

Returns:

s – The Stokes vector normalized so that its 0 element is 1.

Return type:

StokesVector

pol_part()

Return the polarized part of the Stokes vector.

Returns:

s – The polarized part of the Stokes vector.

Return type:

StokesVector

psi()

Return arc tangent of the amplitude ratio between the two components.

Returns:

psi – The arc tangent in radians of the ratio between the two components of the polarized part of the light. The returned value is zero for p-polarized light.

Return type:

float

rotate(angle)

Return a Stokes vector rotated by an angle.

Parameters:

angle (float) – Angle to rotate the Stokes vector in radians

Returns:

rot – Stokes vector rotated by angle

Return type:

StokesVector

unpol_part()

Return the unpolarized part of the Stokes vector.

Returns:

s – The unpolarized part of the Stokes vector.

Return type:

StokesVector

valid()

Checks if the Stokes vector is valid.

Returns:

valid – True if the Stokes vector is valid.

Return type:

bool