galah

An R interface to biodiversity data hosted by the living atlases; a set of organisations that share a common codebase, and act as nodes of the Global Biodiversity Information Facility.
https://github.com/AtlasOfLivingAustralia/galah-R

Category: Biosphere
Sub Category: Biodiversity Data Access and Management

Keywords

r

Keywords from Contributors

ala-product-ala4r ala ala-systems ala-product-auth ala-product-spatial occurrences ala-product-biocache webservices ala-product-infrastructure ansible

Last synced: about 20 hours ago
JSON representation

Repository metadata

Query living atlases from R

• Host: GitHub
• URL: https://github.com/AtlasOfLivingAustralia/galah-R
• Owner: AtlasOfLivingAustralia
• Created: 2020-12-06T22:49:59.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2025-04-09T07:05:52.000Z (19 days ago)
• Last Synced: 2025-04-17T21:28:35.534Z (10 days ago)
• Topics: r
• Language: R
• Homepage: https://galah.ala.org.au
• Size: 48.9 MB
• Stars: 45
• Watchers: 8
• Forks: 3
• Open Issues: 18
• Releases: 16
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS.md

README.Rmd

          ---
output: github_document
---



```{r, echo = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "vignettes/README-"
)
```

# galah 



[![CRAN
status](https://www.r-pkg.org/badges/version/galah)](https://cran.r-project.org/package=galah)
[![Codecov test coverage](https://codecov.io/gh/AtlasOfLivingAustralia/galah-R/branch/main/graph/badge.svg)](https://app.codecov.io/gh/AtlasOfLivingAustralia/galah-R?branch=main)
[![R-CMD-check](https://github.com/AtlasOfLivingAustralia/galah-R/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/AtlasOfLivingAustralia/galah-R/actions/workflows/R-CMD-check.yaml)



## Overview

`galah` is an R interface to biodiversity data hosted by the 
[Global Biodiversity Information Facility](https://www.gbif.org) (GBIF) and 
those members of the GBIF node network that maintain their own APIs (i.e. the
['living atlases'](https://living-atlases.gbif.org)). These organisations 
collate and store observations of individual life forms, using the 
['Darwin Core'](https://dwc.tdwg.org) data standard. `galah` was built and is 
maintained by the [Science & Decision Support Team](https://labs.ala.org.au) at 
the [Atlas of Living Australia](https://www.ala.org.au) (ALA).

`galah` enables users to locate and download species occurrence records 
(observations, specimens, eDNA records, etc.), taxonomic information, or 
associated media such as images or sounds, and to restrict their queries to 
particular taxa or locations. Users can specify which columns are returned by a 
query, or restrict their results to occurrences that meet particular 
data-quality criteria. All functions return a `tibble` as their standard format.

The package is named for the bird of the same name
(*Eolophus roseicapilla*), a widely-distributed endemic Australian species. The 
logo was designed by [Ian Brennan](https://www.iangbrennan.org/).

If you have any comments, questions or suggestions, please [contact us](mailto:[email protected]).


## Getting started

- The [quick start guide](https://galah.ala.org.au/R/articles/quick_start_guide.html) provides an introduction to the package functions.
- For an outline of the package structure, and a list of all the available functions, run `?galah` or view the [reference page](https://galah.ala.org.au/R/index.html).



## Installation

Install from CRAN:
```{r eval=FALSE}
install.packages("galah")
```

Install the development version from GitHub:
```{r eval=FALSE}
install.packages("remotes")
remotes::install_github("AtlasOfLivingAustralia/galah-R")
```

`galah` depends on `sf` for location-based searches. To install `galah` you will
need to make sure your system meets the `sf` system requirements, as specified
[here](https://cran.r-project.org/package=sf).



## Cheat sheet





## Citations
To generate a citation for the package version you are using, you can run

```r
citation(package = "galah")
```
If you're using occurrence data downloaded through `galah` in a publication, 
please generate a DOI and cite it. To request a DOI for a download of occurrence 
record, set `mint_doi = TRUE` in a call to `atlas_occurrences()`. To generate a 
citation for the downloaded occurrence records, pass the `tibble` generated to
`atlas_citation()`.

```{r eval = FALSE}
# Download occurrence records with a DOI 
occ <- atlas_occurrences(..., mint_doi = TRUE)

# See DOI
attr(occ, "doi")

# Generate citation
atlas_citation(occ)
```

        

---

Owner metadata

• Name: Atlas of Living Australia
• Login: AtlasOfLivingAustralia
• Email: [email protected]
• Kind: organization
• Description: Free and open source IT infrastructure for the aggregation and delivery of biodiversity data. Funded by the Australian government via NCRIS and hosted by CSIRO
• Website: https://www.ala.org.au
• Location: Australia
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/7296572?v=4
• Repositories: 180
• Last ynced at: 2023-03-11T02:32:07.415Z
• Profile URL: https://github.com/AtlasOfLivingAustralia

---

GitHub Events

Total

• Create event: 3
• Release event: 2
• Issues event: 24
• Watch event: 2
• Member event: 1
• Issue comment event: 16
• Push event: 52
• Pull request event: 13
• Fork event: 1

Last Year

• Create event: 3
• Release event: 2
• Issues event: 24
• Watch event: 2
• Member event: 1
• Issue comment event: 16
• Push event: 52
• Pull request event: 13
• Fork event: 1

---

Committers metadata

Last synced: 5 days ago

Name	Email	Commits
Ben Raymond	b****n@t****g	853
matilda2812	m****2@g****m	782
Martin Westgate	m****e@g****m	589
Dax Kellie	d****e@c****u	373
Jeremy VanDerWal	j****l@g****m	64
Tasilee	l****n@g****m	49
Peggy Newman	p****n@g****m	22
Shandiya Balasubramaniam	s****b@g****m	6
Dimi Brosens	d****s@i****e	4
Dave Martin	d****n	3
Tom Saleeba	t****a@g****m	3
Peter Ansell	p****l@y****m	3
Shandiya Balasubramaniam	s****b@g****m	2
Matt Andrews	M****s@c****u	2
oliviatorresan	o****n@c****u	2
Nick dos Remedios	n****s@c****u	1
dewmini	5****i	1
mbohun	m****n@g****m	1
rforge rforge	r****e@r****t	1
cjwaite23	c****0@g****m	1

Committer domains:

• csiro.au: 4
• rforge.net: 1
• inbo.be: 1
• theraymonds.org: 1

---

Issue and Pull Request metadata

Last synced: 2 days ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/AtlasOfLivingAustralia/galah-R

---

---

---

Dependencies

Score: 7.138866999945524