Other polarization operations¶
- pySCATMECH.mueller.HermitianToMueller(h)¶
Convert a Hermitian coherency matrix to its equivalent Mueller matrix.
- Parameters:
h (ndarray((4,4),complex)) – A Hermitian coherency matrix
- Returns:
m – The Mueller matrix form of the coherency matrix.
- Return type:
- pySCATMECH.mueller.JonesDiattenuator(diatten=None, angle=0, DOCP=None, jones=None)¶
Return the Jones matrix for a homogeneous diattenuator with a given phase and axes.
- Parameters:
angle (float) – Angle (in radians) of axis (default is 0)
DOCP (float) – Degree of circular polarization of the axis. Cannot define both DOCP and jones.
jones (2-element list of complex) – Jones vector associated with axis Cannot define both DOCP and jones. (Default is [1,0])
- Returns:
jones – Jones matrix diattenuator
- Return type:
2x2 numpy array of complex
- pySCATMECH.mueller.JonesMueller(jones)¶
Convert a Jones matrix to a Mueller matrix
- Parameters:
jones (2x2 list or array of int, float, or complex) – A Jones matrix
- Returns:
mueller – The Mueller matrix associated with jones.
- Return type:
- pySCATMECH.mueller.JonesPolarizer(diatten=None, angle=0, DOCP=None, jones=None)¶
Return the Jones matrix for a homogeneous diattenuator with a given phase and axes.
- Parameters:
angle (float) – Angle (in radians) of axis (default is 0)
DOCP (float) – Degree of circular polarization of the axis. Cannot define both DOCP and jones.
jones (2-element list of complex) – Jones vector associated with axis Cannot define both DOCP and jones. (Default is [1,0])
- Returns:
jones – Jones matrix diattenuator
- Return type:
2x2 numpy array of complex
- pySCATMECH.mueller.JonesRetarder(phase=None, angle=0, DOCP=None, jones=None)¶
Return the Jones matrix for a homogeneous retarder with a given phase and axes.
- Parameters:
angle (float) – Angle (in radians) of axis (default is 0)
DOCP (float) – Degree of circular polarization of the axis. Cannot define both DOCP and jones.
jones (2-element list of complex) – Jones vector associated with axis Cannot define both DOCP and jones. (Default is [1,0])
- Returns:
jones – Jones matrix retarder
- Return type:
2x2 numpy array of complex
- pySCATMECH.mueller.JonesRotator(angle)¶
Return a Jones matrix that rotates the polarization by angle”
- Parameters:
angle (float) – Angle that matrix will rotate in radians
- Returns:
R – The rotation matrix
- Return type:
2x2 np.array
- pySCATMECH.mueller.JonesStokes(jones)¶
Convert a Jones vector to a Stokes vector
- Parameters:
jones (2 element list or array of int, float, or complex) –
- pySCATMECH.mueller.JonesUnit()¶
Return a unit Jones matrix
- pySCATMECH.mueller.JonesZero()¶
Return a zero Jones matrix
- pySCATMECH.mueller.MuellerDiagonal(a)¶
Return a diagonal Mueller matrix
- Parameters:
a (4 element list or array of float) –
- pySCATMECH.mueller.MuellerDiattenuator(diatten=0, angle=0, DOCP=None, jones=None)¶
Return the Mueller matrix for a homogeneous diattenuator with a given phase and axis.
- Parameters:
angle (float) – Angle (in radians) of axis (default is 0)
DOCP (float) – Degree of circular polarization of the axis. Cannot define both DOCP and jones.
jones (2-element list of complex) – Jones vector associated with axis Cannot define both DOCP and jones. (Default is [1,0])
- Return type:
MuellerMatrix diattenuator
- pySCATMECH.mueller.MuellerExp(L)¶
Return matrix exponential.
- Returns:
L – The matrix exponent of M
- Return type:
4x4 np.array
- pySCATMECH.mueller.MuellerPolarizer(diatten=0, angle=0, DOCP=None, jones=None)¶
Return the Mueller matrix for a homogeneous diattenuator with a given phase and axis.
- Parameters:
angle (float) – Angle (in radians) of axis (default is 0)
DOCP (float) – Degree of circular polarization of the axis. Cannot define both DOCP and jones.
jones (2-element list of complex) – Jones vector associated with axis Cannot define both DOCP and jones. (Default is [1,0])
- Return type:
MuellerMatrix diattenuator
- pySCATMECH.mueller.MuellerRetarder(phase=0, angle=0, DOCP=None, jones=None)¶
Return the Mueller matrix for a homogeneous retarder with a given phase and axis.
- Parameters:
angle (float) – Angle (in radians) of axis (default is 0)
DOCP (float) – Degree of circular polarization of the axis. Cannot define both DOCP and jones.
jones (2-element list of complex) – Jones vector associated with axis Cannot define both DOCP and jones. (Default is [1,0])
- Returns:
jones – Jones matrix retarder
- Return type:
2x2 numpy array of complex
- pySCATMECH.mueller.MuellerRotator(angle)¶
Return a Mueller matrix that rotates the polarization by angle”
- Parameters:
angle (float) – Angle that matrix will rotate in radians
- Returns:
R – The rotation matrix
- Return type:
- pySCATMECH.mueller.MuellerToHermitian(m)¶
Convert a Mueller matrix into its equivalent Hermitian coherency matrix.
- Parameters:
m (MuellerMatrix) – The Mueller matrix to be converted.
- Returns:
h – Hermitian coherence matrix
- Return type:
4x4 complext np.array
- pySCATMECH.mueller.MuellerUnit(attenuation=1)¶
Return a unit Mueller matrix
- Parameters:
attenuation (float, optional) – Default is 1
- pySCATMECH.mueller.MuellerZero()¶
Return a zero Mueller matrix
- Returns:
m – Zero matrix
- Return type:
- pySCATMECH.mueller.Polarization(*args, **kwargs)¶
Return a StokesVector with a given name
- Parameters:
args (str or float) –
- Can be any of:
P or p for p-polarization S or s for s-polarization L or l for LCP-polarization R or r for RCP-polarization U or u for unpolarized any float for linear polarization at angle name in radians
state (str) – Any of the aboves strings that can be used in args
I (float, optional) – The intensity. (Default is 1)
DOP (float, optional) – The degree of polarization. (Default is 1)
angle (float, optional) – The principal angle of the polarization. (Default is set by args or state.)
ellipticity (float) – The ellipticity of the polarization
- Returns:
s – The Stokes vector with the given parameters
- Return type:
- pySCATMECH.mueller.Sensitivity(*args, **kwargs)¶
Return a StokesVector with a given name that corresponds to a sensitivity.
- Parameters:
name (str or float) –
- Can be any of:
P or p for p-polarization S or s for s-polarization L or l for LCP-polarization R or r for RCP-polarization U or u for unpolarized any float for linear polarization at angle name
- pySCATMECH.mueller.StokesZero()¶
Return zero Stokes vector