Orcasound hydrophone data are stored in publicly accessible Amazon Web Service (AWS) Simple Cloud Storage Service (S3) buckets. The buckets have both public list and public read enabled, which means you can use the AWS API to connect directly to the buckets, list the available files, and download them without any special credentials.
There are three types of buckets, two of which have live and dev versions:
- Streaming -- lossy compressed data for live listening (e.g. HLS and/or DASH)
- Archive -- lossless compressed data for nodes with sufficient bandwidth (FLAC format)
- Sandboxes -- data sets for machine learning and other analyses
The two versions of the streaming bucket support three versions of the Orcasound app (as depicted in this evolution model): dev-streaming-orcasound-net is for end-to-end tests where the audio source is stable/known; and streaming-orcasound-net is both for beta-testing new app features with realistic audio data from existing nodes and for the public production version at live.orcasound.net
The recommended way to install AWS CLI is via pip
, which requires python
to be installed:
pip install awscli
You may also be able to use a package manager such as homebrew
or apt-get
. Or for a friendlier UI, check out SAWS
. Either way, if the aws
command works then you are ready to go!
No credentials are necessary to connect to the publicly accessible buckets, just use the --no-sign-request
flag instead. For example, the command to access the lossy compressed audio stream segments (HLS format) in the streaming-orcasound-net
bucket is:
aws --no-sign-request s3 ls streaming-orcasound-net
For nodes that have sufficent bandwidth, the lossless compressed audio data (FLAC format) can by found in the archive-orcasound-net
bucket here:
aws --no-sign-request s3 ls archive-orcasound-net
Bucket | Description |
---|---|
streaming-orcasound-net | Production streaming data |
dev-streaming-orcasound-net | Dev streaming data |
archive-orcasound-net | Lossless compressed data |
dev-archive-orcasound-net | Lossless compressed data |
acoustic-sandbox | Machine learning space |
To learn how to use the AWS CLI to download Orcasound data, please see Using Amazon S3 with the AWS CLI.
The AWS CLI can be used to acquire training and testing data if you're interested in developing machine learning algorithms. Please refer to the Orcadata wiki for futher information.