Difference between revisions of "Main Page"

From Anitra Support
Jump to: navigation, search
(MAIN CONCEPTS)
 
(190 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Anitra User Guide}}
+
{{DISPLAYTITLE: Anitra Platform User Guide}}
Anitra is a software platform we develop to give our users a comfortable tool to store, visualize and analyze telemetry data and manage even very complex telemetry projects.
 
  
The tool is flexible enough to host datasets generated by transmitters of any brand (manual and automatic data feeds) however some of the most advanced features are tailored to complement the unique onboard functionality of our ANITRA BirdieOne transmitters only.
+
'''ABOUT'''
 +
<br>
 +
: Anitra platform is a flexible environment that allows storing, analyzing, and visualizing telemetry data. On top of actual telemetry data, a lot of additional metainformation and field information can be stored to document and visualize data in a very rich context. Anitra is primarily tailored to manage even very complex telemetry projects but similarly, a single user data can be comfortably maintained.  
  
The functionality is primarily designed for Data Owners/Admins but a limited subset of it is also freely available to other users through elaborated sharing scheme. Each user can act in both modes at the same time (i.e. admin for some devices and viewer for data shared with him)
+
: The tool allows hosting data generated by transmitters of any brand however some of the more advanced features are tailored to complement the unique onboard functionality of ANITRA GPS-GSM transmitters only. Part of the core functionality serves as a device backend for Anitra tags (a functionality for Data Owners/Admins). An elaborated sharing scheme allows granting a full range of access rights from "admin" to "view only". Data in form of the maps can be made public in a very controlled and safe way. Most of the platform functionality is free of any charge and available to anyone having some defined access rights to particular data sets. Some data-intensive areas such as data/photo storage might be possibly restricted or charged per amount of data.
  
Login / Sign up screen of ANITRA platform available at https://anitra.cz/app/
 
  
 +
= [[SIGNING_IN | SIGNING IN - How do I get into the app?]] =
  
'''AREAS OF FUNCTIONALITY''' (also indicated by menu icons on the left side)
+
: Home screen of the ANITRA platform is at https://app.anitra.cz/
  
 +
: New users can register in the system either using "Create new account link" or using the "SIGN IN WITH GOOGLE" button ''(you will not need to type user name+pass anymore)''<br>[[File:sign-in_ user,pass_createNew.JPG|400px]]
  
=SIGNING IN=
+
: Note new user can also be created by other existing users sending an invitation to the new person from access granting wizards (e.g. sharing tracking, adding admins, or assigning project access) - typing a new email address launches the invite process <br>[[File:user_invite_dialogue.jpg|400px]]
  
==Sign up==
+
: Once you have your account created and active you can log in either typing user name and password or using Google sign-in feature
  
* Use "Create new account" link on the login page: https://anitra.cz/app to auto-register yourself as a new platform user
+
: You can review and modify your details and preferences in your user profile later.<br>[[File:user_profile_google_auth.JPG|900px]]
  
* Use a valid email address as your future username
+
: ''[[SIGNING_IN| More about User creation and user managment here]].''
  
* Upon completion, an email with account confirmation link will be sent to your inbox <br>[[File:Create new user.jpg|502x502px]]
 
  
* Note that you can also create a new account by using "SIGN IN WITH GOOGLE" button.
+
= MAIN CONCEPTS =
 +
<br>
 +
: Anitra data model is based on the following key concepts:
  
* This flow will link a newly created account with a chosen google account (you will not need to type user name+pass anymore) <br>[[File:Create new google user.jpg|762x762px]]
+
: '''Device'''
 +
:: Device (or Tag) entity represents the physical telemetry hardware that collects particular telemetry data. Any tracking and sensor data are linked to one of the devices.
  
==Sign in==
+
:: Devices are created automatically in the system while importing a new telemetry dataset (via Import or Integration flow) or created by us in the case of Anitra devices (created as part of the device purchase process).
  
* Once registered you can log in
+
:: Device Status attribute reflects the current usage of the devices (statuses are '''pool-new''', '''pool-used''', '''deployed-active''', '''deployed-delayed''', and '''deployed-missing''').
** using your username and password
+
:: Besides, a "Discard" flag is available to mark the tags that are considered out of service.
** using "Sign in with Google" functionality (you will not need to type user name+pass anymore) <br>[[File:Sign-in user-pass.JPG|502x502px]]
+
:: [[Main_Page#Device_Status_and_Discard_Flow |More on device statuses and discard flow here]].
  
* Manage (add/remove) your linked Google Account(s) in your user profile
+
:: Attributes related to the hardware (brand, model, serial no., GSM no., etc.) or summary metrics can be seen and managed in the [[Main_Page#Device_profile|Device profile]].
  
  
==Password reset==
+
: '''Organisation, Customer, or Ownership'''
 +
:: Device "Ownership" defines which organization/customer holds ownership of the data.
 +
:: Purchased Anitra devices are transferred under the Customer account during the purchasing process.
 +
:: Non-Anitra devices are linked to particular Customers by running integration connectors or Importing data manually.
  
* you can reset your password using "Forget password ?" link on the Sign In if needed
+
:: Customer account also holds the credit balance (data fee prepay)
* you need to enter your login address <br>[[sign-in_ reset password request.JPG]]
 
* a reset password link will be sent to your email address <br>[[sign-in_ reset password retype.JPG]]
 
* you can change your user password anytime in your user profile page
 
  
=MAP=
 
  
* A tool to analyze multiple Individuals in a single map <br>[[File:map00_paralelanalysis.JPG|900px]]
+
: '''Animal'''
 +
:: Animal (or Individual) entity represents a particular animal/individual
  
* The functionality displays all the Tracked Individuals available to a user (both owned/administered and shared only)
+
:: The main attributes for an Animal are its Species, Sex, and Dates when Born and Died (~ which also defines the current age e.g.).
* By default an overview of the last positions is shown - the color of the point categorizes data by the last data update. <br>[[File:map01_lastdatacolors.JPG|900px]]
 
  
* Filtering functionality below the map limits data in the map and in the right Tracked Object selection list by following criteria:
+
:: Additional complex meta-information can be linked-to Animal such as origin info, relationships to other animals, ringing, tagging or trapping details, and mortality attributes
** "Search" (full text search across Device/TO codes/names/aliases)
 
** Species
 
** Last "X" Days (limits all the data showing specified last X days interval)
 
** Other: Tracking Status, Country of Tagging, Current Age <br>[[File:map02_mapfilterfilled.JPG|900px]]
 
  
* Map functionality <br>[[File:map04_mapFunctionality.JPG|900px]]
+
:: Photos (or documents) can be attached either directly to the Animal entity or indirectly to some related entities or Events such as Tagging or Mortality.
::# Map zoom
 
::# Full screen mode
 
::# Overview map
 
::# Map layers - a wide range of available maps <br>[[File:map04a_mapFunct_maps.JPG[300px]]
 
::# Show current user position
 
::# Map options
 
::::* Last positions
 
::::* Tracks
 
::::* Waypoints
 
::::* Night Points <br>[[File:map04b_mapFunct_Options.JPG|900px]] <br>[[File:map04c_mapFunct_OptNight.JPG|900px]]
 
  
* TO details
 
** Track point details in the tooltip (note that more track point tooltips can be displayed simultaneously)
 
** Additional TO detail in the right TO selection list (including "Share" button for admins)
 
** Click through link to particular Tracked Object profile <br>[[File:map05_TOdetails.JPG|900px]]
 
  
* TO Mortality Indicated by black/red symbols in the right TO side selection and in the tooltips <br>[File:map06_mortalityInMap.JPG|900px]]
+
: '''Tracking'''
 +
:: Tracking (or Deployment) entity defines the relationship between Devices and Animals primarily in terms of time. Check out a detailed guide on [[TRACKING_ANIMAL|creation and modification of the tracking range]].
  
={{Fa|fa-tablet}} DEVICES=
+
:: The date(time) interval defines when the device was physically attached to the Animal
  
==DEVICE LIST==
+
:: ''Note when looking at the timeline of a particular Animal, multiple telemetry devices might have been used to track it subsequently (e.g. first tag failed and removed or was shed by the animal). Similarly, when analyzing Device usage history a single device might have been possibly reused several times for Tracking various animals (e.g. one animal died, the tag was recovered and reused elsewhere).''
* List of owned or administered devices (= hardware)
 
* Click through to device details (profile)
 
* Available device types:
 
** "Anitra": used for Anitra native devices, device functionality includes remote control of active devices in the field
 
** "Ecotone": virtual devices for Ecotone data, possibly of the data feed on Ecotone web (available on request)
 
** "Ornitela": virtual devices for Ecotone data, possibly of data feed on Ornitela web (available on request)
 
** "Upload/Basic": devices created through Import functionality, any other tracking data, the one who uploads becomes Device Owner
 
* User-managed Device Status: allows to categorize devices into activity groups (archive, installed, backup)
 
* System of warning messages
 
** Incorrect/Missing Device-TrackedObject configuration: "Device Code" followed by the black/{{red|red}} exclamation mark ( "!" or {{red|"!"}} )
 
** Mortality indication: "Device Status" colored in red and followed by {{red|red skull}} symbol
 
** Missing data last X days: "Last Device Position" followed by red question mark {{red|"?"}}. Mouse-over symbol tells the last data delay.
 
* Search and predefined filtering options (Status = Installed, Mortality, Last data before +7 days, incorrect Tracked Object configuration)"Ecotone": virtual devices for Ecotone data, possibly of data feed from Ecotone web (available on request <br>[[File:Capture.JPG|900px]]
 
  
* Device information (and configuration) is accessible only to owners/admins (users of shared data do not have the rights see this data]
+
:: Besides the time aspect, some additional details such as place of tagging, place of release, tagging persons, various notes, photos, etc can be attached to Tracking Start/End. 
  
[[File:Capture_2.JPG|900px]]
+
:: Tracking inherits permissions from its parent Device entity so users with device owner/admin access can create and modify the deployments as well.
  
==DEVICE PROFILE==
 
  
* Device identification, meta info, status, overview and admin management
+
: '''Group''', Project, Study
* Device data visualized on the map and on the timeline
+
: '''Person''', User, Role
* Management of device tracked objects
+
:: Data owners can make their data available to other users or even make their data public in a simplified and secured way using an elaborated sharing scheme. Each user can act in both modes (i.e. admin for owned or administered devices and viewer for data shared with him by others). Most of the platform functionality is free of charge and available to anyone. Only large data volumes might be possibly restricted or charged.
** Removal of technical/manipulation periods
+
 
** Creation/split of device data into real tracked objects (situation when one logger was subsequently used for more than one animal)
+
 
* Last known geolocation (DateTime + country etc.)
+
: '''Place''', Point of Interest (POI)
* System of warnings
+
: '''Event''', Observation
** Incorrect/Missing Device-TrackedObject configuration
+
 
** Mortality indication: red/black warning in "Last device Position" row (red = for installed and currently tracking devices/black = tracking finished)
+
** Missing data last X days: red warning in "Last Device Position" row (warning active just for installed and currently tracking devices)
+
: '''Device Data''', Records, Positions, Outliers
* Summary for related TO profiles (bellow timeline) including Mortality Indication symbols
+
:: Measurement data collected by telemetry devices.
 +
:: A combination of the device ID and UTC timestamp (date time in milliseconds) uniquely identifies each record.
 +
:: Records are linked to devices but can also be fetched for child Trackings, or Animals.
 +
 
 +
:: '''Record''': a dataset related to particular UTC timestamp carrying measurements performed by particular device sensors (such as GNSS module, IMU, barometer)
 +
:: '''Position''': a record with a successful GPS fix (obtained Latitude and Longitude). Positions can be shown on maps.
 +
:: '''Outlier''': a record without GPS fix (no valid Latitude/Longitude) due to unsuccessful, skipped, or wrong GPS fixing. Note Outliers are not shown in maps but can still be displayed in table, timeline, and graph view.
 +
 
 +
:: You can visualize, analyse, or download data using the Anitra platform functionality.
 +
::: Within the platform you can see the data in [[Main_Page#MAIN_TRACKING_MAP:_Where_do_I_see_more_animals_in_one_map.3F|the main overview tracking map]] or in [[Main_Page#Device_profile|the (device or tracking) profile]] data tables, maps, timelines, and graphs
 +
::: To analyze data outside of Anitra you can use the [[DATA_FLOWS#.28OUT.29_Manual_DATA_Export|Export]] functionality or [[DATA_FLOWS#.28OUT.29_Anitra_API_data_.26_metadata_access|Anitra API]].
  
[[File:Capture_3.JPG|900px]]
+
:: Note the list of columns/metrics covered by the Anitra data model can be understood from various places:
 +
::*  [[DATA_COLUMNS| a table of the most important metrics]] with explanations and comments - primarily to explain those used by Anitra tags
 +
::*  a detailed [https://anitracking.com/api/ Anitra API specification] provides a list of all the columns available over the API with a brief description
 +
::*  [[Main_Page#COLUMN_EDITOR:_How_can_I_adjust_columns_I_see.3F|column editor]] functionality lists the available columns per platform functionality.
 +
::*  the [[DATA_FLOWS#.28IN.29_Manual_data_import|Manual Data Import]] functionality reference guide provides the samples/examples of files, columns, or formats to be used while importing data.
 +
::*  for additional explanations about some columns you can also refer to [https://www.movebank.org/cms/movebank-content/movebank-attribute-dictionary| Movebank attribute dictionary]. As the data from Movebank can be easily integrated in Anitra the data model and column names are ovelapping much.
  
==DEVICE CONFIGURATION==
+
: '''Data Cluster''', Annotation
 +
:: An object created (automatically or manually) on top of the telemetry data that annotates a series of Records into semantic groups (such as Mortality or Night clusters).
 +
:: These clusters can be used to simplify the visibility of tracks and positions in the maps by masking details showing statistically aggregated information.
  
* Customer Owners/Admins can access device configuration
+
= PROFILEs: Where can I see and manage the detail info for entities such as Device, Animal, and Tracking? =
** from Device List <br>[[File:Config01.JPG|900px]]
+
Most entities in Anitra carry a certain list of attributes and offer a range of functions and operations related to it. The place that accommodates all this is a detail or profile page of it.  
** from Device Profile
 
  
[[File:Config02.JPG|900px]]
+
Depending on the importance and complexity of a particular entity, the detail page might be rather simple (e.g. Person/User profile) or more structured and information-rich (e.g. Tracking/Animal profile). Most important entity pages are described here:
  
=TRACKED OBJECTS=
+
=={{Fa|fa-tablet}} Device profile ==
  
==TRACKED OBJECT LIST==
+
: '''Device profile''' tab (tab control marked green):
 +
:* holds all the information about the device (identification, status, type, brand, model, and user description
 +
:* allows administration of the device (i.e. managing admin list, activating Movebank Datafeed, exporting device data into the file, configuring/programming tag (cogwheel icon))
 +
:* shows device activity (i.e. bits needed for monitoring: Statistics, System of warnings (mortality, missing data), the last position in the overview map, first/last geolocation, communication log (wifi icon))
 +
:* lists Trackings/Animals created on top of device data (bottom right) - more rows in situation when single tag was redeployed multiple times <br>[[File:device_profile_functionality_marked.jpg|900px]]
  
* List of owned TO (tab "my tracked objects")
+
: '''Data''' tab (marked green):
* List of TO shared with me (tab "shared with me")
+
:* data collected by the tag visualized in the table, on the map, in the timeline, and the graph
* Overview of all tracked objects including first and last data
+
:* [[MORE_GUIDES#Tracking_range_management|functionality for creation of Trackings (aka Deployments) and modification of the DateTime ranges]].<br>[[File:01_create_new_tracking_here - kontext.jpg|900px]]
** Click through to TO detail/profile
 
** System of warnings
 
** Mortality indication: "Tracking" followed by <span style="color:red">red</span> <span style="color:red">skull</span> symbol
 
** Missing data last X days: "Last Data " followed by red questionmark <span style="color:red">"?"</span>. Mouse-over symbol tells the last data delay.
 
* Search and predefined filtering options (Mortality, Last data before +7 days)
 
  
[[File:TOL01.JPG|900px]]
+
: '''Graph''' tabs (marked green):
 +
:* data collected by the tag can be analysed in the graph
 +
:* wide range and flexible selection of columns for display
 +
:* [[Main_Page#GRAPHS:_How_to_visualize_important_data_relations_in_graphs.3F|More about graphs here]]<br>[[File:device_profile_graph_marked.jpg|900px]]
  
==TRACKED OBJECT PROFILE==
+
=={{Fa|fa-paw}} Tracking & Animal profile ==
  
* Details of tracked object (= tracking of individual bird)
+
* Details of tracked object (= tracking of the individual animal)
** Identification (code, name, ringing, tagging etc.)
+
** Identification (code, name, ringing, tagging, etc.)
 
** Info related to particular Individual (species, sex, age, origin)
 
** Info related to particular Individual (species, sex, age, origin)
 
** Info related to Start of tracking (including photo and file documentation)
 
** Info related to Start of tracking (including photo and file documentation)
 
** Info related to End of tracking (~ mortality/device failure)
 
** Info related to End of tracking (~ mortality/device failure)
 
* System of warnings
 
* System of warnings
** Mortality indication: <span style="color:red">red</span>/black warnining in "Last known Position" row (<span style="color:red">red</span> = for installed and currently tracking devices / black = tracking finished)
+
** Mortality indication: <span style="color:red">red</span>/black warning in "Last known Position" row (<span style="color:red">red</span> = for deployed and currently tracking devices / black = tracking finished)
** Missing data last X days: <span style="color:red">red</span> warning in "Last Device Position" row (warning active just for installed and currently tracking devices) <br>[[File:TOP00.JPG|738x138]]
+
** Missing data last X days: <span style="color:red">red</span> warning in "Last Device Position" row (warning active just for deployed and currently tracking devices)
 +
:[[File:TOP00.JPG|738x138]]
  
* TO data visualized on the map and on the timeline <br>[[File:TOP01.JPG|900px]]
+
* Tracked animal data visualized on the map and on the timeline <br>[[File:TOP01.JPG|900px]]
  
* "Share" button allows sharing TO to other Anitra users
+
* "Share" button allows sharing Tracking to other Anitra users
 
* Possibility to attach photos /documents related to
 
* Possibility to attach photos /documents related to
** tracking start
+
** Tracking start
 
** Mortality
 
** Mortality
* Same photo can be shared by various Tracked Objects <br>[[File:TOP02.JPG|900px]]
+
* Same photo can be shared by various Trackings <br>[[File:TOP02.JPG|900px]]
 +
 
 +
=={{Fa|fa-user}} Organisation/Customer profile==
 +
 
 +
A section visible in the side menu (only) for users with Admin/Owner relations to Organisations listed in the system.
 +
* users not having any role in any organization do not see this menu item at all
 +
* in case the user is active in more organizations the list of these is displayed first<br>[[File:customer_list.JPG|900px]]
 +
 
 +
Organization details such as contacts and access roles can be edited on the organization profile.
 +
* main customer admin (owner) is assigned
 +
* owner can make other people admins granting them "customer admin" role.
 +
* customer owner(admins) have full access to devices belonging to a particular customer/organization account (can export data, manage trackings and animals, etc.)
 +
 
 +
 
 +
[[DATA_FLOWS|Various inbound and outbound data flows]] from manual data export to fully automated can be managed for organization account
 +
* (IN) Inbound data flows (connectors for Movebank, Ornitela, and Ecotone available)
 +
* (IN) Manual data import (see the Import functionality)
 +
* (OUT) API data access
 +
* (OUT) Manual data export
 +
* (OUT) Anitra to Movebank datafeed
 +
 
 +
Note, only the legal owners of original data are allowed to configure inbound data flows!
 +
* Any data uploaded manually or synchronized automatically to Anitra are linked to a particular legal entity (Organisation / Customer) represented by its "owner" i.e. person in charge.
 +
* The ownership of and the responsibility for all the data remain with this legal entity. This organization's owner and admins assigned by the owner retain full control over the data related to this entity.
 +
* Anitra works as private and secure storage and a visualization tool of these data only.
 +
 
 +
Data Management section of Customer profile is also a place to define and review customer [[PUBLISHED_MAPS|published maps]] i.e. a creation wizard for maps construction.
 +
 
 +
''Note the term "customer" refers to any "organization" having some kind of (active or past) commercial agreement with Anitra company''
 +
 
 +
'''Customer balance''' - i.e. usage/charging summary vs. payment history is available in the Customer profile<br>[[File:spending_payments_tab.jpg|900px]]
 +
 
 +
: A list of the devices owned by the customer is updated and visible right before or soon after shipping devices
 +
: Fix data fee calculation is also available instantly
 +
: Overage data charges are updated according to reality after the month is over and the detailed billing summary is available from the mobile network
 +
: Payments (from invoices paid) are visible after the data fee payment is received by us
 +
 
 +
= LISTS, GRIDS=
 +
 
 +
=={{Fa|fa-tablet}} Device list==
 +
: List of owned or administered devices (= hardware) - accessible only to owners/admins (users with shared data do not have the rights to see this area)
 +
: Click through to device details (profile), sort by the column, browsed by pages, first column freezing, quick system, and user filters
 +
: [[Main_Page#FILTERS_.26_SEARCHES:_How_do_I_find_what_I_am_looking_for_.3F|Search and Filter functionality]]: allows filtering your devices by criteria
 +
: Manageable through Filter manager next to the Search box, marked with icon [[File:C2.JPG|30px]]
 +
:* Predefined quick filters, which cannot be modified (Missing data in the last 7+ days, Anitra devices only, Powered off devices, Wrong tracking configuration, Deployed devices, Mortality indication)
 +
:* You can turn on multiple Quick filters at once in the Quick filter panel
 +
: Context menu - as anywhere in Anitra the right-click mouse context menu offers the most relevant actions for the current context, functionality, or the whole page or a user
 +
: A wide range of columns available. Column selection and more column-related actions using Column manager from the context menu or directly e.g. by drag-drop columns:
 +
:* Column selection, adding, removing columns (a default list can be restored using "reset visibility")
 +
:* Column renames (default names can be restored using "reset display names")
 +
:* Column order (a default order can be restored using "reset order")
 +
: Multi-select for bulk operations (open all in tabs, graph, apply config preset, etc)
 +
: System of warning messages such as Mortality indication: "Device Status" colored in red and followed by {{red|red skull}} symbol or Missing data last X days: "Last Device Position" followed by red question mark {{red|"?"}}.
 +
 
 +
=={{Fa|fa-paw}} Tracking & Animal list ==
 +
 
 +
* List of owned Trackings (tab "my trackings")
 +
* List of Trackings shared with me (tab "shared with me")
 +
* Overview of all Trackings including first and last data
 +
** Click through to Tracking detail/profile
 +
** System of warnings
 +
** Mortality indication: "Tracking" followed by <span style="color:red">red</span> <span style="color:red">skull</span> symbol
 +
** Missing data last X days: "Last Data " followed by red question mark <span style="color:red">"?"</span>. Mouse-over symbol tells the last data delay.
 +
 
 +
= MAPS =
 +
 
 +
: Common map properties and controls
 +
: 1) '''Map zoom'''
 +
:: ''Note besides the zoom buttons you can zoom the map''
 +
::* ''using the mouse scroll wheel''
 +
::* ''or by double-clicking the left mouse button (to zoom in) and the right button (to zoom out)''
 +
 
 +
: 2) '''Full-screen''' mode
 +
 
 +
: 3) Shows the user/device's '''current position''' on the map as a blue dot
 +
 
 +
: 4) '''GPS search''' tool - various GPS formats accepted (e.g. decimal degrees such as "52.7761 27.811889")
 +
 
 +
: 5) '''Background maps'''
 +
:* a wide range of background maps of various types
 +
:* transparent overlays (country and admin borders)
 +
 
 +
: 6) '''Transparent map overlays'''
 +
:* country borders
 +
:* admin leve1 1 borders
 +
 
 +
: 7) '''Map options'''
 +
:* '''Tracks''' - note the option "'''Clustered'''" simplifies the track by removing movements within clusters
 +
:* '''Waypoints''' - note the option "'''All'''" suppresses the default performance optimisation behavior (= option "'''Filtered'''") - i.e. enforces showing of all the waypoints
 +
:* '''Annotations''' (aka '''Clusters''') - currently these two Annotatin/Cluster types availabe to be used
 +
:** '''Last positions''' - show/hide the last position of the tracking
 +
:** '''Sleep clusters''' - show/hide the sleep clusters (data from periods defined by solar night/day i.e. by sun angle)<br>[[File:map04_mapFunctionality.JPG|900px]]
 +
 
 +
: 8) '''Copy coordinates to clipboard'''
 +
:: using left click context menu
 +
 
 +
: 9) '''Measure distance'''
 +
:: using left click context menu<br>[[File:map04_mapFunctionality_2.JPG|600px]]
 +
 
 +
 
 +
=={{Fa|fa-map-o}} MAIN TRACKING MAP: Where do I see more animals in one map? ==
 +
 
 +
: A tool to analyze multiple Trackings / Individuals in a single map.
 +
: The functionality displays all the Tracked Individuals available to a user (both owned/administered and shared only)
 +
: The start view shows an overview of the last positions - the color of the point classifies the last positions by the last update. <br>[[File:map01_lastdatacolors.JPG|900px]]
 +
 
 +
: '''Filtering functionality below the map''' limits the data in the map (and in the right Tracking list panel]
 +
:: The three quick filter conditions ("Search", "Tracking filters", "Species") directly filter matching/not matching Trackings/Animals
 +
::* "Search": a full-text search across Device/Tracking/Animal codes/names/aliases
 +
::* "Tracking filters": existing Tracking filters created by the user can be reused here in the map. This allows applying very complex filter conditions in the map
 +
::* "Species": an obvious and simple quick filter conditions
 +
:: Note that the "Days filter" works differently - it uses a time filter over telemetry data first and based on that it leaves or removes Trackings/Animals from the page
 +
::* it excludes all the trackings with data outside of the time interval
 +
::* for overlapping Trackings/Animals it limits data/tracks in the map according to the interval defined - i.e. only relevant parts of the tracks are loaded<br>[[File:map02_mapfilterfilled.JPG|900px]]
 +
:: Also note the map filter is stored in the URL (browser address bar). You can open another browser tab with a map page and configure a different filter (eg. another species). Both tabs then work independently.
 +
 
 +
: '''Choosing Trackings / Animals to be loaded''' in the map.
 +
:* using tooltips of single last points
 +
:* or for multiple items using the rectangle tool selection in the map (using CTRL + click/drag with left mouse button)
 +
:* selecting/unselcting particular items in the right Tracking pannel (single Trackings or all grouped by species)<br>[[File:map03_TOselection.JPG|900px]]
 +
 
 +
: '''Waypoints and Last positions (tooltips)'''
 +
:* More tooltips can be displayed simultaneously
 +
:* Click through the link to a particular Tracked Object profile<br>[[File:map05_TOdetails.JPG|900px]]
 +
:* Warnings and statuses are shown in tooltips e.g. mortality being indicated by black/red symbols <br>[[File:map06_mortalityInMap.JPG|900px]]
 +
 
 +
== [[PUBLISHED_MAPS|PUBLISHED MAPS: How do I show an overview of our study results to the public?]]==
 +
''[[PUBLISHED_MAPS|A detailed guide to to Published maps functionality is available here]].''
 +
 
 +
: A tool tailored to configure simplified and secured live telemetry maps from your full data sets.
 +
 
 +
: Configured maps are available in form of a link or in form of short HTML code which can be simply added to your web presentation or published on Facebook.
 +
 
 +
: Map output can be created:
 +
:* on top of single organization data
 +
:* on top of "project" (i.e. accross more complex data ownership structure)
 +
 
 +
: Map editor with a live preview is used to configure the map<br>[[File:publish_map_configuration_groups.JPG|900px]]
 +
 
 +
: Two map modes can be configured:
 +
:* map showing the simplified '''Tracks'''
 +
:* map showing the '''Last positions''' only
 +
 
 +
: For the mode of "Tracks" '''Animation''' can be anabled
 +
 
 +
: The map configuration includes:
 +
:* animal selection
 +
:* language localisations (alternative language variants)
 +
:* map mode (tracks vs. last position), grouping options, ordering, data filtering (e.g. track simplified to one position a day)
 +
:* security features (security delay, zoom restriction, position "rounding")
 +
:* presentation and visualization presets (a default map selection, icon/track styles, choice of icons, logos with links, foto gallery, animation enabling)
 +
 
 +
: Samples showing some of the map features
 +
:* map with tracks and gallery and animation anabled:https://app.anitra.cz/share/map/5d2e379ed6f9c <br>[[File:publish_map_animationEnabled.jpg|900px]]
 +
:* map of last positions with categories: https://app.anitra.cz/share/map/5f1a97bb13ba5
 +
 
 +
''[[PUBLISHED_MAPS|A detailed guide to to Published maps functionality is available here]].''
 +
 
 +
= GRAPHS: How to visualize important data relations in graphs? =
 +
 
 +
: Graph functionality available
 +
:* as a tab in Device and Tracking profiles (see #0)
 +
:* for a group of Devices (only admin functionality now).
 +
 
 +
: Time is indicated by the horizontal axis (see #1)
 +
: By default period of the last 7 data days is loaded.
 +
: The interval shown can be managed either by the interval slider (see #2) or using the date input below the chart area (see #3).<br>[[File:graph_time.jpg|600px]]
 +
 
 +
: You can hover over the chart to preview the actual values (see #4).
 +
: The values of metrics are plotted at the vertical axis of the graph (see #5).
 +
: The scale for a particular metric is shown on the left and right from the graph area (see #6).
 +
: To quickly show/hide a particular metric click the label color above the graph (only used till the next page reload)(see #7).<br>[[File:graph_orientation.jpg|600px]]
 +
 
 +
: You can customize your metric list (visibility) and order using the "Choose metrics" button below the chart (see #8).
 +
: Visibility (see #9) and order (see #10) is controlled by drag'n'drop action.<br>[[File:graph_choseMetrics.jpg|600px]]
 +
 
 +
: Visibility and order can also be managed in "Edit graph columns" from the context menu (see #11).
 +
: Additionally, this functionality offers even more properties to be controlled such as custom rename (see #12) or colors, graph type, and default value range (see #13).
 +
: It also allows resetting the changes to system defaults (reset options in the top right corner)(see #14)<br>[[File:graph_editColumns.jpg|600px]]
 +
 
 +
={{Fa|fa-photo}}PHOTO GALLERY: Where do I browse all the photos? =
 +
 
 +
* Displays a complete gallery of pictures from all the Trackings (own and shared)
 +
* Filtering by main attributes <br>[[File:TO.JPG|900px]]
 +
 
 +
= {{Fa|fa-cog}} MANAGING and CONFIGURING of Anitra Tags =
 +
 
 +
== Device Status and Discard Flow ==
 +
 
 +
: '''Device Status''' attribute is automatically assigned based on device usage history (including its past and current deployments)
 +
:: ''E.g. the tags are automatically moved from Pool to Deployed statuses by creating Tracking (+Animal) object. [[TRACKING_ANIMAL| Check the detailed guide here.]]''
 +
 
 +
:: ''pool-new'' : devices never deployed previously
 +
:: ''pool-used'': devices returned to the device pool after deployment
 +
:: ''deployed-active'': deployed on animals, known to have delivered fresh data within the last 3 days
 +
:: ''deployed-delayed'': deployed on animals, known to have delivered fresh data within the last 4-7 days
 +
:: ''deployed-missing'': last data older than 7 days
 +
 
 +
:: ''Note Devices status applies to all the devices types including data imported from Movebank of from Import flow.''
 +
 
 +
: '''Device/SIM Discard Flow''' (for Anitra devices)
 +
:: Device/SIM closing(discard/termination) workflow is available for Anitra device owners so the SIM can be closed and the device removed from (data fees) billing
 +
:: Users are supposed to mark the devices they wish to be terminated - to be used for devices not expected to deliver new data anymore.
 +
:: Marking the device triggers a process that '''irreversibly''' terminates the device SIM with our network provider
 +
:: SIM is ultimately terminated by the end of the month following after marking the device to be discarded ''(e.g for a device marked to be discarded on the 13th of February the SIM will be active (and data fees charged till the end of the March))''
 +
:: Note you can still stop the discard process till the SIM is irreversibly terminated by the network operator by contacting us directly till the end of the following month (i.e. for the example above we can manually withdraw the SIM closing request till the 31st of March)
 +
:: The check for marking devices to be terminated is available at the bottom part of the device profile.
 +
 
 +
: Device Discard/Archive flow for non-Anitra devices
 +
:: For non-Anitra devices (= devices originating from import or integration - i.e. Movebank, Ornitela, Ecotone, Manual Import) there is also a Discard/Archive mark present in the Device profile
 +
:: For those, the flag only allows marking those that are not active anymore (for the sake of filtering and correct visibility in the maps)
 +
:: A recommendable practice is to mark the tags that are considered lost or those terminated in the original control panel
 +
:: Note in this case the flag is fully reversible (the user can change it there and back without any restriction)
 +
 
 +
: '''Device Status Extended/Long'''
 +
:: Extended/long devices status is summarizing all the status information related.
 +
:: It is a combined field of Device status, history summary and Discard status.
 +
:: It is displayed in the Device profile, Device list, and Customer balance overview
 +
 
 +
== Configuration /programming of devices ==
 +
 
 +
: ''For complete detail of all the configuration options see the configuration guide [[configuration| to the latest firmware version ]] or to [[configuration_fw2| older versions respectively]].''
 +
<br>
 +
: Users with admin rights can access the configuration from the lists and profiles using cogwheel icons. Note the configuration functionality is available for Anitra devices only.
 +
:[[File:config_lists_profiles.JPG|900px]]
 +
<br>
 +
: Configuration contains three main areas
 +
:* Data collection settings
 +
:** GPS/sensor sampling time schedules
 +
:** Data collection triggered by events
 +
:** Configuration of bursting  behavior
 +
:** Mortality detection adjustment
 +
:** Geofencing
 +
:* Communication schedules
 +
:* Other settings
 +
:[[File:config_sections.JPG|900px]]
 +
: ''For complete detail of all the configuration options see the configuration guide [[configuration| to the latest firmware version ]] or to [[configuration_fw2| older versions respectively]].''
 +
 
 +
= OTHER PRODUCTIVITY TOOLS =
 +
== FILTERS & SEARCHES: How do I find what I am looking for ? ==
 +
 
 +
Various features helping user find and filter down what is needed are available in Anitra:
 +
 
 +
# '''Global full text search'''<br>- full text seach accross all the objects of various types which user has access rights to.<br>- a list of relevant item s sorted by relevancy is returned<br>[[File:global_full_text_search.JPG|500px]]
 +
# '''Grid search'''<br>- seaches in important fields in displayed grid only<br>[[File:grid_search.JPG|500px]]
 +
# '''System and Custom "Quick" filters'''<br>- allows quickly filter data using predefined "system" or "user defined" filters<br>- filters are available as icons on top of the device or tracking grid header line<br>- custom filters can be created in "Filter manager"<br>[[File:quick_filters.JPG|900px]]
 +
# '''Published map filters'''
 +
 
 +
* Filter manager
 +
** Customized quick filters that filter devices according to specified criteria (e.g. Device list, Name fields, Device notes..), you can set multiple criteria at once <br>:[[File:B.JPG|900px]]
 +
** You can save your customized filter with the green "check" icon <br>:[[File:Ml.JPG|900px]]
 +
** "Eye" icon enables to pin the particular Quick filter into the Quick filter panel next to the Search box <br>:[[File:Mil.JPG|900px]]
 +
 
 +
* Filter functionality: allows filtering your trackings by criteria
 +
** Predefined quick filters, which cannot be modified (Mortality Warning, Last data warning only, Anitra devices only)
 +
** Customized quick filters, which filter Trackings by set criteria (e.g. Tracked Objects, Name fields, Note fields..), you can set multiple criteria at once
 +
** You can save your customized filter with the green "check" icon
 +
** "Eye" icon enables to pin the particular Quick filter into the Quick filter panel next to the Search box <br>:[[File:ksdjf.JPG|900px]]
 +
** You can turn on multiple Quick filters at once in the Quick filter panel
 +
 
 +
== NOTES: Where to note down info about particular things? ==
 +
: A handy feature helping users to get organized and stay organized with their data.<br>:[[File:note_thread_narrow.JPG|600px]]
 +
 
 +
: Available for multiple entities (Devices, Trackings, Animals, and Customers/Organizations)
 +
 
 +
: Note threads can be accessed
 +
:* from entity profiles - in the green shown opening of the Tracking note, the blue mark on the right shows the place to access the device note <br>[[File:note_from_profile.JPG|900px]]
 +
:* entity lists or using the context menu - either click on the note icon in the Notes column or use the context menu over the desired row<br>[[File:note_from_listContext.JPG|900px]]
 +
:* from user Task List <br>[[File:task_userTaskList.jpg|700px]]
 +
: Here a new note can be created, existing notes can be edited, or a reply to previous notes can be posted.
 +
: The thread window is flowing over the entity. It can be open parallel to whatever you do in your profile. You can switch tabs, type forms, take screenshots while browsing, or even create/edit notes.
 +
 +
: Create the note simply by typing in the form
 +
: Edit existing notes by double-clicking them or using "more" or "Edit" icons in the right top corner. This switches note into "'''edit'''" mode<br>
 +
:[[File:note_editMode.JPG|500px]]
 +
: Save the new or edited note by clicking the "Publish/Done" button or simply hitting ENTER.
 +
: While creating or editing you can cancel by the "Cancel" button or using ESC on your keyboard
 +
: The note text does not allow formatting but you can structure the note to more rows. Use SHIFT+ENTER for the new line (as ENTER is reserved for the "Save" operation)
 +
: An existing note can be deleted using the "more" button >> "Delete thread". Note while deleting the parent note all the replies will also be deleted.
 +
: "Clone note" function - particularly useful e.g. for fast duplicating of notes with complex definitions (i.e. notes linked to many items).
 +
:: ''While cloning notes attachments are removed (not cloned with the note).''<br>:[[File:note_deleteClone_thread.JPG|500px]]
 +
: Use "Promote to parent note" when you need to convert a note reply to a top-level parent note.
 +
:: ''While promoting reply to note it inherits the relations from its original parent note''
 +
: Use "drag'n'drop: action to move one note into the reply area of the other note to move and transform the note into the reply.
 +
:: ''Converting note into reply is only possible for notes created by the user himself and only to notes that have no complex relationship''
 +
 
 +
: By default the note thread is
 +
:* sorted starting with newest notes up. You can invert the sort order to have the oldest notes on top of the page. This setting is remembered in your user preferences.
 +
:* positioned on the top right side of the page. You can modify the position by dragging the floating window to any side, This setting is remembered in your user preferences.
 +
:* sized to one-third of the screen width. You can switch the window size between one-third and one-half by the "shrinking/stretching" button. This setting is also remembered in your user preferences.<br>:[[File:note_sortSizePosition.JPG|600px]]
  
=PHOTO GALLERY=
+
: Notes can be saved as
 +
:* shared - will be visible to all the users with access to the entity. a way to share knowledge, tasks, and the status of particular items
 +
:* private - will be visible only to the author of the note. a way to note down things or ToDos only for the author<br>:[[File:note_sharedPrivate.JPG|600px]]
  
* Displays a complete gallery of pictures from all the Tracked Objects (own and shared)
+
: The functionality contains a complex toolkit covering<br>:[[File:note_functionality_options.JPG|900px]]
* Filtering by main metadata criteria <br>[[File:TO.JPG|900px]]
+
:* relations - a single note (thread) can be linked to multiple items of the same type (e.g. a single/shared note linked to 5 devices)
 +
:* attachments
 +
:** To each note or reply, one or more attachments (e.g. pictures) can be attached (by browse function or using drag 'n' drop)
 +
:** Picture attachments are then previewed in the thread, photos can be opened in full size and browsed as a gallery
 +
:* screenshots
 +
:** For adding a screenshot from the clipboard just press CTRL+V (paste) while in the note body.
 +
:** This will append the screenshot similarly as it was a regular attached picture file. Note you can modify the screenshot file name as well.
 +
:* links/URL
 +
:* tags - you can label your notes by using user "tags", later you can search, filter, or group by these tags
  
=IMPORT DATA=
+
== TASKS (TODOS): Where to note down reminders and ToDos ? ==
  
* Allows importing any other tracking data in the predefined structure. Currently, we support:
+
: Extension of the Notes functionality
** Data in simple structure device-GPSDateTime-latitude-longitude-note (type "Basic")
+
: By assigning a note to someone (to ''another user'', to ''user himself'' or to ''anyone'') the note is transformed into the Task (ToDo)
** Ecotone CSV format
 
** Ornitela CSV format
 
* "Upload" automatically analyses imported data and offers the creation of new "Devices"
 
* Data for already existing devices are appended to these devices (e.g. allows a user to update data in the system by monthly update files..)
 
* The user who uploaded data becomes Device Owner <br>[[File:Import.JPG|900px]]
 
  
=CUSTOMERS AND INTEGRATION=
+
: Use the button below the note editor or simply type @+name to assign the note as a task to someone<br>[[File:task_assignment.jpg|600px]]
 +
:* assigning a task to another person (''@other.person'') will list the task in the other person's Task list (as created by you).
 +
:* assigning a task to yourself (''@your.name'') will list the task in your Task list (as created by yourself).
 +
:* assigning a task to anyone (''@anyone'') will create a shared task displayed to all the people with access to the linked entity (e.g. particular device, tracking, or customer)
  
* There is one more menu item visible for those users who act in the system as "Customer Owners" or "Customer Admins" <br>[[File:Customers_And_Integration01.JPG|900px]]
+
: A simple workflow for tasks exists - the task can be in one of the three states
 +
:* new/open (= to be completed, highlighted by yellow background)
 +
:* completed  /done (= marked as completed, highlighted by a green background)
 +
:* canceled / rejected (highlighted by a reddish background)<br>[[File:task_statusColors.jpg|600px]]
  
* Customer detail can hold the definition of one or more integration connections (currently Ecotone and Ornitela data feeds supported) <br>[[File:Customers_And_Integration02.JPG|900px]]
+
: Users can move the tasks between the states using icons and controls in the right corner<br>:[[File:task_statusChange.jpg|600px]]
  
* Integration connection toolbox allows
+
: User Task board screen shows all the ToDos assigned to the user or defined by the user to others
** Create-edit-remove management of the connection
+
: Entity note thread can be accessed from the Task list by clicking the particular task
** Sending a request for automatic integration run
+
: Task status can be changed from here or some comments added
* Review of the log of the service <br>[[File:Customers_And_Integration03.JPG|900px]] <br>[[File:Customers_And_Integration04.JPG|900px]]
+
: You can also jump to the profile screen of the linked entity by clicking its name<br>:[[File:task_userTaskList.jpg|600px]]
  
=EXPORT CSV/XLSX=
+
== COLUMN EDITOR: How can I adjust columns I see? ==
* At the moment, there are two places to have your data exported:
 
::#'''Customer profile:''' full data for all ANITRA devices owned by Customer (available for CustomerOwner and CustomerAdmins)
 
::#'''Device profile:''' all data for a single device (available for all Customer/Device Owner/Admins)
 
* /* mass data takeout not available for people with shared acces only */
 
* Ref 1) Mass export ANITRA data on "Customer profile"
 
::::(Both CSV and formatted Excel sheet available): <br>[[File:Export001.JPG|900px]]
 
  
* Ref 2) Export data for one particular device <br>[[File:Export002.JPG|900px]]
+
: All the data visualization and download features are designed to allow users to pick and modify the columns to be used.
 +
: Use "Edit columns" options from the context menu of the functionality you wish to modify.
 +
: Beyond choosing the columns, the Edit functionality allows customizing names, order, color, graph type, and ranges, and reset changes to the default.
 +
: Edit columns option is available for
 +
:* metadata (device/tracking) lists
 +
:* metadata list exports
 +
:* profile data table columns
 +
:* profile graph columns
 +
:* data export columns
 +
: See the [[Main_Page#GRAPHS:_How_to_visualize_important_data_relations_in_graphs.3F|Graphs section]] for some screens of column editing
  
* Export columns specification: <br>[[File:Export004.JPG|900px]]
+
: Both metadata and data can be accessed via [[DATA_FLOWS#.28OUT.29_Anitra_API_data_.26_metadata_access|Anitra API]] and same here the columns to be included can also be managed at the level of API query
 +
: [https://anitracking.com/api/| The detailed API specification] provides basic info about columns available.
  
* CSV file sample preview: <br>[[File:Export005.JPG|900px]]
+
== USER PREFERENCES: How can I customize my user experience ? ==
  
* XLSX file sample preview <br>[[File:Export006.JPG|900px]]
+
: Various features in the application are designed to remember user modifications
 +
: You can see and manage all your user preferences in the User preferences screen
 +
: The preferences listed are organized into categories
 +
: It is accessible from the user avatar in left menu or anywhere from right click context menu<br>[[File:user_preferences.jpg|600px]]
  
=DEVICE-TRACKED OBJECTS-MORTALITY=
+
= [[DATA_FLOWS | DATA FLOWS: How do I get the data IN/OUT?]] =
* Anitra platforms data model is based on the following key concepts:
+
''[[DATA_FLOWS|A detailed guide to to all the data flows here]].''
  
==Device==
+
: Anitra offers a range of data manipulation options on how to get data and metadata IN or OUT of the platform.
* Represents physical hardware device to which all the tracking and sensor data are linked
 
* Allows storing info related to hardware (Brand, logger model, serial number, GSM no. Etc.)
 
* The device in the system can be created
 
** By purchasing Anitra logger (the device will be created and assigned to Anitra Customer)
 
** By importing tracking file (csv, kml/kmz, gpx)
 
** Automatically by Integration (i.e. automated data feed e.g. from Ecotone or Ornitela panels)
 
 
==Tracked Object (or Tracking)==
 
* Represents particular animal carrying logger device, a single device can be reused several times (in case of mortality of tracked object)
 
** Allows filtering (e.g. display, share) relevant subset of device data
 
** Allows attaching metainformation related to:
 
*** The tracked Individual (species, sex, age, ringing, origin etc)
 
*** The tracking of that animal (start of tracking, end of tracking, mortality attributes, photos/documents)
 
** Tracked Object in the system can be created
 
*** Automatically: by default, any new device has got a default tracked object configured starting with the first device data
 
*** Using "split TO" functionality in the device profile
 
*** Using "create new TO" functionality in the device profile
 
 
==Device Data==
 
* A basic level of tracking/measurement information
 
* Data are accessible through devices and their tracked object(s)
 
 
==Device Status Management and Tracked Object configuration==
 
  
* For maximum benefit of a full array of Anitra functionality (data filtering, mortality warnings, advanced sharing etc.) we highly recommend to maintain "Device Statuses" for your devices and Tracked Objects for your study animals up to date.
+
: This functionality area involves features of data import, export, automated data connectors or API access
  
* Available basic "Device Statuses":
+
: The options range from purely manual (e.g. [[DATA_FLOWS#.28OUT.29_Manual_DATA_Export|manual data exports]] or [[DATA_FLOWS#.28IN.29_Manual_data_import|data imports]]) to fully automated (e.g. [[DATA_FLOWS#.28IN.29_Inbound_DATA_flows|inbound data flows for Ornitela, Ecotone, or Movebank]]).
** '''Backup / Pool''':
 
*** To be used for spare/pool devices which are not currently in the field and are planned to be (re)used in the future.
 
*** New devices which appear in the system are labeled "Backup" status automatically
 
** '''Deployed''':
 
*** To be used for devices which are currently deployed "in the field" and potentially sending data
 
*** There are 4 sub-statuses available which allow the user to configure Anitra behavior further
 
:::::'''1. Deployed Active''':
 
::::::::* Known to be currently delivering data reliably and  new data expected to be updated on a regular basis
 
::::::::* Mortality notification should work reliably
 
:::::'''2. Deployed Down''':
 
::::::::* Known to be still delivering data (at least for some time), but based on data received the device very likely not already attached to target animal (shed/down logger, killed animal)
 
::::::::* Hardware to be either recollected or written-off
 
::::::::* "New data" notifications could help investigate the case until the logger transmits data
 
::::::::* After collecting all possible information and closing the case the device should be turned to "Archive" status
 
:::::'''3. Deployed Missing''':
 
::::::::* Data delivery suddenly interrupted, last positions do not show animal/logger issue
 
::::::::* "New data" notifications possibly used to notify on the restoration of data transfer
 
:::::'''4. Deployed Problem''':
 
::::::::* Depending on the issue type the data delivery fails or some sensor data might be unreliable
 
::::::::* Allows suppressing mortality notification as false or confusing warnings may be raised
 
::* '''Archive / Discarded''':
 
::::::::* meant for out of use devices (inactivated, suspended, finished) not expected to deliver any new data
 
::::::::* Turning device into this state allows suppressing warning scheme 
 
::::::::* Allows to store and filter out archive data
 
::::::::* Note that devices created through import functionality are by default switched to this state
 
  
==Tracked Object EndDate==
+
: Some flows make sense for the particular user but most of the data management tools are meant to be configured at the level of customer/organization (hence available in customer profile)
  
* Device Statuses are meant to help to control active Loggers >> Tracked Objects (Trackings). In order to receive a meaningful warning, it is highly recommended not only to turn inactive devices to Archive but also to end related active Tracked Objects (Trackings) whenever the tracking in the field is over (i.e. you do not expect to receive any new data).
+
: '''Outbound data flows:'''
** Ending Tracked Object / Tracking is done by filling in date into field "End of tracking" in the Tracked Object profile
+
:* [[DATA_FLOWS#.28OUT.29_Manual_DATA_Export|Data Export]]<br>[[File:export_tracking_profile.JPG|900px]]
** "End Of Tracking" field leaves space for individual interpretation. For instance in case of mortality you can include the period when the tracked individual was alive only or you might as well close the tracking date later when the device was physically found and removed.
+
:* [[DATA_FLOWS#.28OUT.29_Manual_METADATA_Export|Metadata Export]]<br>[[File: export_meta_tracking_grid.JPG|900px]]
** Note that you can additionally enter more detail related to mortality event ("Estimated date of death", "Mortality Reason", "Mortality Note", "Mortality Photos/Documents/Reports")
+
:* [[DATA_FLOWS#.28OUT.29_Anitra_API_data_.26_metadata_access|API (both data and metadata)]]
 +
:* [[DATA_FLOWS#.28OUT.29_Anitra_to_Movebank_data_feed|Anitra to Movebank data feed]]
  
'''Mortality warnings''' <br>[[File:DTO000.JPG|44x38px]]
+
: '''Inbound data flows:'''
* Notifies on possible mortality in the last position of finished (archive) trackings
+
:* [[DATA_FLOWS#.28IN.29_Inbound_DATA_flows|Data integration of external data sources (i.e. connectors for Movebank, Ornitela, and Ecotone available)]]<br>[[File:Inbound_connection_overview.jpg|600px]]
* You can set the end date of tracking so that the mortality sign is displayed in you archive data (see the end date for the first two tracked objects in the example no 1)
+
:* [[DATA_FLOWS#.28IN.29_Manual_data_import|Data Import]]<br>[[File:manual_customer_import.JPG|900px]]
[[File:DTO0000.JPG|36x37px]]
 
* 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''
+
''[[DATA_FLOWS|A detailed guide to to all the data flows here]].''
::* ''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 Anitra platform:
+
= WARNINGS, NOTIFICATIONS=
** Device list (''only Red warning for Active trackings'') <br>[[File:DTO001.JPG|900px]]
 
  
* Device Profile <br>[[File:DTO002.JPG|900px]]
+
==MORTALITY WARNINGS==
 +
[[File:DTO0000.JPG|36x37px]] Red skull
 +
* Indicates mortality detected by onboard mortality detector (Anitra tags only)
 +
* More about mortality detector in firmware configuration
 +
* The flag is stored at the level of database records (visible in data history anytime the device detected mortality)
  
* TO List (''both Red warnings for Active trackings and Black Info for Archive trackings'') <br>[[File:DTO003.JPG|900px]]
+
[[File:DTO000.JPG|44x38px]] Black skull
 +
: Notifies on possible mortality in the last records of trackings as estimated by server post-process analysis
 +
: Recalculated
 +
:* with new received data
 +
:* with modification of the tracking range (i.e. when closing active Tracking or when updating Tracking End Date)
 +
: The flag is recalculated and visible for the last data only (not visible in data history).
 +
: Algorithm factors in roll and pitch oscillations for the latest three records and/or the last 3 hours
  
* TO profile <br>[[File:DTO004.JPG|900px]]
+
Red bird belly up
 +
: Unnatural body position in the very last record (roll and pitch)
 +
: whenever the absolute value of the angle for Roll or Pitch exceeds 90 degrees
  
* Map (both Red warnings for Active trackings and Black Info for Archive trackings) <br>[[File:DTO005.JPG|900px]]
 
  
* Device Owner/Admins can freely switch devices from one state to another and modify Tracked Objects end dates in order to achieve desired Anitra behavior
+
=={{Fa|fa-map-o}} RELEASE NOTES==
  
----------------------------------------
+
: Latest release note overview is shown to the user any time a new release is deployed since the last user's Anitra access.
'''Appendix:''' Examples of correct and incorrect configurations:
+
: After being displayed the screen is no longer shown till another release
<br>'''''Example no. 1)'''
+
: The release note screen aggregates data from the past 60 days are shown.
''Correct Device/TO configuration: a device used subsequently for tracking of tree animals (the latest TO still active tracking)'' <br>[[File:DTO006.JPG|900px]]
+
: Release note screen can be manually invoked by pressing the Anitra icon (left top corner of the application)<br>[[File:ReleaseNotes_drill.jpg|900px]]
  
'''''Example no. 2)'''
+
=[[MORE_GUIDES| MORE GUIDES]]=
''Outdated Device/TO configuration: a device used subsequently for tracking of tree animals''
 
* ''Last data warning says that the last data arrived more than a year ago, SIM card probably already deactivated?''
 
''>> no more new data expected to arrive'' <br>''>>> TO should be Ended + Device should be switched to Archive status'' <br>[[File:DTO007.JPG|900px]]
 
  
'''''Example no. 3)'''
+
: [[RK_WINTERCOUNT_TIPS| LIFE EUROKITE Red kite Wintering count (Anitra tips)]]
* ''Outdated Device/TO configuration: Dead bird, logger recovered and physically back in office''
 
** ''As the device is still in the "Deployed Active" state and tracked object not closed, it raises false red mortality warnings''
 
** ''In this case''
 
*** ''The tracked object should be ended with the date when the dead bird was found and the logged recovered''
 
*** ''Device status for AUKI06 should be changed from "Deployed Active" to Backup or Archive (depending on intention to reuse HW)'' <br>[[File:DTO008.JPG|900px]]
 
  
Anitra [[Terms_of_service|Terms of Service]] and [[Privacy_policy|Privacy policy]]
+
: [[EUROKITE_PROJECT_DATASHARING| LIFE EUROKITE Project datasharing (a guide for Eurokite data controllers)]]

Latest revision as of 13:26, 2 May 2024


ABOUT

Anitra platform is a flexible environment that allows storing, analyzing, and visualizing telemetry data. On top of actual telemetry data, a lot of additional metainformation and field information can be stored to document and visualize data in a very rich context. Anitra is primarily tailored to manage even very complex telemetry projects but similarly, a single user data can be comfortably maintained.
The tool allows hosting data generated by transmitters of any brand however some of the more advanced features are tailored to complement the unique onboard functionality of ANITRA GPS-GSM transmitters only. Part of the core functionality serves as a device backend for Anitra tags (a functionality for Data Owners/Admins). An elaborated sharing scheme allows granting a full range of access rights from "admin" to "view only". Data in form of the maps can be made public in a very controlled and safe way. Most of the platform functionality is free of any charge and available to anyone having some defined access rights to particular data sets. Some data-intensive areas such as data/photo storage might be possibly restricted or charged per amount of data.


SIGNING IN - How do I get into the app?

Home screen of the ANITRA platform is at https://app.anitra.cz/
New users can register in the system either using "Create new account link" or using the "SIGN IN WITH GOOGLE" button (you will not need to type user name+pass anymore)
Sign-in user,pass createNew.JPG
Note new user can also be created by other existing users sending an invitation to the new person from access granting wizards (e.g. sharing tracking, adding admins, or assigning project access) - typing a new email address launches the invite process
User invite dialogue.jpg
Once you have your account created and active you can log in either typing user name and password or using Google sign-in feature
You can review and modify your details and preferences in your user profile later.
User profile google auth.JPG
More about User creation and user managment here.


MAIN CONCEPTS


Anitra data model is based on the following key concepts:
Device
Device (or Tag) entity represents the physical telemetry hardware that collects particular telemetry data. Any tracking and sensor data are linked to one of the devices.
Devices are created automatically in the system while importing a new telemetry dataset (via Import or Integration flow) or created by us in the case of Anitra devices (created as part of the device purchase process).
Device Status attribute reflects the current usage of the devices (statuses are pool-new, pool-used, deployed-active, deployed-delayed, and deployed-missing).
Besides, a "Discard" flag is available to mark the tags that are considered out of service.
More on device statuses and discard flow here.
Attributes related to the hardware (brand, model, serial no., GSM no., etc.) or summary metrics can be seen and managed in the Device profile.


Organisation, Customer, or Ownership
Device "Ownership" defines which organization/customer holds ownership of the data.
Purchased Anitra devices are transferred under the Customer account during the purchasing process.
Non-Anitra devices are linked to particular Customers by running integration connectors or Importing data manually.
Customer account also holds the credit balance (data fee prepay)


Animal
Animal (or Individual) entity represents a particular animal/individual
The main attributes for an Animal are its Species, Sex, and Dates when Born and Died (~ which also defines the current age e.g.).
Additional complex meta-information can be linked-to Animal such as origin info, relationships to other animals, ringing, tagging or trapping details, and mortality attributes
Photos (or documents) can be attached either directly to the Animal entity or indirectly to some related entities or Events such as Tagging or Mortality.


Tracking
Tracking (or Deployment) entity defines the relationship between Devices and Animals primarily in terms of time. Check out a detailed guide on creation and modification of the tracking range.
The date(time) interval defines when the device was physically attached to the Animal
Note when looking at the timeline of a particular Animal, multiple telemetry devices might have been used to track it subsequently (e.g. first tag failed and removed or was shed by the animal). Similarly, when analyzing Device usage history a single device might have been possibly reused several times for Tracking various animals (e.g. one animal died, the tag was recovered and reused elsewhere).
Besides the time aspect, some additional details such as place of tagging, place of release, tagging persons, various notes, photos, etc can be attached to Tracking Start/End.
Tracking inherits permissions from its parent Device entity so users with device owner/admin access can create and modify the deployments as well.


Group, Project, Study
Person, User, Role
Data owners can make their data available to other users or even make their data public in a simplified and secured way using an elaborated sharing scheme. Each user can act in both modes (i.e. admin for owned or administered devices and viewer for data shared with him by others). Most of the platform functionality is free of charge and available to anyone. Only large data volumes might be possibly restricted or charged.


Place, Point of Interest (POI)
Event, Observation


Device Data, Records, Positions, Outliers
Measurement data collected by telemetry devices.
A combination of the device ID and UTC timestamp (date time in milliseconds) uniquely identifies each record.
Records are linked to devices but can also be fetched for child Trackings, or Animals.
Record: a dataset related to particular UTC timestamp carrying measurements performed by particular device sensors (such as GNSS module, IMU, barometer)
Position: a record with a successful GPS fix (obtained Latitude and Longitude). Positions can be shown on maps.
Outlier: a record without GPS fix (no valid Latitude/Longitude) due to unsuccessful, skipped, or wrong GPS fixing. Note Outliers are not shown in maps but can still be displayed in table, timeline, and graph view.
You can visualize, analyse, or download data using the Anitra platform functionality.
Within the platform you can see the data in the main overview tracking map or in the (device or tracking) profile data tables, maps, timelines, and graphs
To analyze data outside of Anitra you can use the Export functionality or Anitra API.
Note the list of columns/metrics covered by the Anitra data model can be understood from various places:
  • a table of the most important metrics with explanations and comments - primarily to explain those used by Anitra tags
  • a detailed Anitra API specification provides a list of all the columns available over the API with a brief description
  • column editor functionality lists the available columns per platform functionality.
  • the Manual Data Import functionality reference guide provides the samples/examples of files, columns, or formats to be used while importing data.
  • for additional explanations about some columns you can also refer to Movebank attribute dictionary. As the data from Movebank can be easily integrated in Anitra the data model and column names are ovelapping much.
Data Cluster, Annotation
An object created (automatically or manually) on top of the telemetry data that annotates a series of Records into semantic groups (such as Mortality or Night clusters).
These clusters can be used to simplify the visibility of tracks and positions in the maps by masking details showing statistically aggregated information.

PROFILEs: Where can I see and manage the detail info for entities such as Device, Animal, and Tracking?

Most entities in Anitra carry a certain list of attributes and offer a range of functions and operations related to it. The place that accommodates all this is a detail or profile page of it.

Depending on the importance and complexity of a particular entity, the detail page might be rather simple (e.g. Person/User profile) or more structured and information-rich (e.g. Tracking/Animal profile). Most important entity pages are described here:

Device profile

Device profile tab (tab control marked green):
  • holds all the information about the device (identification, status, type, brand, model, and user description
  • allows administration of the device (i.e. managing admin list, activating Movebank Datafeed, exporting device data into the file, configuring/programming tag (cogwheel icon))
  • shows device activity (i.e. bits needed for monitoring: Statistics, System of warnings (mortality, missing data), the last position in the overview map, first/last geolocation, communication log (wifi icon))
  • lists Trackings/Animals created on top of device data (bottom right) - more rows in situation when single tag was redeployed multiple times
    Device profile functionality marked.jpg
Data tab (marked green):
Graph tabs (marked green):
  • data collected by the tag can be analysed in the graph
  • wide range and flexible selection of columns for display
  • More about graphs here
    Device profile graph marked.jpg

Tracking & Animal profile

  • Details of tracked object (= tracking of the individual animal)
    • Identification (code, name, ringing, tagging, etc.)
    • Info related to particular Individual (species, sex, age, origin)
    • Info related to Start of tracking (including photo and file documentation)
    • Info related to End of tracking (~ mortality/device failure)
  • System of warnings
    • Mortality indication: red/black warning in "Last known Position" row (red = for deployed and currently tracking devices / black = tracking finished)
    • Missing data last X days: red warning in "Last Device Position" row (warning active just for deployed and currently tracking devices)
738x138
  • Tracked animal data visualized on the map and on the timeline
    TOP01.JPG
  • "Share" button allows sharing Tracking to other Anitra users
  • Possibility to attach photos /documents related to
    • Tracking start
    • Mortality
  • Same photo can be shared by various Trackings
    TOP02.JPG

Organisation/Customer profile

A section visible in the side menu (only) for users with Admin/Owner relations to Organisations listed in the system.

  • users not having any role in any organization do not see this menu item at all
  • in case the user is active in more organizations the list of these is displayed first
    Customer list.JPG

Organization details such as contacts and access roles can be edited on the organization profile.

  • main customer admin (owner) is assigned
  • owner can make other people admins granting them "customer admin" role.
  • customer owner(admins) have full access to devices belonging to a particular customer/organization account (can export data, manage trackings and animals, etc.)


Various inbound and outbound data flows from manual data export to fully automated can be managed for organization account

  • (IN) Inbound data flows (connectors for Movebank, Ornitela, and Ecotone available)
  • (IN) Manual data import (see the Import functionality)
  • (OUT) API data access
  • (OUT) Manual data export
  • (OUT) Anitra to Movebank datafeed

Note, only the legal owners of original data are allowed to configure inbound data flows!

  • Any data uploaded manually or synchronized automatically to Anitra are linked to a particular legal entity (Organisation / Customer) represented by its "owner" i.e. person in charge.
  • The ownership of and the responsibility for all the data remain with this legal entity. This organization's owner and admins assigned by the owner retain full control over the data related to this entity.
  • Anitra works as private and secure storage and a visualization tool of these data only.

Data Management section of Customer profile is also a place to define and review customer published maps i.e. a creation wizard for maps construction.

Note the term "customer" refers to any "organization" having some kind of (active or past) commercial agreement with Anitra company

Customer balance - i.e. usage/charging summary vs. payment history is available in the Customer profile
Spending payments tab.jpg

A list of the devices owned by the customer is updated and visible right before or soon after shipping devices
Fix data fee calculation is also available instantly
Overage data charges are updated according to reality after the month is over and the detailed billing summary is available from the mobile network
Payments (from invoices paid) are visible after the data fee payment is received by us

LISTS, GRIDS

Device list

List of owned or administered devices (= hardware) - accessible only to owners/admins (users with shared data do not have the rights to see this area)
Click through to device details (profile), sort by the column, browsed by pages, first column freezing, quick system, and user filters
Search and Filter functionality: allows filtering your devices by criteria
Manageable through Filter manager next to the Search box, marked with icon C2.JPG
  • Predefined quick filters, which cannot be modified (Missing data in the last 7+ days, Anitra devices only, Powered off devices, Wrong tracking configuration, Deployed devices, Mortality indication)
  • You can turn on multiple Quick filters at once in the Quick filter panel
Context menu - as anywhere in Anitra the right-click mouse context menu offers the most relevant actions for the current context, functionality, or the whole page or a user
A wide range of columns available. Column selection and more column-related actions using Column manager from the context menu or directly e.g. by drag-drop columns:
  • Column selection, adding, removing columns (a default list can be restored using "reset visibility")
  • Column renames (default names can be restored using "reset display names")
  • Column order (a default order can be restored using "reset order")
Multi-select for bulk operations (open all in tabs, graph, apply config preset, etc)
System of warning messages such as Mortality indication: "Device Status" colored in red and followed by red skull symbol or Missing data last X days: "Last Device Position" followed by red question mark "?".

Tracking & Animal list

  • List of owned Trackings (tab "my trackings")
  • List of Trackings shared with me (tab "shared with me")
  • Overview of all Trackings including first and last data
    • Click through to Tracking detail/profile
    • System of warnings
    • Mortality indication: "Tracking" followed by red skull symbol
    • Missing data last X days: "Last Data " followed by red question mark "?". Mouse-over symbol tells the last data delay.

MAPS

Common map properties and controls
1) Map zoom
Note besides the zoom buttons you can zoom the map
  • using the mouse scroll wheel
  • or by double-clicking the left mouse button (to zoom in) and the right button (to zoom out)
2) Full-screen mode
3) Shows the user/device's current position on the map as a blue dot
4) GPS search tool - various GPS formats accepted (e.g. decimal degrees such as "52.7761 27.811889")
5) Background maps
  • a wide range of background maps of various types
  • transparent overlays (country and admin borders)
6) Transparent map overlays
  • country borders
  • admin leve1 1 borders
7) Map options
  • Tracks - note the option "Clustered" simplifies the track by removing movements within clusters
  • Waypoints - note the option "All" suppresses the default performance optimisation behavior (= option "Filtered") - i.e. enforces showing of all the waypoints
  • Annotations (aka Clusters) - currently these two Annotatin/Cluster types availabe to be used
    • Last positions - show/hide the last position of the tracking
    • Sleep clusters - show/hide the sleep clusters (data from periods defined by solar night/day i.e. by sun angle)
      Map04 mapFunctionality.JPG
8) Copy coordinates to clipboard
using left click context menu
9) Measure distance
using left click context menu
Map04 mapFunctionality 2.JPG


MAIN TRACKING MAP: Where do I see more animals in one map?

A tool to analyze multiple Trackings / Individuals in a single map.
The functionality displays all the Tracked Individuals available to a user (both owned/administered and shared only)
The start view shows an overview of the last positions - the color of the point classifies the last positions by the last update.
Map01 lastdatacolors.JPG
Filtering functionality below the map limits the data in the map (and in the right Tracking list panel]
The three quick filter conditions ("Search", "Tracking filters", "Species") directly filter matching/not matching Trackings/Animals
  • "Search": a full-text search across Device/Tracking/Animal codes/names/aliases
  • "Tracking filters": existing Tracking filters created by the user can be reused here in the map. This allows applying very complex filter conditions in the map
  • "Species": an obvious and simple quick filter conditions
Note that the "Days filter" works differently - it uses a time filter over telemetry data first and based on that it leaves or removes Trackings/Animals from the page
  • it excludes all the trackings with data outside of the time interval
  • for overlapping Trackings/Animals it limits data/tracks in the map according to the interval defined - i.e. only relevant parts of the tracks are loaded
    Map02 mapfilterfilled.JPG
Also note the map filter is stored in the URL (browser address bar). You can open another browser tab with a map page and configure a different filter (eg. another species). Both tabs then work independently.
Choosing Trackings / Animals to be loaded in the map.
  • using tooltips of single last points
  • or for multiple items using the rectangle tool selection in the map (using CTRL + click/drag with left mouse button)
  • selecting/unselcting particular items in the right Tracking pannel (single Trackings or all grouped by species)
    Map03 TOselection.JPG
Waypoints and Last positions (tooltips)
  • More tooltips can be displayed simultaneously
  • Click through the link to a particular Tracked Object profile
    Map05 TOdetails.JPG
  • Warnings and statuses are shown in tooltips e.g. mortality being indicated by black/red symbols
    Map06 mortalityInMap.JPG

PUBLISHED MAPS: How do I show an overview of our study results to the public?

A detailed guide to to Published maps functionality is available here.

A tool tailored to configure simplified and secured live telemetry maps from your full data sets.
Configured maps are available in form of a link or in form of short HTML code which can be simply added to your web presentation or published on Facebook.
Map output can be created:
  • on top of single organization data
  • on top of "project" (i.e. accross more complex data ownership structure)
Map editor with a live preview is used to configure the map
Publish map configuration groups.JPG
Two map modes can be configured:
  • map showing the simplified Tracks
  • map showing the Last positions only
For the mode of "Tracks" Animation can be anabled
The map configuration includes:
  • animal selection
  • language localisations (alternative language variants)
  • map mode (tracks vs. last position), grouping options, ordering, data filtering (e.g. track simplified to one position a day)
  • security features (security delay, zoom restriction, position "rounding")
  • presentation and visualization presets (a default map selection, icon/track styles, choice of icons, logos with links, foto gallery, animation enabling)
Samples showing some of the map features

A detailed guide to to Published maps functionality is available here.

GRAPHS: How to visualize important data relations in graphs?

Graph functionality available
  • as a tab in Device and Tracking profiles (see #0)
  • for a group of Devices (only admin functionality now).
Time is indicated by the horizontal axis (see #1)
By default period of the last 7 data days is loaded.
The interval shown can be managed either by the interval slider (see #2) or using the date input below the chart area (see #3).
Graph time.jpg
You can hover over the chart to preview the actual values (see #4).
The values of metrics are plotted at the vertical axis of the graph (see #5).
The scale for a particular metric is shown on the left and right from the graph area (see #6).
To quickly show/hide a particular metric click the label color above the graph (only used till the next page reload)(see #7).
Graph orientation.jpg
You can customize your metric list (visibility) and order using the "Choose metrics" button below the chart (see #8).
Visibility (see #9) and order (see #10) is controlled by drag'n'drop action.
Graph choseMetrics.jpg
Visibility and order can also be managed in "Edit graph columns" from the context menu (see #11).
Additionally, this functionality offers even more properties to be controlled such as custom rename (see #12) or colors, graph type, and default value range (see #13).
It also allows resetting the changes to system defaults (reset options in the top right corner)(see #14)
Graph editColumns.jpg

PHOTO GALLERY: Where do I browse all the photos?

  • Displays a complete gallery of pictures from all the Trackings (own and shared)
  • Filtering by main attributes
    TO.JPG

MANAGING and CONFIGURING of Anitra Tags

Device Status and Discard Flow

Device Status attribute is automatically assigned based on device usage history (including its past and current deployments)
E.g. the tags are automatically moved from Pool to Deployed statuses by creating Tracking (+Animal) object. Check the detailed guide here.
pool-new : devices never deployed previously
pool-used: devices returned to the device pool after deployment
deployed-active: deployed on animals, known to have delivered fresh data within the last 3 days
deployed-delayed: deployed on animals, known to have delivered fresh data within the last 4-7 days
deployed-missing: last data older than 7 days
Note Devices status applies to all the devices types including data imported from Movebank of from Import flow.
Device/SIM Discard Flow (for Anitra devices)
Device/SIM closing(discard/termination) workflow is available for Anitra device owners so the SIM can be closed and the device removed from (data fees) billing
Users are supposed to mark the devices they wish to be terminated - to be used for devices not expected to deliver new data anymore.
Marking the device triggers a process that irreversibly terminates the device SIM with our network provider
SIM is ultimately terminated by the end of the month following after marking the device to be discarded (e.g for a device marked to be discarded on the 13th of February the SIM will be active (and data fees charged till the end of the March))
Note you can still stop the discard process till the SIM is irreversibly terminated by the network operator by contacting us directly till the end of the following month (i.e. for the example above we can manually withdraw the SIM closing request till the 31st of March)
The check for marking devices to be terminated is available at the bottom part of the device profile.
Device Discard/Archive flow for non-Anitra devices
For non-Anitra devices (= devices originating from import or integration - i.e. Movebank, Ornitela, Ecotone, Manual Import) there is also a Discard/Archive mark present in the Device profile
For those, the flag only allows marking those that are not active anymore (for the sake of filtering and correct visibility in the maps)
A recommendable practice is to mark the tags that are considered lost or those terminated in the original control panel
Note in this case the flag is fully reversible (the user can change it there and back without any restriction)
Device Status Extended/Long
Extended/long devices status is summarizing all the status information related.
It is a combined field of Device status, history summary and Discard status.
It is displayed in the Device profile, Device list, and Customer balance overview

Configuration /programming of devices

For complete detail of all the configuration options see the configuration guide to the latest firmware version or to older versions respectively.


Users with admin rights can access the configuration from the lists and profiles using cogwheel icons. Note the configuration functionality is available for Anitra devices only.
Config lists profiles.JPG


Configuration contains three main areas
  • Data collection settings
    • GPS/sensor sampling time schedules
    • Data collection triggered by events
    • Configuration of bursting behavior
    • Mortality detection adjustment
    • Geofencing
  • Communication schedules
  • Other settings
Config sections.JPG
For complete detail of all the configuration options see the configuration guide to the latest firmware version or to older versions respectively.

OTHER PRODUCTIVITY TOOLS

FILTERS & SEARCHES: How do I find what I am looking for ?

Various features helping user find and filter down what is needed are available in Anitra:

  1. Global full text search
    - full text seach accross all the objects of various types which user has access rights to.
    - a list of relevant item s sorted by relevancy is returned
    Global full text search.JPG
  2. Grid search
    - seaches in important fields in displayed grid only
    Grid search.JPG
  3. System and Custom "Quick" filters
    - allows quickly filter data using predefined "system" or "user defined" filters
    - filters are available as icons on top of the device or tracking grid header line
    - custom filters can be created in "Filter manager"
    Quick filters.JPG
  4. Published map filters
  • Filter manager
    • Customized quick filters that filter devices according to specified criteria (e.g. Device list, Name fields, Device notes..), you can set multiple criteria at once
      :B.JPG
    • You can save your customized filter with the green "check" icon
      :Ml.JPG
    • "Eye" icon enables to pin the particular Quick filter into the Quick filter panel next to the Search box
      :Mil.JPG
  • Filter functionality: allows filtering your trackings by criteria
    • Predefined quick filters, which cannot be modified (Mortality Warning, Last data warning only, Anitra devices only)
    • Customized quick filters, which filter Trackings by set criteria (e.g. Tracked Objects, Name fields, Note fields..), you can set multiple criteria at once
    • You can save your customized filter with the green "check" icon
    • "Eye" icon enables to pin the particular Quick filter into the Quick filter panel next to the Search box
      :Ksdjf.JPG
    • You can turn on multiple Quick filters at once in the Quick filter panel

NOTES: Where to note down info about particular things?

A handy feature helping users to get organized and stay organized with their data.
:Note thread narrow.JPG
Available for multiple entities (Devices, Trackings, Animals, and Customers/Organizations)
Note threads can be accessed
  • from entity profiles - in the green shown opening of the Tracking note, the blue mark on the right shows the place to access the device note
    Note from profile.JPG
  • entity lists or using the context menu - either click on the note icon in the Notes column or use the context menu over the desired row
    Note from listContext.JPG
  • from user Task List
    Task userTaskList.jpg
Here a new note can be created, existing notes can be edited, or a reply to previous notes can be posted.
The thread window is flowing over the entity. It can be open parallel to whatever you do in your profile. You can switch tabs, type forms, take screenshots while browsing, or even create/edit notes.
Create the note simply by typing in the form
Edit existing notes by double-clicking them or using "more" or "Edit" icons in the right top corner. This switches note into "edit" mode
Note editMode.JPG
Save the new or edited note by clicking the "Publish/Done" button or simply hitting ENTER.
While creating or editing you can cancel by the "Cancel" button or using ESC on your keyboard
The note text does not allow formatting but you can structure the note to more rows. Use SHIFT+ENTER for the new line (as ENTER is reserved for the "Save" operation)
An existing note can be deleted using the "more" button >> "Delete thread". Note while deleting the parent note all the replies will also be deleted.
"Clone note" function - particularly useful e.g. for fast duplicating of notes with complex definitions (i.e. notes linked to many items).
While cloning notes attachments are removed (not cloned with the note).
:Note deleteClone thread.JPG
Use "Promote to parent note" when you need to convert a note reply to a top-level parent note.
While promoting reply to note it inherits the relations from its original parent note
Use "drag'n'drop: action to move one note into the reply area of the other note to move and transform the note into the reply.
Converting note into reply is only possible for notes created by the user himself and only to notes that have no complex relationship
By default the note thread is
  • sorted starting with newest notes up. You can invert the sort order to have the oldest notes on top of the page. This setting is remembered in your user preferences.
  • positioned on the top right side of the page. You can modify the position by dragging the floating window to any side, This setting is remembered in your user preferences.
  • sized to one-third of the screen width. You can switch the window size between one-third and one-half by the "shrinking/stretching" button. This setting is also remembered in your user preferences.
    :Note sortSizePosition.JPG
Notes can be saved as
  • shared - will be visible to all the users with access to the entity. a way to share knowledge, tasks, and the status of particular items
  • private - will be visible only to the author of the note. a way to note down things or ToDos only for the author
    :Note sharedPrivate.JPG
The functionality contains a complex toolkit covering
:Note functionality options.JPG
  • relations - a single note (thread) can be linked to multiple items of the same type (e.g. a single/shared note linked to 5 devices)
  • attachments
    • To each note or reply, one or more attachments (e.g. pictures) can be attached (by browse function or using drag 'n' drop)
    • Picture attachments are then previewed in the thread, photos can be opened in full size and browsed as a gallery
  • screenshots
    • For adding a screenshot from the clipboard just press CTRL+V (paste) while in the note body.
    • This will append the screenshot similarly as it was a regular attached picture file. Note you can modify the screenshot file name as well.
  • links/URL
  • tags - you can label your notes by using user "tags", later you can search, filter, or group by these tags

TASKS (TODOS): Where to note down reminders and ToDos ?

Extension of the Notes functionality
By assigning a note to someone (to another user, to user himself or to anyone) the note is transformed into the Task (ToDo)
Use the button below the note editor or simply type @+name to assign the note as a task to someone
Task assignment.jpg
  • assigning a task to another person (@other.person) will list the task in the other person's Task list (as created by you).
  • assigning a task to yourself (@your.name) will list the task in your Task list (as created by yourself).
  • assigning a task to anyone (@anyone) will create a shared task displayed to all the people with access to the linked entity (e.g. particular device, tracking, or customer)
A simple workflow for tasks exists - the task can be in one of the three states
  • new/open (= to be completed, highlighted by yellow background)
  • completed /done (= marked as completed, highlighted by a green background)
  • canceled / rejected (highlighted by a reddish background)
    Task statusColors.jpg
Users can move the tasks between the states using icons and controls in the right corner
:Task statusChange.jpg
User Task board screen shows all the ToDos assigned to the user or defined by the user to others
Entity note thread can be accessed from the Task list by clicking the particular task
Task status can be changed from here or some comments added
You can also jump to the profile screen of the linked entity by clicking its name
:Task userTaskList.jpg

COLUMN EDITOR: How can I adjust columns I see?

All the data visualization and download features are designed to allow users to pick and modify the columns to be used.
Use "Edit columns" options from the context menu of the functionality you wish to modify.
Beyond choosing the columns, the Edit functionality allows customizing names, order, color, graph type, and ranges, and reset changes to the default.
Edit columns option is available for
  • metadata (device/tracking) lists
  • metadata list exports
  • profile data table columns
  • profile graph columns
  • data export columns
See the Graphs section for some screens of column editing
Both metadata and data can be accessed via Anitra API and same here the columns to be included can also be managed at the level of API query
The detailed API specification provides basic info about columns available.

USER PREFERENCES: How can I customize my user experience ?

Various features in the application are designed to remember user modifications
You can see and manage all your user preferences in the User preferences screen
The preferences listed are organized into categories
It is accessible from the user avatar in left menu or anywhere from right click context menu
User preferences.jpg

DATA FLOWS: How do I get the data IN/OUT?

A detailed guide to to all the data flows here.

Anitra offers a range of data manipulation options on how to get data and metadata IN or OUT of the platform.
This functionality area involves features of data import, export, automated data connectors or API access
The options range from purely manual (e.g. manual data exports or data imports) to fully automated (e.g. inbound data flows for Ornitela, Ecotone, or Movebank).
Some flows make sense for the particular user but most of the data management tools are meant to be configured at the level of customer/organization (hence available in customer profile)
Outbound data flows:
Inbound data flows:

A detailed guide to to all the data flows here.

WARNINGS, NOTIFICATIONS

MORTALITY WARNINGS

DTO0000.JPG Red skull

  • Indicates mortality detected by onboard mortality detector (Anitra tags only)
  • More about mortality detector in firmware configuration
  • The flag is stored at the level of database records (visible in data history anytime the device detected mortality)

DTO000.JPG Black skull

Notifies on possible mortality in the last records of trackings as estimated by server post-process analysis
Recalculated
  • with new received data
  • with modification of the tracking range (i.e. when closing active Tracking or when updating Tracking End Date)
The flag is recalculated and visible for the last data only (not visible in data history).
Algorithm factors in roll and pitch oscillations for the latest three records and/or the last 3 hours

Red bird belly up

Unnatural body position in the very last record (roll and pitch)
whenever the absolute value of the angle for Roll or Pitch exceeds 90 degrees


RELEASE NOTES

Latest release note overview is shown to the user any time a new release is deployed since the last user's Anitra access.
After being displayed the screen is no longer shown till another release
The release note screen aggregates data from the past 60 days are shown.
Release note screen can be manually invoked by pressing the Anitra icon (left top corner of the application)
ReleaseNotes drill.jpg

MORE GUIDES

LIFE EUROKITE Red kite Wintering count (Anitra tips)
LIFE EUROKITE Project datasharing (a guide for Eurokite data controllers)