TG2 OLD (2022-02-20) - Develop a VOCABULARY that covers the terms used within TG2

[ArthurChapman]

This is a copy of #152 from about 20 February 2022. This is an Archive copy for comparative purposes only.

Terms in UPPER CASE are a Response (q.v.) or an Information Element (q.v.) or part of the name of a test; terms in Italic are from the FFU Framework (Viega et al. 2017). Use the reference to the Framework Definitions for more details and examples.

Term	Definition	Comment
AMBIGUOUS	A Response (q.v.) where a value is open to more than one interpretation; not having one obvious meaning.
Ambiguous	A Warning Type (q.v.) used to report where the Data Quality Dimension: Conformance (q.v.) is not satisfied due to Information Elements (q.v.) not being unambiguously resolvable by a specified source authority (q.v.).	Is this one that should be added to the Framework?
Amended	A Warning Type (q.v.) used to report on a recommended change to a record.
Amendment	From the FFU FrameworkFrom: Data were amended by modification or addition of a value or values following defined Criteria (q.v.).	#164
ASSUMEDDEFAULT	A Response (q.v.) in which an Amendment recommends that a predefined default value be added to a record where the Information Element (q.v.) is either empty or uninterpretable.
bdq:isMarine	An Information Element (q.v.) that is used as an indicator whether the record pertains to a marine environment. May be defined by reference to a source authority (q.v.) which lists marine taxa (example see test #51).	See Issue #51
bdq:earliestValidDate	A Parameter (q.v.) that optionally establishes the earliest date in a parameterized test. A default date is supplied in cases where a parameter is not set at the time the test is run.
bdq:latestValidDate	A Parameter (q.v.) that optionally establishes the latest date in a parameterized test. A default date is supplied in cases where a parameter is not set at the time the test is run.
bdq:maximumValidDepthInMeters	A Parameter (q.v.) that optionally establishes the maximum depth in a parameterized test. A default depth is supplied in cases where a parameter is not set at the time the test is run.
bdq:maximumValidElevationInMeters	A Parameter (q.v.) that optionally establishes the highest elevation in a parameterized test. A default elevation is supplied in cases where a parameter is not set at the time the test is run.
bdq:minimumValidDepthInMeters	A Parameter (q.v.) that optionally establishes the minimum depth in a parameterized test. A default depth is supplied in cases where a parameter is not set at the time the test is run.
bdq:minimumValidElevationInMeters	A Parameter (q.v.) that optionally establishes the lowest elevation in a parameterized test (q.v.). A default elevation is supplied in cases where a parameter is not set at the time the test is run.
bdq:sourceAuthority	A Parameter (q.v.) that identifies a target source authority (q.v.) for use in a test. Where the test is a paramaterized test (q.v.) a default source authority ("bdq:sourceAuthority (default = xxx)") is specified.
bdq:useEarliestValidDate	A Parameter (q.v.) that, when equal to true, asserts that the bdq:earliestValidDate (q.v.) should be applied in the test where its application is optional, if no value is provided, then the default value is applied. When the bdq:useEarliestValidDate has a value equal to false, then bdq:earliestValidDate is not tested for.
bdq:useLatestValidDate	A Parameter (q.v.) that, when equal to true, asserts that the bdq:latestValidDate (q.v.) should be applied in the test where its application is optional, if no value is provided, then the default value is applied. When the bdq:useLatestValidDate has a value equal to false, then bdq:latestValidDate is not tested for.
bdq:useMaximumValidDepthInMeters	A Parameter (q.v.) that, when equal to true, asserts that the bdq:maximumValidDepthInMeters (q.v.) should be applied in the test where its application is optional, if no value is provided, then the default value is applied. When the bdq:useMaximumValidDepthInMeters has a value equal to false, then bdq:maximumValidDepthInMeters is not tested for.
bdq:useMaximumValidElevationInMeters	A Parameter (q.v.) that, when equal to true, asserts that the bdq:maximumValidElevationInMeters (q.v.) should be applied in the test where its application is optional, if no value is provided, then the default value is applied. When the bdq:useMaximumValidElevationInMeters has a value equal to false, then bdq:maximumValidElevationInMeters is not tested for.
bdq:useMinimumValidDepthInMeters	A Parameter (q.v.) that, when equal to true, asserts that the bdq:minimumValidDepthInMeters (q.v.) should be applied in the test where its application is optional, if no value is provided, then the default value is applied. When the bdq:useMinimumValidDepthInMeters has a value equal to false, then bdq:minimumValidDepthInMeters is not tested for.
bdq:useMinimumValidElevationInMeters	A Parameter (q.v.) that, when equal to true, asserts that the bdq:minimumValidElevationInMeters (q.v.) should be applied in the test where its application is optional, if no value is provided, then the default value is applied. When the bdq:useMinimumValidElevationInMeters has a value equal to false, then bdq:minimumValidElevationInMeters is not tested for.
Completeness	From the FFU Framework: A Data Quality Dimension (q.v.) - the extent to which data are present and sufficiently comprehensive for use.	from: #164, https://tdwg.github.io/bdq/tg1/site/glossary.htm
Conformance	From the FFU Framework: A Data Quality Dimension (q.v.) - conforms to a format, syntax, type, range, standard, or to the own nature of the Information Element (q.v.).	from: #164, https://tdwg.github.io/bdq/tg1/site/glossary.htm
COMPLIANT	A Response (q.v.) whereby data that were validated were found to be compliant with the test Criteria (q.v.).	NB This differs slightly from current FFU Framework Definition at #164
Consistency	From the FFU Framework: A Data Quality Dimension (q.v.) - agreement among related Information Elements (q.v.) in the data.	from: #164
CONVERTED	A Response (q.v.) that implies that a conversion has been made within defined Information Elements (q_.v._) to conform with a targeted reference system.	See #43
COORDINATES	An Information Element (q.v.) that represents the combination of the Darwin Core terms dwc:decimalLatitude and dwc:decimalLongitude.
CORE	Of tests: Essential or priority (e.g., most common research uses of biodiversity data, or use case formed by the most important needs analyzed by user stories).
Criteria (Criterion)	From the FFU Framework: Statement that describes acceptable levels of data quality (e.g., data are consistent, value is in controlled vocabulary).	from: https://tdwg.github.io/bdq/tg1/site/glossary.htm
Data Quality Dimension	From the FFU Framework: Measurable quality Criterion (q.v.).	Slightly different to Framework definition from: https://tdwg.github.io/bdq/tg1/site/glossary.htm
DETECTED	A Response (q.v.) that identifies the presence of an illegal value in any one of a defined number of Information Elements (q.v.) (example, see test #97).	see #97
Default source authority	A default where a required Parameter (q.v.) or a source authority (q.v.) has not been provided.
Default value	A default value (e.g. year, elevation) where a required Parameter (q.v.) has not been provided.
EMPTY	A field that is either not present or does not contain any characters or values. Note: A field containing non-printing or other invalid characters or values (including NULL values) may be separately detected.	see discussion in #111
EXTERNAL_PREREQUISITES_NOT_MET	From the FFU Framework: A Response (q.v.) was not generated because an external prerequisite was not met (e.g., a targeted source authority (q.v.) resource could not be found).	See #164
FILLED_IN	A Response (q.v.) that indicates that a term contained no value, and that a value has been proposed.
GEOGRAPHY	An Information Element (q.v.) that represents the combination of Darwin Core administrative geography terms dwc:continent, dwc:country, dwc:countryCode, dwc:stateProvince, dwc:county, dwc:municipality.
GUID	Globally Unique Identifier. It is a 128-bit Universal Unique Identifier (UUID) used to identify resources.
Incomplete	A Warning Type (q.v.) used to report on a record where the Information Element (q.v.) is Empty (q.v.).	Is this one that should be in Framework?
INCONSISTENT	A Response (q.v.) that identifies the presence of a value in one Information Element (q.v.) that is inconsistent with values in one or more other Information Elements (q.v.) in the record.
Inconsistent	A Warning Type (q.v.) used to report where the Data Quality Dimension: Consistency (q.v.) is not satisfied due to inconsistent values between the different Information Elements (q.v.) of the record.	Should this be added to the Framework?
Information Element	From the FFU Framework: An abstraction that represents relevant content (e.g., coordinates).	Modified from the Framework https://tdwg.github.io/bdq/tg1/site/glossary.html
INTERNAL_PREREQUISITES_NOT_MET	From the FFU Framework: A Response (q.v.) was not generated because an internal prerequisite was not met (e.g., a field required to run a test was missing or empty).	See #164
Invalid	A Warning Type (q.v.) used to report where the Data Quality Dimension: Conformance (q.v.) is not satisfied due to Information Elements (q.v.) containing non-standard values, values outside of an acceptable range, or unable to be found in a specified source authority (q.v.).	Is this one that should be in the Framework?
Likeliness	From the FFU Framework: A Data Quality Dimension (q.v.) - probability of data having the expected value; the likelihood of a data having true values rather than having false values.	from #164
Measure	A summary of the number of test of type Validation (q.v.) run with the expected Response (q.v.) of "Compliant", "Not compliant", and "Prerequisites not met" and the number of tests of type Amendment (q.v.) run with the expected Response (q.v.) of "Prerequisites not met" and "Proposed".	NB This differs from the Framework (https://tdwg.github.io/bdq/tg1/site/glossary.html)
NOTEMPTY	A field that is present and has content.
NOTFOUND	A Response (q.v.) that refers to the value in an Information Element (q.v.) not being found in a specified source authority (q.v.).
Notification	Flags a potential issue where data remains valid. It has only one Response (q.v.). For example, "dwc:dataGeneralizations=not empty" flags to the user that the data may have been generalized.	Should this be one for the Framework?
NOTSTANDARD	A Response (q.v.) that signifies that the value in an Information Element (q.v.) is not an allowed value, or is not a value found in a specified source authority (q.v.)
OUTOFRANGE	A Response (q.v.) that refers to the value in an Information Element (q.v.) being outside an acceptable range for that Information Element (q.v.).
Parameter	Either 1) a link to a source authority (q.v.) from which to find matching values, or 2) a value that can be used to define limits for an Information Element (q.v.).
paramaterized test	A test that requires a parameter (q.v.) to be set prior to the test being run. Where a parameter (q.v.) has not been set, a default is specified.
POLYNOMIAL	An Information Element (q.v.) that represents a combination of the Darwin Core terms dwc:genus, dwc:specificEpithet, dwc:infraspecificEpithet.
PRECISIONINSECONDS	A Response (q.v.) that measures the length of the period of an event in seconds (see test #140).
PREREQUISITESNOTMET	A Response (q.v.) that refers in a test of type Measure (q.v.) to the number of tests of type Validation (q.v.) that did not run due to one or more prerequisites not being met.	See #134 If used, could be superclass for INTERNAL/DATA_PREREQUISITES_NOT_MET and EXTERNAL_PREREQUISITES_NOT_MET
PROPOSED	A Response (q.v.) in a Measure (q.v.) test that pertains to an Amendment (q.v.) where an action is recommended to modify a record in some way through a change or addition (example, see test #65).
Reliability	From the FFU Framework: A Data Quality Dimension (q.v.). Measure of how the data values agree with an identified source of truth. The degree to which data correctly describes the truth (object, event or any abstract or real "thing").	from #164
REPORT	A Response (q.v.) reporting on the status from a test of type Measure (q.v.).
Resolution	From the FFU Framework: A Data Quality Dimension (q.v.) that refers to the data having sufficiently detailed information. Measure of the granularity of the data, or the smallest measurable increment.	from: #164, https://tdwg.github.io/bdq/tg1/site/glossary.html
resolvable	A Response (q.v.) whereby one is able to reach a decision, or make a determination (for example, through access to a source authority (q.v.) (example, see test #121).	See #121 Do we need definition or is it obvious?
Response	A reported result from running a test.	@chicoreus to check definition related to RESULT_STATUS of Framework
single record	From the FFU Framework: a single record from a dataset.	from: https://tdwg.github.io/bdq/tg1/site/glossary.html
source authority	A Parameter (q.v.). A vocabulary or standard to which the values in an Information Element (q.v.) are referred.
STANDARDIZED	A Response (q.v.) where a value in an Information Element (q.v.) is recommended from a specified source authority (q.v.).
TERRESTRIALMARINE	A Response (q.v.) where a terrestrial taxon has geographic coordinates that fall within terrestrial boundaries; or a marine taxon that has geographic coordinates that fall within marine boundaries.
test prerequisite	Prerequisites to the test being run in the form of: fields having values, tests that need to be run before the current test, availability of a specified source authority (q.v.), etc.
TRANSPOSED	A Response (q.v.) whereby the geographic coordinates (latitude and longitude values) have been swapped or the coordinate signs reversed (example, see test #54).	see Tests #54
Unlikely	A Warning Type (q.v.) used to report where the Data Quality Dimension: Likelihood (q.v.) is not satisfied due to Information Elements (q.v.) containing values that are not likely to occur (for example where the geographic coordinates are "0", "0").	Should this be in the Framework?
Validation	A set of tests on one or more Darwin Core terms within a single record (q.v.) based on defined Criteria (q.v.) and with a Response (q.v.) of either Compliant (q.v.) or Not_Compliant.	Varies from the definition in the Framework (https://tdwg.github.io/bdq/tg1/site/glossary.html).
VERBATIM	An Information Element (q.v.) as in the original wording of the value in the respective Darwin Core term: dwc:verbatimCoordinates, dwc:verbatim:dwc:EventDate, dwc:verbatimElevation, or dwc:verbatimDepth.
Warning Type	Warning assertion resulting from running a test, one of: Ambiguous (q.v.), Amended (q.v.), Incomplete (q.v.), Inconsistent (q.v.), Invalid (q.v.), Notification (q.v.), Report (q.v.), Unlikely (q.v.).
YEARMONTHDAY	An Information Element (q.v.) which represents a combination of the Darwin Core terms dwc:year, dwc:month, dwc:day.
YEARSTARTDAYOFYEARENDDAYOFYEAR	An Information Element (q.v.) which represents a combination of the Darwin Core terms dwc:year, dwc:startDayOfYear, dwc:endDayofYear.