IPP Software Navigation Tools IPP Links Communication Pan-STARRS Links

Ignore:
Timestamp:
Mar 31, 2004, 5:01:04 PM (22 years ago)
Author:
Paul Price
Message:

Standardised on /< as Doxygen comment for variable.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/archive/pslib/include/psStats.h

    r257 r344  
    3939/** generic statistics structure */
    4040typedef struct {
    41     double sampleMean;                  //<! formal mean of sample
    42     double sampleMedian;                //<! formal median of sample
    43     double sampleMode;                  //!< Formal mode of sample
    44     double sampleStdev;                 //<! standard deviation of sample
    45     double sampleUQ;                    //<! upper quartile of sample
    46     double sampleLQ;                    //<! lower quartile of sample
    47     double robustMean;                  //<! robust mean of array
    48     double robustMeanError;             //<! error on robust mean
    49     int    robustMeanNvalues;           //<! number of measurements used for robust mean
    50     double robustMedian;                //<! robust median of array
    51     double robustMedianError;           //<! error on robust median
    52     int    robustMedianNvalues;         //<! number of measurements used for robust median
    53     double robustMode;                  //!< Robust mode of array
    54     double robustModeErr;               //!< Error in robust mode
    55     int    robustModeNvalues;           //!< Number of measurements used for robust mode
    56     double robustStdev;                 //<! robust standard deviation of array
    57     double robustUQ;                    //<! robust upper quartile
    58     double robustLQ;                    //<! robust lower quartile
    59     double clippedMean;                 //<! Nsigma clipped mean
    60     double clippedMeanError;            //<! error on clipped mean
    61     int    clippedMeanNvalues;          //<! number of data points used for clipped mean
    62     double clippedStdev;                //!< standard deviation after clipping
    63     double clipSigma;                   //<! Nsigma used for clipping; user input
    64     int    clipIter;                    //!< Number of clipping iterations; user input
    65     double min;                         //<! minimum data value in array
    66     double max;                         //<! maximum data value in array
    67     int    nValues;                     //<! number of data values in array
    68     psStatsOptions options;             //<! bitmask of calculated values
     41    double sampleMean;                  ///< formal mean of sample
     42    double sampleMedian;                ///< formal median of sample
     43    double sampleMode;                  ///< Formal mode of sample
     44    double sampleStdev;                 ///< standard deviation of sample
     45    double sampleUQ;                    ///< upper quartile of sample
     46    double sampleLQ;                    ///< lower quartile of sample
     47    double robustMean;                  ///< robust mean of array
     48    double robustMeanError;             ///< error on robust mean
     49    int    robustMeanNvalues;           ///< number of measurements used for robust mean
     50    double robustMedian;                ///< robust median of array
     51    double robustMedianError;           ///< error on robust median
     52    int    robustMedianNvalues;         ///< number of measurements used for robust median
     53    double robustMode;                  ///< Robust mode of array
     54    double robustModeErr;               ///< Error in robust mode
     55    int    robustModeNvalues;           ///< Number of measurements used for robust mode
     56    double robustStdev;                 ///< robust standard deviation of array
     57    double robustUQ;                    ///< robust upper quartile
     58    double robustLQ;                    ///< robust lower quartile
     59    double clippedMean;                 ///< Nsigma clipped mean
     60    double clippedMeanError;            ///< error on clipped mean
     61    int    clippedMeanNvalues;          ///< number of data points used for clipped mean
     62    double clippedStdev;                ///< standard deviation after clipping
     63    double clipSigma;                   ///< Nsigma used for clipping; user input
     64    int    clipIter;                    ///< Number of clipping iterations; user input
     65    double min;                         ///< minimum data value in array
     66    double max;                         ///< maximum data value in array
     67    int    nValues;                     ///< number of data values in array
     68    psStatsOptions options;             ///< bitmask of calculated values
    6969} psStats;
    7070
     
    7272/** Do Statistics on an array.  Returns a status value. \ingroup MathGroup */
    7373psStats *
    74 psArrayStats(const psFloatArray *restrict myArray, //!< Array to be analysed
    75              const psIntArray *restrict maskArray, //!< Ignore elements where (maskArray & maskVal) != 0
    76                                                    //!< May be NULL
    77              unsigned int maskVal,      //!< Only mask elements with one of these bits set in maskArray
    78              psStats *stats             //!< stats structure defines stats to be calculated and how
     74psArrayStats(const psFloatArray *restrict myArray, ///< Array to be analysed
     75             const psIntArray *restrict maskArray, ///< Ignore elements where (maskArray & maskVal) != 0
     76                                                   ///< May be NULL
     77             unsigned int maskVal,      ///< Only mask elements with one of these bits set in maskArray
     78             psStats *stats             ///< stats structure defines stats to be calculated and how
    7979    );
    8080
     
    8383/** Histograms  */
    8484typedef struct {
    85     const psFloatArray *restrict lower; //!< Lower bounds for the bins
    86     const psFloatArray *restrict upper; //!< Upper bounds for the bins
    87     psIntArray *nums;                   //!< Number in each of the bins
    88     const float minVal, maxVal;         //!< Minimum and maximum values
    89     int minNum, maxNum;                 //!< Number below the minimum and above the maximum
     85    const psFloatArray *restrict lower; ///< Lower bounds for the bins
     86    const psFloatArray *restrict upper; ///< Upper bounds for the bins
     87    psIntArray *nums;                   ///< Number in each of the bins
     88    const float minVal, maxVal;         ///< Minimum and maximum values
     89    int minNum, maxNum;                 ///< Number below the minimum and above the maximum
    9090} psHistogram;
    9191
    9292/** Constructor \ingroup MathGroup */
    9393psHistogram *
    94 psHistogramAlloc(float lower,           //!< Lower limit for the bins
    95                  float upper,           //!< Upper limit for the bins
    96                  float size             //!< Size of the bins
     94psHistogramAlloc(float lower,           ///< Lower limit for the bins
     95                 float upper,           ///< Upper limit for the bins
     96                 float size             ///< Size of the bins
    9797    );
    9898
    9999/** Generic constructor \ingroup MathGroup */
    100100psHistogram *
    101 psHistogramAllocGeneric(const psFloatArray *restrict lower, //!< Lower bounds for the bins
    102                         const psFloatArray *restrict upper, //!< Upper bounds for the bins
    103                         float minVal,   //!< Minimum value
    104                         float maxVal    //!< Maximum value
     101psHistogramAllocGeneric(const psFloatArray *restrict lower, ///< Lower bounds for the bins
     102                        const psFloatArray *restrict upper, ///< Upper bounds for the bins
     103                        float minVal,   ///< Minimum value
     104                        float maxVal    ///< Maximum value
    105105    );
    106106
    107107/** Destructor \ingroup MathGroup **/
    108108void
    109 psHistogramFree(psHistogram *restrict myHist //!< Histogram to destroy
     109psHistogramFree(psHistogram *restrict myHist ///< Histogram to destroy
    110110    );
    111111
     
    113113/** Calculate a histogram \ingroup MathGroup **/
    114114psHistogram *
    115 psGetArrayHistogram(psHistogram *restrict myHist, //!< Histogram data
    116                     const psFloatArray *restrict myArray //!< Array to analyse
     115psGetArrayHistogram(psHistogram *restrict myHist, ///< Histogram data
     116                    const psFloatArray *restrict myArray ///< Array to analyse
    117117    );
    118118
Note: See TracChangeset for help on using the changeset viewer.