User Manual

User Manual:

Open the PDF directly: View PDF PDF.
Page Count: 16

DownloadUser Manual
Open PDF In BrowserView PDF
USER MANUAL
WILDLIFE DRONES AND FLIGHT PLANS
Stakeholders
Matthew Evans
Reinhardt Eiselen
Brayan Jansen van Vuuren
Andreas Louw
Deane Roos

Team DR BAM
drbam301@gmail.com

TABLE OF CONTENTS
1.

System Overview ....................................................................................................................... 3

2.

System Configuration................................................................................................................. 3
1.

Installation............................................................................................................................. 3

2.

Install NodeJS ........................................................................................................................ 3

3.

Installing/running server ........................................................................................................ 3

4.

Installing/running client ......................................................................................................... 4

2.

Getting started .......................................................................................................................... 4

3.

Using the system ....................................................................................................................... 4
1.

Logging in .............................................................................................................................. 4

2.

Map features ......................................................................................................................... 6

3.

Choosing reserve ................................................................................................................... 8

4.

Viewing the map .................................................................................................................. 11

5.

Plotting points of interest .................................................................................................... 12

6.

Adding animal tracking data to database ............................................................................. 15

4.

Troubleshooting ...................................................................................................................... 15
1.

No data received.................................................................................................................. 15

User Manual

1

2019/05/17

Figure 1 Login .................................................................................................................................... 5
Figure 2 Login with details ................................................................................................................. 5
Figure 3 Roads, dams and boarder ..................................................................................................... 6
Figure 4 Rivers and residential areas.................................................................................................. 7
Figure 5 Rivers ................................................................................................................................... 7
Figure 6 Home view ........................................................................................................................... 8
Figure 7 Select Button ....................................................................................................................... 9
Figure 8 Draw box over map area ...................................................................................................... 9
Figure 9 Reserves to choose from .................................................................................................... 10
Figure 10 Reserve selected .............................................................................................................. 10
Figure 11 Features on map .............................................................................................................. 11
Figure 12 Map ................................................................................................................................. 11
Figure 13 Interest point button ........................................................................................................ 12
Figure 14 Place point of interest ...................................................................................................... 13
Figure 15 First point of interest........................................................................................................ 13
Figure 16 Second point of interest ................................................................................................... 14
Figure 17 Third point of interest ...................................................................................................... 14

User Manual

2

2019/05/17

1. SYSTEM OVERVIEW
The primary use of the system is to aid wildlife rangers in protecting wildlife. The system is used to be
able to use tracking data of animals so that the animal movements can be predicted, where the animal
will most likely be in the next 2 hours. This will allow optimal flight plans to be created for drones to
be piloted on to increase conservation of animal. Rangers will also be able to receive patrol routes
that will have the most optimal route for conservation.
Pilots and rangers will be able to add point of interest marker on the map, to indicate a point of
possible interest that may have to be taken into account when plotting flight/ patrol routs.
The administrator of the system will be able to add new users, delete existing users, specify/update
the reserve properties,

Jargon
-Node JS is an open-source, cross-platform JavaScript run-time environment that executes
JavaScript code server-side.
-Point of interest is a point or points that the user deems as important this could be because
of a poaching incident, fence that needs repairs, dead animal or other suspicious activities.

2. SYSTEM CONFIGURATION
1. Installation
Required software: Node JS for server.

2. Install NodeJS
2.1. Download https://nodejs.org/en/
2.2. Run the installer.
2.3. Follow the prompts in the installer.
2.4. Restart your computer.
The software will be available on the following GitHub link : https://github.com/cos301-2019se/Wildlife-Drones-and-Flight-Plans.git.
On the GitHub page click on Clone or download, then select Download ZIP. Once the zip file has been
downloaded unzip the folder.

3. Installing/running server
3.1. In the extracted folder go into the server folder.
3.2. Open a command prompt in the server folder.
3.3. In the command prompt type: npm install.
3.4. After the download and installation is complete, in the command prompt type: npm run start.

User Manual

3

2019/05/17

4. Installing/running client
4.1. In the extracted folder go into the client folder.
4.2. Open a command prompt in the client folder.
4.3. In the command prompt type: npm install.
4.4. After the download and installation is complete, in the command prompt type: npm run start.

2. GETTING STARTED
Users can only be added to the system via the administrator, the administrator can only be added by
the system administrator when setting up the database.
A user (Ranger/Pilot) can access the system by entering their given user id and password on the log in
page further described at Figure 1Logging in on page 4.
After a user has logged-in to the system, the following can be done depending on the role of the user:
• The Pilot will be able to generate a flight plan for his/her shift via the client application on the
provided computer that has the software installed.
• The Ranger will be able to generate patrol routes via the client application that will be on the
provided smartphone.
• The user will be able to toggle features on the map such as routs used, locations of drones
and rangers, points of interest and hotspots.

3. USING THE SYSTEM
Pre-condition:
-The user (pilot/ranger/administrator) is logged into the system
-The user has basic skills to work with computers and

1. Logging in
1.1. The user starts the application on the platform used.
1.2. Start the mobile/desktop application with the name Wildlife Drones and Flight Plans.
1.3. The user will be presented with a login screen with the following fields: username and
password. After the application has loaded and opened. Shown in Figure 1.
1.4. The user has to fill in the username and password in the corresponding fields. Shown in Figure
2.
1.5. The user will have to click the login button underneath the password box at the bottom
centre of the screen. Shown in Figure 2
1.6. The user will be notified of successful or unsuccessful login
1.6.1. If login was successful, the user will be shown the map and related features. Shown in
Figure 6.
1.6.2.If the login was unsuccessful the user will be notified of an unsuccessful login and will
be able to repeat step 1.1.1.3.

User Manual

4

2019/05/17

Figure 1 Login

Figure 2 Login with details

User Manual

5

2019/05/17

Pre-condition:
The user (pilot/ranger/administrator) is logged into the system.

2. Map features
2.1. Roads shown with orange lines (Figure 3), reserve boarder shown with red lines (Figure 3),
dams shown with blue blobs (Figure 3), residential area in reserve shown with grey blocks
(Figure 4), rivers shown with blue lines (Figure 4), volatile shown with dashed grey lines
(Figure 5).

Figure 3 Roads, dams and boarder

User Manual

6

2019/05/17

Figure 4 Rivers and residential areas

Figure 5 Rivers

User Manual

7

2019/05/17

3. Choosing reserve
3.1. The administrator logs into the client server system. Shown by Figure 1, Figure 2 and Figure
6Figure 6.
3.2. The administrator then clicks on the select area button, on the top right-hand corner of the
screen. Shown with red arrow and circle in Figure 7.
3.3. The administrator then draws a box over the reserve that will be used. Shown in Figure 8.
3.4. A notification box will appear that show all the reserves that are in the selected area. Shown
in Figure 9.
3.5. The administrator will then select the appropriate reserve if it appears in the list. Shown in
Figure 10
3.5.1.If the reserve does not appear ….
3.6. The system will then map the following features on the map: dams, rivers, residential areas
and roads. Shown in Figure 11

Figure 6 Home view

User Manual

8

2019/05/17

Figure 7 Select Button

Figure 8 Draw box over map area

User Manual

9

2019/05/17

Figure 9 Reserves to choose from

Figure 10 Reserve selected

User Manual

10

2019/05/17

Figure 11 Features on map

4. Viewing the map
4.1. If the user is on the home page the map is shown automatically. Shown in Figure 12.
4.2. If the user is not on the home page the user will have to click the map button to be taken to
the map.

Figure 12 Map

User Manual

11

2019/05/17

5. Plotting points of interest
5.1. A user (pilot/ranger) logs into the client system (desktop for pilot and mobile for ranger).
5.2. The user clicks on the point of interest button on the bottom left corner of screen. Indicated
with red circle and arrow in Figure 13.
5.3. The user clicks on the map where the point of interest is. Shown in Figure 14 and Figure 14.
5.4. The system will then provide the user will the shortest path (strait path, not currently
following roads), if multiple points were plotted, that will visit all the points indicated by the
user. Shown in Figure 15-Figure 17.

Figure 13 Interest point button

User Manual

12

2019/05/17

Figure 14 Place point of interest

Figure 15 First point of interest

User Manual

13

2019/05/17

Figure 16 Second point of interest

Figure 17 Third point of interest

User Manual

14

2019/05/17

6. Adding animal tracking data to database
6.1.
6.2.
6.3.
6.4.
6.5.

The administrator will use the admin interface.
The administrator selects add data via csv file button.
The administrator clicks the upload csv file button.
The administrator selects the file to be upload.
The administrator selects the upload to database button.

The csv file has have to be comma (‘,’) separated data with the following headers in the following
format: event-id,visible,timestamp,location-long,location-lat,external-temperature,habitat,sensortype,individual-taxon-canonical-name,tag-local-identifier,individual-local-identifier,study-name.

4. TROUBLESHOOTING
1. No data received
1.1. If no map data is being downloaded/ received.
Make sure device is connected to internet.
1.2. If login fails with correct authentication details (email and password)
Make sure device is connected to internet.

User Manual

15

2019/05/17



Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.7
Linearized                      : No
Page Count                      : 16
Language                        : en-ZA
Tagged PDF                      : Yes
XMP Toolkit                     : 3.1-701
Producer                        : Microsoft® Word for Office 365
Title                           : User Manual
Creator                         : Team DR BAM
Description                     : WILDLIFE DRONES AND FLIGHT PLANS
Creator Tool                    : Microsoft® Word for Office 365
Create Date                     : 2019:05:23 19:20:46+02:00
Modify Date                     : 2019:05:23 19:20:46+02:00
Document ID                     : uuid:B427790E-A710-4C04-A7C0-F4FDC1D4012E
Instance ID                     : uuid:B427790E-A710-4C04-A7C0-F4FDC1D4012E
Author                          : Team DR BAM
Subject                         : WILDLIFE DRONES AND FLIGHT PLANS
EXIF Metadata provided by EXIF.tools

Navigation menu