# doc-cache created by Octave 6.4.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: 854
 -- 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.

     See also: .


# 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: 900
 -- 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: 902
 -- 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: 863
 -- 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.

     See also: .


# 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: 1399
 -- 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: 975
 -- 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: 1183
 -- 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: 916
 -- 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: 923
 -- 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: 922
 -- 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: 912
 -- 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: 962
 -- 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: 1277
 -- 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: 1055
 -- 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: 965
 -- 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: 1008
 -- 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: 946
 -- 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: 1104
 -- 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: 1447
 -- 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: 1187
 -- 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: 921
 -- 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: 1707
 -- 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: 1972
 -- 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: 1093
 -- 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: 1444
 -- 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: 984
 -- 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: 1217
 -- 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: 977
 -- 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: 1296
 -- 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: 1067
 -- 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: 924
 -- 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: 973
 -- 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: 1044
 -- 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: 902
 -- 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: 904
 -- 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: 949
 -- 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: 913
 -- 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: 939
 -- 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: 918
 -- 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: 925
 -- 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: 924
 -- 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: 914
 -- 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: 924
 -- 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: 506
 -- 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: 368
 -- 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: 276
 -- 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: 786
 -- [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: 671
 -- 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: 2922
 -- [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...





