Neotoma Developer Center

Remote programmatic access to the Neotoma Database

User Tools

Site Tools


SampleData

Resource URI:

api.neotomadb.org/v1/data/sampledata/

Description

Returns a collection of discrete taxon/taxa occurrences in time and space useful for performing statistical analysis and creating data plots. If you wish to get the data for one or more samples in a particular dataset, use the Downloads resource instead.

Request Parameters

The following parameters may be specified in the call.

Parameter Required? Description
taxonids yes (one) Unique database record identifier for a taxon; accepts one or more ids separated by commas.
taxonname Name or partial name of the taxon/taxa.
ageold no Oldest age, as calendar years before present, to include in results.
ageyoung no Youngest age, as calendar years before present, to include in results.
loc no Geographic bounding box within which to constrain the search. Coordinates are specified in decimal degrees as a comma-separated list in the following order: longitudeWest, latitudeSouth, longitudeEast, latitudeNorth.
gpid no Limit occurrences to a geopolitical entity id. Valid values provided by GeoPoliticalUnits database table.
altmin no Minimum site altitude in meters.
altmax no Maximum site altitude in meters.

Taxa Ages

You may specify both, one, or none of the age parameters to construct search types like those below.

Specified Ages Result
none Any occurrence of the taxon.
both Dated taxon occurrences whose age/age range is contained within the range ageold–ageyoung.
only ageold Dated taxon occurrences whose age/age range is contained within the range ageold–present.
only ageyoung Dated taxon occurrences whose age/age range is contained within the range 5.5 Ma–ageyoung; 5.5 Ma is approximate limit to Neotoma database.

Response Properties

A SampleData object is described by the following properties.

Property Description
TaxaGroup Code for taxa group to which taxon/physical variable belongs.
Value Value of the variable.
VariableUnits The unit of measurement.
TaxonName Name of the taxon or physical variable.
VariableElement The element, part, or organ of the taxon identified. For physical variables, used to further description/detail.
VariableContext Depositional context (e.g. anachronic, intrusive, redeposited, articulated, clump).
SampleAge Age of the sample (best available chronology; more info here).
SampleAgeYounger Younger error estimate of the age.
SampleAgeOlder Older error estimate of the age.
DatasetID Unique database record identifier for the dataset.
SiteAltitude Site altitude in meters.
SiteLatitudeNorth North bounding latitude, in decimal degrees, for the site.
SiteLatitudeSouth South bounding latitude, in decimal degrees, for the site.
SiteLongitudeEast East bounding longitude, in decimal degrees, for the site.
SiteLongitudeWest West bounding longitude, in decimal degrees, for the site.

Examples

Request Description
http://api.neotomadb.org/v1/data/sampledata?taxonname=Smilodon* All Smilodon occurrences.
http://api.neotomadb.org/v1/data/sampledata?taxonname=Tsuga%2A&ageold=5500&ageyoung=5000 Tsuga occurences dated between 5500-5000 years ago.

View sample response

View sample response

View sample response

{
    "success":1,
    "data":[
        {
            "TaxaGroup":"MAM",
            "Value":1,
            "VariableUnits":"present/absent",
            "TaxonName":"Smilodon floridanus",
            "VariableElement":"bone/tooth",
            "VariableContext":null,
            "SampleAge":null,
            "SampleAgeYounger":9419,
            "SampleAgeOlder":13854,
            "DatasetID":4939,
            "SiteAltitude":null,
            "SiteLatitudeNorth":29.866666666666667,
            "SiteLatitudeSouth":29.866666666666667,
            "SiteLongitudeEast":-91.75,
            "SiteLongitudeWest":-91.75
        },
        {
            "TaxaGroup":"MAM",
            "Value":1,
            "VariableUnits":"present/absent",
            "TaxonName":"Smilodon floridanus",
            "VariableElement":"bone/tooth",
            "VariableContext":null,
            "SampleAge":null,
            "SampleAgeYounger":15332,
            "SampleAgeOlder":30041,
            "DatasetID":4564,
            "SiteAltitude":1280,
            "SiteLatitudeNorth":34.283333333333339,
            "SiteLatitudeSouth":34.283333333333339,
            "SiteLongitudeEast":-103.31666666666666,
            "SiteLongitudeWest":-103.31666666666666
        }
    ]
}

Page Tools