# doc-cache created by Octave 11.3.0
# name: cache
# type: cell
# rows: 3
# columns: 50
# name: <cell-element>
# type: sq_string
# elements: 1
# length: 5
jones


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 812
 -- Function File: M = jones(M)
 -- Function File: A = jones(M,N,...)
     Multiply Jones matrices and vectors.

        − M,N,... define Jones matrices or vectors.  The function will multiply
          these from left to right and return the result.

     M,N,... can be passed as either numeric matrices/vectors or cell arrays.
     In this case, the multiplication is carried out in a ".*" manner.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 36
Multiply Jones matrices and vectors.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 12
jones_cpleft


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 882
 -- Function File: V = jones_cpleft()
 -- Function File: V = jones_cpleft(P)
     Return the Jones vector for left-turn circular polarized light.

        − P is the amplitude of the electric field, if not given or set to []
          the default value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Jones vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_cpright.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 63
Return the Jones vector for left-turn circular polarized light.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 13
jones_cpright


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 884
 -- Function File: V = jones_cpright()
 -- Function File: V = jones_cpright(P)
     Return the Jones vector for right-turn circular polarized light.

        − P is the amplitude of the electric field, if not given or set to []
          the default value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Jones vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_cpleft.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 64
Return the Jones vector for right-turn circular polarized light.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 15
jones_intensity


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 817
 -- Function File: P = jones_intensity(V)
 -- Function File: [P,Q,...] = jones_intensity(V,W,...)
     Return intensity of light described by Jones vectors.

        − V,W,... define (arrays of) Jones vectors.  The function returns their
          intensity values as numeric arrays P,Q,... of corresponding size.

     V,W,... can be passed as either numeric vectors or cell arrays of Jones
     vectors.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 53
Return intensity of light described by Jones vectors.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 21
jones_lindiattenuator


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1390
 -- Function File: M = jones_lindiattenuator()
 -- Function File: M = jones_lindiattenuator(D)
 -- Function File: M = jones_lindiattenuator(PX,PY)
 -- Function File: M = jones_lindiattenuator(..., MODE)
     Return the Jones matrix for a linear diattenuator at zero rotation.

        − D is the diattenuation of the element, i.e.  ‘d=(px-py)/(px+py)’.
          Reversibly, transmission in y direction is ‘(1-d)/(1+d)’, if
          transmission in x direction is 1.
        − PX is the transmittance in x direction.
        − PY is the transmittance in y direction.
        − MODE is a string defining the interpretation of transmittance values:
          'intensity' (default) or 'amplitude'.

     Arguments D, PX or PY can be passed as a scalar or as a matrix or as a cell
     array.  In the two latter cases, a cell array M of Jones matrices is
     returned.  The size of M is set to the maximum of the parameters' size.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_linpolarizer.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 67
Return the Jones matrix for a linear diattenuator at zero rotation.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 18
jones_linpolarizer


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 963
 -- Function File: JM = jones_linpolarizer()
 -- Function File: A = jones_linpolarizer([M, N, ...])
 -- Function File: A = jones_linpolarizer(C)
     Return the Jones matrix for an ideal linear polarizer.

        − [M, N, ...] defines the size of the cell array A and therefore the
          number of linear polarizer matrices returned.
        − C is a cell array defining the size of the returned cell array A,
          ‘size(A)==size(C)’.  The content of C is of not evaluated in this
          case.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_lindiattenuator.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 54
Return the Jones matrix for an ideal linear polarizer.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 17
jones_linretarder


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1157
 -- Function File: JM = jones_linretarder()
 -- Function File: JM = jones_linretarder(P)
 -- Function File: JM = jones_linretarder(..., MODE)
     Return the Jones matrix for a linear retarder with long axis rotation of 0
     degrees.

        − P is the phase delay in radiant units, i.e.  P is ranging between 0
          and 2*pi().  If not given or set to [] the default value 0 is used.
        − MODE is a string defining the units for the phase delay: 'radiant'
          (default), 'degree' (0..360) or 'wavelength' (0..1).

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array JM of Jones matrices of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: Jones_waveplate.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 80
Return the Jones matrix for a linear retarder with long axis rotation of 0
de...



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 18
jones_lphorizontal


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 898
 -- Function File: V = jones_lphorizontal()
 -- Function File: V = jones_lphorizontal(P)
     Return the Jones vector for horizontal linearly polarized light.

        − P is the amplitude of the electric field, if not given or set to []
          the default value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Jones vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_lpvertical.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 64
Return the Jones vector for horizontal linearly polarized light.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 15
jones_lpminus45


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 900
 -- Function File: V = jones_lpminus45()
 -- Function File: V = jones_lpminus45(P)
     Return the Jones vector for light with linear polarization at -45 degrees.

        − P is the amplitude of the electric field, if not given or set to []
          the default value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Jones vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_lpplus45.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 74
Return the Jones vector for light with linear polarization at -45 degrees.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 14
jones_lpplus45


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 899
 -- Function File: V = jones_lpplus45()
 -- Function File: V = jones_lpplus45(P)
     Return the Jones vector for light with linear polarization at +45 degrees.

        − P is the amplitude of the electric field, if not given or set to []
          the default value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Jones vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_lpminus45.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 74
Return the Jones vector for light with linear polarization at +45 degrees.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 16
jones_lpvertical


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 894
 -- Function File: V = jones_lpvertical()
 -- Function File: V = jones_lpvertical(P)
     Return the Jones vector for vertical linearly polarized light.

        − P is the amplitude of the electric field, if not given or set to []
          the default value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Jones vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_lphorizontal.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 62
Return the Jones vector for vertical linearly polarized light.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 12
jones_mirror


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 945
 -- Function File: JM = jones_mirror()
 -- Function File: JA = jones_mirror([M, N, ...])
 -- Function File: JA = jones_mirror(C)
     Return Jones matrices, representing a non-polarizing optical element.

        − [M, N, ...] defines the size of the cell array JA and therefore the
          number of mirror matrices returned.
        − C is a cell array defining the size of the returned cell array JA,
          ‘size(JA)==size(C)’.  The content of C is of not evaluated in this
          case.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_unity.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 69
Return Jones matrices, representing a non-polarizing optical element.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 12
jones_rotate


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1265
 -- Function File: JM = jones_rotate()
 -- Function File: JM = jones_rotate(M, P)
 -- Function File: JM = jones_rotate(..., MODE)
     Return the Jones matrix for rotated Jones elements.

        − M is the Jones matrix for the unrotated elements.  Default value is
          the Jones unity matrix.
        − P is the rotation angle, default value is 0.
        − MODE is a string defining the interpretation of the angle value:
          'radiants' (default) or 'degree'.

     Argument M can be passed as numeric matrix or as a cell array.  Argument P
     can be passed as a numeric scalar or as a cell array.  In the case of at
     least one cell array provided, a cell array M of Jones matrices is
     returned.  The size of M in each dimension is set to the maximum of the
     size of the passed cell arrays.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_rotator.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 51
Return the Jones matrix for rotated Jones elements.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 13
jones_rotator


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1039
 -- Function File: JM = jones_rotator()
 -- Function File: JM = jones_rotator(P)
 -- Function File: JM = jones_rotator(..., MODE)
     Return the Jones matrix for a system rotator.

        − P is the rotation angle, ranging from 0 to 2*pi, if not given or set
          to [] the default value 0 is used.
        − MODE is a string defining the units for the angle: 'radiant' (default)
          or 'degree' (0..360)

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array JM of Jones matrices of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_rotate.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 45
Return the Jones matrix for a system rotator.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 11
jones_unity


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 948
 -- Function File: JM = jones_unity()
 -- Function File: JA = jones_unity([M, N, ...])
 -- Function File: JA = jones_unity(C)
     Return unity Jones matrices, representing a non-polarizing optical element.

        − [M, N, ...] defines the size of the cell array JA and therefore the
          number of unity matrices returned.
        − C is a cell array defining the size of the returned cell array JA,
          ‘size(JA)==size(C)’.  The content of C is of not evaluated in this
          case.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 13, 2014.

     See also: jones_mirror.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 75
Return unity Jones matrices, representing a non-polarizing optical element.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 15
jones_waveplate


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 990
 -- Function File: JM = jones_waveplate ()
 -- Function File: JM = jones_waveplate (P)
     Return the Jones matrix for a linear wave plate with a phase delay given in
     wavelength units and long axis rotation of 0 degrees.

        − P is the phase delay in wavelength units, ranging from 0 to 1; if not
          given or set to [] the default value 0 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array JM of Jones matrices of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Jones calculus" (http://en.wikipedia.org/wiki/Jones_calculus), last
          retrieved on Jan 14, 2013.

     See also: jones_linretarder.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 80
Return the Jones matrix for a linear wave plate with a phase delay given in
w...



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 16
mueller_absorber


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 928
 -- Function File: M = mueller_absorber()
 -- Function File: M = mueller_absorber(P)
     Return Mueller matrices for a (partial) absorber.

        − P is the relative absorbance, ranging from 0 to 1, if not given or set
          to [] the default value 0 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array M of Mueller matrices of the same size
     is returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_lindiattenuator, mueller_circdiattenuator.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 49
Return Mueller matrices for a (partial) absorber.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 20
mueller_checkmueller


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1086
 -- Function File: T = mueller_checkmueller(M)
 -- Function File: [T,U,...] = mueller_checkmueller(M,N,...)
     Check physical validity of Mueller matrix or matrices.

        − M,N,... define potential (arrays of) Mueller matrices.  After checking
          the parameters for validity, the function returns boolean arrays
          T,U,... of corresponding size.

     M,N,... can be passed as either numeric matrices or cell arrays of
     potential Mueller matrices.

     Note that this function checks the physical integrity of the given
     matrices; to check the computational form only, use mueller_ismueller()
     instead.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_ismueller.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 54
Check physical validity of Mueller matrix or matrices.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 24
mueller_circdiattenuator


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1433
 -- Function File: M = mueller_circdiattenuator()
 -- Function File: M = mueller_circdiattenuator(D)
 -- Function File: M = mueller_circdiattenuator(PL,PR)
 -- Function File: M = mueller_circdiattenuator(..., MODE)
     Return the Mueller matrix for a linear diattenuator at zero rotation.

        − D is the diattenuation of the element, i.e.  ‘d=(px-py)/(px+py)’.
          Reversibly, transmission in y direction is ‘(1-d)/(1+d)’, if
          transmission in x direction is 1.
        − PL is the transmittance in x direction.
        − PR is the transmittance in y direction.
        − MODE is a string defining the interpretation of transmittance values:
          'intensity' (default) or 'amplitude'.

     Arguments D, PL or PR can be passed as a scalar or as a matrix or as a cell
     array.  In the two latter cases, a cell array M of Mueller matrices is
     returned.  The size of M is set to the maximum of the parameters' size.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_lindiattenuator, mueller_absorber.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 69
Return the Mueller matrix for a linear diattenuator at zero rotation.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 20
mueller_circretarder


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1161
 -- Function File: M = mueller_circretarder()
 -- Function File: M = mueller_circretarder(P)
 -- Function File: M = mueller_circretarder(..., MODE)
     Return the Mueller matrix for a circular retarder element.

        − P is the phase delay in radiant units, i.e.  P is ranging between 0
          and 2*pi().  If not given or set to [] the default value 0 is used.
        − MODE is a string defining the units for the phase delay: 'radiant'
          (default), 'degree' (0..360) or 'wavelength' (0..1).

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array M of Mueller matrices of the same size
     is returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_waveplate, mueller_linretarder.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 58
Return the Mueller matrix for a circular retarder element.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 19
mueller_depolarizer


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 903
 -- Function File: M = mueller_depolarizer()
 -- Function File: M = mueller_depolarizer(P)
     Return Mueller matrices for a (partial) depolarizer.

        − P is the depolarization, ranging from 0 to 1, if not given or set to
          [] the default value 0 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array M of Mueller matrices of the same size
     is returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_linpolarizer.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 52
Return Mueller matrices for a (partial) depolarizer.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 41
mueller_homogeneous_elliptic_diattenuator


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1699
 -- Function File: M = mueller_homogeneous_elliptic_diattenuator()
 -- Function File: M = mueller_homogeneous_elliptic_diattenuator(T0, D, AZIMUTH,
          ELLIPTICITY)
 -- Function File: M = mueller_homogeneous_elliptic_diattenuator(...,
          AZIMUTHMODE)
     Return the Mueller matrix for a homogeneous elliptic diattenuator (see
     references).

        − T0 is the total transmission (default: 1).
        − D is the diattenuation value (default: 0).
        − AZIMUTH and ELLIPTICITY (default: 0) describe the two orthogonal
          polarization eigenstates.
        − AZIMUTHMODE is a string defining the interpretation of the azimuth
          angle: 'radiants' (default) or 'degree'.

     Arguments T0, D, AZIMUTH, or ELLIPTICITY can be passed as a scalar or as a
     matrix or as a cell array.  In the two latter cases, a cell array M of
     Mueller matrices is returned.  The size of M is given by
     ‘max(size(t0),size(d),size(azimuth),size(ellipticity))’ and elements of
     smaller matrices of T0, D, AZIMUTH or ELLIPTICITY are used in a loop-over
     manner.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.
       4. Boulvert et al., "Decomposition algorithm of an experimental Mueller
          matrix", Opt.Comm.  282(2009):692-704

     See also: mueller_homogeneous_elliptic_retarder.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 80
Return the Mueller matrix for a homogeneous elliptic diattenuator (see
refere...



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 37
mueller_homogeneous_elliptic_retarder


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1941
 -- Function File: M = mueller_homogeneous_elliptic_retarder()
 -- Function File: M = mueller_homogeneous_elliptic_retarder(T0, DELAY, AZIMUTH,
          ELLIPTICITY)
 -- Function File: M = mueller_homogeneous_elliptic_retarder(..., DELAYMODE)
 -- Function File: M = mueller_homogeneous_elliptic_retarder(..., DELAYMODE,
          AZIMUTHMODE)
     Return the Mueller matrix for a homogeneous elliptic retarder (see
     references).

        − T0 is the total transmission (default: 1).
        − DELAY is the retardation delay (default: 0).
        − AZIMUTH and ELLIPTICITY (default: 0) describe the two orthogonal
          polarization eigenstates.
        − DELAYMODE is a string defining the interpretation of the retardation
          delay: 'radiants' (default) or 'degree' or 'wavelength'.
        − AZIMUTHMODE is a string defining the interpretation of the azimuth
          angle: 'radiants' (default) or 'degree'.

     Arguments T0, DELAY, AZIMUTH, or ELLIPTICITY can be passed as a scalar or
     as a matrix or as a cell array.  In the two latter cases, a cell array M of
     Mueller matrices is returned.  The size of M is given by
     ‘max(size(t0),size(delay),size(azimuth),size(ellipticity))’ and elements of
     smaller matrices of T0, DELAY, AZIMUTH or ELLIPTICITY are used in a
     loop-over manner.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.
       4. Boulvert et al., "Decomposition algorithm of an experimental Mueller
          matrix", Opt.Comm.  282(2009):692-704

     See also: mueller_homogeneous_elliptic_diattenuator.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 79
Return the Mueller matrix for a homogeneous elliptic retarder (see references).



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 17
mueller_ismueller


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1070
 -- Function File: T = mueller_ismueller(M)
 -- Function File: [T,U,...] = mueller_ismueller(M,N,...)
     Check computational validity of Mueller matrix or matrices.

        − M,N,... define potential (arrays of) Mueller matrices.  After checking
          the parameters for validity, the function returns boolean arrays
          T,U,... of corresponding size.

     M,N,... can be passed as either numeric matrices or cell arrays of
     potential Mueller matrices.

     Note that this function does not check the physical integrity of the given
     matrices; to check that use mueller_checkmueller() instead.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_checkmueller.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 59
Check computational validity of Mueller matrix or matrices.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 23
mueller_lindiattenuator


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1430
 -- Function File: M = mueller_lindiattenuator()
 -- Function File: M = mueller_lindiattenuator(D)
 -- Function File: M = mueller_lindiattenuator(PX,PY)
 -- Function File: M = mueller_lindiattenuator(..., MODE)
     Return the Mueller matrix for a linear diattenuator at zero rotation.

        − D is the diattenuation of the element, i.e.  ‘d=(px-py)/(px+py)’.
          Reversibly, transmission in y direction is ‘(1-d)/(1+d)’, if
          transmission in x direction is 1.
        − PX is the transmittance in x direction.
        − PY is the transmittance in y direction.
        − MODE is a string defining the interpretation of transmittance values:
          'intensity' (default) or 'amplitude'.

     Arguments D, PX or PY can be passed as a scalar or as a matrix or as a cell
     array.  In the two latter cases, a cell array M of Mueller matrices is
     returned.  The size of M is set to the maximum of the parameters' size.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_circdiattenuator, mueller_absorber.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 69
Return the Mueller matrix for a linear diattenuator at zero rotation.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 20
mueller_linpolarizer


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 972
 -- Function File: M = mueller_linpolarizer()
 -- Function File: A = mueller_linpolarizer([M, N, ...])
 -- Function File: A = mueller_linpolarizer(C)
     Return the Mueller matrix for an ideal linear polarizer.

        − [M, N, ...] defines the size of the cell array A and therefore the
          number of linear polarizer matrices returned.
        − C is a cell array defining the size of the returned cell array A,
          ‘size(A)==size(C)’.  The content of C is of not evaluated in this
          case.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_depolarizer.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 56
Return the Mueller matrix for an ideal linear polarizer.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 19
mueller_linretarder


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1191
 -- Function File: M = mueller_linretarder()
 -- Function File: M = mueller_linretarder(P)
 -- Function File: M = mueller_linretarder(..., MODE)
     Return the Mueller matrix for a linear retarder with long axis rotation of
     0 degrees.

        − P is the phase delay in radiant units, i.e.  P is ranging between 0
          and 2*pi().  If not given or set to [] the default value 0 is used.
        − MODE is a string defining the units for the phase delay: 'radiant'
          (default), 'degree' (0..360) or 'wavelength' (0..1).

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array M of Mueller matrices of the same size
     is returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_waveplate, mueller_circretarder.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 80
Return the Mueller matrix for a linear retarder with long axis rotation of 0
...



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 14
mueller_mirror


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 965
 -- Function File: M = mueller_mirror()
 -- Function File: A = mueller_mirror([M, N, ...])
 -- Function File: A = mueller_mirror(C)
     Return mirror Mueller matrices, representing a non-polarizing optical
     element.

        − [M, N, ...] defines the size of the cell array A and therefore the
          number of mirror matrices returned.
        − C is a cell array defining the size of the returned cell array A,
          ‘size(A)==size(C)’.  The content of C is of not evaluated in this
          case.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_unity.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 78
Return mirror Mueller matrices, representing a non-polarizing optical element.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 14
mueller_rotate


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1284
 -- Function File: M = mueller_rotate()
 -- Function File: M = mueller_rotate(M, P)
 -- Function File: M = mueller_rotate(..., MODE)
     Return the Mueller matrix for rotated Mueller elements.

        − M is the Mueller matrix for the unrotated elements.  Default value is
          the Mueller unity matrix.
        − P is the rotation angle, default value is 0.
        − MODE is a string defining the interpretation of the angle value:
          'radiants' (default) or 'degree'.

     Argument M can be passed as numeric matrix or as a cell array.  Argument P
     can be passed as a numeric scalar or as a cell array.  In the case of at
     least one cell array provided, a cell array M of Mueller matrices is
     returned.  The size of M in each dimension is set to the maximum of the
     size of the passed cell arrays.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_rotator.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 55
Return the Mueller matrix for rotated Mueller elements.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 15
mueller_rotator


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1051
 -- Function File: M = mueller_rotator()
 -- Function File: M = mueller_rotator(P)
 -- Function File: M = mueller_rotator(..., MODE)
     Return the Mueller matrix for a system rotator.

        − P is the rotation angle, ranging from 0 to 2*pi, if not given or set
          to [] the default value 0 is used.
        − MODE is a string defining the units for the angle: 'radiant' (default)
          or 'degree' (0..360)

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array M of Mueller matrices of the same size
     is returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_rotate.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 47
Return the Mueller matrix for a system rotator.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 14
mueller_stokes


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 890
 -- Function File: M = mueller_stokes(M)
 -- Function File: A = mueller_stokes(M,N,...)
     Multiply Mueller matrices and Stokes vectors.

        − M,N,... define Mueller matrices or Stokes vectors.  The function will
          multiply these from left to right and return the result.

     M,N,... can be passed as either numeric matrices/vectors or cell arrays.
     In this case, the multiplication is carried out in a ".*" manner.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_checkmueller.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 45
Multiply Mueller matrices and Stokes vectors.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 13
mueller_unity


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 961
 -- Function File: M = mueller_unity()
 -- Function File: A = mueller_unity([M, N, ...])
 -- Function File: A = mueller_unity(C)
     Return unity Mueller matrices, representing a non-polarizing optical
     element.

        − [M, N, ...] defines the size of the cell array A and therefore the
          number of unity matrices returned.
        − C is a cell array defining the size of the returned cell array A,
          ‘size(A)==size(C)’.  The content of C is of not evaluated in this
          case.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_mirror.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 77
Return unity Mueller matrices, representing a non-polarizing optical element.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 17
mueller_waveplate


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1021
 -- Function File: M = mueller_waveplate()
 -- Function File: M = mueller_waveplate(P)
     Return the Mueller matrix for a linear wave plate with a phase delay given
     in wavelength units and long axis rotation of 0 degrees.

        − P is the phase delay in wavelength units, ranging from 0 to 1; if not
          given or set to [] the default value 0 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array M of Mueller matrices of the same size
     is returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Mueller calculus" (http://en.wikipedia.org/wiki/Mueller_calculus),
          last retrieved on Dec 17, 2013.

     See also: mueller_linretarder, mueller_circretarder.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 80
Return the Mueller matrix for a linear wave plate with a phase delay given in...



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 13
stokes_cpleft


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 884
 -- Function File: V = stokes_cpleft()
 -- Function File: V = stokes_cpleft(P)
     Return the Stokes vector for left-turn circular polarized light.

        − P is the intensity of the light, if not given or set to [] the default
          value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Stokes vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Stokes parameters" (http://en.wikipedia.org/wiki/Stokes_parameters),
          last retrieved on Dec 17, 2013.

     See also: stokes_cpright.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 64
Return the Stokes vector for left-turn circular polarized light.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 14
stokes_cpright


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 886
 -- Function File: V = stokes_cpright()
 -- Function File: V = stokes_cpright(P)
     Return the Stokes vector for right-turn circular polarized light.

        − P is the intensity of the light, if not given or set to [] the default
          value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Stokes vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Stokes parameters" (http://en.wikipedia.org/wiki/Stokes_parameters),
          last retrieved on Dec 17, 2013.

     See also: stokes_cpleft.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 65
Return the Stokes vector for right-turn circular polarized light.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 22
stokes_degpolarization


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 931
 -- Function File: P = stokes_degpolarization(V)
 -- Function File: [P,Q,...] = stokes_degpolarization(V,W,...)
     Return degree of polarization of light described by Stokes vectors.

        − V,W,... define (arrays of) Stokes vectors.  The function returns their
          degrees of polarization as numeric arrays P,Q,... of corresponding
          size.

     V,W,... can be passed as either numeric vectors or cell arrays of potential
     Stokes vectors.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Stokes parameters" (http://en.wikipedia.org/wiki/Stokes_parameters),
          last retrieved on Dec 17, 2013.

     See also: stokes_isstokes, stokes_intensity.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 67
Return degree of polarization of light described by Stokes vectors.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 16
stokes_intensity


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 885
 -- Function File: P = stokes_intensity(V)
 -- Function File: [P,Q,...] = stokes_intensity(V,W,...)
     Return intensity of light described by Stokes vectors.

        − V,W,... define (arrays of) Stokes vectors.  The function returns their
          intensity values as numeric arrays P,Q,... of corresponding size.

     V,W,... can be passed as either numeric vectors or cell arrays of Stokes
     vectors.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Stokes parameters" (http://en.wikipedia.org/wiki/Stokes_parameters),
          last retrieved on Dec 17, 2013.

     See also: stokes_isstokes, stokes_degpolarization.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 54
Return intensity of light described by Stokes vectors.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 15
stokes_isstokes


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 921
 -- Function File: T = stokes_isstokes(V)
 -- Function File: [T,U,...] = stokes_isstokes(V,W,...)
     Check validity of Stokes vector or vectors.

        − V,W,... define potential (arrays of) Stokes vectors.  After checking
          the parameters for validity, the function returns boolean arrays
          T,U,... of corresponding size.

     V,W,... can be passed as either numeric vectors or cell arrays of potential
     Stokes vectors.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Stokes parameters" (http://en.wikipedia.org/wiki/Stokes_parameters),
          last retrieved on Dec 17, 2013.

     See also: stokes_intensity, stokes_degpolarization.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 43
Check validity of Stokes vector or vectors.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 19
stokes_lphorizontal


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 900
 -- Function File: V = stokes_lphorizontal()
 -- Function File: V = stokes_lphorizontal(P)
     Return the Stokes vector for horizontal linearly polarized light.

        − P is the intensity of the light, if not given or set to [] the default
          value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Stokes vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Stokes parameters" (http://en.wikipedia.org/wiki/Stokes_parameters),
          last retrieved on Dec 17, 2013.

     See also: stokes_lpvertical.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 65
Return the Stokes vector for horizontal linearly polarized light.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 16
stokes_lpminus45


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 902
 -- Function File: V = stokes_lpminus45()
 -- Function File: V = stokes_lpminus45(P)
     Return the Stokes vector for light with linear polarization at -45 degrees.

        − P is the intensity of the light, if not given or set to [] the default
          value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Stokes vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Stokes parameters" (http://en.wikipedia.org/wiki/Stokes_parameters),
          last retrieved on Dec 17, 2013.

     See also: stokes_lpplus45.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 75
Return the Stokes vector for light with linear polarization at -45 degrees.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 15
stokes_lpplus45


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 901
 -- Function File: V = stokes_lpplus45()
 -- Function File: V = stokes_lpplus45(P)
     Return the Stokes vector for light with linear polarization at +45 degrees.

        − P is the intensity of the light, if not given or set to [] the default
          value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Stokes vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Stokes parameters" (http://en.wikipedia.org/wiki/Stokes_parameters),
          last retrieved on Dec 17, 2013.

     See also: stokes_lpminus45.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 75
Return the Stokes vector for light with linear polarization at +45 degrees.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 17
stokes_lpvertical


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 896
 -- Function File: V = stokes_lpvertical()
 -- Function File: V = stokes_lpvertical(P)
     Return the Stokes vector for vertical linearly polarized light.

        − P is the intensity of the light, if not given or set to [] the default
          value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Stokes vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Stokes parameters" (http://en.wikipedia.org/wiki/Stokes_parameters),
          last retrieved on Dec 17, 2013.

     See also: stokes_lphorizontal.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 63
Return the Stokes vector for vertical linearly polarized light.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 18
stokes_unpolarized


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 906
 -- Function File: V = stokes_unpolarized()
 -- Function File: V = stokes_unpolarized(P)
     Return the Stokes vector for unpolarized light.

        − P is the intensity of the light, if not given or set to [] the default
          value 1 is used.

     Argument P can be passed as a scalar or as a matrix or as a cell array.  In
     the two latter cases, a cell array V of Stokes vectors of the same size is
     returned.

     References:

       1. E. Collett, Field Guide to Polarization, SPIE Field Guides vol.  FG05,
          SPIE (2005).  ISBN 0-8194-5868-6.
       2. R. A. Chipman, "Polarimetry," chapter 22 in Handbook of Optics II, 2nd
          Ed, M. Bass, editor in chief (McGraw-Hill, New York, 1995)
       3. "Stokes parameters" (http://en.wikipedia.org/wiki/Stokes_parameters),
          last retrieved on Dec 17, 2013.

     See also: stokes_lphorizontal, stokes_degpolarization.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 47
Return the Stokes vector for unpolarized light.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 14
zernike_R_poly


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 245
 -- Function File: R = zernike_R_poly (M, N)
     Return the first part of the radial zernike polynom R^m_n.

     The polynom returned has a length of N+1.

     See also: zernike_cartesian, zernike_name, zernike_noll_to_nm,
     zernike_polar.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 58
Return the first part of the radial zernike polynom R^m_n.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 17
zernike_cartesian


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 496
 -- Function File: Z = zernike_cartesian (X, Y, N)
 -- Function File: Z = zernike_cartesian (X, Y, N, LIMIT_R)
     Return the cartesian zernikes up to order n (as noll's index).

     If LIMIT_R is false (default true), the polynoms for r>1 are _not_ set to
     NaN because strictly, the polynoms are only defined for 0 <= r <= 1.

     Size of X must be equal size of Y.

     Demo: type "demo zernike_cartesian"

     See also: zernike_name, zernike_noll_to_nm, zernike_polar, zernike_R_poly.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 62
Return the cartesian zernikes up to order n (as noll's index).



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 12
zernike_name


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 370
 -- Function File: NAME = zernike_name (N)
     Return the classic name for noll's index N or "-" (no name defined) without
     warning if N > 21.

     Examples:
          zernike_name(4)
              ⇒ defocus
          zernike_name(21)
              ⇒ vertical pentafoil

     See also: zernike_cartesian, zernike_noll_to_nm, zernike_polar,
     zernike_R_poly.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 80
Return the classic name for noll's index N or "-" (no name defined) without
w...



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 18
zernike_noll_to_mn


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 266
 -- Function File: [M, N] = zernike_noll_to_mn (J)
     Convert Noll's index J to M (Azimuthal degree) and N (Radial degree).

     See sequence A176988 in OEIS (http://oeis.org/A176988)

     See also: zernike_cartesian, zernike_name, zernike_polar, zernike_R_poly.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 69
Convert Noll's index J to M (Azimuthal degree) and N (Radial degree).



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 22
zernike_osa_ansi_to_mn


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 783
 -- [M, N] = zernike_osa_ansi_to_mn (J)
     Convert OSA/ANSI single-index J to double index M (Azimuthal degree) and N
     (Radial degree).

     Example
          [m,n] = zernike_osa_ansi_to_mn(4)
              ⇒ [0, 2]

     References:

       1. Thibos, L.N, Applegate, R.A., Schwiegerling, J.T. & Webb, R.,
          Standards for reporting the optical aberrations of eyes.  Journal of
          refractive surgery , 18 (5), S652-S660 (2002).
       2. OSA/ANSI standard indices of Zernike polynomials
          (https://en.wikipedia.org/wiki/Zernike_polynomials#OSA/ANSI_standard_indices),
          last retrieved on July 2109.

     See also: zernike_noll_to_mn, zernikes_and_derivatives_cartesian_OSA,
     zernike_cartesian, zernike_name, zernike_polar, zernike_R_poly.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 80
Convert OSA/ANSI single-index J to double index M (Azimuthal degree) and N
(R...



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 13
zernike_polar


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 661
 -- Function File: Z = zernike_polar (R, PHI, N)
 -- Function File: Z = zernike_polar (R, PHI, N, LIMIT_R)
     Return the polar zernikes up to order n (as noll's index).

     If LIMIT_R is false (default true), the polynoms for r>1 are _not_ set to
     NaN because strictly, the polynoms are only defined for 0 <= r <= 1.

     The first argument R is a matrix containing the radial distance, the second
     argument PHI a matrix with the angles.

     Size of R must be equal size of PHI.

     This file hasn't a demo yet but have a look on "demo zernike_cartesian"

     See also: zernike_cartesian, zernike_name, zernike_noll_to_nm,
     zernike_R_poly.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 58
Return the polar zernikes up to order n (as noll's index).



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 38
zernikes_and_derivatives_cartesian_OSA


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 2898
 -- [Z, DZX, DZY] = zernikes_and_derivarives_cartesian_OSA (X, Y, N)
 -- [Z, DZX, DZY] = zernikes_and_derivarives_cartesian_OSA (X, Y, N, NAN_ZERO)
     Return the cartesian Zernike's pollynomials and its partial derivatives up
     to radial degree N, i.e.  until Z[N,N]

     X is a matrix with the X coordinates of the points where the Zernike's
     polynomials and its derivatives are computed.  Y is a matrix with the Y
     coordinates of the same points.  N is an integer with the maximum radial
     degree desired.  NAN_ZERO is a string that determines the values of
     polynomial and derived values outside the radio unit circle.

     Strictly, the polynoms are only defined for 0 <= X²+Y² <= 1.  If variable
     NAN_ZERO = 'nan', the values of the polynomials for which it is verified
     that (X²+Y²)>1 are set = NaN. If variable NAN_ZERO = 'zero', the values of
     the polynomials for which it is verified that (X²+Y²)>1 are set = 0.

     Z is a 3D matrix.  Each page contains a 2D matrix with the values of a
     Zernike's polynomial at the points defined by X and Y.

     DZX is a 3D matrix.  Each page contains the values of the partial
     derivative in x.

     DZY is a 3D matrix.  Each page contains the values of the partial
     derivative in y.

     It should be noted that in standard OSA/ANSI the simple-index j starts at
     0, but in octave the indices of the vectors and matrices start at 1.  So
     that page 1 of the 3D Z, dZx and dZy matrices corresponds to the
     single-index j = 0, and therefore to the double-index m = 0 and n = 0.
     Page 2 corresponds to j = 1, page 3 -> j = 2, etc.

     Example
          x = linspace(-1,1,101);
          [X,Y] = meshgrid(x,x);
          [Z,dZx,dZy] = zernikes_and_derivatives_cartesian_OSA (X,Y,7,'zero');
          Z_00 = Z(:,:,1);
             # Z_00 is a 2D matrix with the values of Zernike's polynomial
             # with simple-index j = 0, and double-index m = 0 & n = 0.
          dZx_-24 = dZx(:,:,11);
             # Z_-44 is a 2D matrix with the values of the partial
             # derivative in x of Zernike's polynomial with
             # simple-index j = 10, and double-index m = -4 & n = 4.

     Run the demo to see a more complete example.

     Size of X must be equal size of Y.

     References:

       1. Andersen T.B., "Efficient and robust recurrence relations for the
          Zernike circle polynomials and their derivatives in Cartesian
          coordinates" (https://doi.org/10.1364/OE.26.018878).  Optic Express
          26(15), 18878-18896 (2018).
       2. Thibos, L.N, Applegate, R.A., Schwiegerling, J.T. & Webb, R.,
          Standards for reporting the optical aberrations of eyes.  Journal of
          refractive surgery, 18(5), S652-S660 (2002).

     See also: zernike_osa_ansi_to_nm, zernike_cartesian, zernike_name,
     zernike_polar, zernike_R_poly.


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 80
Return the cartesian Zernike's pollynomials and its partial derivatives up to...





