IPP Software Navigation Tools IPP Links Communication Pan-STARRS Links

Ignore:
Timestamp:
Oct 16, 2006, 5:00:30 PM (20 years ago)
Author:
Paul Price
Message:

Documenting pmFPARead.[ch]

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/psModules/src/camera/pmFPARead.h

    r7555 r9599  
     1/// @file pmFPAMosaic.h
     2///
     3/// @brief Functions to mosaic FPA components into a single entity
     4///
     5/// @ingroup Camera
     6///
     7/// @author Paul Price, IfA
     8///
     9/// @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
     10/// @date $Date: 2006-10-17 03:00:30 $
     11///
     12/// Copyright 2005-2006 Institute for Astronomy, University of Hawaii
     13///
     14
    115#ifndef PM_FPA_READ_H
    216#define PM_FPA_READ_H
    317
    4 #include "pslib.h"
     18#include <pslib.h>
    519#include "pmFPA.h"
    620
     21/// Read a readout incrementally
     22///
     23/// Multiple calls to this function moves through a readout within a cell incrementally.  It is required to
     24/// pass the readout previously acquired (or a newly-allocated one) in order to preserve state information
     25/// (where the read is at).  Only a maximum of numRows rows are read at a time.  Returns true if pixels are
     26/// read, and false otherwise.  To facilitate looping, no error is generated for reading a plane that doesn't
     27/// exist.  Note that this function doesn't put pixels in the HDU.  It is therefore NOT COMPATIBLE with
     28/// pmCellWrite, pmChipWrite, and pmFPAWrite (or any function that uses or creates an HDU for that matter).
     29/// Use pmReadoutWriteNext to write the data that's read by this function.  This function is intended for
     30/// reading in many readouts into memory at once (e.g., for stacking) where the input is not written out.
    731bool pmReadoutReadNext(pmReadout *readout, // Readout into which to read
    832                       psFits *fits,    // FITS file from which to read
     
    1135                      );
    1236
     37/// Read an entire cell
     38///
     39/// Reads the appropriate HDU, ingests concepts from the header, and portions pixels into readouts.  Pixels
     40/// are converted to F32.
    1341bool pmCellRead(pmCell *cell,           // Cell to read into
    1442                psFits *fits,           // FITS file from which to read
     
    1644               );
    1745
     46/// Read a chip
     47///
     48/// Iterates over component cells, reading each with pmCellRead.
    1849bool pmChipRead(pmChip *chip,           // Chip to read into
    1950                psFits *fits,           // FITS file from which to read
     
    2152               );
    2253
     54/// Read an FPA
     55///
     56/// Iterates over component chips, reading each with pmChipRead.
    2357bool pmFPARead(pmFPA *fpa,              // FPA to read into
    2458               psFits *fits,            // FITS file from which to read
     
    2660              );
    2761
     62/// Read an entire cell into the mask
     63///
     64/// Same as pmCellRead, but reads into the mask element of the readouts.
    2865bool pmCellReadMask(pmCell *cell,           // Cell to read into
    2966                    psFits *fits,           // FITS file from which to read
     
    3168                   );
    3269
     70/// Read an entire chip into the mask
     71///
     72/// Same as pmChipRead, but reads into the mask element of the readouts.
    3373bool pmChipReadMask(pmChip *chip,           // Chip to read into
    3474                    psFits *fits,           // FITS file from which to read
     
    3676                   );
    3777
     78/// Read an entire FPA into the mask
     79///
     80/// Same as pmFPARead, but reads into the mask element of the readouts.
    3881bool pmFPAReadMask(pmFPA *fpa,              // FPA to read into
    3982                   psFits *fits,            // FITS file from which to read
     
    4184                  );
    4285
     86/// Read an entire cell into the weight
     87///
     88/// Same as pmCellRead, but reads into the weight element of the readouts.
    4389bool pmCellReadWeight(pmCell *cell,           // Cell to read into
    4490                      psFits *fits,           // FITS file from which to read
     
    4692                     );
    4793
     94/// Read an entire chip into the weight
     95///
     96/// Same as pmChipRead, but reads into the weight element of the readouts.
    4897bool pmChipReadWeight(pmChip *chip,           // Chip to read into
    4998                      psFits *fits,           // FITS file from which to read
     
    51100                     );
    52101
     102/// Read an entire FPA into the weight
     103///
     104/// Same as pmFPARead, but reads into the weight element of the readouts.
    53105bool pmFPAReadWeight(pmFPA *fpa,              // FPA to read into
    54106                     psFits *fits,            // FITS file from which to read
     
    56108                    );
    57109
    58 bool pmCellReadPHU(pmCell *cell,        // Cell to read into
    59                    psFits *fits         // FITS file from which to read
    60                   );
    61 
    62 bool pmChipReadPHU(pmChip *chip,        // Chip to read into
    63                    psFits *fits         // FITS file from which to read
    64                   );
    65 
    66 bool pmFPAReadPHU(pmFPA *fpa,           // FPA to read into
    67                   psFits *fits          // FITS file from which to read
    68                  );
    69 
    70 
    71 #if 0
    72 bool pmFPARead(pmFPA *fpa,              // FPA to read into
    73                psFits *fits,            // FITS file from which to read
    74                psMetadata *phu,         // Primary header
    75                psDB *db                 // Database handle, for concept ingest
    76               );
    77 
    78 psString p_pmFPATranslateName(const psString name, // The name to translate
    79                               const pmCell *cell // The cell for which to translate
    80                              );
    81 
    82 psString p_pmFPATranslateFileExt(psString *extName, // Extension name, to be returned
    83                                  const psString filenameExt, // The string to parse into filename and ext
    84                                  const pmCell *cell // The cell
    85                                 );
    86 
    87 bool pmFPAReadMask(pmFPA *fpa,          // FPA to read into
    88                    psFits *source       // Source FITS file (for the original data)
    89                   );
    90 
    91 bool pmFPAReadWeight(pmFPA *fpa,        // FPA to read into
    92                      psFits *source     // Source FITS file (for the original data)
    93                     );
    94110#endif
    95 
    96 #endif
Note: See TracChangeset for help on using the changeset viewer.