Managing GPS data with ActivityDiary
Roadbook

© Galyna Andrushko, 123RF
ActivityDiary creates a handy digital diary by mapping your workout and route GPS data.
Where exactly did today's hike take you? What distance do you jog every morning? How many miles have you put behind you since you left training camp? If these or similar questions sound familiar, you are not a newcomer to the topic of GPS in training programs.
In today's age of mobile navigation, many devices either include a GPS module or can have a receiver added without much difficulty. Besides navigation to specific target points, the accompanying software typically lets you collect the data in a kind of digital diary and add your own details.
However, tools for evaluating or managing routes are still fairly rare. Individual websites [1] or programs (such as Google Earth, Marble) will let you visualize routes you have mapped by GPS data, but they do not allow you to manage or analyze multiple routes. Functions for saving user-definable details, such as route descriptions, weather, surface conditions, and photos, would also be useful. And if you actually need to visualize and manage routes on the move, you need a solution that works offline – which is where ActivityDiary [2] enters the picture.
The developers of ActivityDiary, a digital diary that helps visualize and manage training programs, came up with the idea for the program while out cycling. Besides their speedometers and pulse monitors, they also had a cellphone with GPS functionality. When they got home, they discovered that they needed several tools to analyze the three different types of route data: speed, pulse, and geodetic details. What they really wanted was a program that would visualize and manage all of this data – a program that would archive route data centrally and allow them to look back a couple of days, weeks, or months to view older route data. It would let users store the route information they needed independently of their choice of sport or activity. This was the birth of the idea behind ActivityDiary.
Installing ActivityDiary
To install ActivityDiary, download the source code tarball from the project website and unpack the archive. Now change to the directory created by this step, activitydiary-0.2, and build the program according to the instructions in the INSTALL file. ActivityDiary has dependencies for Qt4 and the Qt Widgets for Technical Applications [3]. OpenSUSE users can use the one-click installer on the project homepage instead.
GPS Diary
An activity can comprise GPS and route data, user-defined additional information, and pulse data that you can import from heart rate monitors by Polar. To do so, you need to store the data in HRM (Heart Rate Monitor) format. To access HRM data on your Polar monitor, you need the s710 [4] tool.
The GPS data must be available in the GPS exchange format, GPX. This widespread format describes a route from a collection of waypoints acquired at intervals of multiple seconds. Each waypoint has several properties, such as longitude and latitude, time, and altitude. ActivityDiary reads the waypoints and their properties and stores them in a list, which you can later use to calculate your route length and speed.
For activities in which you did not have a GPS device, ActivityDiary lets you draw the route manually on a map. To do so, double-click to set new waypoints on the map, and connect them with the previous waypoints. ActivityDiary will show you the current position on the route you are creating; it does this by converting the mouse position into longitude and latitude values.
To add user-defined details (e.g., the activity name and type, the route profile and quality, an evaluation of the route and weather, a route description), you can use the controls in the GUI. Future versions of the program will also let you add activity-related photos. ActivityDiary stores any additional information you enter in the program directory in a single file per route.
Interface
When you launch ActivityDiary, you will immediately notice the large map view at the center of the screen (Figure 1). By dragging the mouse to any position on the globe, you can adjust the dynamic world map view. The program automatically downloads any maps it does not have from OpenStreetMap [5] as a background task and inserts them into the current view.

The program supports any zoom level. Once loaded, maps are cached in the program directory where they are available for offline use.
Below the map view, you will find the diagram area. Here, ActivityDiary shows you a line graph of your speed, altitude, and pulse data relative to the total route time. Left of this are controls that let you enter user-definable information for your routes. The right-hand side is reserved for calendar functions. If necessary, you can hide both sides for a full-screen view of the map.
Selecting an individual day in the calendar tells ActivityDiary to look for activities that occurred in the matching week. The activities then appear in the week view, and you can click to load the routes ActivityDiary finds. Below the week view is a weekly summary that gives you details of your total activities for the week in question. On the basis of the total time and distance, this gives you an overview at a glance of how hard you worked out in the week in question (Figure 2).

Above the calendar view is the rapid access feature that lets you jump to the next or previous activity on the basis of the current selection.
Creating Routes
To create a new activity, select New Activity… in the menu. A wizard (Figure 3) then guides you through the process by asking you to enter a name and a start point for the route data (GPS in GPX format or a manual entry on the map); optionally, you can define a file with pulse information. If you opted for a GPS file, the map view will automatically show you the right coordinates after loading the file and select the right zoom level to display the whole of the route on the map. ActivityDiary uses color to highlight the route on the map, as well as show you the start and finish points.

The program also automatically evaluates the speed and altitude information and creates a line graph. If you used the wizard to define pulse information in HRM format, ActivityDiary will import this data and add it to the chart (Figure 4). Selection lists let you hide or display the various chart types. If you opt to enter the route data manually, ActivityDiary toggles the map to edit mode when you quit the wizard. Now you can double-click the map to add waypoints to your route. The distance display for the route is updated for each new waypoint. Saving the map quits edit mode.
Buy Linux Magazine
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters
Support Our Work
Linux Magazine content is made possible with support from readers like you. Please consider contributing when you've found an article to be beneficial.
News
-
Fedora 39 Beta is Now Available for Testing
For fans and users of Fedora Linux, the first beta of release 39 is now available, which is a minor upgrade but does include GNOME 45.
-
Fedora Linux 40 to Drop X11 for KDE Plasma
When Fedora 40 arrives in 2024, there will be a few big changes coming, especially for the KDE Plasma option.
-
Real-Time Ubuntu Available in AWS Marketplace
Anyone looking for a Linux distribution for real-time processing could do a whole lot worse than Real-Time Ubuntu.
-
KSMBD Finally Reaches a Stable State
For those who've been looking forward to the first release of KSMBD, after two years it's no longer considered experimental.
-
Nitrux 3.0.0 Has Been Released
The latest version of Nitrux brings plenty of innovation and fresh apps to the table.
-
Linux From Scratch 12.0 Now Available
If you're looking to roll your own Linux distribution, the latest version of Linux From Scratch is now available with plenty of updates.
-
Linux Kernel 6.5 Has Been Released
The newest Linux kernel, version 6.5, now includes initial support for two very exciting features.
-
UbuntuDDE 23.04 Now Available
A new version of the UbuntuDDE remix has finally arrived with all the updates from the Deepin desktop and everything that comes with the Ubuntu 23.04 base.
-
Star Labs Reveals a New Surface-Like Linux Tablet
If you've ever wanted a tablet that rivals the MS Surface, you're in luck as Star Labs has created such a device.
-
SUSE Going Private (Again)
The company behind SUSE Linux Enterprise, Rancher, and NeuVector recently announced that Marcel LUX III SARL (Marcel), its majority shareholder, intends to delist it from the Frankfurt Stock Exchange by way of a merger.