Function Arguments
/*-*********************************************************************************************/
/* */
/* mHistogram */
/* */
/* This program is essentially a subset of mViewer containing the code that determines */
/* the stretch for an image. With it we can generate stretch information for a whole */
/* file (or one reference file), then use it when we create a set of JPEG/PNG files */
/* from a set of other subsets/files. */
/* */
/* Only one file is processed, so if we want color we need to run this program three */
/* times. The only arguments needed are the image / stretch min / stretch max / mode. */
/* */
/* char *imgFile Input FITS file. */
/* char *histFile Output histogram file. */
/* char *minString Data range minimum as a string (to allow '%' and 's' suffix. */
/* char *maxString Data range maximum as a string (to allow '%' and 's' suffix. */
/* char *stretchType Stretch type (linear, power(log**N), sinh, gaussian or gaussian-log) */
/* */
/* int grayLogPower If the stretch type is log to a power, the power value. */
/* char *betaString If the stretch type is asinh, the transition data value. */
/* */
/* int debug Debugging output level. */
/* */
/***********************************************************************************************/
struct mHistogramReturn *mHistogram(char *grayfile, char *histfile,
char *grayminstr, char *graymaxstr, char *graytype, int graylogpower, char *graybetastr, int indebug)
Return Structure
struct mHistogramReturn
{
int status; // Return status (0: OK, 1:ERROR)
char msg [1024]; // Return message (for error return)
char json[4096]; // Return parameters as JSON string
double minval; // Data value associated with histogram minimum.
double minpercent; // Percentile value of histogram minimum.
double minsigma; // "Sigma" level of histogram minimum.
double maxval; // Data value associated with histogram maximum.
double maxpercent; // Percentile value of histogram maximum.
double maxsigma; // "Sigma" level of histogram maximum.
double datamin; // Minimum data value in file.
double datamax; // Maximum data value in file.
};