finch (version 0.4.0)

simple_read: Parse a DarwinRecordSet and SimpleDarwinRecordSet files

Description

Parse a DarwinRecordSet and SimpleDarwinRecordSet files

Usage

simple_read(file)

Arguments

file

(character) A path to a single simple Darwin Core file in XML format. Required.

Value

a S3 class dwc_recordset when a DarwinRecordSet is given, or a dwc_simplerecordset when a SimpleDarwinRecordSet is given. In each case the object is really just a list, with lightweight S3 class attached for easy downstream usage. Prints summary to screen by default

Details

Make sure when reading a DarwinRecordSet to access the chunks by position rather than name since duplicate names are allowed in chunks.

Examples

# NOT RUN {
# SimpleDarwinRecordSet examples
file <- system.file("examples", "example_simple.xml", package = "finch")
simple_read(file)
file <- system.file("examples", "example_simple_fossil.xml",
  package = "finch")
simple_read(file)

# DarwinRecordSet examples
file <- system.file("examples", "example_classes_observation.xml",
  package = "finch")
simple_read(file)

file <- system.file("examples", "example_classes_specimen.xml",
  package = "finch")
simple_read(file)

# access elements of the object
file <- system.file("examples", "example_classes_specimen.xml",
  package = "finch")
res <- simple_read(file)
## namespaces
res$meta
## locations
res$locations
## chunks, the first one
res$chunks[[1]]
# }