Class: Export::Dwca::GbifProfile::CoreTaxon

Inherits:
Object
  • Object
show all
Defined in:
lib/export/dwca/gbif_profile/core_taxon.rb

Constant Summary collapse

NAMESPACES = 
{
  :taxonID => 'http://rs.tdwg.org/dwc/terms/taxonID',
  :acceptedNameUsageID => 'http://rs.tdwg.org/dwc/terms/acceptedNameUsageID',
  :acceptedNameUsage => 'http://rs.tdwg.org/dwc/terms/acceptedNameUsage',
  :parentNameUsageID => 'http://rs.tdwg.org/dwc/terms/parentNameUsageID',
  :parentNameUsage => 'http://rs.tdwg.org/dwc/terms/parentNameUsage',
  :originalNameUsageID => 'http://rs.tdwg.org/dwc/terms/originalNameUsageID',
  :originalNameUsage => 'http://rs.tdwg.org/dwc/terms/originalNameUsage',
  :nameAccordingTo => 'http://rs.tdwg.org/dwc/terms/nameAccordingTo',
  :nameAccordingToID => 'http://rs.tdwg.org/dwc/terms/nameAccordingToID',
  :namePublishedIn => 'http://rs.tdwg.org/dwc/terms/namePublishedIn',
  :namePublishedInID => 'http://rs.tdwg.org/dwc/terms/namePublishedInID',
  :scientificName => 'http://rs.tdwg.org/dwc/terms/scientificName',
  :scientificNameID => 'http://rs.tdwg.org/dwc/terms/scientificNameID',
  :scientificNameAuthorship => 'http://rs.tdwg.org/dwc/terms/scientificNameAuthorship',
  :higherClassification => 'http://rs.tdwg.org/dwc/terms/higherClassification',
  :kingdom => 'http://rs.tdwg.org/dwc/terms/kingdom',
  :phylum => 'http://rs.tdwg.org/dwc/terms/phylum',
  :klass => 'http://rs.tdwg.org/dwc/terms/class',
  :order => 'http://rs.tdwg.org/dwc/terms/order',
  :family => 'http://rs.tdwg.org/dwc/terms/family',
  :genus => 'http://rs.tdwg.org/dwc/terms/genus',
  :subgenus => 'http://rs.tdwg.org/dwc/terms/subgenus',
  :specificEpithet => 'http://rs.tdwg.org/dwc/terms/specificEpithet',
  :infraspecificEpithet => 'http://rs.tdwg.org/dwc/terms/infraspecificEpithet',
  :taxonRank => 'http://rs.tdwg.org/dwc/terms/taxonRank',
  :verbatimTaxonRank => 'http://rs.tdwg.org/dwc/terms/verbatimTaxonRank',
  :nomenclaturalCode => 'http://rs.tdwg.org/dwc/terms/nomenclaturalCode',
  :taxonomicStatus => 'http://rs.tdwg.org/dwc/terms/taxonomicStatus',
  :nomenclaturalStatus => 'http://rs.tdwg.org/dwc/terms/nomenclaturalStatus',
  :taxonRemarks => 'http://rs.tdwg.org/dwc/terms/taxonRemarks',
  :modified => 'http://purl.org/dc/terms/modified',
  :language => 'http://purl.org/dc/terms/language',
  :rights => 'http://purl.org/dc/terms/rights',
  :rightsHolder => 'http://purl.org/dc/terms/rightsHolder',
  :accessRights => 'http://purl.org/dc/terms/accessRights',
  :bibliographicCitation => 'http://purl.org/dc/terms/bibliographicCitation',
  :informationWithheld => 'http://rs.tdwg.org/dwc/terms/informationWithheld',
  :datasetID => 'http://rs.tdwg.org/dwc/terms/datasetID',
  :datasetName => 'http://rs.tdwg.org/dwc/terms/datasetName',
  :source => 'http://purl.org/dc/terms/source'
}.freeze

Instance Attribute Summary collapse

Instance Attribute Details

#acceptedNameUsage ⇒ String

acceptedNameUsage (http://rs.tdwg.org/dwc/terms/acceptedNameUsage)

The scientificName of the taxon considered to be the valid (zoological) or accepted (botanical) name for this nameUsage.

Example: "Tamias minimus" valid name for "Eutamias minimus"

Returns:

  • (String) 


78
79
80
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 78

def acceptedNameUsage
  @acceptedNameUsage
end

#acceptedNameUsageID ⇒ String

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

This represents a second column in a synonym record that points to the record representing the valid (zoological) or accepted (botanical) name using the taxonID of that record as the "pointer."

Example: 8fa58e08-08de-4ac1-b69c-1235340b7001

Returns:

  • (String) 


69
70
71
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 69

def acceptedNameUsageID
  @acceptedNameUsageID
end

#accessRights ⇒ String

accessRights (http://purl.org/dc/terms/accessRights)

Information about who can access the resource or an indication of its security status. Access Rights may include information regarding access or restrictions based on privacy, security, or other policies.

Example: "not-for-profit use only"

Returns:

  • (String) 


415
416
417
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 415

def accessRights
  @accessRights
end

#bibliographicCitation ⇒ String

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

Citation information specified by the data publisher. Citation information is inherited downward by all child taxa if no other citation is included. Citation information is NOT accumulated upward. For example, one citation may be linked to a Mammalia entry and generally applies to all mammal species but a different citation for a child taxon, Primates, applies to all child primate taxa.

Example: "van Soest, R. (2009). Leucandra fistulosa (Johnston, 1842). In: Van Soest, R.W.M, Boury-Esnault, N., Hooper, J.N.A., Rützler, K, de Voogd, N.J., Alvarez, B., Hajdu, E., Pisera, A.B., Vacelet, J. Manconi, R., Schoenberg, C., Janussen, D., Tabachnick, K.R., Klautau, M. (Eds) (2009). World Porifera database"

Returns:

  • (String) 


432
433
434
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 432

def bibliographicCitation
  @bibliographicCitation
end

#datasetID ⇒ String

datasetID (http://rs.tdwg.org/dwc/terms/datasetID)

An identifier for a (sub) dataset. Ideally globally unique, but any id allowed

Example: "13"

Returns:

  • (String) 


449
450
451
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 449

def datasetID
  @datasetID
end

#datasetName ⇒ String

datasetName (http://rs.tdwg.org/dwc/terms/datasetName)

The title of the (sub)dataset optionally also referenced via datasetID

Example: "World Register of Marine Species" "Fauna Europaea"

Returns:

  • (String) 


457
458
459
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 457

def datasetName
  @datasetName
end

#family ⇒ String

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

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

Example: "Felidae", "Monocleaceae"

Returns:

  • (String) 


258
259
260
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 258

def family
  @family
end

#genus ⇒ String

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

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

Example: "Puma", "Monoclea"

Returns:

  • (String) 


266
267
268
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 266

def genus
  @genus
end

#higherClassification ⇒ String

higherClassification (http://rs.tdwg.org/dwc/terms/higherClassification)

A list (concatenated and separated) of taxon names terminating at the rank immediately superior to the taxon referenced in the taxon record. This is used to fit the entire higher classification for a taxon into a single field. Recommended best practice is to order the list starting with the highest rank and separating the names for each rank with a semi-colon (";").

Example: "Animalia;Chordata;Vertebrata;Mammalia;Theria;Eutheria;Rodentia;Hystricognatha;Hystricognathi;Ctenomyidae;Ctenomyini;Ctenomys"

Returns:

  • (String) 


217
218
219
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 217

def higherClassification
  @higherClassification
end

#informationWithheld ⇒ String

informationWithheld (http://rs.tdwg.org/dwc/terms/informationWithheld)

Additional remarks as to information not published, but available

Example: "hybrid parents information available"

Returns:

  • (String) 


440
441
442
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 440

def informationWithheld
  @informationWithheld
end

#infraspecificEpithet ⇒ String

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

The name of the lowest or terminal infraspecific epithet of the scientificName, excluding any rank marker.

Example: "concolor", "oxyadenia", "sayi"

Returns:

  • (String) 


293
294
295
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 293

def infraspecificEpithet
  @infraspecificEpithet
end

#kingdom ⇒ String

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

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

Example: "Animalia", "Plantae"

Returns:

  • (String) 


226
227
228
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 226

def kingdom
  @kingdom
end

#klass ⇒ String

(klass) class (http://rs.tdwg.org/dwc/terms/class)

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

Example: "Mammalia", "Hepaticopsida"

Returns:

  • (String) 


242
243
244
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 242

def klass
  @klass
end

#language ⇒ String

language (http://purl.org/dc/terms/language)

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

Example: "eng"

Returns:

  • (String) 


388
389
390
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 388

def language
  @language
end

#modified ⇒ String

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

Date when the record was last updated

Example: "2009-08-21"

Returns:

  • (String) 


379
380
381
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 379

def modified
  @modified
end

#nameAccordingTo ⇒ String

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

A bibliographic citation representing the concept or sense in which the name is used. Traditionally, in botany, the Latin "sensu" or "sec". (for secundum – according to) have been used. For taxa that result from identifications a reference to the keys used, monographs, online source or experts should be given.

Example: "Werner Greuter 2008; Lilljeborg 1861, Upsala Univ. Arsskrift, Math. Naturvet., pp. 4, 5", "McCranie, J. R., D. B. Wake, and L. D. Wilson. 1996. The taxonomic status of Bolitoglossa schmidti, with comments on the biology of the Mesoamerican salamander Bolitoglossa dofleini (Caudata: Plethodontidae). Carib. J. Sci. 32:395- 398."

Returns:

  • (String) 


140
141
142
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 140

def nameAccordingTo
  @nameAccordingTo
end

#nameAccordingToID ⇒ String

nameAccordingToID (http://rs.tdwg.org/dwc/terms/nameAccordingToID)

A unique identifier that returns the details of a nameAccordingTo (see above) reference.

Example: "doi:10.1016/S0269-915X(97)80026-2"

Returns:

  • (String) 


149
150
151
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 149

def nameAccordingToID
  @nameAccordingToID
end

#namePublishedIn ⇒ String

namePublishedIn (http://rs.tdwg.org/dwc/terms/namePublishedIn)

Reference to a publication representing the original publication of the name.

Example: "Forel, Auguste, Diagnosies provisoires de quelques espèces nouvelles de fourmis de Madagascar, récoltées par M. Grandidier., Annales de la Societe Entomologique de de Belgique, Comptes-rendus des Seances 30, 1886"

Returns:

  • (String) 


161
162
163
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 161

def namePublishedIn
  @namePublishedIn
end

#namePublishedInID ⇒ String

namePublishedInID (http://rs.tdwg.org/dwc/terms/namePublishedInID)

A preferably resolvable, globally unique identifier that refers to namePublishedIn.

Example: http://hdl.handle.net/10199/7

Returns:

  • (String) 


170
171
172
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 170

def namePublishedInID
  @namePublishedInID
end

#nomenclaturalCode ⇒ String

nomenclaturalCode (http://rs.tdwg.org/dwc/terms/nomenclaturalCode)

The nomenclatural code under which the scientificName is constructed.

Vocabulary: http://rs.gbif.org/vocabulary/gbif/nomenclatural_code.xml

Example: ICBN; ICZN

Returns:

  • (String) 


335
336
337
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 335

def nomenclaturalCode
  @nomenclaturalCode
end

#nomenclaturalStatus ⇒ String

nomenclaturalStatus (http://rs.tdwg.org/dwc/terms/nomenclaturalStatus)

The status related to the original publication of the name and its conformance to the relevant rules of nomenclature. It is based essentially on an algorithm according to the business rules of the code. It requires no taxonomic opinion.

Recommended vocabulary: http://rs.gbif.org/vocabulary/gbif/nomenclatural_status.xml

Example: "nom. ambig.", "nom. illeg.", "nom. subnud."

Returns:

  • (String) 


363
364
365
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 363

def nomenclaturalStatus
  @nomenclaturalStatus
end

#order ⇒ String

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

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

Example: "Carnivora", "Monocleales"

Returns:

  • (String) 


250
251
252
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 250

def order
  @order
end

#originalNameUsage ⇒ String

originalNameUsage (http://rs.tdwg.org/dwc/terms/originalNameUsage)

The equivalent of the scientificName as it originally appeared when the name was first established under the rules of the associated nomenclaturalCode (i.e., within the namePublishedIn reference). The basionym (botany) or basonym (bacteriology) of the scientificName or the senior/earlier homonym for replaced names.

Example: "Pinus abies", "Gasterosteus saltatrix Linnaeus 1768"

Returns:

  • (String) 


123
124
125
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 123

def originalNameUsage
  @originalNameUsage
end

#originalNameUsageID ⇒ String

originalNameUsageID (http://rs.tdwg.org/dwc/terms/originalNameUsageID)

The taxonID of the record representing the name that was originally established under the rules of the associated nomenclaturalCode (i.e., within the namePublishedIn reference). This may be known as the basionym (botany) or basonym (bacteriology) of the scientificName or the senior/earlier homonym for replaced names.

Example: "101" 8fa58e08-08de-4ac1-b69c-1235340b7001

Returns:

  • (String) 


111
112
113
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 111

def originalNameUsageID
  @originalNameUsageID
end

#parentNameUsage ⇒ String

parentNameUsage (http://rs.tdwg.org/dwc/terms/parentNameUsage)

The scientificName of the immediate higher-rank parent taxon (in a classification). This name must match the name used in the row representing the parent taxon. Using IDs (using parentNameUsage) is preferred to this method.

Example: "Rubiaceae", "Gruiformes", "Testudinae"

Returns:

  • (String) 


99
100
101
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 99

def parentNameUsage
  @parentNameUsage
end

#parentNameUsageID ⇒ String

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

The taxonID of the immediate higher-rank parent taxon (in a classification). Using the ID is preferred over using the name (listed as the next term).

Example: "101" 8fa58e08-08de-4ac1-b69c-1235340b7001

Returns:

  • (String) 


88
89
90
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 88

def parentNameUsageID
  @parentNameUsageID
end

#phylum ⇒ String

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

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

Example: "Chordata" (phylum), "Bryophyta" (division)

Returns:

  • (String) 


234
235
236
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 234

def phylum
  @phylum
end

#rights ⇒ String

rights (http://purl.org/dc/terms/rights)

Information about rights held in and over the resource. Typically, rights information includes a statement about various property rights associated with the resource, including intellectual property rights.

Example: "Content licensed under Creative Commons Attribution 3.0 United States License", "CC BY-SA"

Returns:

  • (String) 


399
400
401
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 399

def rights
  @rights
end

#rightsHolder ⇒ String

rightsHolder (http://purl.org/dc/terms/rightsHolder)

A person or organization owning or managing rights over the resource.

Returns:

  • (String) 


405
406
407
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 405

def rightsHolder
  @rightsHolder
end

#scientificName ⇒ String

scientificName (http://rs.tdwg.org/dwc/terms/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.)"

Returns:

  • (String) 


181
182
183
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 181

def scientificName
  @scientificName
end

#scientificNameAuthorship ⇒ String

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

The authorship information for the scientificName formatted according to the conventions of the applicable nomenclaturalCode. If authorship is included in the scientificName field, this field is optional.

Example: "(Torr.) J.T. Howell", "(Martinovsk ) Tzvelev", "(Linnaeus 1768)"

Returns:

  • (String) 


203
204
205
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 203

def scientificNameAuthorship
  @scientificNameAuthorship
end

#scientificNameID ⇒ String

scientificNameID (http://rs.tdwg.org/dwc/terms/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"

Returns:

  • (String) 


191
192
193
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 191

def scientificNameID
  @scientificNameID
end

#source ⇒ String

source (http://purl.org/dc/terms/source)

Used to link to an external representation of the data record such as in a source web database. A URI link or reference to the source of this record. A link to a webpage or RESTful webservice is recommended. URI is mandatory format.

Example: "http://www.catalogueoflife.org/annual-checklist/show_species_details.php?record_id=6197868"

Returns:

  • (String) 


468
469
470
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 468

def source
  @source
end

#specificEpithet ⇒ String

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

The name of the species epithet of the scientificName.

Example: "concolor", "gottschei"

Returns:

  • (String) 


284
285
286
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 284

def specificEpithet
  @specificEpithet
end

#subgenus ⇒ String

subgenus (http://rs.tdwg.org/dwc/terms/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

Returns:

  • (String) 


276
277
278
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 276

def subgenus
  @subgenus
end

#taxonID ⇒ String

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

The unique identifier used for a name or taxon reference in the core data file. Each row in the core data file has a unique taxonID and it should be the first column in the data file. Synonyms occupy separate lines and therefore also have unique taxonIDs. TaxonIDs may be simple integers or more complex globally unique identifiers.

Examples: 101; "8fa58e08-08de-4ac1-b69c-1235340b7001;

Returns:

  • (String) 


59
60
61
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 59

def taxonID
  @taxonID
end

#taxonomicStatus ⇒ String

taxonomicStatus (http://rs.tdwg.org/dwc/terms/taxonomicStatus)

The status of the use of the scientificName as a label for a taxon. Requires taxonomic opinion to define the scope of a taxon. Rules of priority then are used to define the taxonomic status of the nomenclature contained in that scope, combined with the experts opinion. It must be linked to a specific taxonomic reference that defines the concept.

Recommended vocabulary: http://rs.gbif.org/vocabulary/gbif/taxonomic_status.xml

Example: "invalid", "misapplied", "homotypic synonym", "accepted"

Returns:

  • (String) 


350
351
352
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 350

def taxonomicStatus
  @taxonomicStatus
end

#taxonRank ⇒ String

taxonRank (http://rs.tdwg.org/dwc/terms/taxonRank)

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

Recommended vocabulary: http://rs.gbif.org/vocabulary/gbif/rank.xml

Example: "subspecies", "varietas", "forma", "species", "genus"

Returns:

  • (String) 


303
304
305
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 303

def taxonRank
  @taxonRank
end

#taxonRemarks ⇒ String

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

Comments or notes about the taxon or name.

Example: "Type consists of a skull and skeletal fragments".

Returns:

  • (String) 


371
372
373
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 371

def taxonRemarks
  @taxonRemarks
end

#verbatimTaxonRank ⇒ String

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

The taxonomic rank of the most specific name in the scientificName as it appears in the original record or the rank designator within the verbatim original name itself. May incude abbreviations for example.

Example: "Agamospecies", "sub-lesus", "prole", "apomict", "nothogrex", "sp.", "subsp.", "var."

Returns:

  • (String) 


314
315
316
 
# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 314

def verbatimTaxonRank
  @verbatimTaxonRank
end

#vernacularName ⇒ Object

vernacularName (http://rs.tdwg.org/dwc/terms/vernacularName)

A common or vernacular name. Use this in the core file when there is only a single common name to share per taxon record.

Example: "Andean Condor", "Condor Andino", "American Eagle", "Gänsegeier"

Raises:

  • (NoMethodError) —

    (This information is provided in the vernaculars extension)




# File 'lib/export/dwca/gbif_profile/core_taxon.rb', line 316