das2/units.h

Go to the documentation of this file.

#ifndef _das2_units_h_
#define _das2_units_h_

#include <stdbool.h>

#ifndef _das2_units_c_

extern const char* UNIT_US2000;
extern const char* UNIT_MJ1958;
extern const char* UNIT_T2000; /* seconds since midnight, Jan 1, 2000 */
extern const char* UNIT_T1970; /* seconds since midnight, Jan 1, 1970 */
extern const char* UNIT_UTC;   /* Time strings on the Gergorian Calendar */

/* Other common units */
extern const char* UNIT_SECONDS;
extern const char* UNIT_HOURS;
extern const char* UNIT_MILLISECONDS;
extern const char* UNIT_MICROSECONDS;

extern const char* UNIT_HERTZ;
extern const char* UNIT_KILO_HERTZ;
extern const char* UNIT_MEGA_HERTZ;
extern const char* UNIT_E_SPECDENS;
extern const char* UNIT_B_SPECDENS;
extern const char* UNIT_NT;

extern const char* UNIT_NUMBER_DENS;
      
extern const char* UNIT_DB;

extern const char* UNIT_KM;

extern const char* UNIT_DEGREES;
extern const char* UNIT_DIMENSIONLESS;

#endif

typedef const char* UnitType;

#define FILL_VALUE -1e31

const char* Units_toStr( UnitType unit );

UnitType Units_fromStr( const char * string );


bool Units_canConvert(UnitType fromUnits , UnitType toUnits);


double Units_convertTo( UnitType toUnits, double value, UnitType fromUnits );

void Units_double2Time(double time, UnitType units, 
        int *year, int *month, int *dom, int *hour, int *minute, double *seconds);

char* Units_double2TimeStr( double time, UnitType units );

double Units_time2Double(int year, int month, int dom, int hour, int minute,
                         double seconds, UnitType units );

double Units_timeStr2Double(const char* timeString, UnitType units );


double convertToUS2000( double value, UnitType fromUnits );
double convertFromUS2000( double value, UnitType toUnits );
double secondsToUnitsOffsetFactor( UnitType toUnits );

/* Convenient method for getting the seconds since midnight
 * for the Datum (double,unit) 
 */
double getSecondsSinceMidnight( double timeDouble, UnitType units );

/* Get the Julian day for the Datum (double,unit) */
int getJulianDay( double timeDouble, UnitType units );


#endif /* _das2_units_h_ */

---