src/viktrack.c

   1 /*
   2  * viking -- GPS Data and Topo Analyzer, Explorer, and Manager
   3  *
   4  * Copyright (C) 2003-2005, Evan Battaglia <gtoevan@gmx.net>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19  *
  20  */
  21 #ifdef HAVE_CONFIG_H
  22 #include "config.h"
  23 #endif
  24
  25 #include <glib.h>
  26 #include <time.h>
  27 #include <stdlib.h>
  28 #ifdef HAVE_STRING_H
  29 #include <string.h>
  30 #endif
  31 #ifdef HAVE_MATH_H
  32 #include <math.h>
  33 #endif
  34
  35 #include "coords.h"
  36 #include "vikcoord.h"
  37 #include "viktrack.h"
  38 #include "globals.h"
  39 #include "dems.h"
  40
  41 VikTrack *vik_track_new()
  42 {
  43   VikTrack *tr = g_malloc0 ( sizeof ( VikTrack ) );
  44   tr->ref_count = 1;
  45   return tr;
  46 }
  47
  48 void vik_track_set_comment_no_copy(VikTrack *tr, gchar *comment)
  49 {
  50   if ( tr->comment )
  51     g_free ( tr->comment );
  52   tr->comment = comment;
  53 }
  54
  55
  56 void vik_track_set_comment(VikTrack *tr, const gchar *comment)
  57 {
  58   if ( tr->comment )
  59     g_free ( tr->comment );
  60
  61   if ( comment && comment[0] != '\0' )
  62     tr->comment = g_strdup(comment);
  63   else
  64     tr->comment = NULL;
  65 }
  66
  67 void vik_track_ref(VikTrack *tr)
  68 {
  69   tr->ref_count++;
  70 }
  71
  72 void vik_track_set_property_dialog(VikTrack *tr, GtkWidget *dialog)
  73 {
  74   /* Warning: does not check for existing dialog */
  75   tr->property_dialog = dialog;
  76 }
  77
  78 void vik_track_clear_property_dialog(VikTrack *tr)
  79 {
  80   tr->property_dialog = NULL;
  81 }
  82
  83 void vik_track_free(VikTrack *tr)
  84 {
  85   if ( tr->ref_count-- > 1 )
  86     return;
  87
  88   if ( tr->comment )
  89     g_free ( tr->comment );
  90   g_list_foreach ( tr->trackpoints, (GFunc) g_free, NULL );
  91   g_list_free( tr->trackpoints );
  92   if (tr->property_dialog)
  93     if ( GTK_IS_WIDGET(tr->property_dialog) )
  94       gtk_widget_destroy ( GTK_WIDGET(tr->property_dialog) );
  95   g_free ( tr );
  96 }
  97
  98 VikTrack *vik_track_copy ( const VikTrack *tr )
  99 {
 100   VikTrack *new_tr = vik_track_new();
 101   VikTrackpoint *new_tp;
 102   GList *tp_iter = tr->trackpoints;
 103   new_tr->visible = tr->visible;
 104   new_tr->trackpoints = NULL;
 105   while ( tp_iter )
 106   {
 107     new_tp = g_malloc ( sizeof ( VikTrackpoint ) );
 108     *new_tp = *((VikTrackpoint *)(tp_iter->data));
 109     new_tr->trackpoints = g_list_append ( new_tr->trackpoints, new_tp );
 110     tp_iter = tp_iter->next;
 111   }
 112   vik_track_set_comment(new_tr,tr->comment);
 113   return new_tr;
 114 }
 115
 116 VikTrackpoint *vik_trackpoint_new()
 117 {
 118   VikTrackpoint *tp = g_malloc0(sizeof(VikTrackpoint));
 119   tp->speed = NAN;
 120   tp->course = NAN;
 121   tp->altitude = VIK_DEFAULT_ALTITUDE;
 122   tp->hdop = VIK_DEFAULT_DOP;
 123   tp->vdop = VIK_DEFAULT_DOP;
 124   tp->pdop = VIK_DEFAULT_DOP;
 125   return tp;
 126 }
 127
 128 void vik_trackpoint_free(VikTrackpoint *tp)
 129 {
 130   g_free(tp);
 131 }
 132
 133 VikTrackpoint *vik_trackpoint_copy(VikTrackpoint *tp)
 134 {
 135   VikTrackpoint *rv = vik_trackpoint_new();
 136   *rv = *tp;
 137   return rv;
 138 }
 139
 140 gdouble vik_track_get_length(const VikTrack *tr)
 141 {
 142   gdouble len = 0.0;
 143   if ( tr->trackpoints )
 144   {
 145     GList *iter = tr->trackpoints->next;
 146     while (iter)
 147     {
 148       if ( ! VIK_TRACKPOINT(iter->data)->newsegment )
 149         len += vik_coord_diff ( &(VIK_TRACKPOINT(iter->data)->coord),
 150                                 &(VIK_TRACKPOINT(iter->prev->data)->coord) );
 151       iter = iter->next;
 152     }
 153   }
 154   return len;
 155 }
 156
 157 gdouble vik_track_get_length_including_gaps(const VikTrack *tr)
 158 {
 159   gdouble len = 0.0;
 160   if ( tr->trackpoints )
 161   {
 162     GList *iter = tr->trackpoints->next;
 163     while (iter)
 164     {
 165       len += vik_coord_diff ( &(VIK_TRACKPOINT(iter->data)->coord),
 166                               &(VIK_TRACKPOINT(iter->prev->data)->coord) );
 167       iter = iter->next;
 168     }
 169   }
 170   return len;
 171 }
 172
 173 gulong vik_track_get_tp_count(const VikTrack *tr)
 174 {
 175   gulong num = 0;
 176   GList *iter = tr->trackpoints;
 177   while ( iter )
 178   {
 179     num++;
 180     iter = iter->next;
 181   }
 182   return num;
 183 }
 184
 185 gulong vik_track_get_dup_point_count ( const VikTrack *tr )
 186 {
 187   gulong num = 0;
 188   GList *iter = tr->trackpoints;
 189   while ( iter )
 190   {
 191     if ( iter->next && vik_coord_equals ( &(VIK_TRACKPOINT(iter->data)->coord),
 192                        &(VIK_TRACKPOINT(iter->next->data)->coord) ) )
 193       num++;
 194     iter = iter->next;
 195   }
 196   return num;
 197 }
 198
 199 void vik_track_remove_dup_points ( VikTrack *tr )
 200 {
 201   GList *iter = tr->trackpoints;
 202   while ( iter )
 203   {
 204     if ( iter->next && vik_coord_equals ( &(VIK_TRACKPOINT(iter->data)->coord),
 205                        &(VIK_TRACKPOINT(iter->next->data)->coord) ) )
 206     {
 207       g_free ( iter->next->data );
 208       tr->trackpoints = g_list_delete_link ( tr->trackpoints, iter->next );
 209     }
 210     else
 211       iter = iter->next;
 212   }
 213 }
 214
 215 guint vik_track_get_segment_count(const VikTrack *tr)
 216 {
 217   guint num = 1;
 218   GList *iter = tr->trackpoints;
 219   if ( !iter )
 220     return 0;
 221   while ( (iter = iter->next) )
 222   {
 223     if ( VIK_TRACKPOINT(iter->data)->newsegment )
 224       num++;
 225   }
 226   return num;
 227 }
 228
 229 VikTrack **vik_track_split_into_segments(VikTrack *t, guint *ret_len)
 230 {
 231   VikTrack **rv;
 232   VikTrack *tr;
 233   guint i;
 234   guint segs = vik_track_get_segment_count(t);
 235   GList *iter;
 236
 237   if ( segs < 2 )
 238   {
 239     *ret_len = 0;
 240     return NULL;
 241   }
 242
 243   rv = g_malloc ( segs * sizeof(VikTrack *) );
 244   tr = vik_track_copy ( t );
 245   rv[0] = tr;
 246   iter = tr->trackpoints;
 247
 248   i = 1;
 249   while ( (iter = iter->next) )
 250   {
 251     if ( VIK_TRACKPOINT(iter->data)->newsegment )
 252     {
 253       iter->prev->next = NULL;
 254       iter->prev = NULL;
 255       rv[i] = vik_track_new();
 256       if ( tr->comment )
 257         vik_track_set_comment ( rv[i], tr->comment );
 258       rv[i]->visible = tr->visible;
 259       rv[i]->trackpoints = iter;
 260       i++;
 261     }
 262   }
 263   *ret_len = segs;
 264   return rv;
 265 }
 266
 267 void vik_track_reverse ( VikTrack *tr )
 268 {
 269   GList *iter;
 270   tr->trackpoints = g_list_reverse(tr->trackpoints);
 271
 272   /* fix 'newsegment' */
 273   iter = g_list_last ( tr->trackpoints );
 274   while ( iter )
 275   {
 276     if ( ! iter->next ) /* last segment, was first, cancel newsegment. */
 277       VIK_TRACKPOINT(iter->data)->newsegment = FALSE;
 278     if ( ! iter->prev ) /* first segment by convention has newsegment flag. */
 279       VIK_TRACKPOINT(iter->data)->newsegment = TRUE;
 280     else if ( VIK_TRACKPOINT(iter->data)->newsegment && iter->next )
 281     {
 282       VIK_TRACKPOINT(iter->next->data)->newsegment = TRUE;
 283       VIK_TRACKPOINT(iter->data)->newsegment = FALSE;
 284     }
 285     iter = iter->prev;
 286   }
 287 }
 288
 289 gdouble vik_track_get_average_speed(const VikTrack *tr)
 290 {
 291   gdouble len = 0.0;
 292   guint32 time = 0;
 293   if ( tr->trackpoints )
 294   {
 295     GList *iter = tr->trackpoints->next;
 296     while (iter)
 297     {
 298       if ( VIK_TRACKPOINT(iter->data)->has_timestamp &&
 299           VIK_TRACKPOINT(iter->prev->data)->has_timestamp &&
 300           (! VIK_TRACKPOINT(iter->data)->newsegment) )
 301       {
 302         len += vik_coord_diff ( &(VIK_TRACKPOINT(iter->data)->coord),
 303                                 &(VIK_TRACKPOINT(iter->prev->data)->coord) );
 304         time += ABS(VIK_TRACKPOINT(iter->data)->timestamp - VIK_TRACKPOINT(iter->prev->data)->timestamp);
 305       }
 306       iter = iter->next;
 307     }
 308   }
 309   return (time == 0) ? 0 : ABS(len/time);
 310 }
 311
 312 gdouble vik_track_get_max_speed(const VikTrack *tr)
 313 {
 314   gdouble maxspeed = 0.0, speed = 0.0;
 315   if ( tr->trackpoints )
 316   {
 317     GList *iter = tr->trackpoints->next;
 318     while (iter)
 319     {
 320       if ( VIK_TRACKPOINT(iter->data)->has_timestamp &&
 321           VIK_TRACKPOINT(iter->prev->data)->has_timestamp &&
 322           (! VIK_TRACKPOINT(iter->data)->newsegment) )
 323       {
 324         speed =  vik_coord_diff ( &(VIK_TRACKPOINT(iter->data)->coord), &(VIK_TRACKPOINT(iter->prev->data)->coord) )
 325                  / ABS(VIK_TRACKPOINT(iter->data)->timestamp - VIK_TRACKPOINT(iter->prev->data)->timestamp);
 326         if ( speed > maxspeed )
 327           maxspeed = speed;
 328       }
 329       iter = iter->next;
 330     }
 331   }
 332   return maxspeed;
 333 }
 334
 335 void vik_track_convert ( VikTrack *tr, VikCoordMode dest_mode )
 336 {
 337   GList *iter = tr->trackpoints;
 338   while (iter)
 339   {
 340     vik_coord_convert ( &(VIK_TRACKPOINT(iter->data)->coord), dest_mode );
 341     iter = iter->next;
 342   }
 343 }
 344
 345 /* I understood this when I wrote it ... maybe ... Basically it eats up the
 346  * proper amounts of length on the track and averages elevation over that. */
 347 gdouble *vik_track_make_elevation_map ( const VikTrack *tr, guint16 num_chunks )
 348 {
 349   gdouble *pts;
 350   gdouble total_length, chunk_length, current_dist, current_area_under_curve, current_seg_length, dist_along_seg = 0.0;
 351   gdouble altitude1, altitude2;
 352   guint16 current_chunk;
 353   gboolean ignore_it = FALSE;
 354
 355   GList *iter = tr->trackpoints;
 356
 357   if (!iter || !iter->next) /* zero- or one-point track */
 358           return NULL;
 359
 360   { /* test if there's anything worth calculating */
 361     gboolean okay = FALSE;
 362     while ( iter )
 363     {
 364       if ( VIK_TRACKPOINT(iter->data)->altitude != VIK_DEFAULT_ALTITUDE ) {
 365         okay = TRUE; break;
 366       }
 367       iter = iter->next;
 368     }
 369     if ( ! okay )
 370       return NULL;
 371   }
 372
 373   iter = tr->trackpoints;
 374
 375   g_assert ( num_chunks < 16000 );
 376
 377   pts = g_malloc ( sizeof(gdouble) * num_chunks );
 378
 379   total_length = vik_track_get_length_including_gaps ( tr );
 380   chunk_length = total_length / num_chunks;
 381
 382   /* Zero chunk_length (eg, track of 2 tp with the same loc) will cause crash */
 383   if (chunk_length <= 0) {
 384     g_free(pts);
 385     return NULL;
 386   }
 387
 388   current_dist = 0.0;
 389   current_area_under_curve = 0;
 390   current_chunk = 0;
 391   current_seg_length = 0;
 392
 393   current_seg_length = vik_coord_diff ( &(VIK_TRACKPOINT(iter->data)->coord),
 394       &(VIK_TRACKPOINT(iter->next->data)->coord) );
 395   altitude1 = VIK_TRACKPOINT(iter->data)->altitude;
 396   altitude2 = VIK_TRACKPOINT(iter->next->data)->altitude;
 397   dist_along_seg = 0;
 398
 399   while ( current_chunk < num_chunks ) {
 400
 401     /* go along current seg */
 402     if ( current_seg_length && (current_seg_length - dist_along_seg) > chunk_length ) {
 403       dist_along_seg += chunk_length;
 404
 405       /*        /
 406        *   pt2 *
 407        *      /x       altitude = alt_at_pt_1 + alt_at_pt_2 / 2 = altitude1 + slope * dist_value_of_pt_inbetween_pt1_and_pt2
 408        *     /xx   avg altitude = area under curve / chunk len
 409        *pt1 *xxx   avg altitude = altitude1 + (altitude2-altitude1)/(current_seg_length)*(dist_along_seg + (chunk_len/2))
 410        *   / xxx
 411        *  /  xxx
 412        **/
 413
 414       if ( ignore_it )
 415         pts[current_chunk] = VIK_DEFAULT_ALTITUDE;
 416       else
 417         pts[current_chunk] = altitude1 + (altitude2-altitude1)*((dist_along_seg - (chunk_length/2))/current_seg_length);
 418
 419       current_chunk++;
 420     } else {
 421       /* finish current seg */
 422       if ( current_seg_length ) {
 423         gdouble altitude_at_dist_along_seg = altitude1 + (altitude2-altitude1)/(current_seg_length)*dist_along_seg;
 424         current_dist = current_seg_length - dist_along_seg;
 425         current_area_under_curve = current_dist*(altitude_at_dist_along_seg + altitude2)*0.5;
 426       } else { current_dist = current_area_under_curve = 0; } /* should only happen if first current_seg_length == 0 */
 427
 428       /* get intervening segs */
 429       iter = iter->next;
 430       while ( iter && iter->next ) {
 431         current_seg_length = vik_coord_diff ( &(VIK_TRACKPOINT(iter->data)->coord),
 432             &(VIK_TRACKPOINT(iter->next->data)->coord) );
 433         altitude1 = VIK_TRACKPOINT(iter->data)->altitude;
 434         altitude2 = VIK_TRACKPOINT(iter->next->data)->altitude;
 435         ignore_it = VIK_TRACKPOINT(iter->next->data)->newsegment;
 436
 437         if ( chunk_length - current_dist >= current_seg_length ) {
 438           current_dist += current_seg_length;
 439           current_area_under_curve += current_seg_length * (altitude1+altitude2) * 0.5;
 440           iter = iter->next;
 441         } else {
 442           break;
 443         }
 444       }
 445
 446       /* final seg */
 447       dist_along_seg = chunk_length - current_dist;
 448       if ( ignore_it || !iter->next ) {
 449         pts[current_chunk] = current_area_under_curve / current_dist;
 450         if (!iter->next) {
 451           int i;
 452           for (i = current_chunk + 1; i < num_chunks; i++)
 453             pts[i] = pts[current_chunk];
 454           break;
 455         }
 456       }
 457       else {
 458         current_area_under_curve += dist_along_seg * (altitude1 + (altitude2 - altitude1)*dist_along_seg/current_seg_length);
 459         pts[current_chunk] = current_area_under_curve / chunk_length;
 460       }
 461
 462       current_dist = 0;
 463       current_chunk++;
 464     }
 465   }
 466
 467   return pts;
 468 }
 469
 470
 471 void vik_track_get_total_elevation_gain(const VikTrack *tr, gdouble *up, gdouble *down)
 472 {
 473   gdouble diff;
 474   *up = *down = 0;
 475   if ( tr->trackpoints && VIK_TRACKPOINT(tr->trackpoints->data)->altitude != VIK_DEFAULT_ALTITUDE )
 476   {
 477     GList *iter = tr->trackpoints->next;
 478     while (iter)
 479     {
 480       diff = VIK_TRACKPOINT(iter->data)->altitude - VIK_TRACKPOINT(iter->prev->data)->altitude;
 481       if ( diff > 0 )
 482         *up += diff;
 483       else
 484         *down -= diff;
 485       iter = iter->next;
 486     }
 487   } else
 488     *up = *down = VIK_DEFAULT_ALTITUDE;
 489 }
 490
 491
 492 /* by Alex Foobarian */
 493 gdouble *vik_track_make_speed_map ( const VikTrack *tr, guint16 num_chunks )
 494 {
 495   gdouble *v, *s, *t;
 496   gdouble duration, chunk_dur;
 497   time_t t1, t2;
 498   int i, pt_count, numpts, index;
 499   GList *iter;
 500
 501   if ( ! tr->trackpoints )
 502     return NULL;
 503
 504   g_assert ( num_chunks < 16000 );
 505
 506   t1 = VIK_TRACKPOINT(tr->trackpoints->data)->timestamp;
 507   t2 = VIK_TRACKPOINT(g_list_last(tr->trackpoints)->data)->timestamp;
 508   duration = t2 - t1;
 509
 510   if ( !t1 || !t2 || !duration )
 511     return NULL;
 512
 513   if (duration < 0) {
 514     g_warning("negative duration: unsorted trackpoint timestamps?");
 515     return NULL;
 516   }
 517   pt_count = vik_track_get_tp_count(tr);
 518
 519   v = g_malloc ( sizeof(gdouble) * num_chunks );
 520   chunk_dur = duration / num_chunks;
 521
 522   s = g_malloc(sizeof(double) * pt_count);
 523   t = g_malloc(sizeof(double) * pt_count);
 524
 525   iter = tr->trackpoints->next;
 526   numpts = 0;
 527   s[0] = 0;
 528   t[0] = VIK_TRACKPOINT(iter->prev->data)->timestamp;
 529   numpts++;
 530   while (iter) {
 531     s[numpts] = s[numpts-1] + vik_coord_diff ( &(VIK_TRACKPOINT(iter->prev->data)->coord), &(VIK_TRACKPOINT(iter->data)->coord) );
 532     t[numpts] = VIK_TRACKPOINT(iter->data)->timestamp;
 533     numpts++;
 534     iter = iter->next;
 535   }
 536
 537   /* In the following computation, we iterate through periods of time of duration chunk_dur.
 538    * The first period begins at the beginning of the track.  The last period ends at the end of the track.
 539    */
 540   index = 0; /* index of the current trackpoint. */
 541   for (i = 0; i < num_chunks; i++) {
 542     /* we are now covering the interval from t[0] + i*chunk_dur to t[0] + (i+1)*chunk_dur.
 543      * find the first trackpoint outside the current interval, averaging the speeds between intermediate trackpoints.
 544      */
 545     if (t[0] + i*chunk_dur >= t[index]) {
 546       gdouble acc_t = 0, acc_s = 0;
 547       numpts = 0;
 548       while (t[0] + i*chunk_dur >= t[index]) {
 549         acc_s += (s[index+1]-s[index]);
 550         acc_t += (t[index+1]-t[index]);
 551         index++;
 552         numpts++;
 553       }
 554       v[i] = acc_s/acc_t;
 555     }
 556     else if (i) {
 557       v[i] = v[i-1];
 558     }
 559     else {
 560       v[i] = 0;
 561     }
 562   }
 563   g_free(s);
 564   g_free(t);
 565   return v;
 566 }
 567
 568 /* by Alex Foobarian */
 569 VikTrackpoint *vik_track_get_closest_tp_by_percentage_dist ( VikTrack *tr, gdouble reldist, gdouble *meters_from_start )
 570 {
 571   gdouble dist = vik_track_get_length_including_gaps(tr) * reldist;
 572   gdouble current_dist = 0.0;
 573   gdouble current_inc = 0.0;
 574   if ( tr->trackpoints )
 575   {
 576     GList *iter = tr->trackpoints->next;
 577     GList *last_iter = NULL;
 578     gdouble last_dist = 0.0;
 579     while (iter)
 580     {
 581       current_inc = vik_coord_diff ( &(VIK_TRACKPOINT(iter->data)->coord),
 582                                      &(VIK_TRACKPOINT(iter->prev->data)->coord) );
 583       last_dist = current_dist;
 584       current_dist += current_inc;
 585       if ( current_dist >= dist )
 586         break;
 587       last_iter = iter;
 588       iter = iter->next;
 589     }
 590     if (!iter) { /* passing the end the track */
 591       if (last_iter) {
 592         if (meters_from_start)
 593           *meters_from_start = last_dist;
 594         return(VIK_TRACKPOINT(last_iter->data));
 595       }
 596       else
 597         return NULL;
 598     }
 599     /* we've gone past the dist already, was prev trackpoint closer? */
 600     /* should do a vik_coord_average_weighted() thingy. */
 601     if ( iter->prev && abs(current_dist-current_inc-dist) < abs(current_dist-dist) ) {
 602       if (meters_from_start)
 603         *meters_from_start = last_dist;
 604       iter = iter->prev;
 605     }
 606     else
 607       if (meters_from_start)
 608         *meters_from_start = current_dist;
 609
 610     return VIK_TRACKPOINT(iter->data);
 611
 612   }
 613   return NULL;
 614 }
 615
 616 VikTrackpoint *vik_track_get_closest_tp_by_percentage_time ( VikTrack *tr, gdouble reltime, time_t *seconds_from_start )
 617 {
 618   time_t t_pos, t_start, t_end, t_total;
 619   t_start = VIK_TRACKPOINT(tr->trackpoints->data)->timestamp;
 620   t_end = VIK_TRACKPOINT(g_list_last(tr->trackpoints)->data)->timestamp;
 621   t_total = t_end - t_start;
 622
 623   t_pos = t_start + t_total * reltime;
 624
 625   if ( !tr->trackpoints )
 626     return NULL;
 627
 628   GList *iter = tr->trackpoints;
 629
 630   while (iter) {
 631     if (VIK_TRACKPOINT(iter->data)->timestamp == t_pos)
 632       break;
 633     if (VIK_TRACKPOINT(iter->data)->timestamp > t_pos) {
 634       if (iter->prev == NULL)  /* first trackpoint */
 635         break;
 636       time_t t_before = t_pos - VIK_TRACKPOINT(iter->prev)->timestamp;
 637       time_t t_after = VIK_TRACKPOINT(iter->data)->timestamp - t_pos;
 638       if (t_before <= t_after)
 639         iter = iter->prev;
 640       break;
 641     }
 642     else if ((iter->next == NULL) && (t_pos < (VIK_TRACKPOINT(iter->data)->timestamp + 3))) /* last trackpoint: accommodate for round-off */
 643       break;
 644     iter = iter->next;
 645   }
 646
 647   if (!iter)
 648     return NULL;
 649   if (seconds_from_start)
 650     *seconds_from_start = VIK_TRACKPOINT(iter->data)->timestamp - VIK_TRACKPOINT(tr->trackpoints->data)->timestamp;
 651   return VIK_TRACKPOINT(iter->data);
 652 }
 653
 654 VikTrackpoint* vik_track_get_tp_by_max_speed ( const VikTrack *tr )
 655 {
 656   gdouble maxspeed = 0.0, speed = 0.0;
 657
 658   if ( !tr->trackpoints )
 659     return NULL;
 660
 661   GList *iter = tr->trackpoints;
 662   VikTrackpoint *max_speed_tp = NULL;
 663
 664   while (iter) {
 665     if (iter->prev) {
 666       if ( VIK_TRACKPOINT(iter->data)->has_timestamp &&
 667            VIK_TRACKPOINT(iter->prev->data)->has_timestamp &&
 668            (! VIK_TRACKPOINT(iter->data)->newsegment) ) {
 669         speed =  vik_coord_diff ( &(VIK_TRACKPOINT(iter->data)->coord), &(VIK_TRACKPOINT(iter->prev->data)->coord) )
 670           / ABS(VIK_TRACKPOINT(iter->data)->timestamp - VIK_TRACKPOINT(iter->prev->data)->timestamp);
 671         if ( speed > maxspeed ) {
 672           maxspeed = speed;
 673           max_speed_tp = VIK_TRACKPOINT(iter->data);
 674         }
 675       }
 676     }
 677     iter = iter->next;
 678   }
 679
 680   if (!max_speed_tp)
 681     return NULL;
 682
 683   return max_speed_tp;
 684 }
 685
 686 VikTrackpoint* vik_track_get_tp_by_max_alt ( const VikTrack *tr )
 687 {
 688   gdouble maxalt = -5000.0;
 689   if ( !tr->trackpoints )
 690     return NULL;
 691
 692   GList *iter = tr->trackpoints;
 693   VikTrackpoint *max_alt_tp = NULL;
 694
 695   while (iter) {
 696     if ( VIK_TRACKPOINT(iter->data)->altitude > maxalt ) {
 697       maxalt = VIK_TRACKPOINT(iter->data)->altitude;
 698       max_alt_tp = VIK_TRACKPOINT(iter->data);
 699     }
 700     iter = iter->next;
 701   }
 702
 703   if (!max_alt_tp)
 704     return NULL;
 705
 706   return max_alt_tp;
 707 }
 708
 709 VikTrackpoint* vik_track_get_tp_by_min_alt ( const VikTrack *tr )
 710 {
 711   gdouble minalt = 25000.0;
 712   if ( !tr->trackpoints )
 713     return NULL;
 714
 715   GList *iter = tr->trackpoints;
 716   VikTrackpoint *min_alt_tp = NULL;
 717
 718   while (iter) {
 719     if ( VIK_TRACKPOINT(iter->data)->altitude < minalt ) {
 720       minalt = VIK_TRACKPOINT(iter->data)->altitude;
 721       min_alt_tp = VIK_TRACKPOINT(iter->data);
 722     }
 723     iter = iter->next;
 724   }
 725
 726   if (!min_alt_tp)
 727     return NULL;
 728
 729   return min_alt_tp;
 730 }
 731
 732 gboolean vik_track_get_minmax_alt ( const VikTrack *tr, gdouble *min_alt, gdouble *max_alt )
 733 {
 734   *min_alt = 25000;
 735   *max_alt = -5000;
 736   if ( tr && tr->trackpoints && tr->trackpoints->data && (VIK_TRACKPOINT(tr->trackpoints->data)->altitude != VIK_DEFAULT_ALTITUDE) ) {
 737     GList *iter = tr->trackpoints->next;
 738     gdouble tmp_alt;
 739     while (iter)
 740     {
 741       tmp_alt = VIK_TRACKPOINT(iter->data)->altitude;
 742       if ( tmp_alt > *max_alt )
 743         *max_alt = tmp_alt;
 744       if ( tmp_alt < *min_alt )
 745         *min_alt = tmp_alt;
 746       iter = iter->next;
 747     }
 748     return TRUE;
 749   }
 750   return FALSE;
 751 }
 752
 753 void vik_track_marshall ( VikTrack *tr, guint8 **data, guint *datalen)
 754 {
 755   GList *tps;
 756   GByteArray *b = g_byte_array_new();
 757   guint len;
 758   guint intp, ntp;
 759
 760   g_byte_array_append(b, (guint8 *)tr, sizeof(*tr));
 761
 762   /* we'll fill out number of trackpoints later */
 763   intp = b->len;
 764   g_byte_array_append(b, (guint8 *)&len, sizeof(len));
 765
 766   tps = tr->trackpoints;
 767   ntp = 0;
 768   while (tps) {
 769     g_byte_array_append(b, (guint8 *)tps->data, sizeof(VikTrackpoint));
 770     tps = tps->next;
 771     ntp++;
 772   }
 773   *(guint *)(b->data + intp) = ntp;
 774
 775   len = (tr->comment) ? strlen(tr->comment)+1 : 0;
 776   g_byte_array_append(b, (guint8 *)&len, sizeof(len));
 777   if (tr->comment) g_byte_array_append(b, (guint8 *)tr->comment, len);
 778
 779   *data = b->data;
 780   *datalen = b->len;
 781   g_byte_array_free(b, FALSE);
 782 }
 783
 784 VikTrack *vik_track_unmarshall (guint8 *data, guint datalen)
 785 {
 786   guint len;
 787   VikTrack *new_tr = vik_track_new();
 788   VikTrackpoint *new_tp;
 789   guint ntp;
 790   gint i;
 791
 792   /* only the visibility is needed */
 793   new_tr->visible = ((VikTrack *)data)->visible;
 794   data += sizeof(*new_tr);
 795
 796   ntp = *(guint *)data;
 797   data += sizeof(ntp);
 798
 799   for (i=0; i<ntp; i++) {
 800     new_tp = vik_trackpoint_new();
 801     memcpy(new_tp, data, sizeof(*new_tp));
 802     data += sizeof(*new_tp);
 803     new_tr->trackpoints = g_list_append(new_tr->trackpoints, new_tp);
 804   }
 805
 806   len = *(guint *)data;
 807   data += sizeof(len);
 808   if (len) {
 809     new_tr->comment = g_strdup((gchar *)data);
 810   }
 811   return new_tr;
 812 }
 813
 814 void vik_track_apply_dem_data ( VikTrack *tr )
 815 {
 816   GList *tp_iter;
 817   gint16 elev;
 818   tp_iter = tr->trackpoints;
 819   while ( tp_iter ) {
 820     /* TODO: of the 4 possible choices we have for choosing an elevation
 821      * (trackpoint in between samples), choose the one with the least elevation change
 822      * as the last */
 823     elev = a_dems_get_elev_by_coord ( &(VIK_TRACKPOINT(tp_iter->data)->coord), VIK_DEM_INTERPOL_BEST );
 824     if ( elev != VIK_DEM_INVALID_ELEVATION )
 825       VIK_TRACKPOINT(tp_iter->data)->altitude = elev;
 826     tp_iter = tp_iter->next;
 827   }
 828 }
 829
 830 /* appends t2 to t1, leaving t2 with no trackpoints */
 831 void vik_track_steal_and_append_trackpoints ( VikTrack *t1, VikTrack *t2 )
 832 {
 833   if ( t1->trackpoints ) {
 834     GList *tpiter = t1->trackpoints;
 835     while ( tpiter->next )
 836       tpiter = tpiter->next;
 837     tpiter->next = t2->trackpoints;
 838     t2->trackpoints->prev = tpiter;
 839   } else
 840     t1->trackpoints = t2->trackpoints;
 841   t2->trackpoints = NULL;
 842 }
 843
 844 /* starting at the end, looks backwards for the last "double point", a duplicate trackpoint.
 845  * this is indicative of magic scissors continued use. If there is no double point,
 846  * deletes all the trackpoints. Returns the new end of the track (or the start if
 847  * there are no double points
 848  */
 849 VikCoord *vik_track_cut_back_to_double_point ( VikTrack *tr )
 850 {
 851   GList *iter = tr->trackpoints;
 852   VikCoord *rv;
 853
 854   if ( !iter )
 855     return NULL;
 856   while ( iter->next )
 857     iter = iter->next;
 858
 859
 860   while ( iter->prev ) {
 861     if ( vik_coord_equals((VikCoord *)iter->data, (VikCoord *)iter->prev->data) ) {
 862       GList *prev = iter->prev;
 863
 864       rv = g_malloc(sizeof(VikCoord));
 865       *rv = *((VikCoord *) iter->data);
 866
 867       /* truncate trackpoint list */
 868       iter->prev = NULL; /* pretend it's the end */
 869       g_list_foreach ( iter, (GFunc) g_free, NULL );
 870       g_list_free( iter );
 871
 872       prev->next = NULL;
 873
 874       return rv;
 875     }
 876     iter = iter->prev;
 877   }
 878
 879   /* no double point found! */
 880   rv = g_malloc(sizeof(VikCoord));
 881   *rv = *((VikCoord *) tr->trackpoints->data);
 882   g_list_foreach ( tr->trackpoints, (GFunc) g_free, NULL );
 883   g_list_free( tr->trackpoints );
 884   tr->trackpoints = NULL;
 885   return rv;
 886 }
 887