all-the-species
v0.0.12
Published
information about 1 million species, common names for 80K species, icons and categories for species. animals, plants, bacteria, etc.
Downloads
24
Maintainers
Readme
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
npm i all-the-species
Usage
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.