Bug #4951

Add "?" help buttons/info on the annotation tabs

Added by ben leinfelder over 10 years ago. Updated over 10 years ago.

Morpho Plugin
Target version:
Start date:
Due date:
% Done:


Estimated time:


Full, Column and Context tabs all need help buttons to walk future users through the UI/annotation process.
There is help content accessible via the "Annotate Current Column..." dialog which could be used in these other locations.


#1 Updated by ben leinfelder over 10 years ago

Made the help dialog accessible from buttons/links on:
-Full Annotation tab
-Column Annotation tab
-Context Annotation tab
-Annotate Current Column... dialog window

The content of the help widow (there are also bold terms not seen here):
Help with Semantic Annotations

The Measurement defines rules for what Characteristics of which Entities can be taken using certain Standards and Protocols.

The Entity is the 'thing' being observed. If the diameter of a tree is measured, the Entity will be the tree.

The Characteristic is the property being measured. If the diameter of a tree is measured, the Characteristic will be the diameter (length).

The Standard is the unit used for the measurement. If the diameter of a tree is measured, the Standard will be a length unit (meters).

The Protocol is the method used for taking the measurement. If the diameter of a tree is measured at breast height, this will be the Protocol.

Context defines the relationship between two Observation Entities. If a Tree (observation 1) is located in a Plot (observation 2) the Context might be 'Tree isWithin Plot'.

Measurement (Is Key)
The measurement 'iskey' attribute in the annotation syntax is a constraint, much like (primary) key constraints in relational databases. A measurement 'isKey = yes' constraint states that a particular measurement (characteristic-value pair) determines the identity of the corresponding entity instance. For example, if we have a plot entity with a label characteristic measurement, and state that this measurement is a key, then each occurrence of the label value in a row of the dataset relates to the same entity instance (see example below). For instance, each site label '1' would denote a unique site instance, each site label '2' would denote a different site instance, and so on. If multiple measurements in an observation have an 'isKey = yes' constraint, then each measurement serves as a partial key, i.e., the identity of the entity instance is determined by a combination of the corresponding characteristic-value pairs (and not by just one of the pairs).

Observation (Is Distinct)
The observation 'isDistinct=yes' constraint is somewhat similar, but promoted to the level of the observation. It states that if two of the observation instances are of the same entity instance, then the these observation instances are the same instance (i.e., there is only one 'distinct' or 'unique' observation).

#2 Updated by Redmine Admin over 7 years ago

Original Bugzilla ID was 4951

Also available in: Atom PDF