get_sites: Return Site Information.

In neotoma: A Package to access the Neotoma Paleoecological Database using an API.

Description

get_sites returns site information from the Neotoma Paleoecological Database based on parameters defined by the user.

Usage

  get_sites(siteid, sitename, altmin, altmax, loc, gpid)

Arguments

siteid	The numerical site ID.
sitename	A character string representing the full or partial site name.
altmin	Minimum site altitude (in m).
altmax	Maximum site altitude (in m).
loc	A numeric vector c(lonW, latS, lonE, latN) representing the bounding box within which to search for sites. The convention here is to use negative values for longitudes west of Grewnwich or longitudes south of the equator.
gpid	A character string, must correspond to a valid geopolitical identity in the Neotoma Database. Use get.tables('GeoPoliticalUnits') for a list of acceptable values, or link here: http://api.neotomadb.org/apdx/geopol.htm

Value

A table:

• SiteIDUnique database record identifier for the site.

• SiteNameName of the site.

• AltitudeAltitude in meters.

• LatitudeNorthNorth bounding latitude, in decimal degrees, for a site.

• LatitudeSouthSouth bounding latitude, in decimal degrees, for a site.

• LongitudeEastEast bounding longitude, in decimal degrees, for a site.

• LongitudeWestWest bounding longitude, in decimal degrees, for a site.

• SiteDescriptionFree form description of a site, including such information as physiography and vegetation around the site.

Extended response variables when only a single site is returned:

• CollectionUnitIDUnique database record identifier for the collection unit.

• HandleCode name for the collection unit. This code may be up to 10 characters, but an effort is made to keep these to 8 characters or less. Data are frequently distributed by collection unit, and the handle is used for file names.

• CollTypeThe collection type. Types include cores, sections, excavations, and animal middens. Collection Units may be modern collections, surface float, or isolated specimens. Composite Collections Units include different kinds of Analysis Units, for example a modern surface sample for ostracodes and an associated water sample.

• DatasetsAn array of objects that describe datasets associated with a site.

Author(s)

Simon J. Goring [e-mail]

References

Neotoma Project Website: http://www.neotomadb.org API Reference: http://api.neotomadb.org/doc/resources/contacts

Examples

## Not run: 
#  What is the distribution of site elevations in Neotoma?
all.sites <- get_sites()  #takes a bit of time.

plot(density(all.sites$Altitude, from = 0, na.rm=TRUE),
main = 'Altitudinal Distribution of Neotoma Sites', xlab = 'Altitude (m)', log='x')

## End(Not run)

neotoma documentation built on May 2, 2019, 5:55 p.m.