Difference between revisions of "TRACKING ANIMAL"

From Anitra Support
Jump to: navigation, search
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE: MORE GUIDES}}
+
{{DISPLAYTITLE: TRACKING RANGE and ANIMAL METAINFORMATION}}
=Device Status Management=
 
 
 
To have a full array of Anitra functionality available (data filtering, mortality warnings, advanced sharing, etc.) maintain the Device statuses in line with reality.
 
 
 
'''Backup / Pool''':
 
:To be used for spare/pool devices which are not currently deployed and are ready to be (re)used in the future.<br>
 
:New purchased devices receive "Backup/Pool" status automatically
 
'''Deployed''':
 
:Use for devices that are currently deployed on animals and still collecting/sending data (at least potentially)
 
:Tags are automaticaly moved from Backup/Pool to Deployed status when user enters information on the tag deployment (Tracking) and about Tracked Animal. Check the detailed guide here.
 
:Deployed status is additionaly automatically extended by the system based on the information on the last data delivered
 
:: '''Deployed Active''': known to have delivered fresh data within last 7 days
 
:: '''Deployed Missing''': last data older than 7 days
 
'''Archive / Discarded''':
 
:Meant for achieving data of "out of use" devices not expected to deliver any new data (inactivated, suspended, finished)
 
:Turning the device into this state suppresses the warning and notification scheme
 
:Note that devices created using import functionality are by default switched to "Archieve" state
 
  
 
=Tracking range management=
 
=Tracking range management=
Line 79: Line 62:
 
:A correct and complete definition of Tracking/Deployment and Animal/Individual meta info is crucial for data organization. It is also a must if you want to benefit from all the Anitra tracking/animal-related features (such as seeing animals in maps, activity clusters, mortality detection, etc).
 
:A correct and complete definition of Tracking/Deployment and Animal/Individual meta info is crucial for data organization. It is also a must if you want to benefit from all the Anitra tracking/animal-related features (such as seeing animals in maps, activity clusters, mortality detection, etc).
  
:The Tracking/Animal edit form is launched after creating new Tracking range. You can reenter the form from the [[Main_Page#Tracking_.26_Animal_profile|Tracking Profile]].<br>[[File:tracking_new.jpg|900px]]
+
:[[Main_Page#Tracking_.26_Animal_profile|Tracking/Animal profile]] is launched upon defining new Tracking range from device profile. You can acces the edit form clicking the left side of the screen.<br>[[File:tracking_new.jpg|900px]]
 
 
: Tracking definition first
 
: Important fields
 
: Tracking w/o Animal
 
: create new
 
 
 
: M:N situations - Attach Exisitng animal
 
: 2 devices
 
: twice same device
 
 
 
 
 
 
 
 
 
  
=Mortality warnings=
+
:Edit form contains metainformation about the two related entities (Tracking and Animal).
[[File:DTO000.JPG|44x38px]]
+
:* left panel (marked green below) stores information anout Tracking (aka Deployment).
* Notifies on possible mortality in the last position of finished (archive) trackings
+
:* right panel (marked blue below) contains information about particular Animal (aka Individual)
* You can set the end date of tracking so that the mortality sign is displayed in your archive data (see the end date for the first two tracked objects in example no 1)
+
:Note
[[File:DTO0000.JPG|36x37px]]
+
:: Mouse hover on the left/right shows editable fields (white background of form fields).
* Warns on possible mortality detected in the last position of active trackings
+
:: The tracking date range defined before is listed and not editable here (marked orange). As it consists of time and spatial definition, you can adjust the Tracking start/end info in the map.
* In order to have relevant red warnings shown correct device/TO configuration needs to be kept by project admin
+
:: When defining new Tracking the Animal section is empty offering creation of brand new Animal (Individual) or linking the new tracking to the exisitng Animal<br>[[File:tracking_tracking_vs_animal_marked.jpg|900px]]
  
:::''Note. the detection of mortality is currently based on''
+
: Make sure you enter all the important fields which enable correct display of Tracking/Animal across the platform
::* ''Anitra: dedicated sensor/accelerometer mortality detection logic''
+
:* Fields marked green should be filled for all the Trackings.
::* ''Ornitela: identical body position between subsequent measurements''
+
:* Fields marked brown are to be used when trackig of animal is physically terminated and/or when animal is claimed dead.<br>[[File:tracking_edit_important_fields.jpg|900px]]
::* ''Ecotone Activity column with a simple rule (Activity < 10) triggering the alert. More complex logic is being developed for Anitra native devices''
 
  
* You can find these last data mortality warnings on various screens of the Anitra platform:
+
: There are several fields related to the definition of "age" in the form.
** Device list (''only Red warning for Active trackings'')
+
: To support the user in entering the correct age the Tracking form offers a smart "Start Age" selection list. It combines the age observed with the start year of Tracking calculating the Year of Birth (pink arrow).
:[[File:DTO001.JPG|900px]]
+
: Estimated Birth information from Tracking Start Age (from the left panel) is proposed to be saved in the Animal entity (right panel, blue arrows). Note
 +
:: The proposed values differing from saved animal values carry different colored saving square/check icons.
 +
:: Compared to other unsaved edits in the Animal panel these optional dynamically proposed values do not enforce saving them before editing the other Tracking panel or before leaving the edit form (will be auto-proposed again with the next screen opening)
  
* Device Profile
+
: Estimated Year of Birth information from Tracking Start Age (from the left panel) is proposed to be saved in the Animal entity (right panel, blue arrows).
:[[File:DTO002.JPG|900px]]
+
: Note:
 +
:: The auto proposed calendar date range for the Earliest and Latest date Born fields is fetched from Species-specific information (allowed/maximum date span when young can be born in the season, blues arrows from Species info field)
 +
:: Additional logical rules are applied e.g. the Latest date born must be before the tracking start date for 1st CY year birds (red arrow). <br>[[File:tracking_StartAge_to_YearOfBirth.jpg|900px]]
  
* Tracking List (''both Red warnings for Active trackings and Black Info for Archive trackings'')
+
:: Even when StartAge field is not entered (shown as "age unknown, not recorded") the "latest" year of birth is generated using at only tracking start date (Start Age = "Born in Tracking start year latest")
:[[File:DTO003.JPG|900px]]
+
:: the Birth date data structure (Earliest, Latest, Exact dates of birth) is in line with how the age is defined in Movebank. Same structure enables easy information exchange in both directions (also see the guides on Movebank data connector and reference data import)  
 +
:: the Span Birth definition (similarly as other species-specific definitions such as age category, nocturnal/diurnal activity etc) can be seen in Species info <br>[[File:tracking_birth_range.jpg|900px]]
  
* Tracking profile
 
:[[File:DTO004.JPG|900px]]
 
  
* Map (both Red warnings for Active trackings and Black Info for Archive trackings)
+
:Sometimes a single Animal (individual) can be tracked repeatedly (e.g. replacement of malfunctioning tag).
[[File:DTO005.JPG|900px]]
+
:: In such situations do not create another Animal record from scratch but link the new tracking to existing Animal instead. <br>[[File:tracking_assign_existing_animal.jpg|900px]]
 +
:: The existing animal information is shown in new tracking
 +
:: You can see more than one Tracking/Device relations in Animal pannel (bottom righ, marked green, active tracking highlighted)
 +
:: When reusing tag for the same animal you might want to manualy owerwrite the automaticaly generated tracking code (marked green, top right) as the automatic coding format deviceCode@animaCode will lable both Trackings with the same Tracking code
 +
:: Also note the Animal information is shared by all the linked trackings ! I.e.
 +
::: Any edit in Animal panel is visible in all the Trackings profiles refering the the same Animal.
 +
::: Note the situation when the Start Age is not defined in the second Tracking (marked blue). Same happens when conflicting StartAge are defined for each of the Trackings. In such situations the last saved Animal values are stored (not the proposed not saved values) <br>[[File:tracking_2trackings_1animal.jpg|900px]]
  
* Device Owner/Admins can freely switch devices from one state to another and modify Tracking end dates in order to achieve desired Anitra behavior
+
:You can also unlink existing Animal from the Tracking for reusing it later or delete Animal item while unlinking it. <br>[[File:animal_unlink_delete_existing.jpg|900px]]

Latest revision as of 15:41, 2 April 2024


Tracking range management

The tracking DateTime range setting is the first step of defining Tracking/Deployment meta info.
You can create and edit Trackings/Deployments on the Data tab of the Device profile.
Use right-click context menu items for these actions:
Create new tracking: launches empty tracking (start) creation wizard, a general option available anywhere in the Data tab
Create new tracking here: launches wizard prefilled with selected position DateTime and GPS, available over any point within the tracking range (in the table or in the timeline)
Open tracking: opens the tracking/animal profile in a new browser tab, available over any existing tracking (in the table or over the band the timeline)
Edit tracking start: opens tracking start edit form, available over any existing tracking (in the table or over the band the timeline)
Add tracking end: launches empty tracking end wizard, available over any existing tracking (in the table or in the timeline)
Add tracking end here: launches wizard prefilled with selected position DateTime and GPS, GPS proposed from the last point before the end time, available over any point belonging to the tracking (in the table or in the timeline)
Edit tracking end: opens tracking end edit form, available over any existing tracking with end defined (in the table or over the band the timeline)
Using „here“ actions over selected points offers the comfort of instant visual croschecking of input values (in the table, map, and timeline).
Select the right start point for creating you new tracking with Create new tracking here action:
01 create new tracking here - kontext.jpg
The „start here“ action additionaly prefills the date-time and GPS position from the selected point into the tracking start form:
02 create new tracking here - prefilled.jpg
You can modify the proposed position of the tracking start to the correct place of release.
It can be done either by moving the cyan icon in the map or by typing the latitude/longitude in the form:
03 create new tracking here - prefilled, modified place.jpg
You can also adjust the start date/time manually by adjusting it in the form. Note that after changing the date a new icon appears in the form.
Click it to update the position of the start from the new first position of the tracking automaticaly:
04 create new tracking here - prefilled, modified datetime.jpg
Saving the tracking start by the check icon will open the new tracking/animal profile in a new browser tab. You should fill in all details about the deployment and about the tagged animal there (see more on this).
The device profile browser tab also gets refreshed and updated to reflect the new tracking creation.
The tracking range is displayed as a colored band in the timeline and the same colored column in the table.
From now on you can see additional actions in the right mouse click context menu over the area of tracking range (over the table rows and over the band in the timeline):
05 Existing tracking modification.jpg
In case you wish to end the tracking select the right endpoint and use Add tracking end here action.
Similarly as for the „start here“, the „end here“ action also prefills the date/time and GPS from the selected point
06 add tracking end here.jpg
You can remove the end of tracking by editing it and using a remove button there:
07 edit tracking end (remove).jpg
Note you can create new tracking and/or add the tracking end using general actions without "here". Make sure you enter the correct dates to avoid overlapping with existing trackings.
A special workflow is launched when creating a new tracking before the existing one. In that case, the end date must be also specified at the time of creating the new tracking definition:
08 tracking created before tracking.jpg
Also note the trackings and animals can sometimes be created automatically (e.g. by importing reference data from the Movebank).
In Movebank data only the date/time information for the tracking/deployment range is mandatory and indeed typically GPS missing in reference files.
To display on the map the GPS position of the start/end is needed. Therefore Anitra import flow intends to auto-propose it from the available telemetry data using the date/time provided - i.e. from the first/last position in the range. (Note this only works if data are available at the time of creating the tracking item)
Tracking starts/ends with auto-proposed GPS are labeled by a warning symbol. Users should review and adjust the definition on the Anitra map. The warning sign disappears by saving the confirmed location.
10 auto-proposed position.jpg
if the GPS of the start/end cannot be fetched for some reason the tracking visibility might be restricted till not manually entered by a user in the map.
If you need to delete the Tracking item itself navigate to the tracking profile and use the "Delete" button there:
09 delete tracking.jpg
Note you can also use some (a subset) of the functions on the tracking profile as well:
Edit tracking start: opens tracking start edit form (from context dialog in the table)
Add tracking end: launches empty tracking end wizard, same function as in device profile (from context dialog in the table)
Add tracking end here: launches wizard prefilled with selected position DateTime and GPS, GPS proposed from the last point before the end time, available over any point (from context dialog in the table or over selected point in the timeline)
Edit tracking end: opens tracking end edit form (from context dialog in the table)
Semantically the "End Of Tracking" usually reflects the date/time when the tag was physically removed from the animal (dead or alive)
In case of mortality use dedicated Mortality fields including "Estimated date of death" in parallel independent of Tracking End (see more).
As in normal situations End the tracking in mortality only after the device was physically found and removed.
The Tracking should also be ended when the device could not be physically located but the tag will not deliver any more data (e.g. by terminating the SIM card).


Tracking and Animal metainformation

A correct and complete definition of Tracking/Deployment and Animal/Individual meta info is crucial for data organization. It is also a must if you want to benefit from all the Anitra tracking/animal-related features (such as seeing animals in maps, activity clusters, mortality detection, etc).
Tracking/Animal profile is launched upon defining new Tracking range from device profile. You can acces the edit form clicking the left side of the screen.
Tracking new.jpg
Edit form contains metainformation about the two related entities (Tracking and Animal).
  • left panel (marked green below) stores information anout Tracking (aka Deployment).
  • right panel (marked blue below) contains information about particular Animal (aka Individual)
Note
Mouse hover on the left/right shows editable fields (white background of form fields).
The tracking date range defined before is listed and not editable here (marked orange). As it consists of time and spatial definition, you can adjust the Tracking start/end info in the map.
When defining new Tracking the Animal section is empty offering creation of brand new Animal (Individual) or linking the new tracking to the exisitng Animal
Tracking tracking vs animal marked.jpg
Make sure you enter all the important fields which enable correct display of Tracking/Animal across the platform
  • Fields marked green should be filled for all the Trackings.
  • Fields marked brown are to be used when trackig of animal is physically terminated and/or when animal is claimed dead.
    Tracking edit important fields.jpg
There are several fields related to the definition of "age" in the form.
To support the user in entering the correct age the Tracking form offers a smart "Start Age" selection list. It combines the age observed with the start year of Tracking calculating the Year of Birth (pink arrow).
Estimated Birth information from Tracking Start Age (from the left panel) is proposed to be saved in the Animal entity (right panel, blue arrows). Note
The proposed values differing from saved animal values carry different colored saving square/check icons.
Compared to other unsaved edits in the Animal panel these optional dynamically proposed values do not enforce saving them before editing the other Tracking panel or before leaving the edit form (will be auto-proposed again with the next screen opening)
Estimated Year of Birth information from Tracking Start Age (from the left panel) is proposed to be saved in the Animal entity (right panel, blue arrows).
Note:
The auto proposed calendar date range for the Earliest and Latest date Born fields is fetched from Species-specific information (allowed/maximum date span when young can be born in the season, blues arrows from Species info field)
Additional logical rules are applied e.g. the Latest date born must be before the tracking start date for 1st CY year birds (red arrow).
Tracking StartAge to YearOfBirth.jpg
Even when StartAge field is not entered (shown as "age unknown, not recorded") the "latest" year of birth is generated using at only tracking start date (Start Age = "Born in Tracking start year latest")
the Birth date data structure (Earliest, Latest, Exact dates of birth) is in line with how the age is defined in Movebank. Same structure enables easy information exchange in both directions (also see the guides on Movebank data connector and reference data import)
the Span Birth definition (similarly as other species-specific definitions such as age category, nocturnal/diurnal activity etc) can be seen in Species info
Tracking birth range.jpg


Sometimes a single Animal (individual) can be tracked repeatedly (e.g. replacement of malfunctioning tag).
In such situations do not create another Animal record from scratch but link the new tracking to existing Animal instead.
Tracking assign existing animal.jpg
The existing animal information is shown in new tracking
You can see more than one Tracking/Device relations in Animal pannel (bottom righ, marked green, active tracking highlighted)
When reusing tag for the same animal you might want to manualy owerwrite the automaticaly generated tracking code (marked green, top right) as the automatic coding format deviceCode@animaCode will lable both Trackings with the same Tracking code
Also note the Animal information is shared by all the linked trackings ! I.e.
Any edit in Animal panel is visible in all the Trackings profiles refering the the same Animal.
Note the situation when the Start Age is not defined in the second Tracking (marked blue). Same happens when conflicting StartAge are defined for each of the Trackings. In such situations the last saved Animal values are stored (not the proposed not saved values)
Tracking 2trackings 1animal.jpg
You can also unlink existing Animal from the Tracking for reusing it later or delete Animal item while unlinking it.
Animal unlink delete existing.jpg