Tutorials

Tutorials for using OpenDataBio!

Find here working examples of using OpenDataBio through the web-interface or through the OpenDataBio R package. See Contribution guidelines if you want to contribute with a tutorial.

Before starting

Create an API token, configure the OpenDataBio-R connection, and test it. Work with a pilot batch and follow each UserJob before sending a large import. Keep a local source-row key and reconcile returned OpenDataBio IDs with the original table. The Data import workflow explains the complete sequence.

R workflows

  1. Get and review data: reproduce filters, inspect relationships, maps, and exports.
  2. Prepare and import data: import shared libraries first, then dependent records and Measurements.

Recommended order: People and References; Taxons; Locations; Traits; Projects and Datasets; Individuals; Vouchers; Measurements, Media, and vernacular names. After every stage, retrieve affected IDs, join them to the source table, and GET the resulting records before continuing.

Tutorial improvements are tracked around four goals: restore and maintain figures beside the steps they illustrate; add small downloadable fixtures; show per-row UserJob reconciliation consistently; and distinguish tested examples from illustrative, non-tested examples.


Getting data with OpenDataBio-R

Getting data using the OpenDataBio R client

Import data with R

Import data using the OpenDataBio R client