/disk01/web/ocssw/build/src/l2brsgen/l2brsgen.h (r8218/r6127)

Go to the documentation of this file.

#ifndef L2BRSGEN_H /* avoid re-inclusion */
#define L2BRSGEN_H

#include    <stdio.h>
#include    <string.h>
#include        <time.h>

#include        "hdf.h"
#include        "mfhdf.h" 
#include        "hdfhdr.h"
#include        "hdfmac.h"
#include        "usrhdr.h"
#include        "usrmac.h"

#include <clo.h>
#include <readL2scan.h>
#include <get_product_table.h>

#define VERSION "1.9"

#define IOERR           -1
#define RDERR           -2
#define MEMERR          -3

#define MAXVAL  255

#define CHL_START       (l2_data + 8*nsamp)
#define CHL_END         (l2_data + 9*nsamp)
#define LAT_START       (l2_str.latitude)
#define LAT_END         (l2_str.latitude + max_samp_used+1)
#define LON_START       (l2_str.longitude)
#define LON_END         (l2_str.longitude + max_samp_used+1)

#define MAXTILTS 20
#define NFLAGS   16

/*  Time Conversion Constants  */
#define MSECHOUR 3600000
#define MSECMIN  60000
#define MSECSEC  1000

#define LONGNAME    "long_name"
#define RANGE       "valid_range"

/*  Global (file-level) Attributes  */
/*  Constants defined for attributes defined in sec.5.3.1 of product specs */

#define PNAME           "Product Name"
#define TITLE       "Title"
#define LEGEND      "Legend"
#define TITLE_VAL   " Level-2 Browse Data"
#define DCENTER     "Data Center"
#define DCENTER_VAL     "NASA/GSFC SeaWiFS Data Processing Center"
#define MISSION     "Mission"
#define MSNCHAR         "Mission Characteristics"
#define SENSOR_NAME     "Sensor Name"
#define SENSOR      "Sensor"
#define SNSCHAR     "Sensor Characteristics"


#define REPLACES    "Replacement Flag"
#define SOFTID      "Software ID"
#define SOFTID_VAL  "?????"
#define SOFT_NAME       "Software Name"
#define SOFT_VER        "Software Version"
#define PTIME       "Processing Time"
#define L2BRS_INFILES       "Input Files"
#define PROC_CON    "Processing Control"
#define PROC_LOG    "Processing Log"

/*  Constants defined for attributes defined in sec.5.3.2 of product specs */

#define PINFILES   "Parent Input Files"
#define PPNAME     "Parent Product Name"
#define STATION    "Station Name"
#define STLAT      "Station Latitude"
#define STLON      "Station Longitude"
#define DTYPE      "Data Type"
#define NSAMP      "Parent Pixels per Scan Line"
#define NREC       "Parent Number of Scan Lines"
#define SNCNTR     "Scene Center Scan Line"
#define NFREC      "Filled Scan Lines"
#define FFLAG1     "FF Missing Frames"
#define FFLAG2     "SDPS Missing Frames"
#define PCTFLAG    "Flag Percentages"

/*  Constants defined for attributes defined in sec.5.3.3 of product specs */
#define STIME       "Start Time"
#define ETIME       "End Time"
#define CTIME       "Scene Center Time"
#define NTIME       "Node Crossing Time"
#define SYEAR       "Start Year"
#define SDAY        "Start Day"
#define SMSEC       "Start Millisec"
#define EYEAR       "End Year"
#define EDAY        "End Day"
#define EMSEC       "End Millisec"
#define SNODE       "Start Node"
#define ENODE       "End Node"
#define ORBNUM      "Orbit Number"
#define NORAD1      "NORAD Line 1"
#define NORAD2      "NORAD Line 2"

/*  Constants defined for attributes defined in sec.5.3.4 of product specs */
#define LATUNITS            "Latitude Units"
#define LATUNITS_VAL        "degrees North"
#define LONUNITS            "Longitude Units"
#define LONUNITS_VAL        "degrees East"
#define CLAT                "Scene Center Latitude"
#define CLON                "Scene Center Longitude"
#define SCSOL_Z         "Scene Center Solar Zenith"
#define ULLAT           "Upper Left Latitude"
#define ULLON           "Upper Left Longitude"
#define URLAT           "Upper Right Latitude"
#define URLON           "Upper Right Longitude"
#define LLLAT           "Lower Left Latitude"
#define LLLON           "Lower Left Longitude"
#define LRLAT           "Lower Right Latitude"
#define LRLON           "Lower Right Longitude"
#define NLAT                "Northernmost Latitude"
#define SLAT                "Southernmost Latitude"
#define WLON                "Westernmost Longitude"
#define ELON                "Easternmost Longitude"
#define STCLAT          "Start Center Latitude"
#define STCLON          "Start Center Longitude"
#define ENDCLAT         "End Center Latitude"
#define ENDCLON         "End Center Longitude"
#define NODEL               "Orbit Node Longitude"

/*  Constants defined for attributes defined in sec.5.3.4 of product specs */
#define PARAM           "Parameter"
#define PARAM_VAL       "Chlorophyll a concentration"
#define UNITS           "Units"
#define UNITS_VAL       "mg m^-3"
#define PX_START        "Start Pixel"
#define PX_END          "End Pixel"
#define LAC_PX_ST       "LAC Pixel Start Number"
#define PX_SUBSAMP      "Pixel Subsampling Rate"
#define LAC_PX_SUBSAMP      "LAC Pixel Subsampling"
#define PX_NUM          "Pixels per Scan Line"
#define SC_START        "Start Scan"
#define SC_END          "End Scan"
#define SC_SUBSAMP      "Scan Subsampling Rate"
#define SC_NUM          "Number of Scan Lines"
#define PX_LL_NUM       "Pixel Coordinates"
#define SC_LL_NUM       "Scan Coordinates"
#define SC_TYPE         "Scaling"
#define SC_TY_VAL       "logarithmic"
#define SC_EQN          "Scaling Equation"
#define SC_EQN_VAL  "Base**((Slope*brs_data) + Intercept) = chlorophyll a"
#define BASE            "Base"
#define BASE_VAL        10.0
#define SLOPE           "Slope"
#define SLOPE_VAL       0.015
#define INTERCEPT       "Intercept"
#define INTERCEPT_VAL       -2.0
#define SCALE_OFF       "Scale Offset"

/*  Constants defined for attributes defined in sec.5.4.1 of product specs */
#define PX_LL_FIRST         "px_ll_first"
#define PX_LL_FST_ATTR      "Lat/lon of pixels along first scan line"
#define PX_LL_LAST          "px_ll_last"
#define PX_LL_LST_ATTR      "Lat/lon of pixels along last scan line"
#define SC_LL_FIRST         "sc_ll_first"
#define SC_LL_FST_ATTR      "Lat/lon of starts of scan lines"
#define SC_LL_LAST          "sc_ll_last"
#define SC_LL_LST_ATTR      "Lat/lon of ends of scan lines"

/*  Constants defined for attributes defined in sec.5.4.2 of product specs */
#define NTILTS          "ntilts"
#define NTILTS_NAME     "Number of scene tilt states"
#define T_FLAGS             "tilt_flags"
#define T_FLAGS_NAME        "Tilt indicators"
#define T_RANGES            "tilt_ranges"
#define T_RANGES_NAME       "Scan-line number ranges of scene tilt states"
#define T_LATS              "tilt_lats"
#define T_LATS_NAME     "Latitudes of tilt-range scan line end points"
#define T_LONS              "tilt_lons"
#define T_LONS_NAME     "Longitudes of tilt-range scan line end points"

/* Constants defined for navigation data */
#define ORBVEC           "orb_vec"
#define ORBVEC_NAME      "Orbit position vector at scan line time"
#define ORBVEC_UNITS     "kilometers"
#define LVERT            "l_vert"
#define LVERT_NAME       "Local vertical vector in ECEF frame"
#define SUNREF           "sun_ref"
#define SUNREF_NAME      "Reference Sun vector in ECEF frame"
#define ATTANG           "att_ang"
#define ATTANG_NAME      "Computed yaw, roll, pitch"
#define SENMAT           "sen_mat"
#define SENMAT_NAME      "ECEF-to-sensor-frame matrix"
#define SCANELL          "scan_ell"
#define SCANELL_NAME     "Scan-track ellipse coefficients"
#define NFLAG            "nflag"
#define NFLAG_NAME       "Navigation flags"
#define CNTLPTCOLS       "cntl_pt_cols"
#define CNTLPTCOLS_NAME  "Control point column values"

#define CNTLPTLAT        "latitude"
#define CNTLPTLAT_NAME   "Latitude values"
#define CNTLPTLON        "longitude"
#define CNTLPTLON_NAME   "Longitude values"


extern char ERR_MSG[1024];


int l2brsgen_init_options(clo_optionList_t* list);
int l2brsgen_read_options(clo_optionList_t* list, int argc, char* argv[]);

int32 put_l2brs(char *l2brs_path, char *replaces, char *ptime, char *infiles,
        int32 px_start, int32 px_end, int32 px_subsamp, int32 brs_nsamp,
        int32 sc_start, int32 sc_end, int32 sc_subsamp, int32 brs_nrec,
        char *l2brs_name, float32 *l2brs_data, int32 *l2brs_flags,
        char *flag_names, char *mskflg, unsigned char *palette,
        float32 *px_ll_first, float32 *px_ll_last, float32 *sc_ll_first,
        float32 *sc_ll_last, char *proc_con, int16 syear, int16 sday,
        int32 smsec, int16 eyear, int16 eday, int32 emsec, char *dtype,
        int32 nrec, int32 nsamp, int32 ntilts, short *tilt_flags,
        int16 *tilt_ranges, int16 *cntl_pt_lat, int16 *cntl_pt_lon,
        meta_l2Type *meta_l2, product_table_t *ptable_rec, int32 outmode, int32 apply_pal);

void write_attrs(int32 sdfid, char *l2brs_path, char *replaces, char *ptime,
        char *infiles, int32 px_start, int32 px_end, int32 px_subsamp,
        int32 brs_nsamp, int32 sc_start, int32 sc_end, int32 sc_subsamp,
        int32 brs_nrec, char *l2brs_name, char *proc_con, int16 syear,
        int16 sday, int32 smsec, int16 eyear, int16 eday, int32 emsec,
        char *dtype, int32 nrec, int32 nsamp, meta_l2Type *meta_l2);

int32 write_image(char *l2brs_path, unsigned char *l2brs_data, int32 brs_nsamp,
        int32 brs_nrec, uint8 *palette);

int32 write_SDS(int32 sdfid, char *label, int32 ntype, int32 rank,
        int32 *dimsizes, int32 *start, void *buf);

int32 write_tilt_sets(int32 fid, int32 sdfid, int32 ntilts, int16 *tilt_flags,
        int16 *tilt_ranges);

int32 write_nav_sets(int32 fid, int32 sdfid, int32 brs_nrec, int32 brs_nsamp,
        int16 *cntl_pt_lat, int16 *cntl_pt_lon);


#endif /* L2BRSGEN_H */