wiki-archive/twiki/static/samplingevent.html

169 lines
6.7 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-us" lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15" />
<link rel="stylesheet" type="text/css" href="sdd1.css">
</head>
<body bgcolor="#ffffff">
<a name="PageTop"></a>
<p />
<h2><a name="SDD_Part_0_Introduction_and_Prim"></a> SDD Part 0: Introduction and Primer to the SDD Standard </h2>
<p />
<h3><a name="4_5_Elements_within_SamplingEven"></a> 4.5 Elements within &lt;SamplingEvent&gt; </h3>
<p />
The element &lt;SamplingUnit&gt; contains raw sample data for a specimen. &lt;SamplingEvent&gt; contains information about where and when that sampling occurred.
<p />
A simple SDD instance document representing a sampling event has the basic structure shown below and in example 4.5.1.1.
<p />
<img alt="sampledata4.gif" src="http://wiki.tdwg.org/twiki/static/_publish/sampledata4.gif" />
<p />
Example 4.5.1.1 - A simple sampling event
<p />
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
<p />
<tr>
<td>
<p />
<pre>
&#60;SampleData&#62;
&#60;SamplingEvent id&#61;&#34;TJM45337&#34;&#62;
&#60;DateTime minute&#61;&#34;17&#34; hour&#61;&#34;7&#34; day&#61;&#34;17&#34; month&#61;&#34;7&#34; year&#61;&#34;2006&#34;/&#62;
&#60;DateTimeSpanEnd minute&#61;&#34;27&#34; hour&#61;&#34;7&#34; day&#61;&#34;17&#34; month&#61;&#34;7&#34; year&#61;&#34;2006&#34;/&#62;
&#60;GeographicArea ref&#61;&#34;g2&#34;/&#62;
&#60;Coordinates latitude&#61;&#34;20.44&#34; longitude&#61;&#34;139.29&#34;/&#62;
&#60;SamplingUnit&#62;
&#60;Quantitative ref&#61;&#34;ch1&#34; value&#61;&#34;12&#34;/&#62;
&#60;/SamplingUnit&#62;
...etc
&#60;/SampleData&#62;
</pre>
<p />
</td>
</tr>
<p />
</table>
<p />
<p />
&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.
<p />
&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.
<p />
&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.
<p />
<img alt="geographicarea.gif" src="http://wiki.tdwg.org/twiki/static/_publish/geographicarea.gif" />
<p />
<p />
<p />
Example 4.5.1.2 Defining geographic areas
<p />
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
<p />
<tr>
<td>
<p />
<pre>
&#60;GeographicAreas&#62;
&#60;GeographicArea id&#61;&#34;g1&#34;&#62;
&#60;Representation&#62;
&#60;Label&#62;Worldwide&#60;/Label&#62;
&#60;/Representation&#62;
&#60;/GeographicArea&#62;
&#60;GeographicArea id&#61;&#34;g2&#34;&#62;
&#60;Representation&#62;
&#60;Label&#62;Europe&#60;/Label&#62;
&#60;/Representation&#62;
&#60;/GeographicArea&#62;
&#60;/GeographicAreas&#62;
</pre>
<p />
</td>
</tr>
<p />
</table>
<p />
&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).
<p />
Example 4.5.1.3 Use of the &lt;Coordinate&gt; element
<p />
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
<p />
<tr>
<td>
<p />
<pre>
&#60;SampleData&#62;
&#60;SamplingEvent id&#61;&#34;AQ578462&#34;&#62;
&#60;DateTime&#62;&#60;/DateTime&#62;
&#60;Coordinates latitude&#61;&#34;26.5&#34; longitude&#61;&#34;150.5&#34;
geodeticdatum&#61;&#34;GDA94&#34; verbatim&#61;&#34;5km NW of Roma&#34;/&#62;
&#60;SamplingUnit&#62;
&#60;Categorical ref&#61;&#34;c1&#34;&#62;
&#60;State ref&#61;&#34;s1&#34;/&#62;
&#60;/Categorical&#62;
&#60;/SamplingUnit&#62;
&#60;/SamplingEvent&#62;
&#60;/SampleData&#62;
</pre>
<p />
</td>
</tr>
<p />
</table>
<p />
<h4><a name="4_5_2_SamplingUnit"></a> 4.5.2. SamplingUnit </h4>
<p />
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 SamplingUnits.
<p />
A simple SDD code snippet representing part of the sample data above has the basic structure shown below and in Example 4.5.2.1.
<p />
<img alt="samplingunit2.gif" src="http://wiki.tdwg.org/twiki/static/_publish/samplingunit2.gif" />
<p />
Example 4.5.2.1. Recording sampling data in SDD
<p />
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
<p />
<tr>
<td>
<p />
<pre>
&#60;SampleData&#62;
&#60;SamplingEvent id&#61;&#34;sev1000&#34;&#62;
&#60;DateTime&#62;&#60;/DateTime&#62;
&#60;SamplingUnit&#62;
&#60;Categorical ref&#61;&#34;c1&#34;&#62;
&#60;State ref&#61;&#34;s2&#34;/&#62;
&#60;/Categorical&#62;
&#60;Quantitative ref&#61;&#34;c2&#34; value&#61;&#34;110&#34;/&#62;
&#60;/SamplingUnit&#62;
&#60;SamplingUnit&#62;
&#60;Categorical ref&#61;&#34;c1&#34;&#62;
&#60;State ref&#61;&#34;s1&#34;/&#62;
&#60;/Categorical&#62;
&#60;Quantitative ref&#61;&#34;c2&#34; value&#61;&#34;112&#34;/&#62;
&#60;/SamplingUnit&#62;
&#60;SamplingUnit&#62;
&#60;Categorical ref&#61;&#34;c1&#34;&#62;
&#60;State ref&#61;&#34;s1&#34;/&#62;
&#60;/Categorical&#62;
&#60;Quantitative ref&#61;&#34;c2&#34; value&#61;&#34;110&#34;/&#62;
&#60;/SamplingUnit&#62;
&#60;SamplingUnit&#62;
&#60;Categorical ref&#61;&#34;c1&#34;&#62;
&#60;State ref&#61;&#34;s1&#34;/&#62;
&#60;/Categorical&#62;
&#60;Quantitative ref&#61;&#34;c2&#34; value&#61;&#34;118&#34;/&#62;
&#60;/SamplingUnit&#62;
&#60;/SamplingEvent&#62;
&#60;/SampleData&#62;
</pre>
<p />
</td>
</tr>
<p />
</table>
<p />
-- DonovanSharp - 21 Jun 2006
<p />
<p />
</body></html>