Skip to contents

What is audioblast?

Audioblast is a discovery tool for bioacoustic and ecoacoustic recordings. You can use it to search for recordings (e.g. by species, location, date), annotations of recordings, analysis results and traits.

Audioblast is currently hosted by the Natural History Museum in London. It was conceived by Ed Baker at the University of York as part of the Leverhulme Trust funded Automated Acoustic Observatories project.

Accessing audioblast

The audioblast() function of SonicScrewdriveR is a wrapper allowing full access to the Audioblast API. It is also possible to download many recordings through audioblast using audioblastDownload().

Searching

A search names the type of module ("data", "analysis" or "standalone") and the module, and filters it with named arguments. Each module has its own filters, and audioblastFilters() lists them. audioBlast refuses a query with a filter the module does not have, and the error says which filters it does have.

# The filters of the recordings module
audioblastFilters("recordings")

# Recordings of a species
recs <- audioblast("data", "recordings", taxon="Gryllotalpa vineae")

Results come fifty to a page, and all pages are fetched unless max_pages is set. A larger page_size fetches many results in fewer requests.

recs <- audioblast("data", "recordings", source="bio.acousti.ca", page_size=1000)

A filter that takes several values can be given a vector, and matches a row holding any one of them. Filters on a range, such as duration, lat or lon, can be given a range made by ab_range().

# Two recordings at once
audioblast("data", "recordings", source="bio.acousti.ca", id=c(10754, 11096))

# Recordings between 10 and 20 seconds long
audioblast("data", "recordings", duration=ab_range(10, 20))

# Recordings made north of 60 degrees
audioblast("data", "recordings", lat=ab_range(min=60))

Columns that audioBlast describes as numeric, such as duration, are returned as numbers.

Records and linked data

Each record in audioBlast has its own address, and audioblastRecord() fetches one record from it. Records can also be fetched as linked data (RDF) in JSON-LD or Turtle, from audioblastRecord() or from a search with audioblast().

audioblastRecord("recording", "bio.acousti.ca", 10754)
audioblastRecord("taxon", "bio.acousti.ca", 247, output="Turtle")

Some modules have endpoints of their own. The classification of a taxon, from the root of its source’s taxonomy down to the taxon itself, is given by the classification endpoint of the taxa module.

audioblast("data", "taxa", "classification", source="bio.acousti.ca", id=247)

Annotations

Annotations of recordings can be returned as Annotation objects, which can be used with the other annotation functions of SonicScrewdriveR.

a <- audioblast("data", "annomate", source="bio.acousti.ca", source_id=10754, output="Annotation")

Downloading recordings

audioblastDownload() downloads the files of recordings found by a search, and saves their metadata alongside them. Files already downloaded are skipped. Where audioBlast has measured a file, the file downloaded is checked against the hash audioBlast measured.

recs <- audioblast("data", "recordings", source="inaturalist", id=134)
audioblastDownload(recs, dir="recordings")