tdwg / bdq

Biodiversity Data Quality (BDQ) Interest Group
https://github.com/tdwg/bdq
43 stars 7 forks source link

TG2-VALIDATION_FAMILY_NOTEMPTY #215

Closed Tasilee closed 9 months ago

Tasilee commented 10 months ago
TestField Value
GUID 5bfa043c-1e19-4224-8d55-b568ced347c2
Label VALIDATION_FAMILY_NOTEMPTY
Description Is there a value in dwc:family?
TestType Validation
Darwin Core Class Taxon
Information Elements ActedUpon dwc:family
Information Elements Consulted dwc:taxonRank
Expected Response INTERNAL_PREREQUISITES_NOT_MET if dwc:family is bdq:Empty and dwc:taxonRank contains a value that is not interpretable as a taxon rank; COMPLIANT if dwc:family is bdq:NotEmpty, or dwc:family is bdq:Empty and the value in dwc:taxonRank is higher than family; otherwise NOT_COMPLIANT.
Data Quality Dimension Completeness
Term-Actions FAMILY_NOTEMPTY
Parameter(s)
Source Authority
Specification Last Updated 2024-07-17
Examples [dwc:family="family": Response.status=RUN_HAS_RESULT, Response.result=COMPLIANT, Response.comment="dwc:family is bdq:NotEmpty"]
[dwc:family="": Response.status=RUN_HAS_RESULT, Response.result=NOT_COMPLIANT, Response.comment="dwc:family is bdq:Empty"]
Source TG2
References
Example Implementations (Mechanisms) Kurator/FilteredPush sci_name_qc Library
Link to Specification Source Code https://github.com/FilteredPush/sci_name_qc/blob/v1.1.2/src/main/java/org/filteredpush/qc/sciname/DwCSciNameDQ.java#L3494
Notes Family is expected to be empty when an identification is only to a rank higher than Family. This bdq:Supplementary test is not regarded as CORE (cf. bdq:CORE) because of one or more of the reasons: not being widely applicable; not informative; not straightforward to implement or likely to return a high percentage of either bdq:COMPLIANT or bdq:NOT_COMPLIANT results (cf bdq:Response.result). A Supplementary test may be implemented as CORE when a suitable use case exists.
Tasilee commented 5 months ago

Changed Expected Response from

COMPLIANT if dwc:family is not EMPTY; otherwise NOT_COMPLIANT

to

INTERNAL_PREREQUISITES_NOT_MET if dwc:family is EMPTY or dwc:taxonRank contains a value that is not interpretable as a taxon rank; COMPLIANT if the value in dwc:taxonRank is higher than family or if dwc:family is not EMPTY; otherwise NOT_COMPLIANT.

Tasilee commented 5 months ago

Changed Expected Response from

INTERNAL_PREREQUISITES_NOT_MET if dwc:family is EMPTY or dwc:taxonRank contains a value that is not interpretable as a taxon rank; COMPLIANT if the value in dwc:taxonRank is higher than family or if dwc:family is not EMPTY; otherwise NOT_COMPLIANT.

to

INTERNAL_PREREQUISITES_NOT_MET if dwc:family is EMPTY and dwc:taxonRank contains a value that is not interpretable as a taxon rank; COMPLIANT if dwc:family is not EMPTY, or dwc:family is EMPTY and the value in dwc:taxonRank is higher than family; otherwise NOT_COMPLIANT.