Difference between revisions of "Darwin Core Terms"

From Gcube Wiki
Jump to: navigation, search
(Created page with ''''Darwin Core Archive Format''' '''The Core Taxon File''' Repository URL: [http://rs.gbif.org/core/dwc_taxon.xml http://rs.gbif.org/core/dwc_taxon.xml] {|border="1" cellpa…')
 
Line 7: Line 7:
 
Repository URL: [http://rs.gbif.org/core/dwc_taxon.xml http://rs.gbif.org/core/dwc_taxon.xml]
 
Repository URL: [http://rs.gbif.org/core/dwc_taxon.xml http://rs.gbif.org/core/dwc_taxon.xml]
  
 
+
{|border="1" cellpadding="5" cellspacing="0"
{|border="1" cellpadding="5" cellspacing="0" align="center"
+
 
|-
 
|-
 
! scope="col" style="background:#efefef;" | Field
 
! scope="col" style="background:#efefef;" | Field
 
! scope="col" style="background:#efefef;" | Description
 
! scope="col" style="background:#efefef;" | Description
 +
! scope="col" style="background:#efefef;" | DwC term
 
|-
 
|-
 
|'''taxonID'''
 
|'''taxonID'''
Line 17: Line 17:
 
An accepted name should have a unique ‘taxonID’ value.  
 
An accepted name should have a unique ‘taxonID’ value.  
 
A synonym (or similar name linked to a taxon) should ideally have an identifier in the ‘taxonID’ field.
 
A synonym (or similar name linked to a taxon) should ideally have an identifier in the ‘taxonID’ field.
 +
''Data Type: string''
 +
 +
|''http://rs.tdwg.org/dwc/terms/taxonID''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/taxonID''
 
  
''Data Type: string''
 
  
 
|-
 
|-
 
|'''acceptedNameUsageID'''
 
|'''acceptedNameUsageID'''
 
|The field ‘acceptedNameUsageID’ should be used to link a synonym record to its corresponding accepted name (which will have a matching ‘taxonID’ value).  
 
|The field ‘acceptedNameUsageID’ should be used to link a synonym record to its corresponding accepted name (which will have a matching ‘taxonID’ value).  
 
 
An accepted name should have an empty ‘acceptedNameUsageID’ field.
 
An accepted name should have an empty ‘acceptedNameUsageID’ field.
  
 
+
''http://rs.tdwg.org/dwc/terms/acceptedNameUsageID''
''Qualified Name: http://rs.tdwg.org/dwc/terms/acceptedNameUsageID''
+
  
 
''Data Type: string''
 
''Data Type: string''
Line 38: Line 37:
  
 
''If there is no parent included in the checklist, because the “top of the tree” has been reached, then this field should be empty to indicate this.''
 
''If there is no parent included in the checklist, because the “top of the tree” has been reached, then this field should be empty to indicate this.''
 +
''Data Type: string''
 +
|''http://rs.tdwg.org/dwc/terms/parentNameUsageID''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/parentNameUsageID''
 
  
''Data Type: string''
 
  
 
|-
 
|-
 
|'''scientificName'''
 
|'''scientificName'''
|The scientific name of taxon with or without authorship information
+
|The scientific name of taxon with or without authorship information depending on the format of the source database.
  
depending on the format of the source database.
 
  
 +
Examples: "Coleoptera" , "Vespertilionidae”, "Manis" , "Ctenomys sociabilis", "Ambystoma tigrinum diaboli", "Quercus agrifolia var.oxyadenia (Torr.)"
 +
''Data Type: string''
  
Examples: "Coleoptera" , "Vespertilionidae”, "Manis" , "Ctenomys
+
|''http://rs.tdwg.org/dwc/terms/scientificName''
  
sociabilis", "Ambystoma tigrinum diaboli", "Quercus agrifolia var.
 
  
oxyadenia (Torr.)"
 
 
 
''Qualified Name: http://rs.tdwg.org/dwc/terms/scientificName''
 
 
''Data Type: string''
 
  
 
|-
 
|-
Line 65: Line 58:
 
| If the authority is known and can be separated from the rest of the scientific name, the authority string should also be placed in the ‘scientificNameAuthorship’ field.  
 
| If the authority is known and can be separated from the rest of the scientific name, the authority string should also be placed in the ‘scientificNameAuthorship’ field.  
  
If authorship is included in the scientificName field, this field is
+
If authorship is included in the scientificName field, this field is optional.
 +
Example: "(Torr.) J.T. Howell", "(Martinovsk ) Tzvelev", "(Linnaeus 1768)"
 +
''Data Type: string''
  
optional.
+
|''http://rs.tdwg.org/dwc/terms/scientificNameAuthorship''
  
  
Example: "(Torr.) J.T. Howell", "(Martinovsk ) Tzvelev", "(Linnaeus
 
 
1768)"
 
 
 
''Qualified Name: http://rs.tdwg.org/dwc/terms/scientificNameAuthorship''
 
 
''Data Type: string''
 
  
 
|-
 
|-
Line 83: Line 70:
 
| A citation representing the concept or sense in which the name is used.
 
| A citation representing the concept or sense in which the name is used.
  
 +
''Data Type: string''
 +
|''http://rs.tdwg.org/dwc/terms/nameAccordingTo''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/nameAccordingTo''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 94: Line 81:
 
Example: "Animalia", "Plantae"
 
Example: "Animalia", "Plantae"
  
 +
''Data Type: string''
 +
|''http://rs.tdwg.org/dwc/terms/kingdom''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/kingdom''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 104: Line 91:
  
 
Example: "Chordata" (phylum), "Bryophyta" (division)
 
Example: "Chordata" (phylum), "Bryophyta" (division)
 +
''Data Type: string''
  
 +
|''http://rs.tdwg.org/dwc/terms/phylum''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/phylum''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 115: Line 102:
  
 
Example: "Mammalia", "Hepaticopsida"
 
Example: "Mammalia", "Hepaticopsida"
 +
''Data Type: string''
  
 +
|''http://rs.tdwg.org/dwc/terms/class''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/class''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 127: Line 114:
 
Example: "Carnivora", "Monocleales"
 
Example: "Carnivora", "Monocleales"
  
 +
''Data Type: string''
 +
|''http://rs.tdwg.org/dwc/terms/order''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/order''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 137: Line 124:
  
 
Example: "Felidae", "Monocleaceae"
 
Example: "Felidae", "Monocleaceae"
 +
''Data Type: string''
  
 +
|''http://rs.tdwg.org/dwc/terms/family''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/family''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 148: Line 135:
  
 
Example: "Puma", "Monoclea"
 
Example: "Puma", "Monoclea"
 +
''Data Type: string''
  
 +
|''http://rs.tdwg.org/dwc/terms/genus''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/genus''
 
  
''Data Type: string''
 
  
 
|-
 
|-
 
| '''subgenus'''
 
| '''subgenus'''
| The full scientific name of the subgenus in which the taxon is classified. Values should include the genus to avoid homonym
+
| The full scientific name of the subgenus in which the taxon is classified. Values should include the genus to avoid homonym confusion.
 
+
confusion.
+
  
 
Example: Puma (Puma); Loligo (Amerigo); Hieracium subgen. Pilosella
 
Example: Puma (Puma); Loligo (Amerigo); Hieracium subgen. Pilosella
  
 +
''Data Type: string''
 +
|''http://rs.tdwg.org/dwc/terms/subgenus''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/subgenus''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 173: Line 158:
 
Example:  
 
Example:  
  
scientificName: Carex viridula subsp. brachyrrhyncha var. elatior (Schltdl.) Crins
+
scientificName: Carex viridula subsp. brachyrrhyncha var. elatior (Schltdl.) Crins  
 
+
 
specificEpithet: viridula
 
specificEpithet: viridula
 +
''Data Type: string''
  
 +
|''http://rs.tdwg.org/dwc/terms/specificEpithet''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/specificEpithet''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 188: Line 172:
 
Example:  
 
Example:  
  
scientificName: Carex viridula subsp. brachyrrhyncha var. elatior (Schltdl.) Crins
+
scientificName: Carex viridula subsp. brachyrrhyncha var. elatior (Schltdl.) Crins  
 
+
 
infraspecificEpithet: elatior
 
infraspecificEpithet: elatior
 +
''Data Type: string''
  
 +
|''http://rs.tdwg.org/dwc/terms/infraspecificEpithet''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/infraspecificEpithet''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 203: Line 186:
 
Example:  
 
Example:  
  
scientificName: Carex viridula subsp. brachyrrhyncha var. elatior (Schltdl.) Crins
+
scientificName: Carex viridula subsp. brachyrrhyncha var. elatior (Schltdl.) Crins  
  
 
erbatimTaxonRank: var.
 
erbatimTaxonRank: var.
 +
''Data Type: string''
  
 +
|''http://rs.tdwg.org/dwc/terms/verbatimTaxonRank''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/verbatimTaxonRank''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 217: Line 200:
  
 
Examples: "subspecies", "varietas", "forma", "species", "genus".  
 
Examples: "subspecies", "varietas", "forma", "species", "genus".  
 +
''Data Type: string''
  
 
+
|''http://rs.tdwg.org/dwc/terms/taxonRank''
''Qualified Name: http://rs.tdwg.org/dwc/terms/taxonRank''
+
 
+
''Data Type: string''
+
  
 
|-
 
|-
Line 230: Line 211:
  
 
“unknown” has also been suggested, but often an empty value is expected to indicate an unknown value.
 
“unknown” has also been suggested, but often an empty value is expected to indicate an unknown value.
 +
''Data Type: string''
  
 +
|''Ìhttp://rs.tdwg.org/dwc/terms/taxonomicStatus''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/taxonomicStatus''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 241: Line 222:
  
 
It is recommended this format: “''YYYY''-''MM''-''DD''”.
 
It is recommended this format: “''YYYY''-''MM''-''DD''”.
 +
''Data Type: date''
  
 +
|''http://purl.org/dc/terms/modified''
  
''Qualified Name: http://purl.org/dc/terms/modified''
 
  
''Data Type: date''
 
  
 
|-
 
|-
Line 251: Line 232:
 
| Citation information specified by the data publisher.
 
| Citation information specified by the data publisher.
  
 +
''Data Type: string''
 +
|''http://purl.org/dc/terms/bibliographicCitation''
  
''Qualified Name: http://purl.org/dc/terms/bibliographicCitation''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 260: Line 241:
 
| Comments or notes about the taxon or name.
 
| Comments or notes about the taxon or name.
  
 +
''Data Type: string''
 +
|''http://rs.tdwg.org/dwc/terms/taxonRemarks''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/taxonRemarks''
 
  
''Data Type: string''
 
  
 
|-
 
|-
Line 274: Line 255:
  
 
Example: “urn:lsid:ipni.org:names:37829-1:1.3”
 
Example: “urn:lsid:ipni.org:names:37829-1:1.3”
 +
''Data Type: string''
  
 +
|''http://rs.tdwg.org/dwc/terms/scientificNameID''
  
''Qualified Name: http://rs.tdwg.org/dwc/terms/scientificNameID''
 
  
''Data Type: string''
 
  
 
|}
 
|}

Revision as of 18:34, 6 December 2012

Darwin Core Archive Format


The Core Taxon File


Repository URL: http://rs.gbif.org/core/dwc_taxon.xml

Field Description DwC term
taxonID A ‘taxonID’ value may be any string, it is not required to be numeric.

An accepted name should have a unique ‘taxonID’ value. A synonym (or similar name linked to a taxon) should ideally have an identifier in the ‘taxonID’ field. Data Type: string

http://rs.tdwg.org/dwc/terms/taxonID


acceptedNameUsageID The field ‘acceptedNameUsageID’ should be used to link a synonym record to its corresponding accepted name (which will have a matching ‘taxonID’ value).

An accepted name should have an empty ‘acceptedNameUsageID’ field.

http://rs.tdwg.org/dwc/terms/acceptedNameUsageID

Data Type: string

parentNameUsageID The field ‘parentNameUsageID’ of the accepted name record for a taxon is used to refer to the ‘taxonID’ value of the parent taxon at the next higher taxonomic rank included in the checklist.

If there is no parent included in the checklist, because the “top of the tree” has been reached, then this field should be empty to indicate this. Data Type: string

http://rs.tdwg.org/dwc/terms/parentNameUsageID


scientificName The scientific name of taxon with or without authorship information depending on the format of the source database.


Examples: "Coleoptera" , "Vespertilionidae”, "Manis" , "Ctenomys sociabilis", "Ambystoma tigrinum diaboli", "Quercus agrifolia var.oxyadenia (Torr.)" Data Type: string

http://rs.tdwg.org/dwc/terms/scientificName


scientificNameAuthorship If the authority is known and can be separated from the rest of the scientific name, the authority string should also be placed in the ‘scientificNameAuthorship’ field.

If authorship is included in the scientificName field, this field is optional. Example: "(Torr.) J.T. Howell", "(Martinovsk ) Tzvelev", "(Linnaeus 1768)" Data Type: string

http://rs.tdwg.org/dwc/terms/scientificNameAuthorship


nameAccordingTo A citation representing the concept or sense in which the name is used.

Data Type: string

http://rs.tdwg.org/dwc/terms/nameAccordingTo


kingdom The full scientific name of the kingdom in which the taxon is classified.

Example: "Animalia", "Plantae"

Data Type: string

http://rs.tdwg.org/dwc/terms/kingdom


phylum The full scientific name of the phylum in which the taxon is classified.

Example: "Chordata" (phylum), "Bryophyta" (division) Data Type: string

http://rs.tdwg.org/dwc/terms/phylum


class The full scientific name of the class in which the taxon is classified.

Example: "Mammalia", "Hepaticopsida" Data Type: string

http://rs.tdwg.org/dwc/terms/class


order The full scientific name of the order in which the taxon is classified.

Example: "Carnivora", "Monocleales"

Data Type: string

http://rs.tdwg.org/dwc/terms/order


family The full scientific name of the family in which the taxon is classified.

Example: "Felidae", "Monocleaceae" Data Type: string

http://rs.tdwg.org/dwc/terms/family


genus The full scientific name of the genus in which the taxon is classified.

Example: "Puma", "Monoclea" Data Type: string

http://rs.tdwg.org/dwc/terms/genus


subgenus The full scientific name of the subgenus in which the taxon is classified. Values should include the genus to avoid homonym confusion.

Example: Puma (Puma); Loligo (Amerigo); Hieracium subgen. Pilosella

Data Type: string

http://rs.tdwg.org/dwc/terms/subgenus


specificEpithet 2nd word in a scientific name (species), es. Acer saccharum, saccharum is the specificEpithet.

Example:

scientificName: Carex viridula subsp. brachyrrhyncha var. elatior (Schltdl.) Crins specificEpithet: viridula Data Type: string

http://rs.tdwg.org/dwc/terms/specificEpithet


infraspecificEpithet Terminal word in a scientific name.

Example:

scientificName: Carex viridula subsp. brachyrrhyncha var. elatior (Schltdl.) Crins infraspecificEpithet: elatior Data Type: string

http://rs.tdwg.org/dwc/terms/infraspecificEpithet


verbatimTaxonRank The taxonomic rank of the most specific name in the scientificName.

Example:

scientificName: Carex viridula subsp. brachyrrhyncha var. elatior (Schltdl.) Crins

erbatimTaxonRank: var. Data Type: string

http://rs.tdwg.org/dwc/terms/verbatimTaxonRank


taxonRank The taxonomic rank of the most specific name in the scientificName. Recommended best practice is to use a controlled vocabulary: http://rs.gbif.org/vocabulary/gbif/rank.xml.

Examples: "subspecies", "varietas", "forma", "species", "genus". Data Type: string

http://rs.tdwg.org/dwc/terms/taxonRank
taxonomicStatus The status of the use of the scientificName as a label for a taxon. Controlled vocabulary:

"accepted", "invalid", "misapplied", "provisional", “synonym”, “valid”

“unknown” has also been suggested, but often an empty value is expected to indicate an unknown value. Data Type: string

Ìhttp://rs.tdwg.org/dwc/terms/taxonomicStatus


modified The most recent date-time on which the resource was changed.

It is recommended this format: “YYYY-MM-DD”. Data Type: date

http://purl.org/dc/terms/modified


bibliographicCitation Citation information specified by the data publisher.

Data Type: string

http://purl.org/dc/terms/bibliographicCitation


taxonRemarks Comments or notes about the taxon or name.

Data Type: string

http://rs.tdwg.org/dwc/terms/taxonRemarks


scientificNameID Exclusively used to reference an external and resolvable identifier that returns nomenclatural (not taxonomic) details of a name. Use

taxonID to refer to taxa. Use to explicitly refer to an external

nomenclatural record.

Example: “urn:lsid:ipni.org:names:37829-1:1.3” Data Type: string

http://rs.tdwg.org/dwc/terms/scientificNameID


Vernacular Names Extension


This extension provides the means to share information related to common (vernacular) names linked to taxa in the core data file. Multiple vernacular names can be linked to the same taxon via the taxonID.


Repository: http://rs.gbif.org/extension/gbif/1.0/vernacular.xml


Field Description
taxonID The first field in the data file should be the taxonID representing the

taxon in the core data file to which this vernacular name points. This

identifier provides the link between the core data record and the

extension record.


Qualified Name: http://rs.tdwg.org/dwc/terms/taxonID

Data Type: string

vernacularName A common or vernacular name.

Example: Andean Condor", "Condor Andino", "American Eagle",

"Gönsegeier"


Qualified Name: http://rs.tdwg.org/dwc/terms/vernacularName

Data Type: string

language ISO 639-1 language code used for the vernacular name value.

Example: “ES”, “Spanish”, “Español”


Qualified Name: http://purl.org/dc/terms/language

Data Type: string

locality The specific description of the area from which the vernacular name

usage originates. Vernacular names may have very specific regional

contexts. A name used for a species in one area may refer to a

different species in another.

Example: "Southeastern coastal New England from Buzzards Bay

through Rhode Island"


Qualified Name: http://rs.tdwg.org/dwc/terms/locality

Data Type: string

Simple Darwin Core


The following schema specifies the field contained in a Simple Darwin Core file.

Field Description
language The language of the parent resource. Recommended best practice is to use a controlled vocabulary such as ISO 693

Example: "eng"


Qualified Name: http://purl.org/dc/terms/language

Data Type: string

modified The most recent date-time on which the resource was changed.

Recommended format: "yyyy-MM-dd'T'HH:mm:ss"


Qualified Name: http://purl.org/dc/terms/modified

Data Type: string

basisOfRecord The specific nature of the data record - a subtype of the dcterms:type. Recommended best practice is to use a controlled vocabulary such as the Darwin Core Type Vocabulary (http://rs.tdwg.org/dwc/terms/type-vocabulary/index.htm).

Examples: "PreservedSpecimen", "FossilSpecimen", "LivingSpecimen", "HumanObservation", "MachineObservation".


Qualified Name: http://rs.tdwg.org/dwc/terms/basisOfRecord

Data Type: string

institutionCode The name (or acronym) in use by the institution having custody of the object(s) or information referred to in the record.

Examples: "MVZ", "FMNH", "AKN-CLO", "University of California Museum of Paleontology (UCMP)".


Qualified Name: http://rs.tdwg.org/dwc/terms/institutionCode

Data Type: string

collectionCode The name, acronym, coden, or initialism identifying the collection or data set from which the record was derived.

Examples: "Mammals", "Hildebrandt", "eBird".


Qualified Name: http://rs.tdwg.org/dwc/terms/collectionCode

Data Type: string

catalogNumber An identifier (preferably unique) for the record within the data set or collection.

Examples: "2008.1334", "145732a", "145732".


Qualified Name: http://rs.tdwg.org/dwc/terms/catalogNumber

Data Type: string

recordedBy A list of names of people, groups, or organizations responsible for recording the original Occurrence.

Example: "Oliver P. Pearson; Anita K. Pearson".


Qualified Name: http://rs.tdwg.org/dwc/terms/recordedBy

Data Type: string

scientificName The scientific name of taxon with or without authorship information

depending on the format of the source database.

Examples: "Coleoptera", "Vespertilionidae".


Qualified Name: http://rs.tdwg.org/dwc/terms/scientificName

Data Type: string

kingdom The full scientific name of the kingdom in which the taxon is classified.

Example: "Animalia", "Plantae".


Qualified Name: http://rs.tdwg.org/dwc/terms/kingdom

Data Type: string

family The full scientific name of the family in which the taxon is classified.

Example: "Felidae", "Monocleaceae".


Qualified Name: http://rs.tdwg.org/dwc/terms/family

Data Type: string

locality The specific description of the place.

Example: "Bariloche, 25 km NNE via Ruta Nacional 40".


Qualified Name: http://rs.tdwg.org/dwc/terms/locality

Data Type: string

eventDate The date-time or interval during which an Event occurred. For occurrences, this is the date-time when the event was recorded.

Examples: "1963-03-08T14:07-0600".


Qualified Name: http://rs.tdwg.org/dwc/terms/eventDate

Data Type: date

year The four-digit year in which the Event occurred, according to the Common Era Calendar.

Example: "2008".


Qualified Name: http://rs.tdwg.org/dwc/terms/year

Data Type: date

decimalLatitude The geographic latitude.


Qualified Name: http://rs.tdwg.org/dwc/terms/decimalLatitude

Data Type: float

decimalLongitude The geographic longitude.


Qualified Name: http://rs.tdwg.org/dwc/terms/decimalLongitude

Data Type: float

coordinateUncertaintyInMeters As close an approximation to the standard deviation of the coordinates expressed in meters.


Qualified Name: http://rs.tdwg.org/dwc/terms/coordinateUncertaintyInMeters

Data Type: float

maximumDepthInMeters The greater depth of a range of depth below the local surface, in meters.


Qualified Name: http://rs.tdwg.org/dwc/terms/maximumDepthInMeters

Data Type: float

minimumDepthInMeters The lesser depth of a range of depth below the local surface, in meters.


Qualified Name: http://rs.tdwg.org/dwc/terms/minimumDepthInMeters

Data Type: float