<=  Use event attributes  

  Map subpage  =>

Sailor Logbook App manual
History mainpage - Time ranges and outputs

Local TOC

General (toc)

The History mainpage gives access to ended track - i.e tracks with state RECORDED (and UPLOADED - covered later). Up to now only one track has been ended, the This is my first track, made using a City Bicycle Ride track in the Apple location simulator.

Two more tracks are now made in the simulator:

After tapping   Use date+clock   and   Set time range to whole history  , the History mainpage displays as:

Using date+clock mode

If you go to this page before anything was tracked, a message pops up:

Using date mode

The datepickers (toc)

Occupies the middle part of the page body and are constituted by two wheels, that specifies a time range, i.e. an interval ranging from Time from to Time till.

All track data are saved with a timestamp which includes seconds. The datepickers don't include seconds - but behind the scene, Time from has a zero seconds suffix, and Time till a 59 seconds suffix.

A track starts with departure time (short: Dep), i.e. the time tracking started. It ends at arrival time (short: Arr), i.e. the time tracking was ended.

The time range of a set of tracks spans from departure time of the oldest track till arrival time of the newest track. The time range defined by the datepickers cannot expand beyond that.

If you try to drag a wheel beyond these limits, it will bounce back to its lower or upper limit.

On the other hand, the time range of the datepickers can be narrowed down to just one minute - whether that minute is found in any track or not.

Example A: time range is expanded full to comprise whole history:

   ..................datepickers...................
   ....Track1....   ....Track2....    ....Track3....

Example B: time range only covers part of the history:

                         .....datepickers.....
   ....Track1....   ....Track2....    ....Track3....

The   Set time range to whole history   button is disabled in example A (after having been used), and is enabled in example B.

To avoid a Time from > Time till situation, it you drag one wheel beyond the value of the other, the latter will follow.

In the screen above, the datepickers operate in date+clock mode, which is needed if you need to specify a very exact or narrow time range.

By tapping   Use date only  , mode is changed to date only, which is the most comfortable way to look at whole days, and also reveals the year:

Using date only mode

The   Use date+clock   and   Use date only   buttons are mutually exclusive - tapping the one that is enabled will disable itself and enable the other.

Finally, the   Copy down   and   Copy up   buttons attached to the datepickers can be helpful when defining narrow time ranges (in date+clock mode) or same day (in date only mode). Both are disabled when the wheels are set equal.

When you have set a time range, the four   Show   buttons at the top - as well as the tiny   Bt   button - give different outputs but covers the same period. You can jump to other pages and still have a time range preserved on return.

The Map and the Report buttons (toc)

Both the   Map   button (opening Map subpage) and the   Report   button (opening Report subpage) operate on track sections, i.e. straight lines connecting adjacent plots. Together, the lines constitute chronologically consecutive part(s) of one or more tracks.

For something to be drawn on the Map, at least one track section must live within the given time range, meaning at least two plots must have timestamp falling within the time range *).

For something to be listed in the Report, at least one plot must have timestamp falling within the time range *).

*) Plots may or may not have events attached.

Example C: time range comprises parts of two tracks:

                           ----TimeRange----
   ....Track1....   ....Track2....    ....Track3....

** Result: parts of both Track2 and Track3 are included in the Map and Report.

Example D: time range comprises one whole track and part of another:

                   -------TimeRange-------
   ....Track1....   ....Track2....    ....Track3....

** Result: whole Track2 and parts of Track3 are included in the Map and Report.

Anyway, if nothing can be drawn or reported, a message appears after tapping one of the show buttons:

mpHistoryTimeRangesOutputs_nothing2.png

The two Tracklist buttons (toc)

The   Tracklist (asc)   and the   Tracklist (desc)   button (which both open the Tracklist subpage) operate on whole tracks.

Tap   Set time range to whole history   and   Tracklist (desc)   to make your newest track appear first in the Tracklist.

Example E: Time range comprises one whole track:

                  ----TimeRange----
   ....Track1....   ....Track2....    ....Track3....

** Result: Track2 is included in the Tracklist.

Example F: Time range does not comprise any whole track:

                        ----TimeRange----
   ....Track1....   ....Track2....    ....Track3....

** Result: nothing is included.

Example G: Time range comprises two whole tracks, but not only whole tracks:

              ------------TimeRange-----------------
   ....Track1....   ....Track2....    ....Track3....

** Result: Track2 and Track3 are included.

If nothing can be included in a Tracklist, a message appears after tapping one of the show buttons:

mpHistoryTimeRangesOutputs_nothing3.png

The Bread text button (toc)

Also the tiny   Bt   button (which opens the Bread text subpage) operate on whole tracks.


Sailor Logbook App manual - © Copyright 2018 CoaSoft ApS Denmark

<=  Use event attributes  

  Map subpage  =>

Sailor Logbook App manual
History mainpage - Time ranges and outputs