next up previous contents
Next: stage - positions the Up: setstage - calculates guide Previous: setstage - calculates guide   Contents

Usage

setstage ra= dec= [epoch=] [debug]
setstage present [debug]
\end{varbatim}
setstage calculates the x, y coordinates that the guider stage should be positioned to from the celestial coordinates of the telescope and the guide star. It also calculates whether the guider will be able to see out (vignetting) and whether the guider blocks the science chip. When the position is out of range of the stage, the vignetting flag is set to 1.

The position of the telescope must be entered on the command line either:
\begin{itemize}
\item directly using the ra, dec, and optional epoch
\item if present is specified from the telescope encoders
\end{itemize}
The guide star positions must contain three fields: RA, dec, equinox. The first in HH:MM:SS, the second in DD:MM:SS and the third as floating year. The format is similar to that of the bright (Section~\ref{bright}) or nomad (Section~\ref{nomad}) commands.

For each guide star setstage prints out:
\begin{itemize}
\item guide stage x,y, position
\item vignetting factor (0 or 1)
\item blocking factor (0 or 1)
\item additional fields beyond first three from standard input
\end{itemize}
\subsubsection{Examples}
\begin{verbatim}
echo 0:43:47.067 22:07:50.610 2000.0  | setstage ra=0:42 dec=22:0 
x=-43.89 y=-47.97 vignette=1 block=0



Louis-Gregory Strolger 2012-01-09