.. _fieldSteer:

Wavefront Sensor Field Steering
===============================

Top-Level Use
-------------

.. automodule:: fieldSteer
    :members: calibrate, genPTable, genCTable, point, center, pnc, deltaP, deltaC, command

**Module Data**

.. autodata:: state

Graphics of Field Steer
-----------------------
.. figure:: fieldSteer.png
   :height: 400
   
   **Figure 1** Sketch of mirror-fixed coordinates
   rotated with respect to origin coordinates into
   their nominal positions.

.. figure:: fieldSteer_Picture.png
   :height: 400
   
   **Figure 2** Photograph of the field-steering pair,
   top-down looing on to bench.
   
.. figure:: fieldSteer_Sketch.png
   :height: 400
   
   **Figure 3** Three-D rendition showing beam line and
   mirror and motor numbering.

Expert (Low-Level) Use
----------------------
The fieldSteer module uses linear algebra transformations
to implement Euler rotations, intersections, and ray tracing.
Here are more internal functions that support this.

.. autofunction:: cross
.. autofunction:: euler_rotate
.. autofunction:: intersect
.. autofunction:: normalized
.. autofunction:: plotTable
.. autofunction:: propagate
.. autofunction:: reflect
.. autofunction:: rotate
.. autofunction:: shoot
.. autofunction:: pshoot
.. autofunction:: vector

.. autofunction:: drawPlot

Calibration Data
----------------
The fieldSteer module must be properly calibrated with
empirical data in order to do proper predictions of
beam motion. Here are the calibration parameters
and their current default settings

.. autodata:: d12
.. autodata:: d23
.. autodata:: plate_scale
.. autodata:: fov_arcsec
.. autodata:: f_number