faims / birdexport

Custom made exporter for the FAIMS Mobile Bird Nesting Module

About this exporter:

This exporter was created for the Bird Nesting module, for the Griffith Ecology Lab, Avian Ecology research group based at Macquarie University, Sydney, Australia. The exporter includes a reporting function to guide future visits and actions at the nesting sites.

Authorship:

This exporter was co-developed by Simon Griffith at Macquarie University, Hanja Brandl and Caterina Funghi at University of Hamburg and Adela Sobotkova, Petra Janouchova and Brian Ballsun-Stanton at the FAIMS Project, Department of Ancient History, Macquarie University.

Funding:

Development of this exporter was funded by the Research Attraction and Acceleration Program (RAAP) NSW Department of Industry 16805/00 aimed to support innovation and investment in the New South Wales in 2016 and 2017.

Date of release:

July 2016, update August 2017

FAIMS Mobile / server version:

FAIMS v2.5 (Android 6+)

Licence:

This exporter is licensed under an international Creative Commons Attribution 4.0 Licence (CC BY 4.0).

Access:

This exporter can be downloaded directly from this repository and used on FAIMS v2.5 server

1. Clone the repository
2. Create a tarball (tar.gz) of the repository directory (Do you know how-to-manage a tarball?)
3. Upload the tarball to the server through the plugins interface (for details, see below)

This exporter contains the following features:

• schedule next empty box visit date
• schedule nest visit date
• schedule next egg check
• list chicks for measurement during revisit
• reporting of tasks to be done on the day

Exporter Use Recommendations:

• Immediate field use with the Bird Nesting module
• Output Data format: Custom CSV reports

Contact info:

For more details about the Griffith Ecology Lab please visit https://griffithecology.com/. If you have any questions about the longitudinal monitoring of Bird nesting in NSW, please contact [email protected].

If you have any questions about the module, please contact the FAIMS team at [email protected] and we will get back to you within one business day.

General How-to Info to Exporters

Based on the 'FAIMS User to Developer Documentation' and 'FAIMS Data UI and Logic Cook Book'

To get the data you have collected with the FAIMS Mobile app in a viewable, usable fashion, you'll need to find and download an exporter. An exporter allows you to export data from FAIMS server in many data formats (CSV, shapefile, sqlite database, json etc.). Each exporter has been customised for individual projects, but with none or minor changes it can be reused for other projects.

How do I make it work?

• On a PC, you can simply download / clone the file from GitHub.

• Create a tarball from the exporter using a program like 7zip; if you're using UNIX, enter something like tar -czf shapefileExport.tar.gz shapefileExport

• Now, if you navigate on the server to your module, you'll see a tab at the top labeled 'Plugin Management'. Click that and you'll be brought to a page with the handy feature, 'Upload Exporter'. Choose the tarball you've just created and hit 'Upload'. You now have an exporter permanently stored to your FAIMS server and may make use of it whenever you'd like.

• From now on, whenever you'd like to use your uploaded exporter, navigate to your module from the main page on the server and click 'Export module'. Select from the dropdown menu the exporter you'd like to use, review and select from any additional options, and click 'Export'.

• You'll be brought to your module's background jobs page while the server exports your data. After a few moments, you should be able to hit 'Refresh' and see a blue hyperlink to 'Export results'. Clicking that will allow you to download your exported data in a compressed file.

Exporting data doesn't close down the project or prevent you from working any further on it, so feel free to export data whenever it's convenient.