Tutorial 2: Recording A Session

Tutorial 2: Recording A Session

Posted: Feb 2, 2018
Categories: Tutorials

Prerequisite: tutorial Getting Started

In this tutorial we will record a session. At the end of this tutorial you will know more about:

  1. creating an event and session

  2. checking the server data stream

  3. the screen layout

  4. controlling the map

  5. setting the initial boat state

  6. configuring data cells

  7. building and activating a route

  8. adding the start line

  9. start mode

  10. laylines

  11. logging boat changes

  12. generated data and items

  13. adding a manual speed segment

  14. suspending and resuming a session

  15. inspecting data at a point in time

  16. race mode

  17. the race report

  18. stopping the session

  19. uploading the session to the cloud storage

  20. sharing the session with others

  21. miscellaneous

Here we go!

1. Creating an event and session

We will first create an event and a session. An event consists of one or more sessions. An event often corresponds to a (multi-day) competition, in which a session corresponds to a single race. An event could also correspond to a training event, in which a session is a single training run.

  1. in the Events Screen, press the button to create a new event. Give the event a proper name, e.g. Volvo Ocean Race.

  2. press SAVE to save the event.

  3. select the new event in the list to show its session.

  4. press the button to create a new session. Give the session a name, e.g. Race 1.

  5. press SAVE to save the session. The app will now go to the Session Screen where recording commences.

2. Checking the server data stream

Just after you've entered the Session Screen the app tries to establish a connection with the annalisa server as indicated by the flashing CONNECTING message in the top of the screen. If a connection is successfully made then the app waits for the first incoming GPS sample. A session cannot be recorded without incoming GPS samples.

Next you are presented with the Network Monitor (NetMon) pop up. The NetMon allows you to monitor the connection with the annalisa server.

The NetMon shows a grid of buttons where each button represents a quantity. Which quantities are shown here depends on which quantities you defined to be relevant for your boat in the Configuration Screen. Each button displays the last value that is has been received for that particular quantity. A value is displayed in black to indicate a stuck value, i.e. a value that has not changed at all for the last 20 samples. A black button indicates that no data packets have been received for that particular quantity. This might be normal but could also indicate a sensor problem or on-board (annalisa) server problem. It is highly advised to fix any problems before you press OK or data loss may occur!

  1. please verify that all data is being received as expected. The NetMon will indicate issues in red. In that case you can press to get a more detailed overview of the server-connection state. Press FIX to get some tips on how to remedy the issues at hand.

  2. annalisa requires the following quantities to function properly: GPS, SOG, TWA, TWS, TWD, HDG, BSP and COG. If there is no incoming data for either of these quantities then the session cannot start.

  3. If everything is ok then the NetMon will display "All OK.". Now press START SESSION to start the session.

The NetMon will automatically pop up during the session whenever there is an issue with the server connection.

3. Screen layout

The Session Screen is comprised of the following sections:

  1. the map: shows the boat, the track, waypoints, tacks, speed segments etc. in space. Optionally overlays a Navionics navigational chart.

  2. the timeline: shows events, tacks, jibes, speed segments and video clips in time. The current time is indicated by the playhead (). By dragging the playhead you can go back and forth in time.

  3. the left bar: a menu containing the main tools and settings.

  4. the right bar: a menu containing race-related actions that are recorded in time. The right bar also reflects the boat state for every point in time.

  5. the navigator: helps you find your way through all the data. E.g. you can have a look at the race by leg, or get a list of all tacks you made so you can compare those.

  6. data cells: display quantity values, like BSP. Can also show video camera thumbnails.

4. Controlling the map

With regards to the map the following settings are important: 1. the Map View Mode setting and 2. the Map North Mode setting.

The default map view mode is 2D. In this mode the observer is positioned high above sea level, looking downwards. The controls:

  1. press and hold a point on the map and drag to pan.

  2. now, pinch and spread to zoom in and out.

For demonstration purposes, let's try a different map view mode:3D:

  1. in the left bar, press the button. This will open the View sub menu.

  2. press the button. This will open the Map View Mode sub menu.

  3. press the button to enable 3D mode. In this mode the observer orbits the boat at close range.

  4. now press and hold a point on the map to adjust the orbit rotation angles. Pinch and spread to adjust distance.

  5. when you're done, please reselect 2D mode by pressing the button.

As mentioned, the other setting affecting the map view is the Map North Mode setting. This setting defines which direction the top of the map is pointed at. The default setting is Wind where the top of the map points at the direction the wind came from when the session was started. Another setting commonly used is Magnetic North, where the top of the map points to the north pole.

5. Setting the initial boat state

One important function of the right bar is that it reflects the boat state for every point in time. It is important to ensure that the boat state as defined in the right bar actually reflects the current real-life state of the boat. Note that we defined all possible boat state values when we configured the boat.

The following boat state related buttons exist:

  • MAINSAIL (): indicates in white the sail currently selected as the mainsail.

  • HEADSAIL (): indicates the sail currently selected as the headsail.

  • STAYSAIL (): indicates the sail currently selected as the staysail.

  • MAST (): indicates the currently selected mast setting.

  • CREW (): when pressed opens up the crew sub menu which lists buttons for each defined role. Every button indicates the crew member currently selected for that role.

Now, if a current setting is not correct then please press the corresponding button and select the right setting. Repeat this until the boat state reflects the real-life boat state.

6. Configuring data cells

Data cells display quantity values in realtime, e.g. BSP. They can also display video thumbnails.

sailing data

There are three types of data cells:

  1. numerical data cells. A numerical data cell displays the value of one quantity numerically.

  2. graph data cells. A graph data cell displays the value of one or more quantities as a graph, with time on the horizontal axis and the value range on the vertical axis. Values in the graph are 30s averages. The current value (i.e. corresponding to the timeline playhead) is at the far right. Up to four quantities can be displayed simultaneously allowing you to discover trends and relations. Additionally, the graph can display long-term averages for non-boat-relative quantities, like TWD.

  3. video data cells. A video data cell displays the output of a video camera in thumbnail size at a low frequency.

Let's add a numerical data cell for TWA:

  1. in the left bar, press the

    ALT="sailing data"> button to open the settings sub menu, then press the button to go to the Data Cells sub menu.

  2. press the sailing data button to add a numerical data cell.

  3. press the data cell to reveal its buttons. Now press the sailing data button. A popup will appear.

  4. press the TWA button. Next press OK.

You can move the data cell around by pressing its center and dragging. To resize the data cell you must grab one of its corners and drag.

Now let's add a graph data cell for VMG:

  1. in the left bar, press the button to open the settings sub menu, then press the button to go to the Data Cells sub menu.

  2. press the button to add a graph data cell.

  3. in its settings popup, select VMG. The graph data cell can plot up to 4 quantities simultaneously. Since we only want VMG, uncheck BSP.

By default the graph's vertical scale is automatically adjusted to the current values. You can also manually set a vertical range as follows:

  1. press the data cell to reveal its buttons. Now press the button to enter adjust scale mode.

  2. now press and hold a point on the graph to pan vertically. Pinch to zoom.

  3. when done, press the button again to exit adjust scale mode.

You can minimize a data cell by pressing the button. Pressing a minimized data cell will maximize it.

7. Building and activating a route

annalisa offers full navionics chart integration. Refer to the Getting Started tutorial for information on how to set this up.

Creating marks

In order to navigate we need to define a route. First we must create some marks. There a multiple ways to create a mark:

  • by importing from a gpx file. A mark will be created for every waypoint in the gpx file.

  • by pinging relative to the boat or start line.

  • by manual entry of longitude and latitude coordinates.

  • by manual placement on the map.

In this example we will go for manual placement on the map:

  1. in the right bar, press the button to open the Marks sub menu.

  2. near the bottom of the right bar, press the button to enable place mode.

  3. now press the button to place a mark.

  4. place a couple of more marks. Note that you can always undo you last action in case you made a mistake. Just press the button on the left bar. Also, if you want to adjust the location of a mark simply press its icon on the map and choose MOVE in the popup. Also, please don't add start line marks just yet. We will do this in a later step.

  5. you might want to give each mark a sensible name. To do so, press a mark icon on the map and choose RENAME in the popup.

All marks are listed in the Navigation Screen on the MARKS tab:

  1. in the left bar, press the button to go to the Navigation Screen.

  2. press the MARKS tab in the top of the screen to get the list of marks.

Creating a route

Now that we've placed some marks we can build a route:

  1. press the ROUTES tab in the top of the screen to get the list of routes.

  2. now, press the button to add a new route.

  3. enter a name and press SAVE.

  4. select the route just created to show its marks.

  5. press the button to add a mark. Note that you can also add a gate ().

  6. pick a mark from the list. Note that you can define how the mark must be rounded. In this case we keep the default (TO MARK).

  7. keep on adding marks until your route is complete.

Please note that the route should not contain start line marks.

Activating the route

Now the route is complete we can activate it so that it becomes visible in the Session Screen:

  1. press the ACTIVATE button to activate the route. The button is located near the bottom of the screen.

  2. in the left bar, press CLOSE to return to the Session Screen. Go to the Navigator's Route tab to see that your route is indeed activated.

Setting the target mark

Now that our route is active we need to tell the annalisa which mark is the current target mark, i.e. the one we're sailing to. There are 2 ways to do this:

  1. press the corresponding leg on the Navigator's Route tab.

  2. or, press the mark on the map to select it and then in the popup press MAKE TARGET.

Navigator - Route tab

The Route tab of the Navigator gives a leg-based breakdown of the active route. For each of the legs useful information is given like bearing to mark, time to mark and recommended sails. Note that if the leg's mark is set as the current target then this info is based on the boat, otherwise it is based on the previous mark.

Finally, it is good to know that marks and routes are stored per event, allowing you to easily reuse them for future sessions of this event. If you want to share marks and/or routes between events then simply export to gpx for one event and import from gpx for another.

8. Adding the start line

One piece that is still missing is the start line. The start line consists of two marks: a starboard-end mark and a port-end mark. To add these marks please follow the coming steps:

  1. in the right bar, press the button to open the Marks sub menu.

  2. press the button to open the Start Line sub menu.

  3. now press the button. A popup will appear. Confirm placement of the port-end mark by pressing PING.

  4. repeat the previous step for the starboard-end mark. When placed the map will automatically draw a line between both marks to indicate the start line.

At this point we've fully prepared the session and are ready to for racing.

9. Start mode

Start Mode is a different view, that will enable once the timer has started. It will tell you which end is favoured, and where you are relative to the line. The following screenshot shows Start Mode (in Race Mode, more on that later).

Let's start the countdown:

  1. in the right bar, press the button to enter Start Mode. The countdown clock will appear.

  2. use the -1 and +1 buttons to adjust the countdown time.

  3. press START to start the countdown.

  4. during the countdown you can press the SYNC button to sync to the nearest minute.

During the countdown some relevant information is given in the map view:

  • laylines and times-to-laylines are shown, provided that sufficient layline data exists at this point in time. More info on laylines will given later on.

  • Distance to line indicates the shortest distance from the boat to the start line in meters.

  • Time to burn indicates how early (or late) you are, using your current VMG to the line. This can change if you accelerate quickly! The number is red to indicate that at the current speed you will arrive too early (with risk of a false start). It's green if you are projected to be on time or too late.

  • the favorable end is shown as a map overlay on the start line marks. A green line originating from the starboard end mark means that starboard is favorable. A red line originating from the port end mark means that port is favorable. The value at the other end of the line indicates by how much distance (in meters) the particular end is favored. This information is repeated on the bottom of the screen.

The race starts once the countdown reaches zero. When this happens a race start icon () appears on the timeline.

10. Laylines

Laylines are displayed for the target mark. If a gate or start line is the current target then laylines are shown for both marks.

Depending on the selected laylines mode, either COG-based or polar laylines are shown.

COG laylines are based on various (short-term and long-term) averages of COG and TWD values in which distinct averages are maintained for upwind, downwind, starboard-end and port-end segments.

The app needs sufficient historical data to be able to display reliable laylines. Data from the current and (optional) previous sessions is used. Data from before the start of the race is not used! If no laylines are visible for a target mark then the app needs more data to be able to determine long-term averages.

The laylines are displayed as a pair of fans. The thin line of a fan is based on the long-term COG average. The fat line of a fan also takes a short-term TWD average into account, i.e. short-term wind influences.

The time to each layline is displayed in the top of the screen, depending on the boat position relative to the fat (w/ short-term TWD) layline.

We believe that laylines based on historical COG data yield the highest reliability. However, be aware that the tide can have impact on the reliability of the laylines.

11. Logging boat state changes

During the session, whenever you e.g. change a sail you should also adjust the boat state in the right bar. All changes will be stored as events on the timeline and on the map. The change events can be relevant for future analysis of your performance.

For instance, let's change the headsail setting:

  1. in the right bar, press the HEADSAIL button.

  2. from the list, select a sail that is not currently selected. Now notice the emergence of a sail change icon () on the timeline and on the map.

Here's a list of all possible change events and their corresponding icons:

  • sail change event ()

  • mast setting change event ()

  • crew change event ()

Note that you can add comments to every item on the timeline. Comments can be useful to describe context like sea state or weather for speed segments, tacks or jibes, or to motivate change events. To add a comment:

  1. press a speed segment, tack, jibe or boat config change event to select it. A

    popup will appear.

  2. press the button to open the comment editor.

  3. edit the comments and press SAVE.

12. Generated data and items

While the session is being recorded annalisa analyzes the incoming data to generate:

  • values of various quantities, for instance VMG%. VMG% or BSP% values are color-coded onto the map track and speed timeline. Blue indicates a BSP% or VMG% value of 90% or lower. Orange indicates a values of 105% or higher. You can toggle between BSP% and VMG% display by pressing the corresponding button in the lower-left corner of the map.

  • tacks and jibes. These can be recognized by the tack () and jibe () icons on both the map and the timeline. You can press an icons to get detailed info on the corresponding tack or jibe. All generated tacks and jibes are also listed in the Navigator on the TACKS and JIBES tabs. The color of a tack or jibe indicates its rating. Blue indicates a bad tack or jibe with a meters lost value of more than twice the boat length. Orange indicates a good tack or jibe with a meters lost value of zero or more.

  • (manual) speed segments. Speed segments are race segments with either very low or very high speeds (with respect to the speed polar). Speed segments are either generated by annalisa (depicted by icon ) or created manually (depicted by icon ). Press a speed segment icon for detailed info.

  • legs. All legs are listed in the Navigator on the UPWIND, DOWNWIND and REACHING tabs, depending on their type.

13. Adding a manual speed segment

As mentioned in the previous topic, speed segments are automatically generated by annalisa. However, for every leg, only the speed segment with the lowest performance and the speed segment with the highest performance are stored. If you believe a certain other segment is also significant then you can manually add a speed segment.

To place a manual speed segment at the current time do as follows:

  1. in the right bar, press the button.

A manual speed segment will be placed at the current boat position (on the map) at the current time (on the timeline).

To place a manual speed segment somewhere in the past do as follows:

  1. in the lower-right corner of the map view, press the button to pause playback.

  2. drag the playhead to the desired point in time.

  3. in the right bar, press the button.

  4. resume playback by pressing the button.

To delete a manual speed segment:

  1. press the speed segment in the map or on the timeline. An info popup will appear.

  2. press the button to delete the speed segment.

14. Suspending and resuming the session

Once the recording is started it is not required per se to keep the app running or even keep the iPad on all the time. Data is first and foremost stored on the annalisa on-board server and can be transferred to the app later on. Just make sure to resume the app session when the race is done to officially stop the session. Any missing server data will be transferred to the app.

IMPORTANT: since the amount of data that the server can keep in memory is limited it is advised to resume the app session at least once for every 8 hours of recording! Once resumed, wait for all data to be transferred to the iPad (as indicated by the white percentage in the upper-left corner of the screen) before suspending the app.

When you resume a session the app resumes its generation of tacks, speed segments, etc. from the current point in time, likely leaving a gap. You can force the app to regenerate all data and items up to the current time by pressing the button in the left bar. Before regeneration can commence the app first has to download all missing data from the server.

15. Inspecting data at a point in time

Sometimes you might want to go back in time to e.g. lookup a certain boat state or check the value of a certain quantity. This can be done as follows:

  1. in the lower-right corner of the map view, press the button to pause playback.

  2. now you can drag the playhead to any point in time. Notice how the data cells, map view and right bar are updated accordingly. To zoom in on the time window around the playhead press and hold the button. Press and hold the button to zoom out. Notice how the track in the map view is adapted to the changing time window.

  3. resume playback by pressing the button.

16. Race mode

In Race Mode the user interface is optimized for racing: only the tools and instruments which are essential for racing are shown. Furthermore, contrast and font/icon size is increased to improve visibility in sunny conditions.

To enable race mode:

  1. in the left bar, press the button.

17. Race report

The race report gives a summary of the (ongoing) race and provides a rating on a scale of 1 to 10.

To open the race report:

  1. in the left bar, press the button to bring up the race report. If the button is disabled then this means that the race was not yet started (using a start event) or no route is active.

The screen consists of a race section that gives overall information, upwind, downwind and reaching sections that give information about all upwind, downwind and reaching legs, and a rating. The rating is based on the average VMG% of the upwind and downwind legs and the average BSP% of the reaching legs. An 8 means that you managed to equal the polar performance.

18. Stopping the session

To stop the session do the following:

  1. in the left bar, press the button.

  2. press the STOP RECORDING button to stop the session.

The app will now try to get all missing data from the server. This might take a while: the speed depends on the quality of the Wi-Fi network on the boat, but it should not take more then a couple of minutes. This step is important as it is the last chance to obtain the data from the server, so please be patient. When the transfer is done the app will regenerate all (item) data before returning to the Events Screen.

19. Uploading the session to the cloud storage

Now the session is recorded, it is good practice to sync with the cloud storage to store the precious session data in the cloud. Press the button to start synching. A working internet connection is required.

20. Sharing the session with others

You can give other people (e.g. team members) access to the session through their own iPad devices. This can be done by handing them your sharing key. This allows them to view all your data in the annalisa app (which they have to install on their devices). They will only be allowed to modify event and session data on their own device, they will not be able to upload data to the cloud storage, so they cannot break anything for you.

The sharing key can be found on the annalisa website. Go to Account->Order History and then click on View Order next to your first order. The sharing key can now be found under the Public Notes.

21. Miscellaneous

Increasing battery life

Follow these tips to increase your iPad's battery life while recording a session:

  • minimize touching the screen. Whenever you touch the screen the app has to update the screen at 60Hz to be responsive. When the screen is not touched the refresh frequency drops to 1Hz, which has a significantly lower energy impact.

  • suspend the session when realtime feedback (e.g. for tactics or navigation) is not needed (for a while). This way the wifi connection to the server is suspended which saves a lot of energy. You can suspend the session by pressing the iPad's home button or by closing the app.

Blocking accidental touches

You can lock screen input to block accidental touches on the screen. To achieve this press the padlock button located the bottom-right of the screen. To unlock, press the padlock button twice in quick succession.

And that ends this tutorial! Well done for following this all the way through.

© annalisa B.V.