/ Recent content on Firetail Manual Hugo -- gohugo.io en-us /docs/getting-started/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/getting-started/ Getting started Welcome to Firetail Firetail provides you with a fully featured environment for the visualisation and annotation of modern, large-scale GPS, acceleration and tracking data. Firetail is meant to work completely interactive and connects to Movebank directly. Event data, Acc bursts and Reference data can be explored. This manual covers should cover all current Firetail features. If something is missing, please let us know. Overview of Firetail In the screenshot above we highlighted the most essential elements of firetail: /docs/installation/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/installation/ Installation Guide Firetail is available for Mac, Linux and Windows. Download your copy from here. If you are unsure which version to choose, start with the Free Edition and order a trial license when you hit any hard limits of this edition. For productive use in research consider to include a full license of Firetail in your next grant application. This will include expert support and on-demand features for large-scale projects. /docs/open-files/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/open-files/ Open Files panel The Open Files panel is a tree-like overview of all tags/individuals or deployments in an open dataset. Selecting Individuals To show which individuals/tags are shown in the map Firetail provides the Open File panel. It can be used to select subsets of the data or the complete dataset (default). Click on the checkbox next to each individual to de-/select the associated data. The triangle symbol will show you the number of GPS and acceleration samples available. /docs/sample-projects/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/sample-projects/ Sample projects Firetail provides several sample projects that are featured in the Movebank project. These projects will be shown right after the first start of Firetail. Loading a sample project The datasets shown are associated to studies available for free from the Movebank homepage. We provide the abstract, author list, links to the publication homepage, links to the original data source, and some basic information on each study on roll-over. /docs/time-control/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/time-control/ Time control The time control panel is an integral part of Firetail. It enables quick navigation of datasets. modify the current timestamp (across individuals) set timestamps manually set a Firetail length (tail length) select time brackets (time slicing) select next/previous time bracket set step-length for interval analysis set replay speed replay the dataset GPS tracking data is focused on timestamps that are enriched with location data, acceleration data or spatial orientation data. /docs/layers/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/layers/ Visible Layers Firetail provides a range of maps and data overlays. Use the menu Layer to access them. By default, an Open Street Map view is activated. It provides a great overview of your data, in particular for relatively urban areas. GPS layer This layer contains the GPS tracks for the currently selected tag data. Open Street Map (OSM) By default, Firetail operates using Open Street Map cartographic material hosted on a dedicated server. /docs/movebank-data/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/movebank-data/ Loading Movebank projects Movebank data by … To access data from Movebank you must register for a movebank account. Then, within Firetail use one of File > Download Data by Tag ID File > Download Data by Individual ID File > Download Data by Deployment ID to create a local project snapshot in $USER\movebank_data and enable the annotation feature A window will prompt you to enter your Movebank credentials. /docs/tag-vendors/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/tag-vendors/ Working with local tag data In most cases, datasets will reside on your local hard drive. Firetail supports a range of formats to be loaded via the file menu All datatypes (see below) are accessible via the File > Open CSV... menu. Note: If you fail to open your tag vendor with Firetail, do not hesitate and contact our support support@firetail.de When selecting datasets you may also select multiple files at once (shift select). /docs/map-window/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/map-window/ Map window Visible Information The map gives you an overview over all available and currently selected data sets. Double clicking any visible trajectory will show you the GPS coordinates of all activated (checkboxed) tags having the same timestamp. Most map features are covered in the respective sections of this manual. The map viewport is directly influenced by: time controls bursts events tag selections layers and map selection For acceleration data, it is possible to select consecutive timestamp clusters within the map via shift-<left mouse button>. /docs/event-window/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/event-window/ Event data window Many tags provide additional sensor data recorded as event data. Firetail support a wide range of sensors data shown in the event data viewport. Inspecting event data If events are available in your dataset you can visually inspect the events by selecting Event Data in the Window Selection Tabs (vertical left). Alternatively, you may use the menu entry Windows > Event Data to select how to see the event data (top, right, or as floating window). /docs/acceleration-window/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/acceleration-window/ Acceleration Panel The acceleration panel provides an overview of burst level data with options to zoom into your dataset quickly jump to specific timestamps select regions of interest (shift left-drag) Bursts Modern tags capture acceleration data along with location data. As opposed to GPS data, acceleration data is often captured as bursts (see burst vs. continuous). A burst is a consecutive array of measurements starting at a specific timestamp. /docs/acceleration-annotation/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/acceleration-annotation/ Acceleration annotation Annotation of acceleration data is increasingly important for a wide range of projects. Firetail provides you with a set of tools for manual and machine learning assisted (FireSOM) annotation. You can rapidly annotate Movebank individuals Movebank tags Movebank deployments Core concepts Firetail features layers as highest level of organisation. A layer can hold arbitrary many categories. Each category resides on one specific layer. A burst (see also Burst vs. /docs/data/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/data/ Data Processing Firetail features a several data processing and data visualisation tools. You can access these features via the Data menu. Overview (see below for details) Menu Item Category Description Default Color Color Track by Use the default color for the trajectory. Point Index Color Track by Highlight timestamps by an equidistant index. Time intervals are neglected. Timestamp Color Track by Highlight timestamps with respect to the time intervals among them. /docs/data-imu/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/data-imu/ IMU magnetic field data The orientation of tags in 3D space is a non-trivial problem that cannot usually be resolved via acceleration sensors alone. Tags by e-obs and other manufacturers therefore integrate data gyroscope and compass data for state-of-the-art estimates of tag orientation termed IMU (intertial measuement unit). This type of data can be imported into Firetail via File > Open CSV or via the Movebank Data interface. When working with IMU data it is important to /docs/reference-data/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/reference-data/ Working with Reference Data Loading Reference Data Movebank and other projects provide reference-data files that allow for annotations on the level of individuals. Currently, whenever a reference data file is detected alongside with your dataset (in the same folder), this will open as well. Naming conventions For movebank data the reference annotation is expected to have the same prefix as your dataset and a -reference-data.csv suffix. For example your files could look like this /docs/cloudscene-data/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/cloudscene-data/ Cloud Scenes State-of-the art hardware like e-obs 1Hz sensors easily produce millions of GPS fixes in the context of large-scale studies. Cloud scenes are the Firetail’s approach to enable interactive exploration of huge datasets. Firetail’s cloudscenes are indexed flavours of your data. Currently, we offer cloud scene processing and access as a service for large-scale studies on demand. Contact us for details: Firetail Support Opening a Cloud Scene A local cloudscene can be opened by using File > Open Firetail Cloud Scene. /docs/licensing/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/licensing/ Firetail Editions Free Edition Without a registered license you are running Firetail - Free Edition. No time constraints will apply, yet the number of supported GPS and Acceleration samples will be limited in contrast to a licensed version. Sample projects are excluded from this limitation! Edition GPS limit ACC Samples limit Support Free 100,000 1,000,000 limited Trial 25,000,000 100,000,000 extended Full unlimited* unlimited* full *) license limit: system configuration (RAM, processor, HDD) may impose practical limits /docs/faq/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/faq/ Frequently Asked Questions How can I open e-obs logger.bin files with Firetail? For now, the logger.bin bin must be extracted via the e-obs tools available here: e-obs Service & Downloads. The decoder is a command-line tool from e-obs. download and extract the decoder-v14-win64.zip (or later) place the executable in the same directory as your logger.bin file double click the decoder-v14-win64.exe Press ’m' for movebank and ‘Enter’ The resulting files can then be opened with Firetail. /docs/keyboard-shortcuts/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/keyboard-shortcuts/ Keyboard shortcuts Function Shortcut Context 1m before Ctrl + Arrow Left Time Control 1m later Ctrl + Arrow Right Time Control later (data dependent) Arrow Right Time Control earlier (data dependent) Arrow Left Time Control fix opening time bracket Ctrl + E Time Control fix closing time bracket Ctrl + R Time Control reset time bracket Ctrl + T Time Control recording: start/stop r Record viewport open bookmarks/set bookmark Ctrl + b Bookmarks zoom in mouse scroll up Map, Acceleration View, Event View zoom out mouse scroll down Map, Acceleration View, Event View select region Shift + Left Mouse Map, Acceleration View set threshold Ctrl + Mouse Drag Map, Acceleration View toggle tag label l Map toggle tag coordinates c Map toggle data points F1 Map, Cloud Scenes toggle heatmap F2 Map, Cloud Scenes fullscreen mode F11 Main Window