Changeset 1706

Timestamp:

Sep 7, 2004, 1:23:02 PM (22 years ago)

Author:

Paul Price

Message:

Minor changes.

File:

• trunk/doc/pslib/psLibSDRS.tex (modified) (8 diffs)

trunk/doc/pslib/psLibSDRS.tex

@@ -1 @@
-%%% $Id: psLibSDRS.tex,v 1.109 2004-09-07 00:52:16 eugene Exp $
+%%% $Id: psLibSDRS.tex,v 1.110 2004-09-07 23:23:02 price Exp $
 \documentclass[panstarrs,spec]{panstarrs}
 
@@ -35 +35 @@
    &             & (modified polynomials), ImageTrim for Phase 2. \\
    &             & Changed minimization. \\ \hline
+04-- & Various   & See Appendix A for a change log. \\ \hline
 \RevisionsEnd
 
@@ -174 +175 @@
 \begin{itemize}
 \item Set the error codes for PSLib.
+\item Seed the random number generator.
 \end{itemize}
 
 The prototype is:
 \begin{verbatim}
-void psLibInit(void)
-\end{verbatim}
+void psLibInit(bool predictable);
+\end{verbatim}
+
+If \code{predictable} is \code{true}, then the random number generator
+shall be seeded with a value that does not vary (allowing bugs relying
+on random numbers to be reproduced); otherwise, the random number
+generator shall be seeded from \code{/dev/random} if it exists,
+otherwise from the system clock.
 
 
@@ -2600 +2608 @@
 
 \begin{verbatim}
-psC64 psImagePixelInterpolate (const psImage *input, float x, float y,
-                               psC64 unexposedValue, psImageInterpolateMode mode);
+psC64 psImagePixelInterpolate(const psImage *input, float x, float y,
+                              const psImage *mask, unsigned int maskVal,
+                              psC64 unexposedValue, psImageInterpolateMode mode);
 \end{verbatim}
 Perform interpolation of image pixel values to the given fractional
 coordinate \code{x,y}.  The function returns the interpolated value of
 the image at the given fractional pixel coordinates, based on the
-specified interpolation \code{mode}.  This function will likely be
-implemented as a macro for processing speed.  It may also be necessary
-to define a setup macro which pre-calculates certain values which
-would be reused in a loop.
+specified interpolation \code{mode}.  The \code{mask} allows pixels to
+be excluded if their corresponding mask pixel value matches the value
+of \code{maskVal}.  This function will likely be implemented as a
+macro for processing speed.  It may also be necessary to define a
+setup macro which pre-calculates certain values which would be reused
+in a loop.
 
 \subsubsection{Image I/O Functions}
@@ -2651 +2662 @@
 existing image starting at the coordinate x,y,z.  If any of these
 parameters implies writing pixels outside the existing data area of
-the image, return an error (ie, if x + image.nx >= NAXIS1, y +
-image.ny >= NAXIS2, or z >= NAXIS3).  If the image does not exist,
-require x,y,z to be zero.  This function will only write images of the
-native FITS image types (\code{psU8}, \code{psS16}, \code{psS32},
-\code{psF32}, \code{psF64}).  The user is expected to convert the data
-type as needed with \code{psImageCopy}.  The return value must be 0
-for a successful operation and 1 for an error.
+the image, return an error (ie, if \code{x + image.nx >= NAXIS1},
+\code{y + image.ny >= NAXIS2}, or \code{z >= NAXIS3}).  If the image
+does not exist, require x,y,z to be zero.  This function will only
+write images of the native FITS image types (\code{psU8},
+\code{psS16}, \code{psS32}, \code{psF32}, \code{psF64}).  The user is
+expected to convert the data type as needed with \code{psImageCopy}.
+The return value must be 0 for a successful operation and 1 for an
+error.
 
 \subsubsection{Image Pixel Manipulations}
@@ -3839 +3851 @@
 \end{verbatim}
 
+We also require the ability to precess coordinates from one equinox to
+another.
+
+\begin{verbatim}
+psSphere *psSpherePrecess(psSphere *coords, const psTime *fromTime, const psTime *toTime);
+\end{verbatim}
+
+Given coordinates, \code{coords}, with equinox for \code{fromTime},
+the coordinates are precessed to equinox for \code{toTime}.  The
+\code{coords} are modified in-place.  Equinoxes shall be Julian
+equinoxes (as opposed to Bessellian).
+
 \subsubsection{Projections}
 
@@ -3926 +3950 @@
 
 \subsection{Photometry}
+
+\tbd{This section is to be deferred, and for now consists only of
+placeholders, with no functional items.}
 
 Photometric observations are performed in an instrumental photometric
@@ -3995 +4022 @@
 
 \tbd{These functions are all of low priority, have not yet been
-defined in detail, and are not immediately required.}
+defined in detail, and hence are to be deferred.}
 
 \subsubsection{Positions of Major SS Objects}