Giter Site home page Giter Site logo

audiomnia / audiomnia Goto Github PK

View Code? Open in Web Editor NEW
7.0 2.0 1.0 13.13 MB

A global bioacoustics map featuring birds and marina megafauna

Home Page: https://audiomnia.com

License: GNU General Public License v3.0

Python 46.32% HTML 5.43% Makefile 1.52% JavaScript 43.26% CSS 3.47%
scrapy ornithology scrapers openlayers geospatial bioaccoustics marine-data marine-biology

audiomnia's Introduction

Audiomnia

A global bioacoustics map

standard-readme compliant audiomnia

Data provided by the The Macaulay Library at the Cornell Lab of Ornithology and iNaturalist.

Table of Contents

Usage

Screenshot 1

The main interface is a simple visualization of the bioacoustic samples in the database. Drill down geographically by clicking. When the zoom level reaches maximum a listing of samples will be displayed.

Local One-liner

To run the application locally, you can simply run:

$ npx audiomnia # or run a specific version i.e. npx [email protected]

This requires node.js, which can be installed easily using nvm.

Contributing

Happy to consider issues and PRs are highly encouraged. Experience with OpenLayers, Scrapy, and front-end web development is welcome, but more importantly bioacoustics, conservation, ornithology, and marine science expertise is needed, perhaps even moreso.

Setting up for development

First, grab the source code and install the dependencies:

$ git clone https://github.com/audiomnia/audiomnia
cd audiomnia
npm install

Then, npm start will run the app for you and should work "out of the box."

Scrapers

Audiomnia uses Scrapy for its scrapers.

Currently, the data sets are small enough to check into the repo, so checking out the source code will also include the geojson files. However, if you're working on the scrapers.

npm run scrape

This is shorthand for:

cd scrapers
scrapy crawl macaulaylibrary -a MAX=50000 --loglevel WARNING

You can read the Scrapy docs to learn more about the scrapy crawl

Scrapy cache

By default, HTTP Caching is enabled in the Scrapy config. This will deposit a LOT of data in ./scrapers/scrapers/.scrapy. This will make your development much easier and your scraping much more polite.

Tests

UI Tests using Mocha + Puppeteer are in the test/ folder.

License

GPL-3.0 © 2020 Audiomnia

audiomnia's People

Contributors

aphelionz avatar dependabot[bot] avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Forkers

richardlitt

audiomnia's Issues

Marine Sounds

  • GOSITS
  • Cornell Ornithology live feed
  • Xeno-Canto
  • MIT / WHOI
  • TSS from Listen for whales.org
  • Orcasound
  • Kaggle contest from Right Whales
  • SRU Vancouver

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.