all-the-species

Massive list of species.

- information about ~1M species
- common names for 80,149 species
- human-readable categories per-species
- emoji icons for each species. 🦀🌲🦊🐟🌺☘️

includes animals, plants, bugs, bacteria, etc, all of it!

based on permissibly-licensed datasets from GBIF.

created for ecofactbook.

Table of Contents

- Installation
- Usage
- Licenses and Citation
- See Also

Installation

``sh
npm i all-the-species
`

Usage

`javascript
require('all-the-species').loadSpeciesData(onGotData); //this can take up to 30 seconds

function onGotData(dataSet){
//print random row from dataset
console.log(dataSet[Math.floor(Math.random()*dataSet.length)]);

//get species with common names
var speciesWithCommonNames = dataSet.filter(row=>row.common_name!='_');
console.log(speciesWithCommonNames.length, "species have common names");

// loaded species dataset in 17.326 sec -- 1,037,798 rows
// 80,149 species have common names

//each row of dataset looks like this:
/*
{
taxonomy: {
id: '2433516', // this is the GBIF id
kingdom: 'Animalia',
phylum: 'Chordata',
class_: 'Mammalia',
order: 'Carnivora',
family: 'Eupleridae',
genus: 'Cryptoprocta',
species: 'Cryptoprocta ferox'
},
common_name: 'Fossa', // common name or "_" if none known
category_name: 'Carnivores', // human-readable category name
icon: '🐅' // emoji icon for this species
}
*/

}
``

Licenses and Citation

Raw list derived from Species occurance data [CC0 filtered]
- GBIF.org (5 July 2018) GBIF Occurrence Download https://doi.org/10.15468/dl.ljofvp

Species common names partially derived from
UnitProt Controlled vocabulary of species
under license CC by 4.0

See Also

- common-species - sister module which only includes the 80,149 species with common names. use this if you need a smaller/faster module.