<=  First start of app  

  Resuming a track  =>

Sailor Logbook App manual
Track mainpage - Your first track

Local TOC

Confirm start of tracking (toc)

When you have authorized the App to use the GPS, tap the   New ...   button a second time to open this dialog:

mpTrackFirstTrack_startingFirstTrack.png

The purpose is preventing unintended start. After having confirmed, the GPS is warming up to fetch a first location (may take some time, depending on conditions and when the GPS was last used) and tracking starts:

GPS is warming up

The small GPS active icon (at the top of the screen, next to the battery icon) is now turned on.

If this doesn't happen and no next screen appears, you are probably trying to track on an iPad without GPS (without cellular option) - check the Restrictions.

In this situation, only the   End ...   button is enabled. Use it if you didn't mean to start a new track.

When the GPS is warmed up, and a first position - plot number 1 - has been captured, the screen shows the:

Track mainpage when tracking

mpTrackFirstTrack_waitingToMove.png

and the App waits for you to move approximately 200 meter before a next plot is made - whereafter the progress is seen.

The two textfields can be left blank or be filled in before, during or after tracking.

Note that their labels are changed from ... (next track) to ... (current track).

Tracking in progress (toc)

If not done already, the textfields can be filled in now:

Tracking in progress

Tapping outside a textfield makes the keyboard disappear, and a full screen appears:

mpTrackFirstTrack_afterSomePlots.png

Some so far statistics are displayed:

Promt Meaning / remark
Dep Departure time, i.e. the time you started tracking
Arr Arrival time, i.e. the time the last plot was done
State State of the track (here: BEING TRACKED)
Plots Number of plots
Len Tracklength
ET Elapsed Time, i.e. time from departure to arrival
AvS Average speed between first and last plot
Max Maximal speed from GPS at any plot
Current course From GPS, only shown when tracking
Current speed From GPS, only shown when tracking

Tracklength is shown in meter during the first 1000 meter - thereafter it's shown in Nautical Miles (nm) by default. Speed is shown in knots (nm / Hour), also by default.

Now that the tracking is in progress, the three buttons at the bottom are enabled. A tap on   New event   opens the:

Event editor (toc)

Event editor

On small screens not all lines in the editor are visible - in that case drag a heading (e.g. Weather and waves:) to scroll the page.

Above is the initial layout for this Event editor (the With pickerscreens type) when tracking. The   Instant   button in the green navigation bar is the special Instant plot button and is present only:

After entering some data

- the   Instant   button is replaced by a   Reset   button:

mpTrackFirstTrack_eventEditor2.png

The yellow background indicates state BEING TRACKED.

An event is a collection of observations and actions. Each of these is recorded in an event attribute - e.g. the action of Setting full sails is recorded as a value in a Change of sail attribute. Events are attached to plots, which have location and timestamp.

In this case a text-note is made, and attribute values for change of sail, for change of engine, for wind direction and for wind force are set by tapping the corresponding lines and then selecting a line from the corresponding pickerscreen, e.g:

Event editor picker screen example.png

The event editors comprise up to five attribute sets, each comprising two attributes. The Wind direction and force and the Current direction and force sets are connected sets - i.e. the two attributes inside the sets have a relationship.

For example: you must set a wind direction after setting a wind force - and vice versa.

Attribute values can be set mutually independently - except inside connected sets. For details, see Event editor checks.

Switch settings in the Use event attributes section of the Settings mainpage control which of the attribute sets to use.

Items in the Wind force group have several setup options, as described in the Behaviour section of the Settings mainpage.

The value of an attibute is set or changed by tapping a line in the editor and then selecting a line from the corresponding pickerscreen. In the editor, use:

In this case,   Done   was tapped, whereby a user event was created - after a number of Event editor checks were performed.

The event is made when you have moved approximately 5 meter after pressing   Done  . It's best to keep moving while tracking.

Back in the Track mainpage, tapping   Edit track   opens the:

Track editor (toc)

Track editor

Also here, yellow background indicates state BEING TRACKED.

As can be seen, the same content for the two textfields as was entered in the Track mainpage is displayed. The fields may be edited either place, what is most convenient.

Use the   Cancel   and the   Done   buttons just like in the Event editor (before   Done   is accepted, a number of Track editor checks are performed).

Tapping   Show list with X events   at the bottom opens the:

Eventlist (toc)

mpTrackFirstTrack_eventlist.png

In this example, the list has two cells with events: the first is an automatic First plot (green), the second is the event made before (red, will change to orange when a next plot has been made).

Red meaning last plot has priority over orange meaning user event plot.

Periodic events have dark grey color and are handled like orange plots.

Cell actions:

To: Do:
scroll a long page drag the left part of a cell
scroll a long event drag inside the cell
edit an event tap the disclosure button (  i   in a circle) in the right part of a cell *)
show an event on map tap the left part of a cell
delete an event swipe left (see Deleting events)
zoom a cell in/out pinch outward / inward inside the cell

Tapping the banana-colored area in the first cell below opens a map, dragging it scrolls the page - and tapping the banana-colored area in the second cell below opens the Event editor:

Show tap areas

*) This opens the Event editor - similar to what happened in the Track mainpage after tapping the   New event   button.

Deleting events (toc)

To delete you have two options:

However, you cannot delete the event attached to the first or the last plot:

mpTrackFirstTrack_deleteEvent1.png

A First plot event always exists for any track. A Last plot event only exists in tracks in state RECORDED (teal blue) and UPLOADED (grey). Both are needed at the Sailor Logbook Website for correct map drawing.

Furthermore, you cannot delete any event in tracks in state UPLOADED:

mpTrackFirstTrack_deleteEvent2.png

If a event record - or any other type of record - is deletable, it will not be deleted before you confirm:

mpTrackFirstTrack_deleteEvent3.png

Return to the Track mainpage is done by tapping   < Edit track   and then   Cancel  .

Back here, tapping   Show current track on map   shows the:

Current track on map (toc)

Current track on map

The track is displayed as a polyline kinking at each plot. It starts at the green pin and ends at the red pin. The user event made above appears as an orange pin - tapping it opens a popup with information on the event. The blue spot represents My Location and moves ahead of the red pin.

Which pins that are displayed depend upon the Show eventpins: selection in Map settings. Above, the All option is selected.

Other map settings determine which of a number of other items that are displayed. Above, Show wind markers option was set: the green arrow represents wind direction and force.

The black pin is the MaxSpeed pin and appears when the Show Boat & MaxSpeed pin option is set. Though the 'boat' only appears in historic maps.

When the blue spot has moved approximately 200 meter away from the red pin, a new plot is made, the red pin is moved, and the Map is repositioned and resized so the whole track is shown. Meanwhile, the Map can be moved and zoomed in and out. And any pin can be tapped.

When a pin is tapped, a popup shows:

Callout dialog (toc)

- which for a user event (orange pin) looks like:

mpTrackFirstTrack_calloutDialog.png

Tapping   Edit   opens the Event editor. A tap on   Delete ...   opens the confirmation dialog:

mpTrackFirstTrack_calloutDialog_delete.png

and if you do confirm, the event is deleted and the pin removed.

Tapping the disclosure button in a popup for a green pin (first plot event) opens a Callout dialog like above, but without the delete option.

There is no disclosure button in a popup for a red pin (last plot), because no event is attached to it before the track is ended.

This demonstrates that there are two places from where to show, edit and delete events:

Tracking in the background (toc)

Once tracking has started, it will from time to time capture your location, no matter if the App is in the foreground (visible) or the background (hidden) - even when your device is turned off (with power on). When in the background, this is signalled with:

The blue status bar

mpTrackFirstTrack_trackingInBackground.png

Ending tracking (toc)

To end tracking, on the Track mainpage tap   End ...   - and confirm that this is what you want:

Ending tracking

Just like when starting, the dialog is meant to prevent an unintented operation. The GPS then fetches a final position - this may take some seconds:

mpTrackFirstTrack_coolingDownGPS.png

after which the tracking is ended:

mpTrackFirstTrack_trackingEnded.png

The small GPS active icon will turn off within approximately 10 seconds (provided other apps don't use the GPS).

The textfields and statistics as at end of tracking are kept; however the state is changed from BEING TRACKED to RECORDED. This means that the track is no longer current - it's now history and is no longer accessible from the Track mainpage.

Current course and Current speed are blanked: these come from the GPS and are only shown when tracking.

Also the textfield labels are changed back from ... (current track) to ... (next track) when tracking is ended. This way you may reuse parts of the texts for your next track. Text reuse is possible until the App is closed down, after which you'll have to enter texts from scratch.

Apps are usually closed down by yourself, but the operating system iOS may close any App down at any time, depending on usage and available memory. So when tracking, keep an eye on The blue status bar.


Sailor Logbook App manual - © Copyright 2018 CoaSoft ApS Denmark

<=  First start of app  

  Resuming a track  =>

Sailor Logbook App manual
Track mainpage - Your first track