Difference between revisions of "Main Page"

From Anitra Support
Jump to: navigation, search
({{Fa|fa-user}}ORGANIZATIONS (CUSTOMERS))
(DATA FLOWS: How do I get the data IN/OUT?)
(35 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE: Anitra Platform User Guide}}
 
{{DISPLAYTITLE: Anitra Platform User Guide}}
Anitra platform is a comfortable environment 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 feed) however some of the most advanced features are tailored to complement the unique onboard functionality of ANITRA branded GPS-GSMS transmitters only. The very core functionality serves as a device backend for Data Owners/Admins. 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 possibly 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.  
+
'''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 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 meant 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.
 +
 
 +
: Home screen of ANITRA platform is at https://app.anitra.cz/<br>[[File:sign-in_ user,pass.JPG|500px]]
 +
<br>
 +
 
 +
= MAIN CONCEPTS =
 +
<br>
 +
: Anitra data model is based on the following key concepts:
 +
 
 +
: '''Device'''
 +
:: Device (or Tag) entity represents the physical telemetry device hardware that collects particular telemetry data. Any tracking and sensor data need to be linked to some device.
 +
 
 +
:: Additional attributes related to the hardware (brand, model, serial no., GSM no., etc.) can be stored in the device structure and viewed in the [[Main_Page#Device_profile|Device profile]].
 +
 
 +
:: 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).
 +
 
 +
:: Each device has its "Ownership" defined i.e. definition of which organization or individual user created it or has the master administration access to it granted (including delete rights) - see more below.
 +
 
 +
 
 +
: '''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.
 +
 
 +
:: The date(time) interval defines when the device was physically attached to the Animal
  
Log in/ Sign up screen of ANITRA platform available at https://app.anitra.cz/
+
:: ''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. 
  
'''AREAS OF FUNCTIONALITY'''
+
:: Tracking inherits permissions from its parent Device entity so users with device owner/admin access can create and modify the deployments as well.
  
=SIGNING IN=
+
 +
: '''Device Data''', Records, Positions
 +
:: A basic level of tracking/measurement information
 +
:: Data are accessible refering Devices, Trackings and Animals (s)
  
==Sign up==
 
  
* Use the "Create new account" link on the login page: https://app.anitra.cz/ to auto-register yourself as a new platform user<br>[[File:Create new user.jpg|502x502px]]
+
: '''Group''', Project, Study
** Use a valid email address as your future username ''/do not use shared or group emails/''
+
: '''Person''', User, Role
** Enter your name ''/enter person name, do not use group names, numbers, and similar instead of personal names - important when working in projects with other people/''
+
:: 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.
** Upon completion, an email with an account confirmation link will be sent to your inbox
 
  
* Alternatively create a new account by using the "SIGN IN WITH GOOGLE" button.
+
: '''Organisation''', Customer
** 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]]
+
: '''Place''', Point of Interest (POI)
 +
: '''Event''', Observation
  
* A new user can also be created by other existing users sending an invitation to the new person from access granting wizards
 
** all the flows in the system which allow granting access to someone (e.g. sharing tracking, adding admins, or assigning project access) also offer an option of inviting/adding a brand new user typing a new email address <br>[[File:user_invite_dialogue.jpg|502x502px]]
 
** in this case invitation/account confirmation email is sent to the new user <br>[[File:user_invite_email.jpg|645x635px]]
 
  
==Sign in==
+
= [[SIGNING_IN | SIGNING IN - How do I get into the app?]] =
  
* Once completely registered you can log in
+
: Home screen of the ANITRA platform is at https://app.anitra.cz/
** either using your username and password
 
** or using the "Sign in with Google" functionality <br>[[File:Sign-in user-pass.JPG|502x502px]]
 
  
==Password reset==
+
: 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]]
  
* you can reset your password using the "Forget password ?" link on the "Sign In" form if needed
+
: 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]]
** for resetting the password enter your login address <br>[[File:sign-in_ reset password request.JPG|439px]]
 
** a reset password link will be sent to your email address <br>[[File:sign-in_ reset password retype.JPG|733px]]
 
  
==User/Person profile==
+
: 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 modify personal details and preferences on your user profile detail
+
: You can review and modify your details and preferences in your user profile later.<br>[[File:user_profile_google_auth.JPG|900px]]
** modify your password if needed
 
** manage (add/remove) linked Google Account(s)
 
** adjust other preferences <br>[[File:user_profile_google_auth.JPG|1351px]]
 
  
 +
: ''[[SIGNING_IN| more about User creation and user managment here]].''
  
={{Fa|fa-map-o}}MAP=
+
= MAPS =
 +
 
 +
=={{Fa|fa-map-o}} MAIN MAP: How do I start viewing data? ==
  
 
* A tool to analyze multiple Individuals in a single map <br>[[File:map00_paralelanalysis.JPG|900px]]
 
* A tool to analyze multiple Individuals in a single map <br>[[File:map00_paralelanalysis.JPG|900px]]
Line 81: Line 112:
 
* Tracking Mortality Indicated by black/red symbols in the right Tracking side selection and in the tooltips <br>[[File:map06_mortalityInMap.JPG|900px]]
 
* Tracking Mortality Indicated by black/red symbols in the right Tracking side selection and in the tooltips <br>[[File:map06_mortalityInMap.JPG|900px]]
  
={{Fa|fa-tablet}} DEVICES=
+
== [[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]].''
  
==Device list==
+
: A tool tailored to configure simplified and secured live telemetry maps from your full data sets.
* List of owned or administered devices (= hardware)
+
 
* Click through to device details (profile)
+
: 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.
* Available device types:
+
 
** "Anitra": used for Anitra native devices, device functionality includes remote control of active devices in the field
+
: Map output can be created:
** "Ecotone": virtual devices for Ecotone data, the possibility of the data feed from Ecotone web (available on request)
+
:* on top of single organization data  
** "Ornitela": virtual devices for Ornitela data, possibly of data feed on Ornitela web (available on request)
+
:* on top of "project" (i.e. accross more complex data ownership structure)
** "Upload/Basic": devices created through Import functionality, any other tracking data, the user who uploads become Device Owner
+
 
* Semi-automatic Device Status assignment: devices categorized into activity groups (archive, deployed, backup/stock)
+
: Map editor with a live preview is used to configure the map<br>[[File:publish_map_configuration_groups.JPG|900px]]
* System of warning messages
+
 
** Incorrect/Missing Device-TrackedObject configuration: "Device Code" followed by the black/{{red|red}} exclamation mark ( "!" or {{red|"!"}} )
+
: Two map modes can be configured:
** Mortality indication: "Device Status" colored in red and followed by {{red|red skull}} symbol
+
:* map showing the simplified '''Tracks'''
** Missing data last X days: "Last Device Position" followed by red question mark {{red|"?"}}. The mouse-over symbol tells the last data delay.
+
:* map showing the '''Last positions''' only
* Filter functionality: allows filtering your devices by criteria
+
 
* Manageable through Filter manager next to the Search box, marked with icon [[File:C2.JPG|30px]]
+
: For the mode of "Tracks" '''Animation''' can be anabled
** 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)
+
 
** 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]]  
+
: The map configuration includes:
** You can save your customized filter with the green "check" icon <br>:[[File:Ml.JPG|900px]]
+
:* animal selection
** "Eye" icon enables to pin the particular Quick filter into the Quick filter panel next to the Search box <br>:[[File:Mil.JPG|900px]]  
+
:* language localisations (alternative language variants)
** You can turn on multiple Quick filters at once in the Quick filter panel
+
:* map mode (tracks vs. last position), grouping options, ordering, data filtering (e.g. track simplified to one position a day)
* Device information (and configuration) is accessible only to owners/admins (users of shared data do not have the rights to see this data)
+
:* security features (security delay, zoom restriction, position "rounding")
:[[File:Capture_2.JPG|900px]]
+
:* 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]].''
 +
 
 +
= DETAIL PAGES: Where can I view and manage the full detail? =
 +
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==
+
=={{Fa|fa-tablet}} Device profile ==
  
 
* Device identification, meta info, status, overview, and admin management
 
* Device identification, meta info, status, overview, and admin management
Line 122: Line 165:
 
:[[File:Capture_3.JPG|900px]]
 
:[[File:Capture_3.JPG|900px]]
  
==Device Configuration==
+
=={{Fa|fa-paw}} Tracking & Animal profile ==
<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
 
:* 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]]
 
 
 
={{Fa|fa-paw}}TRACKED OBJECT (TRACKING+ANIMAL)==
 
 
 
==Tracking 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.
 
* 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
 
 
 
==Tracking Profile==
 
  
 
* Details of tracked object (= tracking of the individual animal)
 
* Details of tracked object (= tracking of the individual animal)
Line 176: Line 185:
 
* Same photo can be shared by various Trackings <br>[[File:TOP02.JPG|900px]]
 
* Same photo can be shared by various Trackings <br>[[File:TOP02.JPG|900px]]
  
={{Fa|fa-photo}}PHOTO GALLERY=
+
=={{Fa|fa-user}} Organisation/Customer profile==
  
* Displays a complete gallery of pictures from all the Trackings (own and shared)
+
A section visible in the side menu (only) for users with Admin/Owner relations to Organisations listed in the system.
* Filtering by main attributes <br>[[File:TO.JPG|900px]]
+
* 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]]
  
={{Fa|fa-upload}}IMPORT DATA=
+
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.)
  
* Allows importing any other tracking data in the predefined structure. Currently, we support:
+
Billing summary and payment history is also available in the Customer profile once any (data fees related) ivoices were booked
** Data in simple structure device-GPSDateTime-latitude-longitude-note (type "Basic")
+
* note the term "customer" refers to any "organization" having some kind of (active or past) commercial agreement with Anitra company
** Ecotone CSV format
+
* the cost overview is typically visible upon initial invoicing is accounted
** 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]]
 
  
={{Fa|fa-user}}ORGANIZATIONS (CUSTOMERS)=
+
There is a place to define and review customer [[PUBLISHED_MAPS|published maps]] i.e. a creation wizard for maps construction.
  
* a section visible in the side menu (only) for users with Admin/Owner relations to Organisations listed in the system.
+
[[DATA_FLOWS|Various inbound and outbound data flows]] from manual data export to fully automated can be managed for organization account
** users not having any role in any organization do not see this section
+
* (IN) Inbound data flows (connectors for Movebank, Ornitela, and Ecotone available)
** in case the user is active in more organizations the list of these is displayed first
+
* (IN) Manual data import (see the Import functionality)
<br>[[File:Customers_And_Integration01.JPG|900px]]
+
* (OUT) API data access
 +
* (OUT) Manual data export
 +
* (OUT) Anitra to Movebank datafeed
  
* organization details such as contacts and access roles can be edited on the organization profile
+
Note, only the legal owners of original data are allowed to configure inbound data flows!
** main customer admin (owner) is assigned
+
* 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.
** owner can make other people admins granting them "customer admin" role.
+
* 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.
** customer owner{admins) have full access to devices belonging to a particular customer/organization account (can export data, manage trackings and animals, etc.)
+
* Anitra works as private and secure storage and a visualization tool of these data only.
  
* note the term "customer" refers to any "organization" having some kind of (active or past) commercial agreement with Anitra company
+
= Lists, Grids=
  
* various inbound and outbound data flows for organization account can be configured here - see in detail below
+
=={{Fa|fa-tablet}} Device list==
 +
* 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, the possibility of the data feed from Ecotone web (available on request)
 +
** "Ornitela": virtual devices for Ornitela data, possibly of data feed on Ornitela web (available on request)
 +
** "Upload/Basic": devices created through Import functionality, any other tracking data, the user who uploads become Device Owner
 +
* Semi-automatic Device Status assignment: devices categorized into activity groups (archive, deployed, backup/stock)
 +
* 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|"?"}}. The mouse-over symbol tells the last data delay.
 +
* 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)
  
==Data export==
+
** You can turn on multiple Quick filters at once in the Quick filter panel
* allows exporting data in CSV, XLSX, KML, or GPX formats for offline use
+
* Device information (and configuration) is accessible only to owners/admins (users of shared data do not have the rights to see this data)
* the feature bulk exports data for all the devices belonging to the customer account
 
* data can be filtered by a date range
 
* the column editor feature allows modifying output column list in terms of columns list, order and naming
 
  
==API data access==
+
=={{Fa|fa-paw}} Tracking & Animal list ==
* allows grabbing Anitra data from external tools such as from GIS systems API interface
 
* service currently available on request only
 
  
==Inbound data feeds==
+
* List of owned Trackings (tab "my trackings")
* allows plugging to external telemetry data sources and having them fed into Anitra
+
* List of Trackings shared with me (tab "shared with me")
* a unified metadata structure can be then created on top of the imported data (device - tracking - animal)
+
* Overview of all Trackings including first and last data
* connectors for Movebank, Ecotone, and Ornitela dashboards are currently exist
+
** 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.
  
 +
= Graphs: How to visualize important data relations in graphs? =
  
* Integration connection toolbox allows
+
={{Fa|fa-photo}}PHOTO GALLERY: Where do I browse all the photos? =
** Create-edit-remove management of the connection
 
** Sending a request for automatic integration run
 
* Review of the log of the service <br>[[File:Customers_And_Integration03.JPG|900px]] <br>[[File:Customers_And_Integration04.JPG|900px]]
 
  
 +
* 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}} CONFIGURATION for Anitra Tags =
 +
: ''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]].''
  
can hold the definition of one or more integration connections (currently Ecotone and Ornitela data feeds supported) <br>[[File:Customers_And_Integration02.JPG|900px]]
 
  
 +
= OTHER PRODUCTIVITY TOOLS =
 +
== FILTERS & SEARCHES: How do I find what I am looking for ? ==
  
==Published maps (iframes)==
+
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'''
  
==Published maps (iframes)==
+
* Filter manager
* Iframe functionality has been developed to visually share your ANITRA data. For more details see [[editing iframe| the complete guide for iframe]]
+
** 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]]
* allows creation and publishing of simplified live secured maps (e.g for external website/facebook presentations)
+
** 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]]
  
={{Fa|fa-adress-card}}EXPORT DATA into CSV/XLSX/KMZ/GPX =
+
* Filter functionality: allows filtering your trackings by criteria
* places to export data:
+
** Predefined quick filters, which cannot be modified (Mortality Warning, Last data warning only, Anitra devices only)
::#'''Customer profile:''' full data for all ANITRA devices owned by Customer (available for CustomerOwner and CustomerAdmins)
+
** Customized quick filters, which filter Trackings by set criteria (e.g. Tracked Objects, Name fields, Note fields..), you can set multiple criteria at once
::#'''Device profile:''' all data for a single device (available for all Customer/Device Owner/Admins)
+
** You can save your customized filter with the green "check" icon
::#'''Context menu from Device/Trackings list:''' all data for a single Device or Trackings (available for all Customer/Device Owner/Admins)
+
** "Eye" icon enables to pin the particular Quick filter into the Quick filter panel next to the Search box <br>:[[File:ksdjf.JPG|900px]]  
* /* mass data takeout not available for people with shared access only */
+
** You can turn on multiple Quick filters at once in the Quick filter panel
* Ref 1) Mass export ANITRA data on "Customer profile"
 
::::(Both CSV and formatted Excel sheet available):
 
:[[File:Export001.JPG|900px]]
 
  
* Ref 2) Export data for one particular device <br>[[File:Export002.JPG|900px]]
 
  
* Export columns specification:
 
:[[File:Export004.JPG|900px]]
 
  
* CSV file sample preview:
+
= [[DATA_FLOWS | DATA FLOWS: How do I get the data IN/OUT?]] =
:[[File:Export005.JPG|900px]]
+
''[[DATA_FLOWS|A detailed guide to to all the data flows here]].''
  
* XLSX file sample preview:
+
: Anitra offers a range of data manipulation options on how to get data and metadata IN or OUT of the platform.
:[[File:Export006.JPG|900px]]
 
  
=DEVICE-TRACKED OBJECTS-MORTALITY=
+
: This functionality area involves features of data import, export, automated data connectors or API access
* Anitra platforms data model is based on the following key concepts:
 
  
==Device==
+
: 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]]).
* 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 meta-information 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 animal in the system can be created
 
*** Using "split tracking" functionality in the device profile
 
*** Using "create new tracking" 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.
+
: 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)
  
* Available basic "Device Statuses":
+
: Outbound data flows:
** '''Backup / Pool''':  
+
:* [[DATA_FLOWS#.28OUT.29_Manual_DATA_Export|Data Export]]<br>[[File:export_tracking_profile.JPG|900px]]
*** To be used for spare/pool devices which are not currently in the field and are planned to be (re)used in the future.
+
:* [[DATA_FLOWS#.28OUT.29_Manual_METADATA_Export|Metadata Export]]<br>[[File: export_meta_tracking_grid.JPG|900px]]
*** New devices which appear in the system are labeled "Backup" status automatically
+
:* [[DATA_FLOWS#.28OUT.29_Anitra_API_data_.26_metadata_access|API (both data and metadata)]]
** '''Deployed''':
+
:* [[DATA_FLOWS#.28OUT.29_Anitra_to_Movebank_data_feed|Anitra to Movebank data feed]]
*** To be used for devices that are currently deployed "in the field" and potentially sending data
 
*** There are 4 sub-statuses available that 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 the target animal (shed/down logger, the 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
 
  
==Tracking EndDate==
+
: Inbound data flows:
 +
:* [[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]]
 +
:* [[DATA_FLOWS#.28IN.29_Manual_data_import|Data Import]]<br>[[File:manual_customer_import.JPG|900px]]
  
* 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).  
+
''[[DATA_FLOWS|A detailed guide to to all the data flows here]].''
** Ending Tracked Object / Tracking is done by filling in date into field "End of tracking" in the Tracking profile
 
** "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. 
 
** Note that you can additionally enter more detail related to mortality event ("Estimated date of death", "Mortality Reason", "Mortality Note", "Mortality Photos/Documents/Reports")
 
  
'''Mortality warnings''' <br>[[File:DTO000.JPG|44x38px]]
+
= Warnings, Notifications=
* Notifies on possible mortality in the last position of finished (archive) trackings
 
* You can set the end date of tracking so that the mortality sign is displayed in your archive data (see the end date for the first two tracked objects in example no 1)
 
[[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''
 
::* ''Anitra: dedicated sensor/accelerometer mortality detection logic''
 
::* ''Ornitela: identical body position between subsequent measurements''
 
::* ''Ecotone Activity column with a simple rule (Activity < 10) triggering the alert. More complex logic is being developed for Anitra native devices''
 
  
* You can find these last data mortality warnings on various screens of the Anitra platform:
 
** Device list (''only Red warning for Active trackings'')
 
:[[File:DTO001.JPG|900px]]
 
  
* Device Profile
+
=[[MORE_GUIDES| MORE GUIDES]]=
:[[File:DTO002.JPG|900px]]
 
  
* Tracking List (''both Red warnings for Active trackings and Black Info for Archive trackings'')
+
: [[RK_WINTERCOUNT_TIPS| LIFE EUROKITE Red kite Wintering count (Anitra tips)]]
:[[File:DTO003.JPG|900px]]
 
  
* Tracking profile
+
: [[EUROKITE_PROJECT_DATASHARING| LIFE EUROKITE Project datasharing (a guide for Eurokite data controllers)]]
:[[File:DTO004.JPG|900px]]
+
 +
: [[MORE_GUIDES| Device Status Management and Tracking specification]]  
  
* Map (both Red warnings for Active trackings and Black Info for Archive trackings)
+
: [[MORE_GUIDES| Tracking EndDate & Mortality warnings]]
[[File:DTO005.JPG|900px]]
 
  
* Device Owner/Admins can freely switch devices from one state to another and modify Tracking end dates in order to achieve desired Anitra behavior
+
: [[GUIDE_2021_11_04| Previus version of the guide (version before 2021-11-04)]]

Revision as of 04:56, 22 September 2022


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 meant 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.
Home screen of ANITRA platform is at https://app.anitra.cz/
Sign-in user,pass.JPG


MAIN CONCEPTS


Anitra data model is based on the following key concepts:
Device
Device (or Tag) entity represents the physical telemetry device hardware that collects particular telemetry data. Any tracking and sensor data need to be linked to some device.
Additional attributes related to the hardware (brand, model, serial no., GSM no., etc.) can be stored in the device structure and viewed in the Device profile.
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).
Each device has its "Ownership" defined i.e. definition of which organization or individual user created it or has the master administration access to it granted (including delete rights) - see more below.


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.
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.


Device Data, Records, Positions
A basic level of tracking/measurement information
Data are accessible refering Devices, Trackings and Animals (s)


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.
Organisation, Customer
Place, Point of Interest (POI)
Event, Observation


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.

MAPS

MAIN MAP: How do I start viewing data?

  • A tool to analyze multiple Individuals in a single map
    Map00 paralelanalysis.JPG
  • The functionality displays all the Tracked Individuals available to a user (both owned/administered and shared only)
  • By default an overview of the last positions is shown - the color of the point categorizes data by the last data update.
    Map01 lastdatacolors.JPG
  • Filtering functionality below the map limits data in the map and in the right Tracking selection list by following criteria:
    • "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
Map02 mapfilterfilled.JPG
  • Map functionality

Map04 mapFunctionality.JPG

  1. Map zoom
  2. Full screen mode
  3. Overview map
  4. Map layers - a wide range of available maps
    Map04a mapFunct maps.JPG
  5. Show current user position
  6. Map options
  • Last positions
  • Tracks
  • Waypoints
  • Night Points
Map04b mapFunct Options.JPG
Map04c mapFunct OptNight.JPG
  • Tracking details
    • Track point details in the tooltip (note that more track point tooltips can be displayed simultaneously)
    • Additional Tracking detail in the right TO selection list (including "Share" button for admins)
    • Click through the link to a particular Tracked Object profile
Map05 TOdetails.JPG
  • Tracking Mortality Indicated by black/red symbols in the right Tracking side selection and in the tooltips
    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.

DETAIL PAGES: Where can I view and manage the full detail?

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 identification, meta info, status, overview, and admin management
  • Device data visualized on the map and on the timeline
  • Definition of tracked animal (create, edit, delete)
    • Removal of testing/manipulation/storage periods
    • Creation/split of device data into real tracked animals (situation when one logger was subsequently used for more than one animal)
  • Last known geolocation (DateTime + country etc.)
  • System of warnings
    • Incorrect/Missing Device-TrackedObject configuration
    • Mortality indication: red/black warning in "Last device 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)
  • Summary for related TO profiles including Mortality Indication symbols
Capture 3.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.)

Billing summary and payment history is also available in the Customer profile once any (data fees related) ivoices were booked

  • note the term "customer" refers to any "organization" having some kind of (active or past) commercial agreement with Anitra company
  • the cost overview is typically visible upon initial invoicing is accounted

There is a place to define and review customer published maps i.e. a creation wizard for maps construction.

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.

Lists, Grids

Device list

  • 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, the possibility of the data feed from Ecotone web (available on request)
    • "Ornitela": virtual devices for Ornitela data, possibly of data feed on Ornitela web (available on request)
    • "Upload/Basic": devices created through Import functionality, any other tracking data, the user who uploads become Device Owner
  • Semi-automatic Device Status assignment: devices categorized into activity groups (archive, deployed, backup/stock)
  • System of warning messages
    • Incorrect/Missing Device-TrackedObject configuration: "Device Code" followed by the black/red exclamation mark ( "!" or "!" )
    • Mortality indication: "Device Status" colored in red and followed by red skull symbol
    • Missing data last X days: "Last Device Position" followed by red question mark "?". The mouse-over symbol tells the last data delay.
  • 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
  • Device information (and configuration) is accessible only to owners/admins (users of shared data do not have the rights to see this data)

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.

Graphs: How to visualize important data relations in graphs?

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

CONFIGURATION for Anitra Tags

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


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

MORE GUIDES

LIFE EUROKITE Red kite Wintering count (Anitra tips)
LIFE EUROKITE Project datasharing (a guide for Eurokite data controllers)
Device Status Management and Tracking specification
Tracking EndDate & Mortality warnings
Previus version of the guide (version before 2021-11-04)