The ESAS data model consists of four hierarchical tables (Campaigns, Samples, Positions, Observations) and one metadata table (File Information) containing information about the submitted data. The tables are described below.
- The tables are also described in DATSU.
- Fields indicated with
*
are required (i.e. cannot be empty).
File Information
Source: fileInformation.yml
Metadata about the submitted data. A file can contain data about multiple campaigns, as long as they are associated with the same data rights holder(s).
Name | Description | Vocabulary | Type |
---|---|---|---|
RecordType
*
|
Record type. Use
|
string | |
DataRightsHolder
*
|
Organization owning the legal rights over the resource.
Combine multiple values with
|
EDMO | integer |
Country
*
|
Country associated with the
|
ISO_3166 | string |
Campaign
Source: campaign.yml
Information about the campaign on which data were collected.
Name | Description | Vocabulary | Type |
---|---|---|---|
RecordType
*
|
Record type. Use
|
string | |
CampaignID
*
|
Identifier of the campaign. Must be unique across the entire ESAS database (e.g. by prepending the identifier with the
|
string | |
DataAccess
*
|
Access to the data (
|
Data_access | string |
StartDate
|
Start date of the campaign, formatted as
|
date | |
EndDate
|
End date of the campaign, formatted as
|
date | |
Notes
|
Additional details about the campaign, such as research purpose, area covered or route. Constraints
|
string |
Sample
Source: sample.yml
Information about a sampling event during a campaign. Use separate sample records for different dates, platform sides, methodologies, or observers recording concurrent but independent data streams.
Name | Description | Vocabulary | Type |
---|---|---|---|
RecordType
*
|
Record type. Use
|
string | |
CampaignID
*
|
Identifier of the campaign the sample belongs to. Constraints
|
string | |
SampleID
*
|
Identifier of the sample. Must be unique within the campaign. Constraints
|
string | |
Date
*
|
Sampling date, formatted as
|
date | |
PlatformCode
*
|
Platform from which sampling took place. Use
|
SHIPC | string |
PlatformClass
*
|
Type of the platform.
|
Platform Class | string |
PlatformSide
|
Side of the platform from which sampling took place.
|
PlatformSide | string |
PlatformHeight
|
Height (in m) of the platform during sampling (e.g. average flying height of airplane). Constraints
|
number | |
TransectWidth
*
|
Width (in m) of the sampling transect. Constraints
|
integer | |
SamplingMethod
*
|
Sampling method.
|
BD_CountMethod | string |
PrimarySampling
|
Whether the sample should be considered primary (
|
Boolean | boolean |
TargetTaxa
*
|
Species (groups) that were counted during sampling.
|
TargetTaxa | string |
DistanceBins
|
List of distance bin boundaries applied during sampling and to be used for distance analyses, formatted as
|
string | |
UseOfBinoculars
|
Extent to which binoculars were used during sampling.
|
UseOfBinoculars | string |
NumberOfObservers
|
Number of observers that contributed to the sample. Constraints
|
integer | |
Notes
|
Additional details about the sample, such as the name of the ship in case it has no
|
string |
Position
Source: position.yml
Information about a position during sampling. Since the platform moves during sampling, these positions often represent the calculated midpoint of a trajectory. These trajectories (also called “observation bins”) typically have a predefined duration (e.g. 2 minutes).
Name | Description | Vocabulary | Type |
---|---|---|---|
RecordType
*
|
Record type. Use
|
string | |
SampleID
*
|
Identifier of the sample the position belongs to. Constraints
|
string | |
PositionID
*
|
Identifier of the position. Must be unique within the campaign. Constraints
|
string | |
Time
*
|
UTC time at the start of the trajectory/observation bin of this position, formatted as
|
time | |
Latitude
*
|
Latitude of the position in decimal degrees, using the WGS84 datum. Often the calculated midpoint of a trajectory. Constraints
|
number | |
Longitude
*
|
Longitude of the position in decimal degrees, using the WGS84 datum. Often the calculated midpoint of a trajectory. Constraints
|
number | |
Distance
|
Distance (in km) travelled during the observation bin. Can only remain empty if
|
number | |
Area
|
Area (in km²) of sea surveyed during the observation bin. Can only remain empty if
|
number | |
WindForce
|
Wind force and sea state according to the Beaufort scale.
|
Beaufort | string |
Visibility
|
Visibility (in km).
Use a range code (
|
Visibility | string |
Glare
|
Glare that could be affecting observation quality.
|
Glare | string |
SunAngle
|
Angle of the sun in relation to the observer (
|
integer | |
CloudCover
|
Cloud cover (in oktas). Constraints
|
CloudCover | string |
Precipitation
|
Precipitation.
|
Precipitation | string |
IceCover
|
Ice cover percentage within the transect. Constraints
|
integer | |
ObservationConditions
|
General impression of the observation conditions.
|
Sightability | string |
Observation
Source: observation.yml
Information about an observation of a group of birds or marine mammals. Use separate observation records to distinguish between species, age, etc.
Name | Description | Vocabulary | Type |
---|---|---|---|
RecordType
*
|
Record type. Use
|
string | |
PositionID
*
|
Identifier of the position the observation belongs to. Constraints
|
string | |
ObservationID
*
|
Identifier of the observation. Must be unique within the campaign. Constraints
|
string | |
GroupID
|
Identifier of an aggregation of individuals. Must be unique within the campaign. Observations in a sample with the same
|
string | |
Transect
*
|
Whether the observation was in (
|
Boolean | boolean |
SpeciesCodeType
*
|
Type of
|
RLIST | string |
SpeciesCode
*
|
Code of the observed species. See the species lookup table. Constraints
|
string | |
Count
*
|
Number of animals counted or estimated (not corrected for distance). Constraints
|
integer | |
ObservationDistance
|
Distance (in m) at which the animal(s) was observed.
Values should be the midpoint of the distance bins defined in
|
ObservationDistance | string |
LifeStage
|
Life stage of the animal(s), based on plumage.
|
LifeStage | string |
Moult
|
Primary moult of the animal(s). Use only for fulmar, auks, divers and seaduck.
|
Moult | string |
Plumage
|
Plumage type of the animal(s).
For immature auks (guillemot and razorbill):
For immature northern gannets:
|
Plumage | string |
Sex
|
Sex of the animal(s).
|
SEXCO | string |
TravelDirection
|
Direction in which the animal(s) is travelling.
Use degrees (10° increments) to indicate directions relative to the direction of the platform
and (inter)cardinal directions (e.g.
|
TravelDirection | string |
Prey
|
Observed prey (type) caught or carried by the animal(s).
|
PreyType | string |
Association
|
Associations between the animal(s) and vessels/structures/floating matter.
Combine multiple values with
|
Association | string |
Behaviour
|
Observed behaviour of the animal(s).
Combine multiple values with
|
Behaviour | string |
Notes
|
Additional details about to the observation. Constraints
|
string |