head 1.16;
access;
symbols;
locks; strict;
1.16
date 2007.08.28.19.41.07; author GregorHagedorn; state Exp;
branches;
next 1.15;
1.15
date 2007.07.31.10.06.03; author GregorHagedorn; state Exp;
branches;
next 1.14;
1.14
date 2006.08.30.01.56.54; author DonovanSharp; state Exp;
branches;
next 1.13;
1.13
date 2006.07.13.05.38.34; author DonovanSharp; state Exp;
branches;
next 1.12;
1.12
date 2006.07.13.05.12.49; author KevinThiele; state Exp;
branches;
next 1.11;
1.11
date 2006.07.13.00.08.21; author KevinThiele; state Exp;
branches;
next 1.10;
1.10
date 2006.07.12.07.22.26; author DonovanSharp; state Exp;
branches;
next 1.9;
1.9
date 2006.07.12.05.59.28; author DonovanSharp; state Exp;
branches;
next 1.8;
1.8
date 2006.07.11.02.07.04; author DonovanSharp; state Exp;
branches;
next 1.7;
1.7
date 2006.07.07.01.19.15; author DonovanSharp; state Exp;
branches;
next 1.6;
1.6
date 2006.07.06.05.41.51; author DonovanSharp; state Exp;
branches;
next 1.5;
1.5
date 2006.07.05.02.00.30; author DonovanSharp; state Exp;
branches;
next 1.4;
1.4
date 2006.07.04.02.35.06; author DonovanSharp; state Exp;
branches;
next 1.3;
1.3
date 2006.06.23.06.09.06; author DonovanSharp; state Exp;
branches;
next 1.2;
1.2
date 2006.06.14.06.25.29; author DonovanSharp; state Exp;
branches;
next 1.1;
1.1
date 2006.06.09.06.02.25; author DonovanSharp; state Exp;
branches;
next ;
desc
@@
1.16
log
@none
@
text
@%META:TOPICINFO{author="GregorHagedorn" date="1188330067" format="1.1" version="1.16"}%
%META:TOPICPARENT{name="SddContents"}%
---++SDD Part 0: Introduction and Primer to the SDD Standard
---+++3.17 Descriptive concepts.
Descriptive Concepts in SDD comprise terminological and ontological elements used in descriptions that extend the simple characters and states defined in the <Characters> element. Core descriptive concepts include score modifiers, grouping concepts used in character trees, and "global" (re-useable) states.
Score modifiers are data elements used to modify a standard score (code) in a coded description. For example, flowers in Viola odorata are normally violet but rarely white. In a coded description, the state "white" of the character "Flower colour" can be annotated with the modifer "rarely". The modifer and its meaning are defined in <DescriptiveConcepts>.
Grouping concepts are used when characters (defined in <Characters>) are arranged into character trees (in <CharacterTrees>). For example, the characters "Eye colour" and "Eye shape" may be arranged under the grouping concept "Eyes". The concept is defined in <DescriptiveConcepts> and referenced in <CharacterTrees>.
Global states are states used in multiple places in a character list. For example, the states "blue" and "white" may be used to describe both scales and fins in descriptions of fish. The states may be defined in <DescriptiveConcepts> then referenced for several characters in <Characters>.
---++++3.17.1 Data modifier definitions.
In SDD all modifiers for probability (e.g. "possibly"), frequency (e.g. "rarely"), degree (e.g. "strongly"), timing (e.g. "when mature"), location (e.g. "at the base"), etc. are centrally managed using the <Modifers> element.
A simple SDD instance document for data modifiers (as used by Lucid ([[http://www.lucidcentral.org][www.lucidcentral.org]]) has the basic structure shown below and in Example 3.17.1.1.
%ATTACHURL%/modifier.gif
---+++++Example 3.17.1.1 - Describing the Lucid scoring model using the <modifiers> element.
The <Representation> element provides a label for a set of modifiers. This may be useful if the instance document includes multiple sets of modifiers for different purposes (e.g., "frequency modifiers", "certainty modifiers", "location modifiers", "color modifiers", "seasonal modifiers").
<ModifierClass> may optionally be used where interoperable specifications are desired. There are currently 6 modifier classes available:
* 1. Frequency (<ProportionRange> defines the frequency limits (between 0 and 1) for the modifier).
* 2. Certainty (<ProportionRange> defines the certainty limits (between 0 and 1) for the modifier. A range of 0 to 0 implies zero certainty = certainly false)
* 3. Seasonal (<ProportionRange> defines the range of dates for the modifier.)
* 4. Diurnal (<ProportionRange> defines the range of times for the modifier, using a 24 hour day).
* 5. !TreatAsMisinterpretation. With this set, the current modifier becomes one of a special class of misinterpretation modifiers. States to which such modifiers are added are known to be intentionally wrongly scored to accomodate known misunderstandings of the character under study. For example, bracts of a dogwood (Cornus)look like petals; this taxon may be scored as Petals: present (by misinterpretation) to accommodate likely misinterpretation of this feature by a user.
* 6. !OtherModifierClass (used for extensibility)
Modifiers may be assigned language specific labels and assigned usage for generation of natural language descriptions. Using a very simple grammar, the concatenation of these phrases yields a simple natural language description. See the example below.
---+++++Example 3.17.1.2 - Language specific labels and modifiers.
---++++3.17.2 Grouping concepts
Character hierarchies comprise a tree of nodes with characters at the end of each branch, as demonstrated in the example below.
%ATTACHURL%/character_trees_example.gif
Internal nodes in a character tree are not characters but grouping concepts. These are defined in the <DescriptiveConcepts> element and referenced within the <CharacterTree> element, as in the example below.
...etc
For more information on using groupinf concepts to build a character tree, see the topic [[CharacterHierarchies][Character Hierarchies]]
---++++3.17.3 Sharing states across characters (Concept States)
SDD provides a mechanism for defining state values that are reusable in multiple characters. For example the concept state 'blue' may be applied to many different colour descriptors such as "Eye colour', 'Fin colour' and 'Tail colour'. Similarly, the state "ovate" may be used for "Leaf shape", "Petal shape", "Seed shape" etc. Using concept states simplifies the management of terminology and improves data analysis, as states from different characters can be compared if they refer to identical concept states.
Concept states are defined in much the same way as local states (i.e. states defined within a character). Once defined, concept states are referenced in the definition of a character. The basic structure od SDD code for concept states has the basic structure shown below and in example 3.5.1.2.
%ATTACHURL%/conceptstates.gif
---+++++Example 3.17.3.1 - SDD representation of the categorical characters in 3.5.1.1.
...etc.
...
...etc.
In this example, the states "blue" and "white" are defined as <ConceptStates> within a descriptive concept. When the categorical character "Eye Colour" is defined in <Characters>, the concepts states are referenced (using their ids cs1 and cs2), instead of local states being defined.
%META:FILEATTACHMENT{name="character_trees_example.gif" attr="" autoattached="1" comment="" date="1152688237" path="character_trees_example.gif" size="3298" user="Main.DonovanSharp" version="1"}%
%META:FILEATTACHMENT{name="modifier.gif" attr="" autoattached="1" comment="" date="1152767342" path="modifier.gif" size="13983" user="Main.KevinThiele" version="4"}%
%META:FILEATTACHMENT{name="conceptstates.gif" attr="" autoattached="1" comment="" date="1152768861" path="conceptstates.gif" size="4253" user="Main.DonovanSharp" version="1"}%
%META:FILEATTACHMENT{name="descriptiveconcepts.gif" attr="" autoattached="1" comment="" date="1152680549" path="descriptiveconcepts.gif" size="3671" user="Main.DonovanSharp" version="3"}%
@
1.15
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="GregorHagedorn" date="1185876363" format="1.1" reprev="1.15" version="1.15"}%
d195 1
a195 1
...etc
d198 1
a198 1
d205 2
a206 6
d209 1
a209 1
...etc
d216 1
a216 3
In this example, the states "blue" and "white" are defined in <ConceptStates>. When the categorical character "Eye Colour" is defined in <Characters>, the concepts states are referenced (using their ids cs1 and cs2), instead of local states being defined.
The <Representation> element provides a label for the description. This may be useful if the instance document includes multiple descriptions for different purposes, or is intended for publication in multiple languages (see the topic [[SddLanguage][Language support in SDD]].
@
1.14
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1156903014" format="1.1" reprev="1.14" version="1.14"}%
d15 1
a15 1
---++++3.17.1 Data modifiers.
d26 1
a26 2
d64 1
d67 1
a67 7
The <Representation> element provides a label for the set of modifiers. This may be useful if the instance document includes multiple sets of modifiers for different purposes.
d69 1
a69 1
<ModifierClass> is used where interoperable specifications are needed. There are currently 6 modifier classes available:
d83 1
a83 4
d131 1
a131 4
d166 1
a166 1
---++++3.17.3 Concept States
a223 5
-- Main.DonovanSharp - 09 Jun 2006
@
1.13
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1152769114" format="1.1" reprev="1.13" version="1.13"}%
d5 1
a5 1
---+++4.8 Descriptive concepts.
d15 1
a15 1
---++++4.8.1 Data modifiers.
d19 1
a19 1
A simple SDD instance document for data modifiers (as used by Lucid ([[http://www.lucidcentral.org][www.lucidcentral.org]]) has the basic structure shown below and in Example 4.8.1.1.
d23 1
a23 1
---+++++Example 4.8.1.1 - Describing the Lucid scoring model using the <modifiers> element.
d86 1
a86 1
---+++++Example 4.8.1.2 - Language specific labels and modifiers.
d146 1
a146 1
---++++4.8.2 Grouping concepts
d178 1
a178 1
---++++4.8.3 Concept States
d186 1
a186 1
---+++++Example 3.5.1.2 - SDD representation of the categorical characters in 3.5.1.1.
@
1.12
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="KevinThiele" date="1152767569" format="1.1" reprev="1.12" version="1.12"}%
d161 1
a161 1
d166 1
a166 1
d182 1
a182 1
Concept states are defined in much the same way as local states (i.e. states defined within a character). Once defined, concept states are referenced in the definition of a character.
d184 2
d234 5
d243 1
@
1.11
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="KevinThiele" date="1152749301" format="1.1" reprev="1.11" version="1.11"}%
a14 2
%ATTACHURL%/descriptiveconcepts.gif
d233 1
d17 1
a17 1
In SDD all modifiers for probability, frequency ("rarely"), degree ("strongly", "weakly"), timing ("when mature"), location ("at the base"), etc. are centrally managed and may be centrally translated; probability, frequency, and by-misinterpretation modifiers further provide an analytical description.
d23 1
a23 1
---+++++Example 4.8.1.1 - Describing lucid scoring model using the modifiers element.
a25 1
a27 2
d75 1
a75 1
<Modifier class> is used where interoperable specifications are needed. There are currently 6 modifier classes available:
d81 2
a82 2
* 5. TreatAsMisinterpretation. With this set, the current modifier becomes one of a special class of misinterpretation modifiers. States to which such modifiers are added are known to be intentionally wrongly scored to accomodate known misunderstandings of the character under study. For example, bracts of a dogwood (Cornus)look like petals; this taxon may be scored as Petals: present (by misinterpretation) to accommodate likely misinterpretation of this feature by a user.
* 6. OtherModifierClass
d148 1
a148 1
Character hierarchies consist of a tree of nodes with characters at the end of each series, as demonstrated in the example below.
d152 1
a152 1
The nodes are not characters but grouping concepts which are defined within the <DescriptiveConcepts> element and referenced within the <CharacterTree> element, as in the example below.
a153 1
a170 1
a154 1
a156 1
a170 36
a202 1
InteractiveIdentification
...etc
a211 1
d176 4
a179 2
---++++4.8.3 ConceptStates
SDD provides a mechanism for defining state values that are reusable in multiple characters. For example the concept 'colour' can be applied to many different taxonomic descriptors including "petal', 'wing' and 'eye'. Other concept states, for example 'shape' and 'size' can also be applied to the same descriptors.
d182 1
a182 1
SDD provides a mechanism to centrally define state values that are reusable in multiple characters. For example the concept 'colour' can be applied to many different taxonomic descriptors including "petal', 'wing' and 'eye'. Other concept states, for example 'shape' and 'size' can also be applied to the same descriptors.
d184 1
d186 46
d235 1
a235 1
%META:FILEATTACHMENT{name="modifier.gif" attr="" autoattached="1" comment="" date="1152763362" path="modifier.gif" size="14754" user="Main.KevinThiele" version="3"}%
@
1.10
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1152688946" format="1.1" reprev="1.10" version="1.10"}%
d7 1
a7 1
The SDD [[DescriptiveConcepts][<DescriptiveConcepts>]] element expresses basic terminological concepts of a more general concept than "characters" (structural hierarchy, property hierarchy, methods). In SDD, the concepts expressed in such hierarchies are defined here, and their relation to the characters (defined in [[CharacterHierarchies][<CharacterTrees>]]).
d9 1
a9 1
%ATTACHURL%/descriptiveconcepts.gif
d11 1
d13 1
d15 1
a15 1
Descriptive concepts contains data modifiers, for example the multiple scoring types used by Lucid, grouping concepts (such as the nodes in [[CharacterHierarchies][Character hierarchies]]), and concept states, a method for defining reuseable concepts.
@
1.9
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1152683968" format="1.1" reprev="1.9" version="1.9"}%
d153 70
d226 1
d232 1
@
1.8
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1152583624" format="1.1" version="1.8"}%
d13 1
a13 1
Descriptive concepts contains data modifiers, for example the multiple scoring types used by Lucid, and concept states, a method for defining reuseable concepts. For example the concept 'colour' can be applied to many different taxonomic descriptors including "petal', 'wing' and 'eye'. Other concept states, for example 'shape' and 'size' can also be applied to the same descriptors.
d19 2
a74 1
Modifiers can also be assigned language specific labels and assigned usage for generation of natural language descriptions.
d76 15
d151 1
a151 1
---++++4.8.2 ConceptStates
d153 1
a154 1
SDD provides a mechanism to centrally define state values that are reusable in multiple characters.
d156 1
a158 1
d161 2
a162 2
%META:FILEATTACHMENT{name="modifier.gif" attr="" autoattached="1" comment="" date="1152235065" path="modifier.gif" size="13480" user="Main.DonovanSharp" version="1"}%
%META:FILEATTACHMENT{name="descriptiveconcepts.gif" attr="" autoattached="1" comment="" date="1152234947" path="descriptiveconcepts.gif" size="3800" user="Main.DonovanSharp" version="1"}%
@
1.7
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1152235155" format="1.1" reprev="1.7" version="1.7"}%
d73 1
a73 1
Modifiers cam also be assigned language specific labels and assigned usage for generation of natural language descriptions.
@
1.6
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1152164511" format="1.1" reprev="1.6" version="1.6"}%
d9 1
a9 1
%ATTACHURL%/descriptiveconcepts.jpg
d19 1
a19 1
%ATTACHURL%/modifier.jpg
d145 2
a146 2
%META:FILEATTACHMENT{name="modifier.jpg" attr="" autoattached="1" comment="" date="1150266329" path="modifier.jpg" size="16858" user="Main.DonovanSharp" version="1"}%
%META:FILEATTACHMENT{name="descriptiveconcepts.jpg" attr="" autoattached="1" comment="" date="1149832945" path="descriptiveconcepts.jpg" size="11914" user="Main.DonovanSharp" version="1"}%
@
1.5
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1152064829" format="1.1" version="1.5"}%
d23 5
d68 5
d77 6
d129 4
@
1.4
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1151980506" format="1.1" version="1.4"}%
d7 1
a7 1
SDD DescriptiveConcepts express basic terminological concepts of a more general concept than "characters" (structural hierarchy, property hierarchy, methods). In SDD, the concepts expressed in such hierarchies are defined here, and their relation to the characters (defined in [[CharacterHierarchies][CharacterTrees]]).
@
1.3
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1151042946" format="1.1" reprev="1.3" version="1.3"}%
d5 1
a5 1
---+++3.6.1 Descriptive concepts.
d15 1
a15 1
---++++3.6.1.1 Data modifiers.
d21 1
a21 1
---+++++Example 3.6.1.1.1 - Describing lucid scoring model using the modifiers element.
d65 2
d115 1
a115 1
---++++3.6.1.1 ConceptStates
@
1.2
log
@@
text
@d1 2
a2 2
%META:TOPICINFO{author="DonovanSharp" date="1150266329" format="1.1" reprev="1.2" version="1.2"}%
%META:TOPICPARENT{name="WebTopicList"}%
d62 51
d123 1
a124 1
%META:FILEATTACHMENT{name="modifier.jpg" attachment="modifier.jpg" attr="" comment="" date="1150266328" path="modifier.jpg" size="16858" stream="modifier.jpg" user="Main.DonovanSharp" version="1"}%
@
1.1
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1149832945" format="1.1" reprev="1.1" version="1.1"}%
d72 2
a73 1
%META:FILEATTACHMENT{name="descriptiveconcepts.jpg" attachment="descriptiveconcepts.jpg" attr="" comment="" date="1149832945" path="descriptiveconcepts.jpg" size="11914" stream="descriptiveconcepts.jpg" user="Main.DonovanSharp" version="1"}%
@