dwc icon indicating copy to clipboard operation
dwc copied to clipboard

Change term - measurementUnit: use at least one SI example

Open peterdesmet opened this issue 3 years ago • 5 comments

Term change

  • Submitter: @damianooldoni @peterdesmet
  • Efficacy Justification (why is this change necessary?): The comments for measurementUnit state: "Recommended best practice is to use the International System of Units (SI)." However, none of the examples (mm, C, km, ha) are one of the 7 base SI units, although mm and km are SI units with prefixes. It would be good to have at least m (meter) as first example, which use is widespread as measurementUnit. In addition, it would be good to have an example of a squared unit (e.g. km²) showing that a superscripted 2 is available in UTF8.
  • Demand Justification (if the change is semantic in nature, name at least two organizations that independently need this term): no explicit demand, but e.g. use of m is widespread, so would be helpful to have that as a base SI example
  • Stability Justification (what concerns are there that this might affect existing implementations?):
  • Implications for dwciri: namespace (does this change affect a dwciri term version)?: yes, although currently no examples are listed for https://dwc.tdwg.org/terms/#dwciri:measurementUnit

Current Term definition: https://dwc.tdwg.org/list/#dwc_measurementUnit

Proposed attributes of the new term version (Please put actual changes to be implemented in bold and ~strikethrough~):

  • Term name (in lowerCamelCase for properties, UpperCamelCase for classes):
  • Organized in Class (e.g., Occurrence, Event, Location, Taxon):
  • Definition of the term (normative):
  • Usage comments (recommendations regarding content, etc., not normative):
  • Examples (not normative): ~mm, C, km, ha~ → m, mm, km², C
  • Refines (identifier of the broader term this term refines; normative):
  • Replaces (identifier of the existing term that would be deprecated and replaced by this term; normative):
  • ABCD 2.06 (XPATH of the equivalent term in ABCD or EFG; not normative):

peterdesmet avatar Apr 08 '22 07:04 peterdesmet

Assuming C is intended to be degrees Celcius, °C is the unit. (C means coulombs, the SI unit of electric charge.)

Some other common units in GBIF data: %, percent, Percentages, hh:mm:ss, per mille, date, ppb, inches.

MattBlissett avatar Apr 08 '22 08:04 MattBlissett

I guess we need to decide how serious we are about the meaning of "SI" because the actual SI unit of temperature is kelvin (K), but people do not typically use it in everyday life.

baskaufs avatar Apr 09 '22 16:04 baskaufs

The degree Celsius is an SI derived unit, these are included in my understanding of "SI units". Minutes, hours, days, litres, hectares and tonnes are also acceptable.

Conversions between any of these can be done automatically. It's non-SI units that can have conflicting abbreviations or sizes that are most important to avoid.

MattBlissett avatar Apr 11 '22 15:04 MattBlissett

This is an interesting case where maybe we could set a precedent by adding recommendations of what to avoid in a term comment along with positive examples.

tucotuco avatar Apr 11 '22 15:04 tucotuco

@tucotuco wrote:

adding recommendations of what to avoid in a term comment along with positive examples.

Pedagogically-speaking, excellent. The "not" case/s often very informative in helping to clarify what does "go in the box."

debpaul avatar Apr 11 '22 15:04 debpaul