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

%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"}%