Class: Dwca::GbifProfile::CoreTaxon

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

Instance Attribute Summary (collapse)

Instance Attribute Details

- (String) acceptedNameUsage

acceptedNameUsage (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)


36
37
38
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 36

def acceptedNameUsage
  @acceptedNameUsage
end

- (String) acceptedNameUsageID

acceptedNameUsageID (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)


27
28
29
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 27

def acceptedNameUsageID
  @acceptedNameUsageID
end

- (String) accessRights

accessRights (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)


373
374
375
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 373

def accessRights
  @accessRights
end

- (String) bibliographicCitation

bibliographicCitation (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)


390
391
392
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 390

def bibliographicCitation
  @bibliographicCitation
end

- (String) datasetID

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

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

Example: “13”

Returns:

  • (String)


407
408
409
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 407

def datasetID
  @datasetID
end

- (String) datasetName

datasetName (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)


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

def datasetName
  @datasetName
end

- (String) family

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

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

Example: “Felidae”, “Monocleaceae”

Returns:

  • (String)


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

def family
  @family
end

- (String) genus

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

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

Example: “Puma”, “Monoclea”

Returns:

  • (String)


224
225
226
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 224

def genus
  @genus
end

- (String) higherClassification

higherClassification (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)


175
176
177
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 175

def higherClassification
  @higherClassification
end

- (String) informationWithheld

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

Additional remarks as to information not published, but available

Example: “hybrid parents information available”

Returns:

  • (String)


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

def informationWithheld
  @informationWithheld
end

- (String) infraspecificEpithet

infraspecificEpithet (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)


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

def infraspecificEpithet
  @infraspecificEpithet
end

- (String) kingdom

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

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

Example: “Animalia”, “Plantae”

Returns:

  • (String)


184
185
186
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 184

def kingdom
  @kingdom
end

- (String) klass

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

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

Example: “Mammalia”, “Hepaticopsida”

Returns:

  • (String)


200
201
202
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 200

def klass
  @klass
end

- (String) language

language (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)


346
347
348
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 346

def language
  @language
end

- (String) modified

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

Date when the record was last updated

Example: “2009-08-21”

Returns:

  • (String)


337
338
339
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 337

def modified
  @modified
end

- (String) nameAccordingTo

nameAccordingTo (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)


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

def nameAccordingTo
  @nameAccordingTo
end

- (String) nameAccordingToID

nameAccordingToID (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)


107
108
109
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 107

def nameAccordingToID
  @nameAccordingToID
end

- (String) namePublishedIn

namePublishedIn (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)


119
120
121
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 119

def namePublishedIn
  @namePublishedIn
end

- (String) namePublishedInID

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

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

Example: hdl.handle.net/10199/7

Returns:

  • (String)


128
129
130
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 128

def namePublishedInID
  @namePublishedInID
end

- (String) nomenclaturalCode

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

The nomenclatural code under which the scientificName is constructed.

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

Example: ICBN; ICZN

Returns:

  • (String)


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

def nomenclaturalCode
  @nomenclaturalCode
end

- (String) nomenclaturalStatus

nomenclaturalStatus (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: rs.gbif.org/vocabulary/gbif/nomenclatural_status.xml

Example: “nom. ambig.”, “nom. illeg.”, “nom. subnud.”

Returns:

  • (String)


321
322
323
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 321

def nomenclaturalStatus
  @nomenclaturalStatus
end

- (String) order

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

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

Example: “Carnivora”, “Monocleales”

Returns:

  • (String)


208
209
210
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 208

def order
  @order
end

- (String) originalNameUsage

originalNameUsage (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)


81
82
83
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 81

def originalNameUsage
  @originalNameUsage
end

- (String) originalNameUsageID

originalNameUsageID (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)


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

def originalNameUsageID
  @originalNameUsageID
end

- (String) parentNameUsage

parentNameUsage (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)


57
58
59
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 57

def parentNameUsage
  @parentNameUsage
end

- (String) parentNameUsageID

parentNameUsageID (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)


46
47
48
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 46

def parentNameUsageID
  @parentNameUsageID
end

- (String) phylum

phylum (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)


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

def phylum
  @phylum
end

- (String) rights

rights (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)


357
358
359
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 357

def rights
  @rights
end

- (String) rightsHolder

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

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

Returns:

  • (String)


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

def rightsHolder
  @rightsHolder
end

- (String) scientificName

scientificName (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)


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

def scientificName
  @scientificName
end

- (String) scientificNameAuthorship

scientificNameAuthorship (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)


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

def scientificNameAuthorship
  @scientificNameAuthorship
end

- (String) scientificNameID

scientificNameID (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)


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

def scientificNameID
  @scientificNameID
end

- (String) source

source (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: “www.catalogueoflife.org/annual-checklist/show_species_details.php?record_id=6197868

Returns:

  • (String)


426
427
428
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 426

def source
  @source
end

- (String) specificEpithet

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

The name of the species epithet of the scientificName.

Example: “concolor”, “gottschei”

Returns:

  • (String)


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

def specificEpithet
  @specificEpithet
end

- (String) subgenus

subgenus (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)


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

def subgenus
  @subgenus
end

- (String) taxonID

taxonID (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)


17
18
19
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 17

def taxonID
  @taxonID
end

- (String) taxonomicStatus

taxonomicStatus (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: rs.gbif.org/vocabulary/gbif/taxonomic_status.xml

Example: “invalid”, “misapplied”, “homotypic synonym”, “accepted”

Returns:

  • (String)


308
309
310
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 308

def taxonomicStatus
  @taxonomicStatus
end

- (String) taxonRank

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

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

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

Example: “subspecies”, “varietas”, “forma”, “species”, “genus”

Returns:

  • (String)


261
262
263
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 261

def taxonRank
  @taxonRank
end

- (String) taxonRemarks

taxonRemarks (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)


329
330
331
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 329

def taxonRemarks
  @taxonRemarks
end

- (String) verbatimTaxonRank

verbatimTaxonRank (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)


272
273
274
# File 'lib/dwca/gbif_profile/core_taxon.rb', line 272

def verbatimTaxonRank
  @verbatimTaxonRank
end

- (Object) vernacularName

vernacularName (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/dwca/gbif_profile/core_taxon.rb', line 274