Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DM-9111 Add rotator information to HSC VisitInfo #190

Merged
merged 1 commit into from
Mar 20, 2017
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
8 changes: 3 additions & 5 deletions doc/FITS headers for exposures.rst
Original file line number Diff line number Diff line change
Expand Up @@ -31,11 +31,9 @@ BORE-ALT float deg VisitInfo.getBoreAzAlt() Position of
BORE-ROTANG float deg VisitInfo.getBoreRotAngle() Orientation of rotator at boresight.
ROTTYPE str VisitInfo.getRotType() Type of rotation; one of:
\ - UNKNOWN
\ - SKY Orientation of E,N with respected to detector X,Y;
X is flipped, if necessary, to match the handedness of E,N.
\ - HORIZON orientation of Az/Alt with respect to detector X,Y;
X is flipped, if necessary, to match the handedness of Az,Alt.
\ - MOUNT the position sent to the instrument rotator; the details depend on the rotator.
\ - SKY Position angle of focal plane +Y measured from N through E.
\ - HORIZON Position angle of focal plane +Y measured from +Alt through +Az.
\ - MOUNT the position sent to the instrument rotator; the details depend on the rotator.
OBS-LONG float deg VisitInfo.getObservatory() Longitude of telescope.
OBS-LAT float deg VisitInfo.getObservatory() Latitude of telescope (positive eastward).
OBS-ELEV float m VisitInfo.getObservatory() Geodetic elevation of telescope (meters above reference spheroid).
Expand Down
15 changes: 8 additions & 7 deletions include/lsst/afw/image/VisitInfo.h
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,12 @@ namespace lsst { namespace afw { namespace image {
enum class RotType {
UNKNOWN, ///< Rotation angle is unknown. Note: if there is no instrument rotator then it is better
///< to compute SKY or HORIZON and use that rotation type rather than specify UNKNOWN.
SKY, ///< Orientation of E,N with respected to detector X,Y;
///< X is flipped, if necessary, to match the handedness of E,N.
HORIZON, ///< orientation of Az/Alt with respect to detector X,Y;
///< X is flipped, if necessary, to match the handedness of Az,Alt.
SKY, ///< Position angle of focal plane +Y, measured from N through E.
///< At 0 degrees, +Y is along N and +X is along E/W depending on handedness.
///< At 90 degrees, +Y is along E and +X is along S/N depending on handedness.
HORIZON, ///< Position angle of focal plane +Y, measured from +Alt through +Az.
///< At 0 degrees, +Y is along +Alt and +X is along +/-Az, depending on handedness.
///< At 90 degrees, +Y is along +Az and +X is along -/+Alt, depending on handedness.
MOUNT ///< The position sent to the instrument rotator; the details depend on the rotator.
};

Expand Down Expand Up @@ -160,9 +162,8 @@ class VisitInfo : public table::io::PersistableFacade<VisitInfo>, public table::
/**
* Get rotation angle at boresight at middle of exposure
*
* Rotation angle is angle of coordinate system specified by boresightRotType with respect to detector.
* For example if boresightRotType is SKY then at a rotation angle of 0 North is along detector Y axis
* (never flipped) and East is along the detector X axis (flipped if necessary)
* The meaning of rotation angle depends on @ref RotType "rotType". For example, if `rotType` is SKY
* the angle is the position angle of the focal plane +Y with respect to North.
*/
geom::Angle getBoresightRotAngle() const { return _boresightRotAngle; }

Expand Down