Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
162 lines (133 sloc) 3.75 KB
#ifndef DIVE_H
#define DIVE_H
#include <stdlib.h>
#include <time.h>
#include <glib.h>
* Some silly typedefs to make our units very explicit.
* Also, the units are chosen so that values can be expressible as
* integers, so that we never have FP rounding issues. And they
* are small enough that converting to/from imperial units doesn't
* really matter.
* We also strive to make '0' a meaningless number saying "not
* initialized", since many values are things that may not have
* been reported (eg cylinder pressure or temperature from dive
* computers that don't support them). But sometimes -1 is an even
* more explicit way of saying "not there".
* Thus "millibar" for pressure, for example, or "millikelvin" for
* temperatures. Doing temperatures in celsius or fahrenheit would
* make for loss of precision when converting from one to the other,
* and using millikelvin is SI-like but also means that a temperature
* of '0' is clearly just a missing temperature or cylinder pressure.
* Also strive to use units that can not possibly be mistaken for a
* valid value in a "normal" system without conversion. If the max
* depth of a dive is '20000', you probably didn't convert from mm on
* output, or if the max depth gets reported as "0.2ft" it was either
* a really boring dive, or there was some missing input conversion,
* and a 60-ft dive got recorded as 60mm.
* Doing these as "structs containing value" means that we always
* have to explicitly write out those units in order to get at the
* actual value. So there is hopefully little fear of using a value
* in millikelvin as Fahrenheit by mistake.
* We don't actually use these all yet, so maybe they'll change, but
* I made a number of types as guidelines.
typedef struct {
int seconds;
} duration_t;
typedef struct {
int mm;
} depth_t;
typedef struct {
int mbar;
} pressure_t;
typedef struct {
int mkelvin;
} temperature_t;
typedef struct {
int mliter;
} volume_t;
typedef struct {
int permille;
} fraction_t;
typedef struct {
int grams;
} weight_t;
typedef struct {
fraction_t o2;
fraction_t he;
} gasmix_t;
typedef struct {
volume_t size;
pressure_t workingpressure;
const char *description; /* "LP85", "AL72", "AL80", "HP100+" or whatever */
} cylinder_type_t;
typedef struct {
cylinder_type_t type;
gasmix_t gasmix;
pressure_t start, end;
} cylinder_t;
static inline int to_feet(depth_t depth)
return * 0.00328084 + 0.5;
static inline int to_C(temperature_t temp)
if (!temp.mkelvin)
return 0;
return (temp.mkelvin - 273150) / 1000;
static inline int to_PSI(pressure_t pressure)
return pressure.mbar * 0.0145037738 + 0.5;
struct sample {
duration_t time;
depth_t depth;
temperature_t temperature;
pressure_t cylinderpressure;
int cylinderindex;
#define MAX_CYLINDERS (8)
struct dive {
time_t when;
char *location;
char *notes;
depth_t maxdepth, meandepth;
duration_t duration, surfacetime;
depth_t visibility;
temperature_t airtemp, watertemp;
cylinder_t cylinder[MAX_CYLINDERS];
int samples;
struct sample sample[];
extern int verbose;
struct dive_table {
int nr, allocated;
struct dive **dives;
extern struct dive_table dive_table;
static inline struct dive *get_dive(unsigned int nr)
if (nr >=
return NULL;
return dive_table.dives[nr];
extern void parse_xml_init(void);
extern void parse_xml_file(const char *filename, GError **error);
extern void flush_dive_info_changes(void);
extern void save_dives(const char *filename);
static inline unsigned int dive_size(int samples)
return sizeof(struct dive) + samples*sizeof(struct sample);
extern struct dive *fixup_dive(struct dive *dive);
extern struct dive *try_to_merge(struct dive *a, struct dive *b);
#endif /* DIVE_H */