Skip to content

NeotomaDB/neotomataxonomy

 
 

Repository files navigation

NSF-1550707 NSF-1541002

DOI

Neotoma Taxonomy Viewer

This repository is intended to act as a graphical viewer for the Neotoma Paleoecology Database's taxonomy table. The basis of this repository is work by Scott Farley who built a set of three linked visualizations for Neotoma's taxa, served using D3.js visualizations through HTML webpages.

Subsequent modifications have been made to use new Neotoma APIs for site and sample queries, and to link data to additional information within Neotoma.

Contributors

This project is an open project however it is subject to the license of the original GitHub project. All contributors to Neotoma Paleoecology Database project are bound by a code of conduct. Please review and follow this code of conduct as part of your contribution.

Tips for Contributing

Issues and bug reports are always welcome. Code clean-up, and feature additions can be done either through pull requests to project forks or project branches.

All products of the Neotoma Paleoecology Database are licensed under an MIT License unless otherwise noted.

How to Run

This repository uses a set of static HTML pages to serve the taxonomic visualization which can be accessed directly with your browser by opening the pages.

It is possible to view the pages using GitHub Pages with the following links:

Generating Data

The data is generated using a Python v3.11 script (csv_to_nested.py) that calls out to Neotoma's taxonomy table using the Neotoma API. The updated script replaces the old v1.0 API calls and improves script efficiency. At the same time, cleaning up the repository has removed additional functionality in an effort to simplify the purpose and structure of the repository.

To build the needed data files:

> python3.11 utils/csv_to_nested.csv

This calls the Neotoma API for each individual taxon to get a count of the number of sites each taxon is present at. Because this represents tens of thousand of individual API calls this takes some time to run. This may be parallelized using a library like joblib to speed up data processing. It is also possible that we might choose to restructure the Neotoma API to speed up the calls.

About

A viewer for Neotoma Taxonomic data.

Resources

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 75.4%
  • Python 13.8%
  • JavaScript 10.8%