wiki-archive/twiki/data/SDD/Primer/SamplingEvent.txt

165 lines
5.6 KiB
Plaintext

%META:TOPICINFO{author="LeeBelbin" date="1258682522" format="1.1" version="1.12"}%
%META:TOPICPARENT{name="CodedDescription"}%
---++Main.BDI Part 0: Introduction and Primer to the Main.BDI Standard
---+++4.5 Elements within <SamplingEvent>
The element <SamplingUnit> contains raw sample data for a specimen. <SamplingEvent> contains information about where and when that sampling occurred.
A simple Main.BDI instance document representing a sampling event has the basic structure shown below and in example 4.5.1.1.
%ATTACHURL%/sampledata4.gif
Example 4.5.1.1 - A simple sampling event
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
<tr>
<td>
<verbatim>
<SampleData>
<SamplingEvent id="TJM45337">
<DateTime minute="17" hour="7" day="17" month="7" year="2006"/>
<DateTimeSpanEnd minute="27" hour="7" day="17" month="7" year="2006"/>
<GeographicArea ref="g2"/>
<Coordinates latitude="20.44" longitude="139.29"/>
<SamplingUnit>
<Quantitative ref="ch1" value="12"/>
</SamplingUnit>
...etc
</SampleData>
</verbatim>
</td>
</tr>
</table>
&lt;DateTime&gt; records the date and time when the sampling event occurred, either as a single time point or as the start of a time period.
&lt;DateTimeSpanEnd&gt; records the end of a time span if event timing is recorded as such.
Both date/times may be incomplete in ways not expressible in xs:datetime, e.g. the day and year may be known, but month unknown.
&lt;GeographicArea&gt; is a reference to a geographic area at which the event occurred. This is defined in the element &lt;GeographicAreas&gt; with the basic structure shown below and in example 4.5.1.2.
%ATTACHURL%/geographicarea.gif
Example 4.5.1.2 Defining geographic areas
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
<tr>
<td>
<verbatim>
<GeographicAreas>
<GeographicArea id="g1">
<Representation>
<Label>Worldwide</Label>
</Representation>
</GeographicArea>
<GeographicArea id="g2">
<Representation>
<Label>Europe</Label>
</Representation>
</GeographicArea>
</GeographicAreas>
</verbatim>
</td>
</tr>
</table>
&lt;Coordinates&gt; records a point on earth at which the event occurred. Elements available are &lt;Latitude&gt;, &lt;Longitude&gt;, &lt;GeodeticDatum&gt;; &lt;Verbatim&gt; (a textual representation of the original location data) and &lt;Literal&gt; (a free-form string in addition to or instead of numeric coordinates (i.e. Charley's Creek, near Chinchilla).
Example 4.5.1.3 Use of the &lt;Coordinate&gt; element
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
<tr>
<td>
<verbatim>
<SampleData>
<SamplingEvent id="AQ578462">
<DateTime></DateTime>
<Coordinates latitude="26.5" longitude="150.5"
geodeticdatum="GDA94" verbatim="5km NW of Roma"/>
<SamplingUnit>
<Categorical ref="c1">
<State ref="s1"/>
</Categorical>
</SamplingUnit>
</SamplingEvent>
</SampleData>
</verbatim>
</td>
</tr>
</table>
---++++4.5.2. <noautolink>SamplingUnit</noautolink>
A sampling unit may be an individual organism, a leaf of a tree, a piece of tissue, etc. In each sampling unit multiple characters may have been observed together ('paired observations'). Example: 'leaf shape, length, and width' of a single leaf). Value frequencies (e. g., '2.3': observed 4 x) are not supported; they are useful when only a single character variable is supported, but complicate paired observations unnecessarily. Char. values with a frequency should be entered in repeated <noautolink>SamplingUnits</noautolink>.
A simple Main.BDI code snippet representing part of the sample data above has the basic structure shown below and in Example 4.5.2.1.
%ATTACHURL%/samplingunit2.gif
Example 4.5.2.1. Recording sampling data in Main.BDI
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
<tr>
<td>
<verbatim>
<SampleData>
<SamplingEvent id="sev1000">
<DateTime></DateTime>
<SamplingUnit>
<Categorical ref="c1">
<State ref="s2"/>
</Categorical>
<Quantitative ref="c2" value="110"/>
</SamplingUnit>
<SamplingUnit>
<Categorical ref="c1">
<State ref="s1"/>
</Categorical>
<Quantitative ref="c2" value="112"/>
</SamplingUnit>
<SamplingUnit>
<Categorical ref="c1">
<State ref="s1"/>
</Categorical>
<Quantitative ref="c2" value="110"/>
</SamplingUnit>
<SamplingUnit>
<Categorical ref="c1">
<State ref="s1"/>
</Categorical>
<Quantitative ref="c2" value="118"/>
</SamplingUnit>
</SamplingEvent>
</SampleData>
</verbatim>
</td>
</tr>
</table>
-- Main.DonovanSharp - 21 Jun 2006
%META:FILEATTACHMENT{name="geographicarea.gif" attr="" autoattached="1" comment="" date="1153205684" path="geographicarea.gif" size="2794" user="Main.DonovanSharp" version="2"}%
%META:FILEATTACHMENT{name="samplingunit2.gif" attr="" autoattached="1" comment="" date="1153206390" path="samplingunit2.gif" size="30913" user="Main.DonovanSharp" version="1"}%
%META:FILEATTACHMENT{name="sampledata4.gif" attr="" autoattached="1" comment="" date="1153197893" path="sampledata4.gif" size="28691" user="Main.DonovanSharp" version="1"}%
%META:TOPICMOVED{by="DonovanSharp" date="1153196197" from="SDD.SamplingUnit" to="SDD.SamplingEvent"}%