Difference between revisions of "E-Ecology GPS Bird Track Generator"

From ecology
Jump to: navigation, search
Line 21: Line 21:
 
The two drop down menu's in the upper left of the interface are for selection of specific birds. The species drop down, when used, filters the available birds so that only birds of the selected species are visible. The Ptt-id drop down shows all the unique bird ID's. Every single number is a unique bird.  
 
The two drop down menu's in the upper left of the interface are for selection of specific birds. The species drop down, when used, filters the available birds so that only birds of the selected species are visible. The Ptt-id drop down shows all the unique bird ID's. Every single number is a unique bird.  
  
In the upper right of the interface there are selectors to specify the range of time to be looked at. For the begin and end date, there are two options: You can either type a date directly, or you can use the calender button. When you use the calender button, a small window pops up where a desired date can be selected. Here you can either use the arrows, or you can use ctrl up/down and ctrl left/right to change the years and months respectively. If you have selected a year and month, you can click on a day to finalize you date selection.
+
In the upper right of the interface there are selectors to specify the time range. For the begin and end date, there are two options: You can either type a date directly, or you can use the calender button. When you use the calender button, a small window pops up where a desired date can be selected. Here you can either use the arrows, or you can use ctrl up/down and ctrl left/right to change the years and months respectively. If you have selected a year and month, you can click on a day to finalize you date selection.
 
For more detailed time tuning, there are also fields for the hours and minutes. Again, you can either type it, or you can use the drop down to select the desired hour.
 
For more detailed time tuning, there are also fields for the hours and minutes. Again, you can either type it, or you can use the drop down to select the desired hour.
  
 
==== Visualization and calculation options ====
 
==== Visualization and calculation options ====
  
There are a few options in the interface that modify the visual properties of the bird tracks that are returned:
+
There are a few options in the interface that modify the visual properties of the bird tracks:
 
* The Color option assigns a specific color to the selected bird track. Here there are two version or each color: ''normal'' and ''range''. In the ''normal option, all icons are the same color, but with the ''range'' option, the icons are colored according to speed, where the darker shades correspond to lower speeds, while the whiter shades correspond to higher speeds.
 
* The Color option assigns a specific color to the selected bird track. Here there are two version or each color: ''normal'' and ''range''. In the ''normal option, all icons are the same color, but with the ''range'' option, the icons are colored according to speed, where the darker shades correspond to lower speeds, while the whiter shades correspond to higher speeds.
 
* The icon option lets the user choose between two different icons, the circle and the arrow. The difference is that the arrow shows direction, while the circle does not.
 
* The icon option lets the user choose between two different icons, the circle and the arrow. The difference is that the arrow shows direction, while the circle does not.
* The ''Force calculated speed/heading'' checkbox is an option that forces the underlying scripts to calculate speed and heading instead of using the measured speed and heading in the database. The reason for this is that not all GPS tags had the capability for measuring speed and heading. With this option the older and newer tags are homogenized. (option does not function yet)
+
* The ''Force calculated speed/heading'' checkbox is an option that forces the underlying scripts to calculate speed and heading instead of using the measured speed and heading in the database. The reason for this is that not all GPS tags had the capability for measuring speed and heading. With this option the older and newer tags are homogenized. (14-05-09: option does not function yet)
 
   
 
   
 
More details about the visualization can be found in [[#Visualization]].
 
More details about the visualization can be found in [[#Visualization]].
Line 35: Line 35:
 
==== Selection list and Submitting ====
 
==== Selection list and Submitting ====
  
When you are finished selecting a bird, a timespan and your visualization options, you can add the bird to you current selection list with the "Add New" button. You then have the option of either adding more birds, or if you're satisfied with your selection, you can submit your selection to the server with the "Submit" button. After submitting, you have to wait a bit (depending on the size of your selection) while the server queries the database and makes your KML file.  
+
When you are finished selecting a bird, a timespan and your visualization options, you can add the bird to you current selection list with the "Add New" button. You then have the option of either adding more birds, or if you're satisfied with your selection, you can submit your selection to the server with the "Submit" button. After submitting, you have to wait a bit (depending on the size of your selection) while the server queries the database and constructs your KML file.  
  
Because users often have specific bird(s) that they are interested in, it would be tedious to fill in the form with the same selections every time. Therefor we have added functionality to save and load specific selections.  
+
Because users often have specific bird(s) that they are interested in, it would be tedious to fill in the form with the same selections every time. Therefor we have added functionality to save and load specific selections. To save the current selection, simply press the ''Save Selection'' button, choose a name, and press Save.  
 
 
To save the current selection, simply press the ''Save Selection'' button, choose a name, and press Save.  
 
 
To load a previously saved selection, simply press the '' Previous Selections'' button, select the list your interested in, and press Load.
 
To load a previously saved selection, simply press the '' Previous Selections'' button, select the list your interested in, and press Load.
  
Line 47: Line 45:
 
[[Image:GPS_visualization_screenshot1.png|thumb|right|560px|GPS track Visualization in Google Earth|]]
 
[[Image:GPS_visualization_screenshot1.png|thumb|right|560px|GPS track Visualization in Google Earth|]]
  
The GPS service generates KML files containing one or more bird tracks. Currently, it saves the resulting file as tracks<#1>-<#2>.kml, where <#1> is the lowest bird ID, and <#2> the highest bird ID in the file.
+
The GPS service generates KML files containing one or more bird tracks. Currently, it saves the resulting file as tracks<#1>-<#2>.kml, where <#1> is the lowest bird ID, and <#2> the highest bird ID in the file.
The kml itself can be viewed with a variety of applications, provided they support the KML format of files. In this document, we will limit ourselves to the use of Google Earth.
+
The kml itself can be viewed with a variety of applications, provided they support the KML format of files. In this documentation, we will limit ourselves to the use of Google Earth.
 +
 
 +
==== Data Representation ====
 +
 
 +
The data of each bird track consists of two different parts. The first part is a simple line of the chosen color showing the route that the bird has flown between the selected dates. The route is created by connecting all the GPS measurements in order of their timestamps. This gives a clear view of foraging and migratory habits over longer periods of time.
 +
 
 +
The second part is a collection of icons, each one representing a GPS tag measurement on a certain time-step, and located on the latitude/longitude of the measurement. Each icon has several different visual indications of the measurement, such as:
 +
* The size of the icon is an indication of the altitude of the measurement, where the bigger icon represents a higher altitude.
 +
* The color of the icon is an indication
 +
 
  
  
 +
Because one bird track can consist of a large number of measurements, which are sometimes located in a small area, there are several tricks that can be used when looking at the data in Google earth.
 +
* Because each measurement has a timestamp attached to it, you can use the built in Google Earth time slider to specify
  
 
==== BirdView ====
 
==== BirdView ====
  
An alternative way of looking at the GPS bird track kml files is with [http://public.flysafe.sara.nl/birdview.html BirdView]. [http://public.flysafe.sara.nl/birdview.html BirdView] is the name of a FlySafe website with built in Google Earth functionality. Looking at GPS bird tracks in [http://public.flysafe.sara.nl/birdview.html BirdView] would allow you to compare GPS track data with the other forms of data available in [http://public.flysafe.sara.nl/birdview.html BirdView].  
+
An alternative way of looking at the GPS bird track kml files is with [http://public.flysafe.sara.nl/birdview.html BirdView]. [http://public.flysafe.sara.nl/birdview.html BirdView] is the name of a FlySafe webservice built with the Google Earth plugin. Looking at GPS bird tracks in [http://public.flysafe.sara.nl/birdview.html BirdView] would allow you to compare GPS track data with the other forms of data available in [http://public.flysafe.sara.nl/birdview.html BirdView].  
  
 
The current support of kml files in [http://public.flysafe.sara.nl/birdview.html BirdView] is slightly complicated though. It consists of two different steps:
 
The current support of kml files in [http://public.flysafe.sara.nl/birdview.html BirdView] is slightly complicated though. It consists of two different steps:

Revision as of 17:20, 14 May 2009

The FlySafe GPS bird tracks service

One of the data types available in the FlySafe database is GPS bird tracks. These are produced by attaching small GPS tracking sensors to birds, which track the bird movements throughout the year. The data is subsequently collected by the Argos satellite system, and made available in the FlySafe Database. The data itself is geo-referenced, and as such it makes sense to provide a service that allows you to look at the data in a GIS-system. The GIS system of choice is Google Earth, and therefor the output of the GPS track service is a KML file. This KML file can be loaded into Google Earth, but many other GIS-systems also provide KML reading capabilities.

The service itself can be found at the Flysafe website, or with a direct link to the GPS service. Both do require special access: You need to have credentials and your IP address should be registered. Please contact grid.support@sara.nl if you have problems getting access.

The Interface

GPS interface screenshot1.png

Currently there are 40 different birds available in the database, and records exist from June 2006 and on. In order to be able to select specific bird(s) and timespan(s) for detailed studying, an interface was built that allows users to query and retrieve specified subsets of the available data. See the image to the right for a screenshot of the interface.

To use the GPS service, one must first make one or more bird selections, where "add new" button is used to add a selection to the list. When the user is satisfied with the list, the submit button can be pressed to generate the KML file with all the selected data.

Each individual option in the interface is described in more detail below.

Bird and Time selection

The two drop down menu's in the upper left of the interface are for selection of specific birds. The species drop down, when used, filters the available birds so that only birds of the selected species are visible. The Ptt-id drop down shows all the unique bird ID's. Every single number is a unique bird.

In the upper right of the interface there are selectors to specify the time range. For the begin and end date, there are two options: You can either type a date directly, or you can use the calender button. When you use the calender button, a small window pops up where a desired date can be selected. Here you can either use the arrows, or you can use ctrl up/down and ctrl left/right to change the years and months respectively. If you have selected a year and month, you can click on a day to finalize you date selection. For more detailed time tuning, there are also fields for the hours and minutes. Again, you can either type it, or you can use the drop down to select the desired hour.

Visualization and calculation options

There are a few options in the interface that modify the visual properties of the bird tracks:

  • The Color option assigns a specific color to the selected bird track. Here there are two version or each color: normal and range. In the normal option, all icons are the same color, but with the range option, the icons are colored according to speed, where the darker shades correspond to lower speeds, while the whiter shades correspond to higher speeds.
  • The icon option lets the user choose between two different icons, the circle and the arrow. The difference is that the arrow shows direction, while the circle does not.
  • The Force calculated speed/heading checkbox is an option that forces the underlying scripts to calculate speed and heading instead of using the measured speed and heading in the database. The reason for this is that not all GPS tags had the capability for measuring speed and heading. With this option the older and newer tags are homogenized. (14-05-09: option does not function yet)

More details about the visualization can be found in #Visualization.

Selection list and Submitting

When you are finished selecting a bird, a timespan and your visualization options, you can add the bird to you current selection list with the "Add New" button. You then have the option of either adding more birds, or if you're satisfied with your selection, you can submit your selection to the server with the "Submit" button. After submitting, you have to wait a bit (depending on the size of your selection) while the server queries the database and constructs your KML file.

Because users often have specific bird(s) that they are interested in, it would be tedious to fill in the form with the same selections every time. Therefor we have added functionality to save and load specific selections. To save the current selection, simply press the Save Selection button, choose a name, and press Save. To load a previously saved selection, simply press the Previous Selections button, select the list your interested in, and press Load.

It must be noted that the selection are saved as cookies, and are therefor browser specific, and can be lost over time.

Visualization

GPS visualization screenshot1.png

The GPS service generates KML files containing one or more bird tracks. Currently, it saves the resulting file as tracks<#1>-<#2>.kml, where <#1> is the lowest bird ID, and <#2> the highest bird ID in the file. The kml itself can be viewed with a variety of applications, provided they support the KML format of files. In this documentation, we will limit ourselves to the use of Google Earth.

Data Representation

The data of each bird track consists of two different parts. The first part is a simple line of the chosen color showing the route that the bird has flown between the selected dates. The route is created by connecting all the GPS measurements in order of their timestamps. This gives a clear view of foraging and migratory habits over longer periods of time.

The second part is a collection of icons, each one representing a GPS tag measurement on a certain time-step, and located on the latitude/longitude of the measurement. Each icon has several different visual indications of the measurement, such as:

  • The size of the icon is an indication of the altitude of the measurement, where the bigger icon represents a higher altitude.
  • The color of the icon is an indication


Because one bird track can consist of a large number of measurements, which are sometimes located in a small area, there are several tricks that can be used when looking at the data in Google earth.

  • Because each measurement has a timestamp attached to it, you can use the built in Google Earth time slider to specify

BirdView

An alternative way of looking at the GPS bird track kml files is with BirdView. BirdView is the name of a FlySafe webservice built with the Google Earth plugin. Looking at GPS bird tracks in BirdView would allow you to compare GPS track data with the other forms of data available in BirdView.

The current support of kml files in BirdView is slightly complicated though. It consists of two different steps:

  • First the kml file has to be made publicly available on the internet, for example by putting it in your personal home space of a website you have.
  • Then you can use BirdView to load the kml file, by providing a full internet link to your kml file under the KML Document tab of BirdView.

We hope to make the process of loading kml files into BirdView easier in the future, but for now it works trough loading kml files form the internet.

Underlying Query and Data

The data in the database is produced with different models of GPS trackers. The result is that not every bird has exact the same data available. However, in order to provide compatibility, they are all put in the same table, but with the older models having certain fields empty.

 SELECT g.ptt_id, i.species, g.date_time, g.latitude, g.longitude, g.speed, g.course, g.altitude,
   g.alt_status, g.quality, g.user_qc, g.parser_qc, g."location", elevation.srtm_getvalue(g."location") 
   AS elevation, case when g.altitude = 0 then NULL else (g.altitude - elevation.srtm_getvalue(g."location")) end AS agl 
   FROM gps.gps_tracking_data g, gps.individual i, gps.track_session t 
   WHERE g.ptt_id = t.ptt_id AND g.date_time >= t.start_date 
   AND i.ring_number = t.ring_number AND g.parser_qc = 1 AND g.ptt_id = <ptt_id>
   AND g.date_time >= <startTime> AND g.date_time <= <endTime> 
   AND g.latitude <> 0 ORDER BY g.date_time