Difference between revisions of "DECOR-dataset"

(Added timeStampPrecision)
(Added facet applicability)
Line 115: Line 115:
  
 
{| class="artdecor"
 
{| class="artdecor"
! align="left" width="10%" | Facet !! align="left" width="60%" | Description !! align="left" width="20%" | Example
+
! align="left" width="10%" | Facet !! align="left" width="40%" | Description !! align="left" width="20%" | Example !! align="left" width="30%" | Applies to
 
|-
 
|-
 
|unit
 
|unit
 
|Unit for quantities
 
|Unit for quantities
 
|kg, mmol
 
|kg, mmol
 +
|quantity
 
|-
 
|-
 
|minInclude
 
|minInclude
 
|Range min include for quantities
 
|Range min include for quantities
 
|1, 100
 
|1, 100
 +
|count, ordinal, quantity, currency
 
|-
 
|-
 
|maxInclude
 
|maxInclude
 
|Range max include for quantities
 
|Range max include for quantities
 
|1, 100
 
|1, 100
 +
|count, ordinal, quantity, currency
 
|-
 
|-
 
|fractionDigits
 
|fractionDigits
|Fraction digits for quantities, e.g. "1" for at least 1 or "1!" for exactly 1
+
|Fraction digits for quantities"1" for at least 1 or "1!" for exactly 1
|
+
|"1" for at least 1, "1!" for exactly 1
 +
|quantity
 
|-
 
|-
 
|timeStampPrecision
 
|timeStampPrecision
 
|Precisions for timing specs
 
|Precisions for timing specs
 
|
 
|
 +
|date, datetime
 
|-
 
|-
 
|default
 
|default
 
|Default value
 
|Default value
 
|
 
|
 +
|all datatypes
 
|-
 
|-
 
|fixed
 
|fixed
 
|Fixed value
 
|Fixed value
 
|
 
|
 +
|all datatypes
 
|-
 
|-
 
|minLength
 
|minLength
 
|Minimum length for strings
 
|Minimum length for strings
 
|
 
|
 +
|string
 
|-
 
|-
 
|maxLength
 
|maxLength
 
|Maximum length for strings
 
|Maximum length for strings
 
|
 
|
 +
|string
 
|}
 
|}
 +
Facet timeStampPrecision takes the following values
 +
{| class="artdecor"
 +
! align="left" | timeStampPrecision !! align="left" | value
  
{| class="artdecor"
 
! align="left" | timeStampPrecision values
 
 
|-
 
|-
 
|Y
 
|Y

Revision as of 08:21, 18 September 2013

A DECOR project contains one or more datasets. When there are multiple datasets, they are different versions of the same dataset. It is not recommended to create datasets for different healthcare projects in the same DECOR project.

A dataset consists of (healthcare) concepts. You can see a DECOR dataset as an hierarchical concept repository. Concepts should be well-defined and can be demonstrated with the following examples:

Examples
  • Female
  • Body length
  • Diabetes
  • Monochorionic

The following datatypes are available (items printed as bold are part of the current DECOR implementation).

Datatype Nederlands Deutsch Description
count teller Zähler Countable (non-monetary) quantities. Used for countable types such as:
  • pregnancies,
  • steps (taken by a physiotherapy patient),
  • number of cigarettes smoked in a day.
code code Code A system of valid symbols that substitute for specified concepts e.g. alpha, numeric, symbols and/or combinations, usually defined by a formal reference to a terminology or ontology, but may also be defined by the provision of text
ordinal ordinaal Ordinal Models rankings and scores, e.g. pain, Apgar values, etc, where there is a) implied ordering, b) no implication that the distance between each value is con- stant, and c) the total number of values is finite. Note that although the term ‘ordinal’ in mathematics means natural numbers only, here any integer is allowed, since negative and zero values are often used by medical professionals for values around a neutral point.

Examples of sets of ordinal values:

  • -3, -2, -1, 0, 1, 2, 3 -- reflex response values;
  • 0, 1, 2 -- Apgar score values
  • 1, 2, 3, 4,... -- ASA classification
  • I, II, III, IV, ... -- Tanner scale
identifier identificatie Identifikation Type for representing identifiers of real-world entities. Typical identifiers include drivers licence number, social security number, prescription id, order id, and so on.
string string Zeichenkette
text string met opmaak Zeichenkette mit Formatierung A text item, which may contain any amount of legal characters arranged as e.g. words, sentences etc. Visual formatting and hyperlinks may be included.
date datum Datum Represents an absolute point in time, as measured on the Gregorian calendar, and specified only to the day. Semantics defined by ISO 8601. Used for recording dates in real world time. The partial form is used for approximate birth dates, dates of death, etc.
datetime datum+tijd Datum+Zeit Represents an absolute point in time, specified to the second. Semantics defined by ISO 8601. Used for recording a precise point in real world time, e.g. the exact date and time of the birth of a baby, and for approximate time stamps, e.g. the origin of an history observation which is only partially known.
complex collectie van data Sammlung von Daten
quantity hoeveelheid Menge Quantitified type representing "scientific" quantities, i.e. quantities expressed as a magnitude and units.

There are some "special" quantities (used in healthcare), explained later:

  • for time durations duration shall be used
  • for monetary amounts currency shall be used
duration tijdsduur Dauer Is a quantity, represents a period of time with respect to a notional point in time, which is not specified. A sign may be used to indicate the duration is “backwards” in time rather than forwards.
boolean boolean Boolean Items which are truly boolean data, such as true/false or yes/no answers.
blob binair Binär Things that are typically stored as binary objects in the computer world and need to be rendered appropriately, e.g.
  • images: like X-rays, computertomographic images;
  • graphic: diagrams, graphs, mathematical curves, or the like – usually a vector image;
  • icons: a sign or representation that stands for its object by virtue of a resemblance or analogy to it
  • pictures: A visual representation of a person, object, or scene – usually a raster image.
currency valuta Währung Monetary quantities
ratio ratio Ratio A ratio of two Quantity values - a numerator and a denominator

The datatypes can be further restricted using the following datatype facets:

Facet Description Example Applies to
unit Unit for quantities kg, mmol quantity
minInclude Range min include for quantities 1, 100 count, ordinal, quantity, currency
maxInclude Range max include for quantities 1, 100 count, ordinal, quantity, currency
fractionDigits Fraction digits for quantities"1" for at least 1 or "1!" for exactly 1 "1" for at least 1, "1!" for exactly 1 quantity
timeStampPrecision Precisions for timing specs date, datetime
default Default value all datatypes
fixed Fixed value all datatypes
minLength Minimum length for strings string
maxLength Maximum length for strings string

Facet timeStampPrecision takes the following values

timeStampPrecision value
Y at least year (YYYY)
Y! only year (YYYY)
YM at least month (MM) and year (YYYY)
YM! only month (MM) and year (YYYY)
YMD at least day (DD), month (MM) and year (YYYY)
YMD! only day (DD), month (MM) and year (YYYY)
YMDHM at least day (DD), month (MM) and year (YYYY), hour (hh) and minute (mm)