Package org.gbif.api.vocabulary

Enum Class NameUsageIssue

java.lang.Object

java.lang.Enum<NameUsageIssue>

org.gbif.api.vocabulary.NameUsageIssue

All Implemented Interfaces:

Serializable, Comparable<NameUsageIssue>, Constable, InterpretationRemark

public enum NameUsageIssue
extends Enum<NameUsageIssue>
implements InterpretationRemark

Enumeration of issues for each name usage record encountered during checklist processing.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
ACCEPTED_NAME_MISSING	Synonym lacking an accepted name.
ACCEPTED_NAME_NOT_UNIQUE	Synonym has a verbatim accepted name which is not unique and refers to several records.
ACCEPTED_NAME_USAGE_ID_INVALID	The value for dwc:acceptedNameUsageID could not be resolved.
ALT_IDENTIFIER_INVALID	At least one alternative identifier extension record attached to this name usage is invalid.
BACKBONE_MATCH_AGGREGATE	Name usage could only be matched to a GBIF backbone species, but was in fact a broader species aggregate/complex.
BACKBONE_MATCH_FUZZY	Deprecated. because there should be no fuzzy matching being used anymore for matching checklist names
BACKBONE_MATCH_NONE	Name usage could not be matched to the GBIF backbone.
BASIONYM_AUTHOR_MISMATCH	The authorship of the original name does not match the authorship in brackets of the actual name.
BIB_REFERENCE_INVALID	At least one bibliographic reference extension record attached to this name usage is invalid.
CHAINED_SYNOYM	If a synonym points to another synonym as its accepted taxon the chain is resolved.
CLASSIFICATION_NOT_APPLIED	The denormalized classification could not be applied to the name usage.
CLASSIFICATION_RANK_ORDER_INVALID	The given ranks of the names in the classification hierarchy do not follow the hierarchy of ranks.
CONFLICTING_BASIONYM_COMBINATION	There have been more than one accepted name in a homotypical basionym group of names.
DESCRIPTION_INVALID	At least one description extension record attached to this name usage is invalid.
DISTRIBUTION_INVALID	At least one distribution extension record attached to this name usage is invalid.
HOMONYM	A not synonymized homonym exists for this name in some other backbone source which have been ignored at build time.
MULTIMEDIA_INVALID	At least one multimedia extension record attached to this name usage is invalid.
NAME_PARENT_MISMATCH	The (accepted) bi/trinomial name does not match the parent name and should be recombined into the parent genus/species.
NO_SPECIES	The group (currently only genera are tested) are lacking any accepted species GBIF backbone specific issue.
NOMENCLATURAL_STATUS_INVALID	dwc:nomenclaturalStatus could not be interpreted
ORIGINAL_NAME_DERIVED	Record has a original name (basionym) relationship which was derived from name & authorship comparison, but did not exist explicitly in the data.
ORIGINAL_NAME_NOT_UNIQUE	Record has a verbatim original name (basionym) which is not unique and refers to several records.
ORIGINAL_NAME_USAGE_ID_INVALID	The value for dwc:originalNameUsageID could not be resolved.
ORTHOGRAPHIC_VARIANT	A potential orthographic variant exists in the backbone.
PARENT_CYCLE	The child parent classification resulted into a cycle that needed to be resolved/cut.
PARENT_NAME_NOT_UNIQUE	Record has a verbatim parent name which is not unique and refers to several records.
PARENT_NAME_USAGE_ID_INVALID	The value for dwc:parentNameUsageID could not be resolved.
PARTIALLY_PARSABLE	The beginning of the scientific name string was parsed, but there is additional information in the string that was not understood.
PUBLISHED_BEFORE_GENUS	A bi/trinomial name published earlier than the parent genus was published.
RANK_INVALID	dwc:taxonRank could not be interpreted
RELATIONSHIP_MISSING	There were problems representing all name usage relationships, i.e.
SCIENTIFIC_NAME_ASSEMBLED	The scientific name was assembled from the individual name parts and not given as a whole string.
SPECIES_PROFILE_INVALID	At least one species profile extension record attached to this name usage is invalid.
TAXONOMIC_STATUS_INVALID	dwc:taxonomicStatus could not be interpreted
TAXONOMIC_STATUS_MISMATCH
UNPARSABLE	The scientific name string could not be parsed at all, but appears to be a parsable name type, i.e.
VERNACULAR_NAME_INVALID	At least one vernacular name extension record attached to this name usage is invalid.

Method Summary

Modifier and Type	Method	Description
String	getId()	Returns the identifier of the InterpretationRemark.
Set<Term>	getRelatedTerms()	Set containing the Term considered to flag this remark.
InterpretationRemarkSeverity	getSeverity()	Returns the default severity of this InterpretationRemark.
boolean	isDeprecated()	Checks if the InterpretationRemark is deprecated or not.
static NameUsageIssue	valueOf(String name)	Returns the enum constant of this class with the specified name.
static NameUsageIssue[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class java.lang.Enum

compareTo, describeConstable, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

PARENT_NAME_USAGE_ID_INVALID

public static final NameUsageIssue PARENT_NAME_USAGE_ID_INVALID

The value for dwc:parentNameUsageID could not be resolved.

ACCEPTED_NAME_USAGE_ID_INVALID

public static final NameUsageIssue ACCEPTED_NAME_USAGE_ID_INVALID

The value for dwc:acceptedNameUsageID could not be resolved.

ORIGINAL_NAME_USAGE_ID_INVALID

public static final NameUsageIssue ORIGINAL_NAME_USAGE_ID_INVALID

The value for dwc:originalNameUsageID could not be resolved.

ACCEPTED_NAME_MISSING

public static final NameUsageIssue ACCEPTED_NAME_MISSING

Synonym lacking an accepted name.

RANK_INVALID

public static final NameUsageIssue RANK_INVALID

dwc:taxonRank could not be interpreted

NOMENCLATURAL_STATUS_INVALID

public static final NameUsageIssue NOMENCLATURAL_STATUS_INVALID

dwc:nomenclaturalStatus could not be interpreted

TAXONOMIC_STATUS_INVALID

public static final NameUsageIssue TAXONOMIC_STATUS_INVALID

dwc:taxonomicStatus could not be interpreted

SCIENTIFIC_NAME_ASSEMBLED

public static final NameUsageIssue SCIENTIFIC_NAME_ASSEMBLED

The scientific name was assembled from the individual name parts and not given as a whole string.

CHAINED_SYNOYM

public static final NameUsageIssue CHAINED_SYNOYM

If a synonym points to another synonym as its accepted taxon the chain is resolved.

BASIONYM_AUTHOR_MISMATCH

public static final NameUsageIssue BASIONYM_AUTHOR_MISMATCH

The authorship of the original name does not match the authorship in brackets of the actual name.

TAXONOMIC_STATUS_MISMATCH

public static final NameUsageIssue TAXONOMIC_STATUS_MISMATCH

PARENT_CYCLE

public static final NameUsageIssue PARENT_CYCLE

The child parent classification resulted into a cycle that needed to be resolved/cut.

CLASSIFICATION_RANK_ORDER_INVALID

public static final NameUsageIssue CLASSIFICATION_RANK_ORDER_INVALID

The given ranks of the names in the classification hierarchy do not follow the hierarchy of ranks.

CLASSIFICATION_NOT_APPLIED

public static final NameUsageIssue CLASSIFICATION_NOT_APPLIED

The denormalized classification could not be applied to the name usage. For example if the id based classification has no ranks.

VERNACULAR_NAME_INVALID

public static final NameUsageIssue VERNACULAR_NAME_INVALID

At least one vernacular name extension record attached to this name usage is invalid.

DESCRIPTION_INVALID

public static final NameUsageIssue DESCRIPTION_INVALID

At least one description extension record attached to this name usage is invalid.

DISTRIBUTION_INVALID

public static final NameUsageIssue DISTRIBUTION_INVALID

At least one distribution extension record attached to this name usage is invalid.

SPECIES_PROFILE_INVALID

public static final NameUsageIssue SPECIES_PROFILE_INVALID

At least one species profile extension record attached to this name usage is invalid.

MULTIMEDIA_INVALID

public static final NameUsageIssue MULTIMEDIA_INVALID

At least one multimedia extension record attached to this name usage is invalid. This covers multimedia coming in through various extensions including Audubon core, Simple images or multimedia or EOL media.

BIB_REFERENCE_INVALID

public static final NameUsageIssue BIB_REFERENCE_INVALID

At least one bibliographic reference extension record attached to this name usage is invalid.

ALT_IDENTIFIER_INVALID

public static final NameUsageIssue ALT_IDENTIFIER_INVALID

At least one alternative identifier extension record attached to this name usage is invalid.

BACKBONE_MATCH_NONE

public static final NameUsageIssue BACKBONE_MATCH_NONE

Name usage could not be matched to the GBIF backbone.

BACKBONE_MATCH_FUZZY

@Deprecated
public static final NameUsageIssue BACKBONE_MATCH_FUZZY

Deprecated.

because there should be no fuzzy matching being used anymore for matching checklist names

Name usage could only be matched to the GBIF backbone using fuzzy matching.

BACKBONE_MATCH_AGGREGATE

public static final NameUsageIssue BACKBONE_MATCH_AGGREGATE

Name usage could only be matched to a GBIF backbone species, but was in fact a broader species aggregate/complex.

See Also:

• gbif/portal-feedback#2935

ACCEPTED_NAME_NOT_UNIQUE

public static final NameUsageIssue ACCEPTED_NAME_NOT_UNIQUE

Synonym has a verbatim accepted name which is not unique and refers to several records.

PARENT_NAME_NOT_UNIQUE

public static final NameUsageIssue PARENT_NAME_NOT_UNIQUE

Record has a verbatim parent name which is not unique and refers to several records.

ORIGINAL_NAME_NOT_UNIQUE

public static final NameUsageIssue ORIGINAL_NAME_NOT_UNIQUE

Record has a verbatim original name (basionym) which is not unique and refers to several records.

RELATIONSHIP_MISSING

public static final NameUsageIssue RELATIONSHIP_MISSING

There were problems representing all name usage relationships, i.e. the link to the parent, accepted and/or original name. The interpreted record in ChecklistBank is lacking some of the original source relation.

ORIGINAL_NAME_DERIVED

public static final NameUsageIssue ORIGINAL_NAME_DERIVED

Record has a original name (basionym) relationship which was derived from name & authorship comparison, but did not exist explicitly in the data. This should only be flagged in programmatically generated GBIF backbone usages. GBIF backbone specific issue.

CONFLICTING_BASIONYM_COMBINATION

public static final NameUsageIssue CONFLICTING_BASIONYM_COMBINATION

There have been more than one accepted name in a homotypical basionym group of names. GBIF backbone specific issue.

NO_SPECIES

public static final NameUsageIssue NO_SPECIES

The group (currently only genera are tested) are lacking any accepted species GBIF backbone specific issue.

NAME_PARENT_MISMATCH

public static final NameUsageIssue NAME_PARENT_MISMATCH

The (accepted) bi/trinomial name does not match the parent name and should be recombined into the parent genus/species. For example the species Picea alba with a parent genus Abies is a mismatch and should be replaced by Abies alba. GBIF backbone specific issue.

ORTHOGRAPHIC_VARIANT

public static final NameUsageIssue ORTHOGRAPHIC_VARIANT

A potential orthographic variant exists in the backbone. GBIF backbone specific issue.

HOMONYM

public static final NameUsageIssue HOMONYM

A not synonymized homonym exists for this name in some other backbone source which have been ignored at build time.

PUBLISHED_BEFORE_GENUS

public static final NameUsageIssue PUBLISHED_BEFORE_GENUS

A bi/trinomial name published earlier than the parent genus was published. This might indicate that the name should rather be a recombination.

UNPARSABLE

public static final NameUsageIssue UNPARSABLE

The scientific name string could not be parsed at all, but appears to be a parsable name type, i.e. it is not classified as a virus or hybrid formula.

PARTIALLY_PARSABLE

public static final NameUsageIssue PARTIALLY_PARSABLE

The beginning of the scientific name string was parsed, but there is additional information in the string that was not understood.

Method Details

values

public static NameUsageIssue[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static NameUsageIssue valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

getId

public String getId()

Description copied from interface: InterpretationRemark

Returns the identifier of the InterpretationRemark. This is normally implemented to return the result of Enum.name(). Potential name clashes are detected by unit tests.

Specified by:

getId in interface InterpretationRemark

Returns:

identifier of the InterpretationRemark. Never null.

getRelatedTerms

public Set<Term> getRelatedTerms()

Description copied from interface: InterpretationRemark

Set containing the Term considered to flag this remark.

Specified by:

getRelatedTerms in interface InterpretationRemark

Returns:

Set of Term or empty Set. Never null.

getSeverity

public InterpretationRemarkSeverity getSeverity()

Description copied from interface: InterpretationRemark

Returns the default severity of this InterpretationRemark. Severity can be relative to the context and profile. This InterpretationRemarkSeverity should be seen as the default severity in the general context of interpretation.

Specified by:

getSeverity in interface InterpretationRemark

Returns:

default severity of this InterpretationRemark. Never null.

isDeprecated

public boolean isDeprecated()

Description copied from interface: InterpretationRemark

Checks if the InterpretationRemark is deprecated or not.

Specified by:

isDeprecated in interface InterpretationRemark

Returns:

true if the InterpretationRemark is marked with @Deprecated.