Write User Stories

[JLBegin]

Brainstorm a list of what a user aims to do with our software.

[JLBegin]

Ordered for a potential production schedule

1. JONES Calculus

• Create a JonesVector of any desired polarization state
• Create a JonesMatrix
• Obtain output JonesVector when multiplied with a JonesMatrix
• Access JonesVector properties like Ex, Ey and phase.
• Rotate a JonesMatrix
• Access built-in polarization components (as JonesMatrix) like waveplates, polarizers and materials. [At this point a birefringent material is created for a single set wavelength, i.e. static material. See story Wavelength-sensitive]

2. STOKES Calculus

• Create a StokesVector of any desired polarization state
• Obtain StokesVector from a JonesVector
• Create MuellerMatrix

3. WAVElength *

• Create a JonesVector of any wavelength
• Calculate the effect of a birefringent material on an arbitrary JonesVector

4. BEAM *

• Create a group of JonesVector (or StokesVector?) with different polarization states (or depolarized) and/or wavelengths
• Apply a JonesMatrix over a group of JonesVector (Beam)
• Calculate DOP, etc.

5. SHOW

• Display a Cartesian view of a polarization state
• Display a Poincare view of a polarization state
• Display a Beam [If you were to measure vertical and horizontal intensity, you would get...]
• Display a partially polarized beam (electric field probability map?)

6. Optical PATH *

• Create an optical path with an input polarization state and polarization components
• Propagate a JonesVector or a collection (beam) through an optical path
• Display a graph of a desired metric as a function of a desired component parameter
• Display an optical path (probably of a few wavelengths) [But this won't be very informative before interactivity...]

7. Interactivity (PLAY) *

• Display an interactive view of a polarization state
• Display an interactive view of an optical path
• GivenAnInteractiveView, allow to rotate components, change their thicknesses, birefringence, and other properties.
• Display a 3D animation where we see how the electric field orientation evolves?

Other feature/plugin ideas

• Scattering
• Tissue: Create and interact (propagateThrough and backscatter) with heterogeneous birefringent materials (current Tissue API)
• Systems: PS-OCT, polarimetry, interferometer
• Monte-Carlo
• Optical fibers, PMD?
• Polarization BeamSplitter?
• Reflections at normal incidence, transmission (beam intensity)
• Material database with all coatings
• Incidence angle and refraction
• DOP, depolarization, intensity
• Calculate dispersion ?

We could also release Display, OpticalPath and Interactivity before Pulse and Wavelength-Sensitivity stories.
*New features that no other polarization API offer.