Welcome to TERN Knowledge Base

EcoPlots CSV output Description

This output format is the most used in EcoPlots. The file contains all the information about the sites, visits and ecological observations related to features of interest. The data in each CSV is grouped according to the Feature of interest selected with the filters during the search process. No further data filtering, cleaning or processing is necessary as data in each file can be analysed using any tool or programming language such as R or Python.

Two types of CSV files are included in each dataset package.


Data Packages

TERN data packages can be downloaded to the local machine as compressed zip files. Once uncompressed, the folder structure contains a data folder with the CSV files containing the data dictionary and observations (see below image). The data dictionary file is represented by the naming convention “data_dictionary_packagerID”; observation files are represented by “feature-of-interest-name_observations_packagerID”. Observations related to each feature of interest are stored in individual CSV files.

Each CSV contains a common set of columns to identify each record. The table below gives brief definitions of each column.

 


Observations data specific to a Feature of Interest

The observation CSV files contain all the information related to the observation. The common set of attributes in the CSV files are as follows:

Column

Description

Column

Description

datasetTitle
Datasource/Dataset to which this data row belongs to.
projectTitle
Project to which this data row belongs to.
siteName
Ecological site where data was collected.
parentSiteName
Ecological site name, which is the parent of the site where data was collected
latitude_Degree
Latitude geographic coordinate of ecological site.
longitude_Degree
Longitude geographic coordinate of ecological site.
plotWidth_Metre
plot dimension width
plotLength_Metre
plot dimension length
topParentSiteName
The larger site to which this ecological site belongs to.
siteVisitName
unique identifier of the site visit instance
siteVisitStartDate
Start date of the site visit
siteVisitEndDate
End date of the site visit
featureType
The feature of interest type related to the observation (e.g., a plant individual, plant specimen, landform, weather, etc.).
featureId
Unique identifier of the feature, e.g. stem-1a, tree-1, bird-0123456, specimen-ABC123.
parentFeatureId
Unique identifier of the greater feature to which the current feature is part of, e.g. tree-1 -> stem-1b.

The sample CSV file is shown below:

The columns in the image below are specific ecological observations found in the columns to the right of the base data columns. Each row contains the ecological observations recorded during that sampling effort. The specific data included in each file is based on the filtering done during the EcoPlots searching process before the package generation.

 

 

 

Each observation consist of three columns:

  • Result of the observation: The column header shows the name of the ecological parameter (i.e. scientificName). Values for this column contain the actual results of the observations made, for instance, the species name of that feature.

  • Result time: When the observation was made.

  • Method: This is a link to the vocabulary of the Method/Procedure. Opening the link on any Internet browser will show all the information about the protocol for collecting the data.

In very specific cases, some extra columns may be included in the CSV. Those columns are the “attributes of the feature of interest” (i.e. plant-individual or soil-sample):

Attributes are easily identifiable because they consist exclusively of 1 column (no result time or method). These attributes are not ecological observations but contain important information about the feature, i.e., the soil sample's depth or a plant's relative position within the site.

 


Data dictionary

Along with the data CSVs, a “data_dictionary” is included in the package. It shows all columns included in the package, their definitions, and where to find additional information.

 

 

The “Additional information” column contains links to the controlled vocabularies of the specific attributes or parameters. Below is the definition of field species name in the TERN-controlled vocabulary.

Next page: EcoPlots GeoJSON output Description

 

Provide your feedback about the experience with Knowledge base