From 6a2f3af91fcaceb31da82bb3539a357d26ab088e Mon Sep 17 00:00:00 2001 From: Thomas Mesaglio Date: Thu, 4 Jul 2024 13:07:56 +1000 Subject: [PATCH] readme updates improved clarity, added more info to readme --- README.Rmd | 12 ++++++++++-- README.md | 22 +++++++++++++++++++++- 2 files changed, 31 insertions(+), 3 deletions(-) diff --git a/README.Rmd b/README.Rmd index 838494b..ed184a6 100644 --- a/README.Rmd +++ b/README.Rmd @@ -20,14 +20,18 @@ knitr::opts_chunk$set( [![R-CMD-check](https://github.com/traitecoevo/infinitylists/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/traitecoevo/infinitylists/actions/workflows/R-CMD-check.yaml) -This shiny-based application allows users to extract species occurrence data from the Atlas of Living Australia (ALA) and generate a species list for any defined area. All records associated with either a physical voucher (stored in Australian herbaria or museums), or a photographic voucher or audio file uploaded to iNaturalist are extracted. For each species within the defined area, the application will return voucher type, number of vouchers, date of the most recent voucher, spatial coordinates, voucher location, and the voucher collector. Records are displayed both in a table and on a map, and are downloadable as a CSV. +This shiny-based application allows users to extract species occurrence data from the Atlas of Living Australia (ALA) and generate a species list for any defined area. All records associated with either a physical voucher (stored in Australian herbaria or museums), or a photographic voucher or audio file uploaded to iNaturalist are extracted. For each species within the defined area, the application will return voucher type, number of vouchers, date of the most recent voucher, spatial coordinates, voucher location, and the voucher collector. Records are displayed both in a table and on a map, and are downloadable as a CSV. The app is currently using data downloaded from the ALA on 1st July 2024. + +## Which records are returned? + +The map and table outputs will only display the **most recent record per species per voucher type**. Each species will therefore be represented on the map and in the table by a maximum of 3 records (for species with a physical voucher, photographic voucher and audio voucher in the target area). The text statement indicates the total number of records, and the downloadable CSV file contains **all records from the target area**, not just the most recent records. ## Use the app The app can be accessed here: https://unsw.shinyapps.io/infinitylists/ -## Local Installation +## Local installation You can install the development version of 'infinitylists' from [GitHub](https://github.com/traitecoevo/infinitylists) with: @@ -62,3 +66,7 @@ infinitylistApp() ``` + +## Why did I get disconnected from the server? + +If infinitylists is left open but idle in your browser for too long, you will be disconnected from the server. Applying the *Use my location* filter without having given your browser access to your current location will also disconnect you from the server. If this occurs, please amend your settings. diff --git a/README.md b/README.md index 69bc918..8d296fc 100644 --- a/README.md +++ b/README.md @@ -17,12 +17,24 @@ species within the defined area, the application will return voucher type, number of vouchers, date of the most recent voucher, spatial coordinates, voucher location, and the voucher collector. Records are displayed both in a table and on a map, and are downloadable as a CSV. +The app is currently using data downloaded from the ALA on 1st July +2024. + +## Which records are returned? + +The map and table outputs will only display the **most recent record per +species per voucher type**. Each species will therefore be represented +on the map and in the table by a maximum of 3 records (for species with +a physical voucher, photographic voucher and audio voucher in the target +area). The text statement indicates the total number of records, and the +downloadable CSV file contains **all records from the target area**, not +just the most recent records. ## Use the app The app can be accessed here: -## Local Installation +## Local installation You can install the development version of ‘infinitylists’ from [GitHub](https://github.com/traitecoevo/infinitylists) with: @@ -63,3 +75,11 @@ download_ala_obs(taxon = "Orthoptera") infinitylistApp() ``` + +## Why did I get disconnected from the server? + +If infinitylists is left open but idle in your browser for too long, you +will be disconnected from the server. Applying the *Use my location* +filter without having given your browser access to your current location +will also disconnect you from the server. If this occurs, please amend +your settings.