Difference between revisions of "TRACKING ANIMAL"
(→Tracking and Animal metainformation) |
(→Tracking and Animal metainformation) |
||
Line 86: | Line 86: | ||
:Note | :Note | ||
:: Mouse hover on the left/right shows editable fields (white background of form fields). | :: Mouse hover on the left/right shows editable fields (white background of form fields). | ||
− | :: The | + | :: 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 | + | :: 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]] |
− | <br>[[File: | + | : 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.<br>[[File:tracking_edit_important_fields.jpg|900px]] | ||
− | Tracking | + | : 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 a different colored saving square/check icons. | ||
+ | :: Comparing to other unsaved edits in Animal panel these optional dynamicaly proposed values do not enforce saving them before editing the other Tracking panel or before leving the the edit form (will be autoproposed again with next screen opening) | ||
+ | : The Year of birth information can be further elaborated in Animal entity detailing particular Dates of birth (Earliest, Latest, or even Exact). | ||
+ | : 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]] | ||
+ | :: 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 so the information can by easyly syncronise in both ways (see the Movebank data connector) | ||
+ | :: the Span Birth definition (similarly as other species-specific definitions such as age category, nocturnal/diurnal activity etc) can be seen in Species info | ||
− | |||
− | |||
− | |||
− | : | + | :Sometimes a single Animal (individual) can be tracked repaatedly (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 |
− | : | + | :: The existing animal information is shown in new tracking |
+ | :: Note you can see more than one Tracking/Device relations in Animal pannel (bottom righ, marked green) | ||
+ | :: 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 refering the the Animal! | ||
=Mortality warnings= | =Mortality warnings= |
Revision as of 11:46, 6 January 2023
Contents
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.
- 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
- 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:
- The „start here“ action additionaly prefills the date-time and GPS position from the selected point into the tracking start form:
- 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:
- 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:
- 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):
- 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
- You can remove the end of tracking by editing it and using a remove button there:
- 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:
- 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.
- 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:
- 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.
- 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
- Make sure you enter all the important fields which enable correct display of Tracking/Animal across the platform
- 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 a different colored saving square/check icons.
- Comparing to other unsaved edits in Animal panel these optional dynamicaly proposed values do not enforce saving them before editing the other Tracking panel or before leving the the edit form (will be autoproposed again with next screen opening)
- The Year of birth information can be further elaborated in Animal entity detailing particular Dates of birth (Earliest, Latest, or even Exact).
- 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).
- 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 so the information can by easyly syncronise in both ways (see the Movebank data connector)
- the Span Birth definition (similarly as other species-specific definitions such as age category, nocturnal/diurnal activity etc) can be seen in Species info
- Sometimes a single Animal (individual) can be tracked repaatedly (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
- The existing animal information is shown in new tracking
- Note you can see more than one Tracking/Device relations in Animal pannel (bottom righ, marked green)
- 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 refering the the Animal!
Mortality warnings
- Notifies on possible mortality in the last position of finished (archive) trackings
- 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)
- Warns on possible mortality detected in the last position of active trackings
- In order to have relevant red warnings shown correct device/TO configuration needs to be kept by project admin
- Note. the detection of mortality is currently based on
- Anitra: dedicated sensor/accelerometer mortality detection logic
- Ornitela: identical body position between subsequent measurements
- 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:
- Device list (only Red warning for Active trackings)
- Device Profile
- Tracking List (both Red warnings for Active trackings and Black Info for Archive trackings)
- Tracking profile
- Map (both Red warnings for Active trackings and Black Info for Archive trackings)
- Device Owner/Admins can freely switch devices from one state to another and modify Tracking end dates in order to achieve desired Anitra behavior