2 /* creates all the necessary data for drawing the dive profile
3 * uses cairo to draw it
15 int selected_dive = 0;
17 typedef enum { STABLE, SLOW, MODERATE, FAST, CRAZY } velocity_t;
18 /* Plot info with smoothing, velocity indication
19 * and one-, two- and three-minute minimums and maximums */
23 int meandepth, maxdepth;
24 int minpressure, maxpressure;
28 int pressure, temperature;
33 struct plot_data *min[3];
34 struct plot_data *max[3];
39 /* convert velocity to colors */
40 typedef struct { double r, g, b; } rgb_t;
41 static const rgb_t rgb[] = {
42 [STABLE] = {0.0, 0.4, 0.0},
43 [SLOW] = {0.4, 0.8, 0.0},
44 [MODERATE] = {0.8, 0.8, 0.0},
45 [FAST] = {0.8, 0.5, 0.0},
46 [CRAZY] = {1.0, 0.0, 0.0},
49 #define plot_info_size(nr) (sizeof(struct plot_info) + (nr)*sizeof(struct plot_data))
51 /* Scale to 0,0 -> maxx,maxy */
52 #define SCALEX(gc,x) (((x)-gc->leftx)/(gc->rightx-gc->leftx)*gc->maxx)
53 #define SCALEY(gc,y) (((y)-gc->topy)/(gc->bottomy-gc->topy)*gc->maxy)
54 #define SCALE(gc,x,y) SCALEX(gc,x),SCALEY(gc,y)
56 static void move_to(struct graphics_context *gc, double x, double y)
58 cairo_move_to(gc->cr, SCALE(gc, x, y));
61 static void line_to(struct graphics_context *gc, double x, double y)
63 cairo_line_to(gc->cr, SCALE(gc, x, y));
66 static void set_source_rgba(struct graphics_context *gc, double r, double g, double b, double a)
69 * For printers, we still honor 'a', but ignore colors
70 * for now. Black is white and white is black
79 cairo_set_source_rgba(gc->cr, r, g, b, a);
82 void set_source_rgb(struct graphics_context *gc, double r, double g, double b)
84 set_source_rgba(gc, r, g, b, 1);
87 #define ROUND_UP(x,y) ((((x)+(y)-1)/(y))*(y))
90 * When showing dive profiles, we scale things to the
91 * current dive. However, we don't scale past less than
92 * 30 minutes or 90 ft, just so that small dives show
94 * we also need to add 180 seconds at the end so the min/max
97 static int get_maxtime(struct plot_info *pi)
99 int seconds = pi->maxtime;
100 /* min 30 minutes, rounded up to 5 minutes, with at least 2.5 minutes to spare */
101 return MAX(30*60, ROUND_UP(seconds+150, 60*5));
104 static int get_maxdepth(struct plot_info *pi)
106 unsigned mm = pi->maxdepth;
107 /* Minimum 30m, rounded up to 10m, with at least 3m to spare */
108 return MAX(30000, ROUND_UP(mm+3000, 10000));
115 } text_render_options_t;
118 #define CENTER (-0.5)
125 static void plot_text(struct graphics_context *gc, const text_render_options_t *tro,
126 double x, double y, const char *fmt, ...)
128 cairo_t *cr = gc->cr;
129 cairo_font_extents_t fe;
130 cairo_text_extents_t extents;
136 vsnprintf(buffer, sizeof(buffer), fmt, args);
139 cairo_set_font_size(cr, tro->size);
140 cairo_font_extents(cr, &fe);
141 cairo_text_extents(cr, buffer, &extents);
142 dx = tro->hpos * extents.width + extents.x_bearing;
143 dy = tro->vpos * extents.height + fe.descent;
146 cairo_rel_move_to(cr, dx, dy);
148 cairo_text_path(cr, buffer);
149 set_source_rgb(gc, 0, 0, 0);
153 cairo_rel_move_to(cr, dx, dy);
155 set_source_rgb(gc, tro->r, tro->g, tro->b);
156 cairo_show_text(cr, buffer);
159 static void plot_one_event(struct graphics_context *gc, struct plot_info *pi, struct event *event, const text_render_options_t *tro)
163 for (i = 0; i < pi->nr; i++) {
164 struct plot_data *data = pi->entry + i;
165 if (event->time.seconds < data->sec)
169 plot_text(gc, tro, event->time.seconds, depth, "%s", event->name);
172 static void plot_events(struct graphics_context *gc, struct plot_info *pi, struct dive *dive)
174 static const text_render_options_t tro = {14, 1.0, 0.2, 0.2, CENTER, TOP};
175 struct event *event = dive->events;
181 plot_one_event(gc, pi, event, &tro);
186 static void render_depth_sample(struct graphics_context *gc, struct plot_data *entry, const text_render_options_t *tro)
188 int sec = entry->sec, decimals;
191 d = get_depth_units(entry->val, &decimals, NULL);
193 plot_text(gc, tro, sec, entry->val, "%.*f", decimals, d);
196 static void plot_text_samples(struct graphics_context *gc, struct plot_info *pi)
198 static const text_render_options_t deep = {14, 1.0, 0.2, 0.2, CENTER, TOP};
199 static const text_render_options_t shallow = {14, 1.0, 0.2, 0.2, CENTER, BOTTOM};
202 for (i = 0; i < pi->nr; i++) {
203 struct plot_data *entry = pi->entry + i;
205 if (entry->val < 2000)
208 if (entry == entry->max[2])
209 render_depth_sample(gc, entry, &deep);
211 if (entry == entry->min[2])
212 render_depth_sample(gc, entry, &shallow);
216 static void plot_depth_text(struct graphics_context *gc, struct plot_info *pi)
218 int maxtime, maxdepth;
220 /* Get plot scaling limits */
221 maxtime = get_maxtime(pi);
222 maxdepth = get_maxdepth(pi);
224 gc->leftx = 0; gc->rightx = maxtime;
225 gc->topy = 0; gc->bottomy = maxdepth;
227 plot_text_samples(gc, pi);
230 static void plot_smoothed_profile(struct graphics_context *gc, struct plot_info *pi)
233 struct plot_data *entry = pi->entry;
235 set_source_rgba(gc, 1, 0.2, 0.2, 0.20);
236 move_to(gc, entry->sec, entry->smoothed);
237 for (i = 1; i < pi->nr; i++) {
239 line_to(gc, entry->sec, entry->smoothed);
241 cairo_stroke(gc->cr);
244 static void plot_minmax_profile_minute(struct graphics_context *gc, struct plot_info *pi,
248 struct plot_data *entry = pi->entry;
250 set_source_rgba(gc, 1, 0.2, 1, a);
251 move_to(gc, entry->sec, entry->min[index]->val);
252 for (i = 1; i < pi->nr; i++) {
254 line_to(gc, entry->sec, entry->min[index]->val);
256 for (i = 1; i < pi->nr; i++) {
257 line_to(gc, entry->sec, entry->max[index]->val);
260 cairo_close_path(gc->cr);
264 static void plot_minmax_profile(struct graphics_context *gc, struct plot_info *pi)
268 plot_minmax_profile_minute(gc, pi, 2, 0.1);
269 plot_minmax_profile_minute(gc, pi, 1, 0.1);
270 plot_minmax_profile_minute(gc, pi, 0, 0.1);
273 static void plot_depth_profile(struct graphics_context *gc, struct plot_info *pi)
276 cairo_t *cr = gc->cr;
278 struct plot_data *entry;
279 int maxtime, maxdepth, marker;
281 /* Get plot scaling limits */
282 maxtime = get_maxtime(pi);
283 maxdepth = get_maxdepth(pi);
285 /* Time markers: every 5 min */
286 gc->leftx = 0; gc->rightx = maxtime;
287 gc->topy = 0; gc->bottomy = 1.0;
288 for (i = 5*60; i < maxtime; i += 5*60) {
293 /* Depth markers: every 30 ft or 10 m*/
294 gc->leftx = 0; gc->rightx = 1.0;
295 gc->topy = 0; gc->bottomy = maxdepth;
296 switch (output_units.length) {
297 case METERS: marker = 10000; break;
298 case FEET: marker = 9144; break; /* 30 ft */
301 set_source_rgba(gc, 1, 1, 1, 0.5);
302 for (i = marker; i < maxdepth; i += marker) {
308 /* Show mean depth */
309 set_source_rgba(gc, 1, 0.2, 0.2, 0.40);
310 move_to(gc, 0, pi->meandepth);
311 line_to(gc, 1, pi->meandepth);
314 gc->leftx = 0; gc->rightx = maxtime;
317 * These are good for debugging text placement etc,
318 * but not for actual display..
321 plot_smoothed_profile(gc, pi);
322 plot_minmax_profile(gc, pi);
325 set_source_rgba(gc, 1, 0.2, 0.2, 0.80);
327 /* Do the depth profile for the neat fill */
328 gc->topy = 0; gc->bottomy = maxdepth;
329 set_source_rgba(gc, 1, 0.2, 0.2, 0.20);
333 for (i = 0; i < pi->nr; i++, entry++)
334 line_to(gc, entry->sec, entry->val);
335 cairo_close_path(gc->cr);
337 set_source_rgba(gc, 1, 1, 1, 0.2);
338 cairo_fill_preserve(cr);
339 set_source_rgb(gc, 1, 1, 1);
345 /* Now do it again for the velocity colors */
347 for (i = 1; i < pi->nr; i++) {
350 /* we want to draw the segments in different colors
351 * representing the vertical velocity, so we need to
352 * chop this into short segments */
353 rgb_t color = rgb[entry->velocity];
355 set_source_rgb(gc, color.r, color.g, color.b);
356 move_to(gc, entry[-1].sec, entry[-1].val);
357 line_to(gc, sec, depth);
362 static int setup_temperature_limits(struct graphics_context *gc, struct plot_info *pi)
364 int maxtime, mintemp, maxtemp, delta;
366 /* Get plot scaling limits */
367 maxtime = get_maxtime(pi);
368 mintemp = pi->mintemp;
369 maxtemp = pi->maxtemp;
371 gc->leftx = 0; gc->rightx = maxtime;
372 /* Show temperatures in roughly the lower third, but make sure the scale
373 is at least somewhat reasonable */
374 delta = maxtemp - mintemp;
375 if (delta > 3000) { /* more than 3K in fluctuation */
376 gc->topy = maxtemp + delta*2;
377 gc->bottomy = mintemp - delta/2;
379 gc->topy = maxtemp + 1500 + delta*2;
380 gc->bottomy = mintemp - delta/2;
383 return maxtemp > mintemp;
386 static void plot_single_temp_text(struct graphics_context *gc, int sec, int mkelvin)
390 static const text_render_options_t tro = {12, 0.2, 0.2, 1.0, LEFT, TOP};
391 temperature_t temperature = { mkelvin };
393 if (output_units.temperature == FAHRENHEIT) {
394 deg = to_F(temperature);
395 unit = UTF8_DEGREE "F";
397 deg = to_C(temperature);
398 unit = UTF8_DEGREE "C";
400 plot_text(gc, &tro, sec, temperature.mkelvin, "%d%s", deg, unit);
403 static void plot_temperature_text(struct graphics_context *gc, struct plot_info *pi)
406 int last = 0, sec = 0;
407 int last_temperature = 0, last_printed_temp = 0;
409 if (!setup_temperature_limits(gc, pi))
412 for (i = 0; i < pi->nr; i++) {
413 struct plot_data *entry = pi->entry+i;
414 int mkelvin = entry->temperature;
418 last_temperature = mkelvin;
420 if (sec < last + 300)
423 plot_single_temp_text(gc,sec,mkelvin);
424 last_printed_temp = mkelvin;
426 /* it would be nice to print the end temperature, if it's different */
427 if (abs(last_temperature - last_printed_temp) > 500)
428 plot_single_temp_text(gc, sec, last_temperature);
431 static void plot_temperature_profile(struct graphics_context *gc, struct plot_info *pi)
434 cairo_t *cr = gc->cr;
437 if (!setup_temperature_limits(gc, pi))
440 set_source_rgba(gc, 0.2, 0.2, 1.0, 0.8);
441 for (i = 0; i < pi->nr; i++) {
442 struct plot_data *entry = pi->entry + i;
443 int mkelvin = entry->temperature;
444 int sec = entry->sec;
451 line_to(gc, sec, mkelvin);
453 move_to(gc, sec, mkelvin);
459 /* gets both the actual start and end pressure as well as the scaling factors */
460 static int get_cylinder_pressure_range(struct graphics_context *gc, struct plot_info *pi)
463 gc->rightx = get_maxtime(pi);
465 gc->bottomy = 0; gc->topy = pi->maxpressure * 1.5;
466 return pi->maxpressure != 0;
469 static void plot_cylinder_pressure(struct graphics_context *gc, struct plot_info *pi)
473 if (!get_cylinder_pressure_range(gc, pi))
476 set_source_rgba(gc, 0.2, 1.0, 0.2, 0.80);
478 move_to(gc, 0, pi->maxpressure);
479 for (i = 1; i < pi->nr; i++) {
481 struct plot_data *entry = pi->entry + i;
483 mbar = entry->pressure;
486 line_to(gc, entry->sec, mbar);
488 line_to(gc, pi->maxtime, pi->minpressure);
489 cairo_stroke(gc->cr);
492 static int mbar_to_PSI(int mbar)
494 pressure_t p = {mbar};
498 static void plot_cylinder_pressure_text(struct graphics_context *gc, struct plot_info *pi)
500 if (get_cylinder_pressure_range(gc, pi)) {
502 const char *unit = "bar";
504 switch (output_units.pressure) {
506 start = pi->maxpressure * 100;
507 end = pi->minpressure * 100;
511 start = (pi->maxpressure + 500) / 1000;
512 end = (pi->minpressure + 500) / 1000;
516 start = mbar_to_PSI(pi->maxpressure);
517 end = mbar_to_PSI(pi->minpressure);
522 text_render_options_t tro = {10, 0.2, 1.0, 0.2, LEFT, TOP};
523 plot_text(gc, &tro, 0, pi->maxpressure, "%d %s", start, unit);
524 plot_text(gc, &tro, pi->maxtime, pi->minpressure,
529 static void analyze_plot_info_minmax_minute(struct plot_data *entry, struct plot_data *first, struct plot_data *last, int index)
531 struct plot_data *p = entry;
532 int time = entry->sec;
533 int seconds = 90*(index+1);
534 struct plot_data *min, *max;
537 /* Go back 'seconds' in time */
539 if (p[-1].sec < time - seconds)
544 /* Then go forward until we hit an entry past the time */
550 if (p->sec > time + seconds)
559 entry->min[index] = min;
560 entry->max[index] = max;
561 entry->avg[index] = (avg + nr/2) / nr;
564 static void analyze_plot_info_minmax(struct plot_data *entry, struct plot_data *first, struct plot_data *last)
566 analyze_plot_info_minmax_minute(entry, first, last, 0);
567 analyze_plot_info_minmax_minute(entry, first, last, 1);
568 analyze_plot_info_minmax_minute(entry, first, last, 2);
571 static velocity_t velocity(int speed)
575 if (speed < -304) /* ascent faster than -60ft/min */
577 else if (speed < -152) /* above -30ft/min */
579 else if (speed < -76) /* -15ft/min */
581 else if (speed < -25) /* -5ft/min */
583 else if (speed < 25) /* very hard to find data, but it appears that the recommendations
584 for descent are usually about 2x ascent rate; still, we want
585 stable to mean stable */
587 else if (speed < 152) /* between 5 and 30ft/min is considered slow */
589 else if (speed < 304) /* up to 60ft/min is moderate */
591 else if (speed < 507) /* up to 100ft/min is fast */
593 else /* more than that is just crazy - you'll blow your ears out */
598 static struct plot_info *analyze_plot_info(struct plot_info *pi)
603 /* Do pressure min/max based on the non-surface data */
604 for (i = 0; i < nr; i++) {
605 struct plot_data *entry = pi->entry+i;
606 int pressure = entry->pressure;
607 int temperature = entry->temperature;
610 if (!pi->minpressure || pressure < pi->minpressure)
611 pi->minpressure = pressure;
612 if (pressure > pi->maxpressure)
613 pi->maxpressure = pressure;
617 if (!pi->mintemp || temperature < pi->mintemp)
618 pi->mintemp = temperature;
619 if (temperature > pi->maxtemp)
620 pi->maxtemp = temperature;
624 /* Smoothing function: 5-point triangular smooth */
625 for (i = 2; i < nr-1; i++) {
626 struct plot_data *entry = pi->entry+i;
630 val = entry[-2].val + 2*entry[-1].val + 3*entry[0].val + 2*entry[1].val + entry[2].val;
631 entry->smoothed = (val+4) / 9;
633 /* vertical velocity in mm/sec */
634 /* Linus wants to smooth this - let's at least look at the samples that aren't FAST or CRAZY */
635 if (entry[0].sec - entry[-1].sec) {
636 entry->velocity = velocity((entry[0].val - entry[-1].val) / (entry[0].sec - entry[-1].sec));
637 /* if our samples are short and we aren't too FAST*/
638 if (entry[0].sec - entry[-1].sec < 30 && entry->velocity < FAST) {
640 while (i+past > 0 && entry[0].sec - entry[past].sec < 30)
642 entry->velocity = velocity((entry[0].val - entry[past].val) /
643 (entry[0].sec - entry[past].sec));
646 entry->velocity = STABLE;
649 /* One-, two- and three-minute minmax data */
650 for (i = 0; i < nr; i++) {
651 struct plot_data *entry = pi->entry +i;
652 analyze_plot_info_minmax(entry, pi->entry, pi->entry+nr);
659 * Create a plot-info with smoothing and ranged min/max
661 * This also makes sure that we have extra empty events on both
662 * sides, so that you can do end-points without having to worry
665 static struct plot_info *create_plot_info(struct dive *dive)
667 int lastdepth, lastindex;
668 int i, nr = dive->samples + 4, sec;
669 size_t alloc_size = plot_info_size(nr);
670 struct plot_info *pi;
672 pi = malloc(alloc_size);
675 memset(pi, 0, alloc_size);
680 for (i = 0; i < dive->samples; i++) {
682 struct sample *sample = dive->sample+i;
683 struct plot_data *entry = pi->entry + i + 2;
685 sec = entry->sec = sample->time.seconds;
686 depth = entry->val = sample->depth.mm;
687 entry->pressure = sample->cylinderpressure.mbar;
688 entry->temperature = sample->temperature.mkelvin;
690 if (depth || lastdepth)
694 if (depth > pi->maxdepth)
695 pi->maxdepth = depth;
699 /* Fill in the last two entries with empty values but valid times */
700 i = dive->samples + 2;
701 pi->entry[i].sec = sec + 20;
702 pi->entry[i+1].sec = sec + 40;
704 pi->nr = lastindex+1;
705 pi->maxtime = pi->entry[lastindex].sec;
707 pi->minpressure = dive->cylinder[0].end.mbar;
708 pi->maxpressure = dive->cylinder[0].start.mbar;
710 pi->meandepth = dive->meandepth.mm;
712 return analyze_plot_info(pi);
715 void plot(struct graphics_context *gc, int w, int h, struct dive *dive)
718 struct plot_info *pi = create_plot_info(dive);
722 cairo_translate(gc->cr, topx, topy);
723 cairo_set_line_width(gc->cr, 2);
724 cairo_set_line_cap(gc->cr, CAIRO_LINE_CAP_ROUND);
725 cairo_set_line_join(gc->cr, CAIRO_LINE_JOIN_ROUND);
728 * We can use "cairo_translate()" because that doesn't
729 * scale line width etc. But the actual scaling we need
730 * do set up ourselves..
734 gc->maxx = (w - 2*topx);
735 gc->maxy = (h - 2*topy);
737 /* Temperature profile */
738 plot_temperature_profile(gc, pi);
740 /* Cylinder pressure plot */
741 plot_cylinder_pressure(gc, pi);
744 plot_depth_profile(gc, pi);
745 plot_events(gc, pi, dive);
747 /* Text on top of all graphs.. */
748 plot_temperature_text(gc, pi);
749 plot_depth_text(gc, pi);
750 plot_cylinder_pressure_text(gc, pi);
752 /* Bounding box last */
753 gc->leftx = 0; gc->rightx = 1.0;
754 gc->topy = 0; gc->bottomy = 1.0;
756 set_source_rgb(gc, 1, 1, 1);
761 cairo_close_path(gc->cr);
762 cairo_stroke(gc->cr);