Skip to content

Commit

Permalink
readme updates
Browse files Browse the repository at this point in the history
improved clarity, added more info to readme
  • Loading branch information
tmesaglio committed Jul 4, 2024
1 parent f8fec61 commit 6a2f3af
Show file tree
Hide file tree
Showing 2 changed files with 31 additions and 3 deletions.
12 changes: 10 additions & 2 deletions README.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -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)
<!-- badges: end -->

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:

Expand Down Expand Up @@ -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.
22 changes: 21 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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: <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:
Expand Down Expand Up @@ -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.

0 comments on commit 6a2f3af

Please sign in to comment.