wiki-archive/twiki/data/SDD/Primer/CodedSampleDescription.txt,v

436 lines
14 KiB
Plaintext

head 1.8;
access;
symbols;
locks; strict;
1.8
date 2009.11.20.02.02.02; author LeeBelbin; state Exp;
branches;
next 1.7;
1.7
date 2006.08.29.02.06.57; author DonovanSharp; state Exp;
branches;
next 1.6;
1.6
date 2006.07.18.04.18.52; author DonovanSharp; state Exp;
branches;
next 1.5;
1.5
date 2006.07.08.02.19.30; author DonovanSharp; state Exp;
branches;
next 1.4;
1.4
date 2006.07.07.09.39.42; author KevinThiele; state Exp;
branches;
next 1.3;
1.3
date 2006.07.07.06.45.47; author DonovanSharp; state Exp;
branches;
next 1.2;
1.2
date 2006.07.07.03.39.59; author DonovanSharp; state Exp;
branches;
next 1.1;
1.1
date 2006.07.06.03.58.20; author KevinThiele; state Exp;
branches;
next ;
desc
@@
1.8
log
@none
@
text
@%META:TOPICINFO{author="LeeBelbin" date="1258682522" format="1.1" version="1.8"}%
%META:TOPICPARENT{name="CodedData"}%
---++Main.BDI Part 0: Introduction and Primer to the Main.BDI Standard
---+++2.2 Main.BDI for coded sample descriptions
Sample data descriptions (Box 2.1.1.2) usually comprise repeated measurements of parts of individual specimens, and are the basis from which the more abstracted descriptions in natural language and coded descriptions are derived. Few taxonomists consistently record and archive their raw data in a standardised format.
----++++Box 2.2.1 - Example of sample (specimen) descriptive data
<div>
<table bgcolor="#ddddff" border="1" width="80%" cellspacing="0" id="table10" cellpadding="0">
<tr>
<td rowspan="2" align="center">Specimen</td>
<td colspan="5" align="center">Spore length</td>
<td colspan="5" align="center">Spore width</td>
<td width="163" rowspan="2" align="center">Spore colour</td>
</tr>
<tr>
<td width="25" align="center">1</td>
<td width="25" align="center">2</td>
<td width="25" align="center">3</td>
<td width="25" align="center">4</td>
<td width="25" align="center">5</td>
<td width="25" align="center">1</td>
<td width="25" align="center">2</td>
<td width="25" align="center">3</td>
<td width="25" align="center">4</td>
<td width="25" align="center">5</td>
</tr>
<tr>
<td align="center">TJM45337</td>
<td width="25" align="center">12</td>
<td width="25" align="center">13</td>
<td width="25" align="center">12</td>
<td width="25" align="center">15</td>
<td width="25" align="center">11</td>
<td width="25" align="center">8</td>
<td width="25" align="center">8</td>
<td width="25" align="center">7</td>
<td width="25" align="center">6</td>
<td width="25" align="center">6</td>
<td width="163" align="center">brown</td>
</tr>
<tr>
<td align="center">TLM33466</td>
<td width="25" align="center">15</td>
<td width="25" align="center">18</td>
<td width="25" align="center">17</td>
<td width="25" align="center">17</td>
<td width="25" align="center">15</td>
<td width="25" align="center">10</td>
<td width="25" align="center">8</td>
<td width="25" align="center">9</td>
<td width="25" align="center">9</td>
<td width="25" align="center">10</td>
<td width="163" align="center">yellow</td>
</tr>
</table>
</div>
Coded sample descriptions record the range of characteristics found in an individual, as opposed to a class or taxon (e.g. species, genus etc.). To record summary data for taxonomic levels higher than the individual, see the topic [[CodedData][Using Main.BDI for coded summary descriptions]].
A coded sample description requires three essential items: the identifiers of the specimens being described, a set of descriptors (characters and states) used to describe the specimens, and the coded descriptions themselves.
A simple Main.BDI instance document representing part of the sample data above has the basic structure shown below and in Example 2.2.1.
%ATTACHURL%/coded_sample_descriptions.gif
----++++Example 2.2.1 - A simple coded sample description
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
<tr>
<td>
<verbatim>
<?xml version="1.0" encoding="UTF-8"?>
<Datasets xsi:schemaLocation="http://ns.tdwg.org/UBIF/2006 http://www.lucidcentral.org/2006/SDD/SDD1.1-RC1/SDD.xsd" xmlns="http://ns.tdwg.org/UBIF/2006" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<TechnicalMetadata created="2006-06-22T11:19:56.007+10:00">
<Generator name="by hand" version="1"/>
</TechnicalMetadata>
<Dataset xml:lang="en-us">
<Representation>
<Label>sample data example</Label>
</Representation>
<Specimens>
<Specimen id="sp1">
<Representation>
<Label>TJM45337</Label>
</Representation>
</Specimen>
<Specimen id="sp2">
<Representation>
<Label>TLM33466</Label>
</Representation>
</Specimen>
...etc
</Specimens>
<Characters>
<QuantitativeCharacter id="ch1">
<Representation>
<Label>Spore length</Label>
</Representation>
</QuantitativeCharacter>
<CategoricalCharacter id="ch3">
<Representation>
<Label>Spore colour</Label>
</Representation>
<States>
<StateDefinition id="s1">
<Representation>
<Label>brown</Label>
</Representation>
</StateDefinition>
<StateDefinition id="s2">
<Representation>
<Label>yellow</Label>
</Representation>
</StateDefinition>
...etc
</States>
</CategoricalCharacter>
...etc
</Characters>
<CodedDescriptions>
<CodedDescription>
<Representation>
<Label>Specimen data for fungal specimens</Label>
</Representation>
<SampleData>
<SamplingEvent id="TJM45337">
<SamplingUnit>
<Quantitative ref="ch1" value="12"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch1" value="13"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch1" value="12"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch1" value="15"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch1" value="11"/>
</SamplingUnit>
<SamplingUnit>
<Categorical ref="ch3">
<State ref="s1"/>
</Categorical>
</SamplingUnit>
</SamplingEvent>
...etc
</SampleData>
</CodedDescription>
</CodedDescriptions>
</Dataset>
</Datasets>
</verbatim>
</td>
</tr>
</table>
For more information on defining sampling units using the &lt;Specimens&gt; element, see the topic [[SpecimenNames][Defining specimen names]].
For more information on defining characters and states using the &lt;Characters&gt; element, see the topic [[SddCharacters][Defining characters and states]].
Note that characters can also be arranged into hierarchies. See the topic [[CharacterHierarchies][Defining character hierarchies]] for more information.
The &lt;Representation&gt; 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 Main.BDI]].
The &lt;SamplingEvent&gt; includes elements specifying the timing and location of the sample data. For more information see the topic [[SamplingEvent][Elements within &lt;SamplingEvent&gt;]]
Characters used in the description are listed under &lt;SampleData&gt;. Main.BDI distinguishes between different kinds of characters (see the topic [[SddCharacters][Defining characters and states]] for more information). For categorical characters (characters with states) the states occurring in the taxon being described are listed by reference. In the example given above, the specimen TJM45337 is described as having brown spores (state s1 of character ch3) while specimen TLM33466is described as having yellow spores (state s2 of character ch3). Note that states that are not listed are inferred to not occur in the taxon being described.
-- Main.KevinThiele - 06 Jul 2006
%META:FILEATTACHMENT{name="coded_sample_descriptions.gif" attachment="coded_sample_descriptions.gif" attr="" comment="" date="1152265181" path="coded_sample_descriptions.gif" size="12647" stream="coded_sample_descriptions.gif" user="Main.KevinThiele" version="3"}%
@
1.7
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1156817217" format="1.1" version="1.7"}%
d3 1
a3 1
---++SDD Part 0: Introduction and Primer to the SDD Standard
d5 1
a5 1
---+++2.2 SDD for coded sample descriptions
d62 1
a62 1
Coded sample descriptions record the range of characteristics found in an individual, as opposed to a class or taxon (e.g. species, genus etc.). To record summary data for taxonomic levels higher than the individual, see the topic [[CodedData][Using SDD for coded summary descriptions]].
d66 1
a66 1
A simple SDD instance document representing part of the sample data above has the basic structure shown below and in Example 2.2.1.
d170 1
a170 1
The &lt;Representation&gt; 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]].
d174 1
a174 1
Characters used in the description are listed under &lt;SampleData&gt;. SDD distinguishes between different kinds of characters (see the topic [[SddCharacters][Defining characters and states]] for more information). For categorical characters (characters with states) the states occurring in the taxon being described are listed by reference. In the example given above, the specimen TJM45337 is described as having brown spores (state s1 of character ch3) while specimen TLM33466is described as having yellow spores (state s2 of character ch3). Note that states that are not listed are inferred to not occur in the taxon being described.
@
1.6
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1153196332" format="1.1" reprev="1.6" version="1.6"}%
d70 2
a71 1
Example 2.2.1 - A simple coded sample description
@
1.5
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1152325170" format="1.1" version="1.5"}%
d170 2
@
1.4
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="KevinThiele" date="1152265182" format="1.1" reprev="1.4" version="1.4"}%
d164 1
a164 1
For more information on defining sampling units using the &lt;Specimens&gt; element, see the topic [[TaxonNames][Defining specimen names]].
@
1.3
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1152254747" format="1.1" reprev="1.3" version="1.3"}%
d7 1
a7 1
SampleData descriptions (Box 2.1.1.2) usually comprise repeated measurements of parts of individual specimens, and are the basis from which the more abstracted descriptions in natural language and coded descriptions are derived. Few taxonomists consistently record and archive their raw data in a standardised format.
d62 1
a62 1
Coded sample descriptions record the range of characteristics found in an individual, as opposed to a group (species, genus etc.). To record summary data for taxonomic levels higher than the individual, see the topic Using SDD for coded summary descriptions.
d66 1
a66 1
A simple SDD instance document representing the sample data above has the basic structure shown below and in Example 2.2.1.
d70 1
a70 1
Example 2.2.1 - A simple coded description
a72 1
a74 1
a75 1
d96 1
a103 5
<QuantitativeCharacter id="ch2">
<Representation>
<Label>Spore Width</Label>
</Representation>
</QuantitativeCharacter>
d119 1
d122 1
d127 1
a127 1
<Label>Specimen data</Label>
a146 15
<Quantitative ref="ch2" value="8"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch2" value="8"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch2" value="7"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch2" value="6"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch2" value="6"/>
</SamplingUnit>
<SamplingUnit>
d152 1
a152 37
<SamplingEvent id="TLM33466">
<SamplingUnit>
<Quantitative ref="ch1" value="15"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch1" value="18"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch1" value="17"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch1" value="17"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch1" value="15"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch2" value="10"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch2" value="8"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch2" value="9"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch2" value="9"/>
</SamplingUnit>
<SamplingUnit>
<Quantitative ref="ch2" value="10"/>
</SamplingUnit>
<SamplingUnit>
<Categorical ref="ch3">
<State ref="s2"/>
</Categorical>
</SamplingUnit>
</SamplingEvent>
a157 2
a161 1
d164 2
a165 2
For more information on defining taxon names using the &lt;Specimens&gt; element, see the topic [[TaxonNames][Defining specimen names]].
For more infirmation on defining characters and states using the &lt;Characters&gt; element, see the topic [[SddCharacters][Defining characters and states]].
a172 2
States used in a description can also be modified using a predefined set of modifiers (such as "rare", "uncertain" etc.). See the topic Using [[SDDModifiers][Modifiers]] in SDD for more information
d175 1
a175 1
%META:FILEATTACHMENT{name="coded_sample_descriptions.gif" attachment="coded_sample_descriptions.gif" attr="" comment="" date="1152252896" path="coded_sample_descriptions.gif" size="12777" stream="coded_sample_descriptions.gif" user="Main.DonovanSharp" version="2"}%
@
1.2
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="DonovanSharp" date="1152243599" format="1.1" version="1.2"}%
d9 1
a9 1
----++++Box 1.2.4 - Example of sample (specimen) descriptive data
d62 1
d64 1
d66 1
d68 1
d70 164
d235 3
@
1.1
log
@@
text
@d1 1
a1 1
%META:TOPICINFO{author="KevinThiele" date="1152158300" format="1.1" version="1.1"}%
d3 4
@