wiki-archive/twiki/data/InvasiveSpecies/ProtocolSpecGISIN.txt,v

3556 lines
135 KiB
Plaintext
Raw Permalink Blame History

head 1.14;
access;
symbols;
locks; strict;
comment @# @;
1.14
date 2008.05.18.06.03.17; author MichaelBrowne; state Exp;
branches;
next 1.13;
1.13
date 2008.03.01.23.35.44; author AnnieSimpson; state Exp;
branches;
next 1.12;
1.12
date 2008.03.01.19.26.46; author AnnieSimpson; state Exp;
branches;
next 1.11;
1.11
date 2008.02.22.02.21.51; author MichaelBrowne; state Exp;
branches;
next 1.10;
1.10
date 2007.11.08.01.12.56; author MichaelBrowne; state Exp;
branches;
next 1.9;
1.9
date 2007.11.07.23.48.15; author MichaelBrowne; state Exp;
branches;
next 1.8;
1.8
date 2007.10.28.00.53.34; author MichaelBrowne; state Exp;
branches;
next 1.7;
1.7
date 2007.09.28.00.02.23; author MichaelBrowne; state Exp;
branches;
next 1.6;
1.6
date 2007.08.09.21.59.59; author AnnieSimpson; state Exp;
branches;
next 1.5;
1.5
date 2007.08.06.19.01.55; author AnnieSimpson; state Exp;
branches;
next 1.4;
1.4
date 2007.08.05.05.27.35; author AnnieSimpson; state Exp;
branches;
next 1.3;
1.3
date 2007.08.05.03.54.46; author AnnieSimpson; state Exp;
branches;
next 1.2;
1.2
date 2007.08.05.02.00.09; author AnnieSimpson; state Exp;
branches;
next 1.1;
1.1
date 2007.08.04.03.27.12; author AnnieSimpson; state Exp;
branches;
next ;
desc
@none
@
1.14
log
@none
@
text
@%META:TOPICINFO{author="MichaelBrowne" date="1211090597" format="1.1" reprev="1.14" version="1.14"}%
%META:TOPICPARENT{name="IntroToGISIN"}%
<h3>Suggestions for Changes and Additions to the GISIN technical document</h3>
<h4>[[http://www.niiss.org/cwis438/websites/GISINTech/Documentation/ProtocolSpecification.html?WebSiteID=5][GISIN Web Service Protocol Specification]]</h4> Click on the title to open the document, then use your browser's back button to return to this page and insert your wiki input below.
<h2>Appendix A - Issues</h2>
<p><br />
1. Do we specify taxonomic hierarchy or just kingdom/scientific name </p>
<p>- Just kingdom/scientific name for now </p>
<p>2.Can ask service: do you supported hierarchical taxon queries?</p>
<p>- Later addition </p>
<p>3. Need a method to determine if a record is from its original data set or is a duplicate</p>
<p>4. Need a method to determine the original source of a duplicated record</p>
<p>5. Need to include LSIDs for each record. Will LSIDs address issues 3 and 4? </p>
<p>6. The Metadata in TAPIR uses' 2 letter language codes. Should we do the same? </p>
<p>7. Should we add "Debugging" as a format parameter? </p>
<p><br />
<h4><a name="Issues_List_with_numbered_issues"></a> &#8220;Issues List&#8221; with numbered issues, current recommendations, current status, and associated discussions. </h4>
The &#8220;Status&#8221; fields have the following values:
<ul>
<li>Investigation &#8211; we&#8217;re trying to come up with a proposal</li>
<li>Proposed &#8211; we have a proposal and are seeing if anyone objects</li>
<li>Resolved &#8211; the issue has been decided but is not yet in the protocol documentation</li>
<li>Existing &#8211; the issue is represented in the documentation</li>
</ul>
<p>
1. PROPOSAL: Add a new data model for <span class="twikiNewLink">EnvironmentalInfo<a href="/twiki/bin/edit/InvasiveSpecies/EnvironmentalInfo?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span><br>
Status: Proposed<br>
This datamodel will help distinguish between species that occur in natural or human modified environments, and/or in freshwater, brackish, marine and terrestrial habitats. Multiple values are possible. These concepts are different from <span class="twikiNewLink">EcosystemImpacted<a href="/twiki/bin/edit/InvasiveSpecies/EcosystemImpacted?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> and <span class="twikiNewLink">HabitatImpacted<a href="/twiki/bin/edit/InvasiveSpecies/HabitatImpacted?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> (a terrestrial species can impact aquatic environments). At the GISIN portal someone could filter by &#8216;terrestrial&#8216; to get all terrestrial species &#8211; whether or not the habitat impacted might be both terrestrial and aquatic.<br>
<p>EnvironmentalInfo supports the following additional Concepts: Possible values for the additional Concepts are listed in the table.</p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>SpeciesEnvironment</td>
<td>No</td>
<td>String</td>
<td>Natural, <span class="twikiNewLink">HumanModified<a href="/twiki/bin/edit/InvasiveSpecies/HumanModified?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span></td>
<td>The environment in which the species occurs</td>
</tr>
<tr>
<td>SpeciesBiome</td>
<td>No</td>
<td>String</td>
<td>Freshwater, Brackish, Marine, Terrestrial</td>
<td>The biome in which the species occurs</td>
</tr>
</table>
<p>
2. PROPOSAL: Change Harmful back to Invasive in <span class="twikiNewLink">BioStatus<a href="/twiki/bin/edit/InvasiveSpecies/BioStatus?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span><br>
Status: Proposed<br>
Discussion: Many believe that &#8216;Harm&#8217; is subjective and that it is the culmination of the invasion process, which begins with establishment, then persistence and spread. If we provided the word &#8216;Invasive&#8217; instead of &#8216;Harmful&#8217; in the <span class="twikiNewLink">BioStatus<a href="/twiki/bin/edit/InvasiveSpecies/BioStatus?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> concept, most providers would be able to map to its possible values, but each provider might mean something different. The key differences are between;<br>
ONE: Scientific uses of the word &#8216;Invasive&#8217; meaning ability to spread (i.e. Distribution = Widespread or Moderate, and/or Abundance= Dominant or Common) and <br>
TWO: Policy uses of the word &#8216;Invasive&#8217; meaning ability to cause harm.<br>
Different meanings or usages can be deduced from the additional concepts for which data is provided. Currently, the first group can select &#8216;Invasive&#8217; then map their data to Distribution = (Widespread or Moderate), and/or Abundance= (Dominant or Common) and/or Harmful= (Yes or Potentially). <br>
The second group can select &#8216;Invasive&#8217; then map their data to <span class="twikiNewLink">ImpactStatus<a href="/twiki/bin/edit/InvasiveSpecies/ImpactStatus?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> concepts as well as those of group 1.<p>
More Discussion: Folks had major issues with the term &#8220;Invasive&#8221;. We decided to use &#8220;Harmful=Yes&#8221;. However, invasiveness data would not be mapped to the &#8216;Harmful&#8217; concept if there is only evidence of establishment, persistence and spread (e.g. when harm has not been confirmed). A search at the GISIN portal on Harmful = yes would miss this invasiveness data.
</p>
<p>BioStatuses support the following additional Concepts. Possible values for the Concepts are listed below this table. </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>Source</td>
<td>No</td>
<td>String</td>
<td>&nbsp;</td>
<td>Citation for the source of the data </td>
</tr>
<tr>
<td>Origin</td>
<td>Yes</td>
<td>String</td>
<td>Indigenous, Nonindigenous, Unknown </td>
<td>Whether the species is considered to be native to a particular location or not. </td>
</tr>
<tr>
<td>Presence</td>
<td>Yes</td>
<td>String</td>
<td>Absent, Sometimes, Present, Unknown </td>
<td>There is supporting evidence to show the species is present within the valid date </td>
</tr>
<tr>
<td>Persistence</td>
<td>No</td>
<td>String</td>
<td>Persistent, Temporary [let's delete this value. MB], Transient, <span class="twikiNewLink">DiedOut<a href="/twiki/bin/edit/InvasiveSpecies/DiedOut?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span>, Unknown </td>
<td>How successful the organism is at surviving and reproducing </td>
</tr>
<tr>
<td>Distribution</td>
<td>No</td>
<td>String</td>
<td>Widespread, Moderate, Localized, Unknown </td>
<td>Whether the species is limited to a local area or covers vast tracks of land or water </td>
</tr>
<tr>
<td>Abundance</td>
<td>No</td>
<td>String</td>
<td>Dominant, Common, Rare, Zero, Unknown </td>
<td>How abundant the organism is </td>
</tr>
<tr>
<td>Trend</td>
<td>No</td>
<td>String</td>
<td>Expanding, Stable, Declining, Unknown </td>
<td>Whether the range of the organism is increasing or decreasing </td>
</tr>
<tr>
<td>RateOfSpread</td>
<td>No</td>
<td>String</td>
<td>Rapid, Moderate, Slow, Unknown </td>
<td>How quickly the range of the organism is expanding </td>
</tr>
<tr>
<td>Invasive</td>
<td>Yes</td>
<td>String</td>
<td>Yes, No, Potentially, Unknown</td>
<td>Whether the organism causes concern. 'Spread' information is dealt with in BioStatus. 'Harm' information is dealt with in the ImpactStatus? Element as are Environmental versus Livelihood and HumanHealth impacts.>?</a></span> element</td>
</tr>
<tr>
<td>RegulartoryListing</td>
<td>No</td>
<td>String</td>
<td>Prohibited, Restricted, <a href="/twiki/bin/view/InvasiveSpecies/NotConsidered" class="twikiLink">NotConsidered</a>, Unknown </td>
<td>The legal regulatory status of the organism </td>
</tr>
</table>
<p>
<P>
<p />
3. <span class="twikiNewLink">ImpactStatus<a href="/twiki/bin/edit/InvasiveSpecies/ImpactStatus?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span><p>
3.1 PROPOSAL: Introduce an <span class="twikiNewLink">ImpactMechanism<a href="/twiki/bin/edit/InvasiveSpecies/ImpactMechanism?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> concept<br>
Status: Proposed<br>
Introduce an <span class="twikiNewLink">ImpactMechanism<a href="/twiki/bin/edit/InvasiveSpecies/ImpactMechanism?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> concept to handle information about competition, predation, etc. i.e. how IAS damage species habitats and ecosystems. This kind of information is widely available and <span class="twikiNewLink">ImpactMechanism<a href="/twiki/bin/edit/InvasiveSpecies/ImpactMechanism?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> allows us to make assumptions about which kinds of native species may be threatened. <br>
3.2 PROPOSAL: Change <span class="twikiNewLink">HarmType<a href="/twiki/bin/edit/InvasiveSpecies/HarmType?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> values from <span class="twikiNewLink">HarmfulToEconomy<a href="/twiki/bin/edit/InvasiveSpecies/HarmfulToEconomy?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> to <span class="twikiNewLink">HarmfulToLivelihoods<a href="/twiki/bin/edit/InvasiveSpecies/HarmfulToLivelihoods?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span>.<br>
Status: Proposed<br>
3.3 PROPOSAL: Make <span class="twikiNewLink">HabitatImpacted<a href="/twiki/bin/edit/InvasiveSpecies/HabitatImpacted?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> non-mandatory<br>
Status: Proposed<br>
<p/>
<p>ImpactStatuses support the following additional Concepts: </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>BiomeImpacted</td>
<td>No</td>
<td>String</td>
<td>Freshwater, Brackish, Marine, Terrestrial</td>
<td>The ecosystem type being impacted (can be more than one).</td>
</tr>
<tr>
<td>EnvironmentImpacted</td>
<td>No</td>
<td>String</td>
<td>Natural, <span class="twikiNewLink">HumanModified<a href="/twiki/bin/edit/InvasiveSpecies/HumanModified?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span></td>
<td>Type of environment being impacted</td>
</tr>
<tr>
<td>HarmType</td>
<td>No</td>
<td>String</td>
<td>HarmfulToEnvironment, <span class="twikiNewLink">HarmfulToLivelihoods<a href="/twiki/bin/edit/InvasiveSpecies/HarmfulToLivelihoods?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span><span class="twikiNewLink">HarmfulToHumanHealth<a href="/twiki/bin/edit/InvasiveSpecies/HarmfulToHumanHealth?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span></td>
<td>What values the species is impacting (can be more than one) </td>
</tr>
<tr>
<td>ImpactLevel</td>
<td>No</td>
<td>String</td>
<td>Habitat, Ecosystem</td>
<td>Level at which impact is occuring (can be more than one)</td>
</tr>
<tr>
<td>SpeciesImpacted</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>Use scientific name (can be more than one)</td>
</tr>
<tr>
<td>HabitatImpacted</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>Description of habitat impacted</td>
</tr>
<tr>
<td>EcosystemImpacted</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>Description of the ecosystem being impacted</td>
</tr>
<tr>
<td>*EcosystemServicesImpacted</td>
<td>No</td>
<td>String</td>
<td>Provisioning, Regulating, Cultural, Supporting</td>
<td>Ecosystem services are the benefits that people obtain from ecosystems (can be more than one).</td>
</tr>
<tr>
<td>LivelihoodValuesImpacted</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>Description of impacts on livelihoods.</td>
</tr>
<tr>
<td>HumanHealthValuesImpacted</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>Description of impacts on human health.</td>
</tr>
<tr>
<td>ImpactMechanism</td>
<td>No</td>
<td>String</td>
<td>Allergenic, Competition, <span class="twikiNewLink">DiseaseTransmission<a href="/twiki/bin/edit/InvasiveSpecies/DiseaseTransmission?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span>, Herbivory, Hybridisation, <span class="twikiNewLink">InteractionWithOtherInvasiveSpecies<a href="/twiki/bin/edit/InvasiveSpecies/InteractionWithOtherInvasiveSpecies?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span>, Pathogenic/Parasite, <span class="twikiNewLink">PhysicalDisturbance<a href="/twiki/bin/edit/InvasiveSpecies/PhysicalDisturbance?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span>, Predation, <span class="twikiNewLink">SoilTransformation<a href="/twiki/bin/edit/InvasiveSpecies/SoilTransformation?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span>, Transpiration, Other, Unknown
</td>
<td>Mechanism by which negative impacts occur </td>
</tr>
<tr>
<td>*ImpactStrength</td>
<td>No</td>
<td>String</td>
<td>Massive, Strong, Moderate, Weak, None, Unknown </td>
<td>How strong the impact is</td>
</tr>
<tr>
<td>ImpactCost</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>Description of cost and either estimated or actual monetary value.</td>
</tr>
<tr>
<td>ImpactBenefit</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>Description of benefit and either estimated or actual monetary value.</td>
</tr>
</table>
<p><strong>HarmTypeValues</strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>HarmfulToEnvironment</td>
<td>Impact on natural or semi-natural environments and/or the species they contain. Includes impacts on species, species interactions, habitats, ecosystem composition, functionality and services.</td>
</tr>
<tr>
<td>HarmfulToLivelihoods</td>
<td>Impact on primary production or subsistence, as well as on safety and social, recreational, aesthetic, spiritual or cultural values.
</td>
</tr>
<tr>
<td>HarmfulToHumanHealth</td>
<td>Impact on human health via disease, allergen, air/water quality, etc.</td>
</tr>
</table>
<p><strong>EcosystemServicesImpacted Values</strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Provisioning</td>
<td>Provisioning services, such as food, fibre, fuel, water, biochemicals, natural medicines, pharmaceuticals and ornamental resources.</td>
</tr>
<tr>
<td>Regulating</td>
<td>Regulating services, i.e. benefits obtained from the regulation of ecosystem processes, such as the regulation of climate, floods, disease, wastes, and water
quality.</td>
</tr>
<tr>
<td>Cultural</td>
<td>Cultural services such as recreation, aesthetic enjoyment and tourism; </td>
</tr>
</tr>
<tr>
<td>Supporting</td>
<td>Services that are necessary for the production of all other ecosystem services, such as soil formation, photosynthesis, and nutrient cycling</td>
</tr>
</table>
<P>
*EcosystemServicesImpacted values and descriptions are adapted from: Kettunen, M. & ten Brink, P. 2006. Value of biodiversity- Documenting EU examples
where biodiversity loss has led to the loss of ecosystem services. Final report for the
European Commission. Institute for European Environmental Policy (IEEP), Brussels,
Belgium. 131 pp.<p>
*ImpactStrength values and descriptions are adapted from: Olenin S, Minchin D, Daunys D (2007) Assessment of biopollution in aquatic ecosystems. Marine Pollution Bulletin (Volume 55, Issues 7-9, 2007, Pages 379-394). <br>
*Some <span class="twikiNewLink">ImpactMechanism<a href="/twiki/bin/edit/InvasiveSpecies/ImpactMechanism?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> values come from the IUCN Red List&#8217;s Authority Files.<br>
<p>
<p/>
4. <span class="twikiNewLink">DispersalStatus<a href="/twiki/bin/edit/InvasiveSpecies/DispersalStatus?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span><p>
4.1 PROPOSAL: Introduce a <span class="twikiNewLink">DispersalStatus<a href="/twiki/bin/edit/InvasiveSpecies/DispersalStatus?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> Concept called <span class="twikiNewLink">MovementStatus<a href="/twiki/bin/edit/InvasiveSpecies/MovementStatus?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span><br>
Status: Investigation<br>
Discussion: <span class="twikiNewLink">DispersalStatus<a href="/twiki/bin/edit/InvasiveSpecies/DispersalStatus?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> applies to species movements at all scales &#8211; introduction across international borders as well as dispersal from one watershed to the next. We could introduce a <span class="twikiNewLink">DispersalStatus<a href="/twiki/bin/edit/InvasiveSpecies/DispersalStatus?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> Concept called <span class="twikiNewLink">MovementStatus<a href="/twiki/bin/edit/InvasiveSpecies/MovementStatus?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> with possible values = Pre-borderMovement and Post-borderMovement.<br>
4.2 PROPOSAL: Introduce Concepts for <span class="twikiNewLink">DispersalMechanisms<a href="/twiki/bin/edit/InvasiveSpecies/DispersalMechanisms?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> and <span class="twikiNewLink">DisperslPathways<a href="/twiki/bin/edit/InvasiveSpecies/DisperslPathways?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span><br>
Status: Proposed<br>
Discussion: The problem with the original Cause and Vector concepts is that it would have been difficult for providers to map to values as there are so many. Now they can map to 1 of 3 dispersal mechanisms and/or 1 of 6 dispersl pathways. This simplified approach lends itself to comparative analysis across a wide range of taxa and to policy applications (see the &#8216;responsibility&#8217; statement in the Descriptions for Pathway values). <br>
4.3 PROPOSAL: Introduce a <span class="twikiNewLink">DateOfFirst<a href="/twiki/bin/edit/InvasiveSpecies/DateOfFirst?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> Report concept<br>
Status: Proposed<br>
Discussion: This date is sometimes available when date of introduction is unknown.<br>
4.4 PROPOSAL: Change Method concept to 'Mode' and make it not mandatory<br>
Status: Proposed<br>
4.5 PROPOSAL: What format should we use for dates?<br>
Proposal: Use the TAPIR standard date format<br>
Status: Existing<br>
Discussion: Michael: YYYY-MM-DD is usually unavailable for &#8216;Date of introduction&#8217;. Typically providers have a year or a decade. How do we handle the lack of MM-DD?
Discussion: Michael: You often get pre- or post- a year or a decade. Could we implement something modelled on DAISIE, which uses 2 fields: If the date is precise, the same date appears in both fields. If the first field alone is populated, the meaning = &#8216;post the date&#8217;, if only the second field is populated, the meaning = &#8216;pre the date&#8217;.<br>
Discussion: Jim:We can setup the toolkit to map years (including a decade) to a date field. Mapping multiple columns into a date is more complicated. All databases have standard date fields that can be automatically mapped to the protocol. On this one I think I would suggest we recommend the providers use the SQL standard date fields if at all possible.<br>
<p />
<p>DispersalStatuses support the following additional Concepts: </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>DateOfIntroduction</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>A textual description of any date (day, month, year, decade, etc.) of introduction</td>
</tr>
<tr>
<td>DateOfFirstReport</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>A textual description of any date (day, month, year, decade, etc.) of first report</td>
</tr>
<tr>
<td>Mode</td>
<td>No</td>
<td>String</td>
<td>Natural, Deliberate, Accidental, Unknown </td>
<td>A high-level categorization of how the organism is dispersing </td>
</tr>
<tr>
<td>MovementStatus</td>
<td>No</td>
<td>String</td>
<td>Pre-borderMovement, Post-borderMovement</td>
<td>A high-level classification of where the dispersal is occurring</td>
</tr>
<tr>
<td>*Mechanism</td>
<td>No</td>
<td>String</td>
<td>Commodity, Vector, <span class="twikiNewLink">NaturalDispersal<a href="/twiki/bin/edit/InvasiveSpecies/NaturalDispersal?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span>, Unknown</td>
<td>Mechanism of arrival, entry and/or dispersal.</td>
</tr>
<tr>
<td>*Pathway</td>
<td>No</td>
<td>String</td>
<td>Release, Escape, Contaminant, Stowaway, Corridor, Unaided, Unknown</td>
<td>Process that results in the introduction of alien species from one location to another</td>
</tr>
<tr>
<td>FromCountryCode</td>
<td>No</td>
<td>String</td>
<td>See section 4.4.1.3 </td>
<td>The country the organism is dispersing from</td>
</tr>
<tr>
<td>Route</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>A textual description of the route the organism took from the <span class="twikiNewLink">FromCountryCode<a href="/twiki/bin/edit/InvasiveSpecies/FromCountryCode?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span>. If used, a <span class="twikiNewLink">LanguageCode<a href="/twiki/bin/edit/InvasiveSpecies/LanguageCode?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> must be specified. </td>
</tr>
</table>
<p>
<p />
<p><strong>Mechanism Values</strong></p>
<p>Mechanism of arrival, entry and dispersal</p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Commodity</td>
<td>Importation of a commodity</td>
</tr>
<tr>
<td>Vector</td>
<td>Arrival of a transport vector. Vector means the physical means, agent or mechanism which facilitates the transfer of organisms or their propagules from one place to another.</td>
</tr>
<tr>
<td>NaturalDispersal</td>
<td>Natural spread from a neighbouring region where the species is alien</td>
</tr>
</table>
<p>
<p />
<p><strong>Pathways Values</strong></p>
<p>Process that results in the introduction of alien species from one location to another</p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Release</td>
<td>Intentional introduction as a commodity for release (examples include biocontrol agents, game animals and plants for erosion control - responsibility should be the applicant&#8217;s)</td>
</tr>
<tr>
<td>Escape</td>
<td>Intentional introduction as a commodity but escapes unintentionally (examples include feral crops and livestock, pets, garden plants, live baits - responsibility should be the importer&#8217;s) [should this include illegal release of e.g. pets, fish for stocking, biocontrol agents, game animals?]</td>
</tr>
<tr>
<td>Contaminant</td>
<td>Unintentional introduction with a specific commodity (examples include parasites, pests and commensals of traded plants and animals - responsibility should be the exporter&#8217;s)</td>
</tr>
<tr>
<td>Stowaway</td>
<td>Unintentional introduction attached to or within a transport vector (examples include hull fouling, ballast water/soil/sediment/organisms - responsibility should be the carrier&#8217;s)</td>
</tr>
<tr>
<td>Corridor</td>
<td>Unintentional introduction via human infrastructures linking previously unconnected regions (examples include Lessepsian migrants, Ponto-Caspian aliens in the Baltic- responsibility should be the developer&#8217;s)</td>
</tr>
<tr>
<td>Unaided</td>
<td>Unintentional introduction through natural dispersal of alien species across political borders (potentially all alien taxa are capable of dispersal - responsibility should be the polluter&#8217;s)</td>
</tr>
</table>
<P>
*Mechanism and Pathway values and descriptions are adapted from: Hulme PE, Bacher S, Kenis M, Klotz S, K<>hn I, Minchin D, Nentwig W, Olenin S, Panov V, Pergl J, Py*ek P, Roques A, Sol D, Solarz W &amp; Vil<69>, M (2008) Grasping at the routes of biological invasions: a framework to better integrate pathways into policy. Journal of Applied Ecology, 45 (in press).
<p>
6. PROPOSAL: Have a Metadata <span class="twikiNewLink">DataModel<a href="/twiki/bin/edit/InvasiveSpecies/DataModel?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span>.<br>
Status: Investigating<br>
Jim: Does TDWG have something we can use here? The TAPIR <span class="twikiNewLink">MetaData<a href="/twiki/bin/edit/InvasiveSpecies/MetaData?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> <span class="twikiNewLink">DataModel<a href="/twiki/bin/edit/InvasiveSpecies/DataModel?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> is for the entire data source so it does not fit well.<br>
<p>
7. PROPOSAL: Have a Citation <span class="twikiNewLink">DataModel<a href="/twiki/bin/edit/InvasiveSpecies/DataModel?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span>. <br>
Status: Investigating<br>
Jim: Does TDWG have something we can use here?<br>
<p>
8. PROPOSAL: Add GUIDs to each record using LSIDs where appropriate<br>
Status: Proposed<br>
<p>
9. PROPOSAL: We need a method to add general text to each record for comments, descriptions, etc.<br>
Status: Proposed<br>
Discussion: Add a &#8220;Comments&#8221; text field to each <span class="twikiNewLink">DataModel<a href="/twiki/bin/edit/InvasiveSpecies/DataModel?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> but insure that the documentation indicates it should not be used for information that is covered in elsewhere in the protocol and cannot be queried at the same level of performance or reliability.<br>
----
Posted Protocol Specification text on Wiki -- <a href="http://www.tdwg.org/membership/list-of-users/?tx_newloginbox_pi3%5BshowUsername%5D=AnnieSimpson#" class="twikiAnchorLink">AnnieSimpson</a> - 04 Aug 2007
<p />
Added <span class="twikiNewLink">DateOfIntroduction<a href="/twiki/bin/edit/InvasiveSpecies/DateOfIntroduction?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> into Table 4.4.7; added detailed descriptions for 'cause' and 'vector';
-- <a href="http://www.tdwg.org/membership/list-of-users/?tx_newloginbox_pi3%5BshowUsername%5D=AnnieSimpson#" class="twikiAnchorLink">AnnieSimpson</a> - 05 Aug 2007
<p />
Added <span class="twikiNewLink">ImpactStrength<a href="/twiki/bin/edit/InvasiveSpecies/ImpactStrength?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> values (and reference) to table at end of section 4.4.6.1.
-- <a href="http://www.tdwg.org/membership/list-of-users/?tx_newloginbox_pi3%5BshowUsername%5D=AnnieSimpson#" class="twikiAnchorLink">AnnieSimpson</a> - 06 Aug 2007
<p />
Removed <span class="twikiNewLink">AbundanceValue<a href="/twiki/bin/edit/InvasiveSpecies/AbundanceValue?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> = monoculture
-- <a href="http://www.tdwg.org/membership/list-of-users/?tx_newloginbox_pi3%5BshowUsername%5D=AnnieSimpson#" class="twikiAnchorLink">AnnieSimpson</a> - 09 Aug 2007
<p />
Removed Protocol Specification document's main text but kept suggested changes list; added document URL as reference; added instructions for making additional comments. -- <a href="http://www.tdwg.org/membership/list-of-users/?tx_newloginbox_pi3%5BshowUsername%5D=AnnieSimpson#" class="twikiAnchorLink">AnnieSimpson</a> - 01 Mar 2008
@
1.13
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="AnnieSimpson" date="1204414544" format="1.1" reprev="1.13" version="1.13"}%
d48 1
a48 1
<td>SpeciesHabitat</td>
d52 1
a52 1
<td>The habitat in which the species occurs</td>
d135 1
a135 1
<td>Whether the organism is considered invasive. 'Spread' information is dealt with here. 'Harm' information in the <span class="twikiNewLink">ImpactStatus<a href="/twiki/bin/edit/InvasiveSpecies/ImpactStatus?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span> element</td>
d146 1
d156 1
a156 1
<p />
d167 1
a167 1
<td>HabitatImpacted</td>
d171 1
a171 1
<td>The habitat being impacted </td>
d174 1
a174 1
<td>EcosystemImpacted</td>
d178 1
a178 1
<td>Type of ecosystem being impacted</td>
d184 51
a234 2
<td>HarmfulToEnvironment, <span class="twikiNewLink">HarmfulToHumanHealth<a href="/twiki/bin/edit/InvasiveSpecies/HarmfulToHumanHealth?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span>, <span class="twikiNewLink">HarmfulToLivelihoods<a href="/twiki/bin/edit/InvasiveSpecies/HarmfulToLivelihoods?topicparent=InvasiveSpecies.ProtocolSpecGISIN" rel="nofollow" title="Create this topic">?</a></span></td>
<td>What values the species is impacting </td>
d251 63
d315 5
d323 5
a327 1
<p />
d382 1
a382 1
<td>A high-level categorization of how the organism is dispersing </td>
d469 1
@
1.12
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="AnnieSimpson" date="1204399605" format="1.1" version="1.12"}%
a5 1
* Suggested changes:
d7 356
a363 1
* Comments:
d369 12
a380 1
-- Main.AnnieSimpson - 01 Mar 2008 - removed document text, added document URL, instructions, and headings for comments.@
1.11
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MichaelBrowne" date="1203646911" format="1.1" reprev="1.11" version="1.11"}%
d3 2
a4 8
<!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">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>GISIN: Protocol Specification</title>
<link rel='stylesheet' href='W3C-REC.css' type='text/css'>
<link rel='stylesheet' href='custom.css' type='text/css'>
</head>
d6 1
a6 2
<body>
<h1>GISIN Web Service Protocol Specification</h1>
a7 2
<h4>Version: 1.8.1, ProtocolSpecGISIN</h4>
<h4>Last Update: 5 August, 2007</h4>
d9 1
a9 33
<h2>1. Introduction</h2>
<p>This document defines the protocol that will be used to communicate invasive species data between computers. For information on why the specification includes the features it does, please see the <a href='Requirements.html'>Requirements Specification</a>.</p>
<p>This document is written for individuals who plan on implementing their own GISIN consumer or provider and assumes the reader has some understanding of web service protocols, <a href='http://www.w3.org/Protocols/'>Hypertext Transfer Protocol (HTTP)</a>, Structured Query Language (SQL), and the <a href="www.gisinetwork.org">Global Invasive Species Information Network (GISIN)</a>. An <a href='Introduction.html'>Introduction to GISIN </a> is available on this web site. W3 Schools provides a free tutorial on <a href='http://www.w3schools.com/sql/default.asp'>SQL</a>. The protocol specification described here has borrowed from other specifications wherever possible. See the <a href='http://wiki.tdwg.org/twiki/bin/view/DarwinCore/WebHome'>DarwinCore</a> documentation, the <a href='http://www.opengeospatial.org/standards'>OpenGIS</a> <a href='http://www.opengeospatial.org/standards/wms'>Web Map Service</a> (WMS), and <a href='http://www.opengeospatial.org/standards/gml'>Geography Markup Language</a> (GML) for related topics. </p>
<h3>1.1 Acknowledgements</h3>
<p>A large number of individuals and organizations helped with the initial idea, content, and reviews of this protocol. They include; Jim Graham and Annie Simpson for coordinating and documenting the effort, Jerry Cooper, Bob Morris and Michael Browne for original work on the IASPS documentation which was a starting point for this document; Greg Ruiz and Jim Carlton for their Framework for Vector Science; Pam Fuller, Greg Ruiz, Brian Steves, and Shawn Dalton, for their development of NISBase as the ground breaking work on implementing invasive species data exchange; Michael Browne for facilitating the development of the status categories; Robert Hilliard, Kevin Thiele and Aaron Wilton for assistance in integrating vocabularies, Roger Hyam, Renato De Giovanni, and Markus Doring for help with implementing TAPIR; Donald Hobern and Hannu Saarenmaa for overall guidance, and Liz Sellers, Rob Emery, Jacob Asiedeau, Greg Newman, Catherine Jarnevich, Silvia Ziller, Andrea Grosse, Olivier de Munck, the staff of Invasive Species Specialist Group and the Global Invasive Species Database. </p>
<p>If we have forgotten anyone please let us know!</p>
<h2>2. Overview</h2>
<p>The protocol has been designed with potential data providers in mind, including, a recognition that these organizations will tend to have simple, flat databases, with minimal technical resources to modify their databases to make them available as a web service. At the same time the protocol must perform at high speeds to allow for both a large number of providers and for providers with very large data sets. </p>
<p>The system operates as an HTTP Request/Response protocol. This is the same method used to serve web pages on the Internet, and ensures, that it can pass through the largest number of firewalls without security problems. This approach also provides the required flexibility with very high performance. </p>
<p>The protocol is a subset of the functionality defined by the <a href="http://www.tdwg.org/dav/subgroups/tapir/1.0/docs/TAPIRSpecification_2007-02-24.html">TAPIR protocol</a>. Specifically, only simple Key-Value Pair (KVP) requests are supported because complex filters encoded as XML were not required and add significant complexity to the provider software. Within TAPIR, the data type of interest is identified as a &quot;Model&quot; and the data elements within the Model as &quot;Concepts&quot;. The protocol described here also implements a limited set of Models and Concepts specifically for the invasive species community. To allow providers to implement the protocol without having to reference the complete TAPIR specification, the present document repeats some of the information that is also available in the TAPIR specification. </p>
<p>The protocol operates by having a client computer submit a request to a specific service on a server computer (also referred to as a the provider). If the server can complete the request it returns the information in a response, otherwise the server returns an error response.</p>
<p>Web services are typically implemented in a web scripting framework such as PHP, ASP, JSP, or CGI with a web scripting language such as PHP, VBScript, JScript, or Perl. Complied languages such as Visual Basic, Java, C# and C++ are also used to program web services. </p>
<p>Each request contains a desired operation and additional parameters depending on which operation is specified. </p>
<p>Operations:</p>
<ul>
<li>Ping: Simple call to insure the service is available </li>
<li>Metadata: Default operation to retrieve basic information about the service </li>
<li>Capabilities: Requests which operations are supported and for which Models </li>
<li>Inventory: Requests the type of records a provider has for a particular Model and, optionally, how many</li>
<li>Search: Requests a set of requested records for a particular Model </li>
</ul>
<p>Inventory and Search operations must specify the type of data, or Model, desired. A list of the defined Models for GISIN are below. Types 1 through 3 are supported in version 1.x of the specification. </p>
<p>Models: </p>
<ol>
<li>BioStatus - BioStatus for a species, in a particular location, at a particular date. This includes data on origin, presence, distribution, abundance, rate of spread, whether the species is harmful. </li>
<li>ProfileURLs - URLs to web pages with profile information (also known as descriptions or fact-sheets) </li>
<li>Occurrences - Spatial information on species locations at specified dates. The location can be coordinates or location names. </li>
<li>Profile data - Data to profile specific species (i.e. life history, management, identification, etc.) </li>
<li>ImpactStatus - The types of impacts the organism is causing at a specific location </li>
<li>DispersalStatus - The methods of dispersal used by the organism. </li>
<li>ManagementStatus - The management activities engaged for an organism </li>
<li>Pictures - Digital images of species, impacts, and key charateristics (not defined yet) </li>
</ol>
a10 9
<p>Note: We broke out ManagementStatus and ImpactStatus from BioStatus when we realized there could be multiple records for ManagementStatus and/or ImpactStatus for a single BioStatus record (i.e. a single species and location). This allows us to keep the Model records flat. </p>
<h3>2.1 Requests </h3>
<p>The form of a request is shown below. &quot;&lt;URL&gt;&quot; is a placeholder for the URL from the registry. The URL must be a fully qualified URL that is available on the Internet. The URL will end with &quot;?&quot; if it contains no parameters and with an &quot;&amp;&quot; if it contains parameters. The additional parameters are added without a delimiter to allow either the first delimiter &quot;?&quot; or a subsequent delimiter &quot;&amp;&quot; to be specified by the provider. Requests can be either GET or POST although POST is recommended. </p>
<p>Request:</p>
<div class="exampleInner">
<pre>http://&lt;URL&gt;Additional Parameters
</pre>
</div class="exampleInner">
<p>The Ping, Metadata, and Capabilities operations do not have any additional parameters. Inventory and Search operations include additional parameters to specify the desired data contained to be contained within the response.</p>
a11 25
<p>Warning: Because some web services treat parameter names as case sensitive please ensure the letter case of the request matches the specification exactly. </p>
<h3>2.2 Responses</h3>
<p>Responses (including errors) are encoded in XML unless images are requested. Images are returned in JPEG, PNG, or GIF formats. Errors are encoded as XML. </p>
<p>Below is a template for a typical response. There are just 2 tags included within a &quot;response&quot; element. The &quot;header&quot; element contains information about the response. The name &quot;operation&quot; in the second element will be replaced by the operation name (&quot;ping&quot;, &quot;inventory&quot;, etc.). The second element will contain a series of records containing the data of interest. </p>
<div class="exampleInner">
<PRE>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;response&gt;
&lt;header&gt;
&lt;source accesspoint="http://example.org/GISIN.asp"
sendtime="2005-11-11T12:23:56"/&gt;
&lt;/header&gt;
&lt;operation&gt;
&lt;record&gt;
&lt;elementName&gt;Element Value&lt;/elementName&gt;
&lt;/record&gt;
&lt;summary start="0" totalReturned="1"/&gt;
&lt;/operation&gt;
&lt;/response&gt;</PRE>
</div class="exampleInner">
<h2>3. Operations </h2>
<p>Note: &quot;Contains&quot; is not supported in TAPIR and I have a request for how to perform this without incurring a &quot;COUNT(*)&quot; operation. </p>
<p>Note: &quot;Count&quot; has been replaced by performing an inventory operation with &quot;Count=true&quot; and no Concepts. </p>
<h3>3.1 Ping </h3>
<p>Ping is a simple operation that returns a &quot;Pong&quot; from the provider's web service to insure that the service is up and running.</p>
a12 4
<h3>3.2 Metadata </h3>
<p>The Metadata operation returns descriptive information about the web service and the organization hosting it. </p>
<h3>3.3 Capabilities </h3>
The Capabilities operation returns information about which operations the web service supports, which Models are supported, and which Concepts within each Model. Web services supporting this protocol can simply return the content shown below in the example response (see 4.3.1). The Inventory and Search templates will then be provided by the GISIN system to match this specification.
d14 2
a15 2405
<h3>3.4 Inventory </h3>
<h4>3.4.1 Determine the number of records available for each Model </h4>
<p>Using the inventory command without any Concepts allows the client to determine the number of records that will be available for a given filter. This operation asks the question &quot;How many of a given type of data do you have for a given set of filters?&quot; Examples include:</p>
<ul>
<li>How many BioStatuses do you have for New Zealand?</li>
<li>How many Occurrences do you have for <i>Tamarix</i>?</li>
<li>How many ProfileURLs do you have for <i>Pinus</i>?</li>
</ul>
<p>This operation will return a count of the number of available records given a general format of:</p>
<blockquote>
<p>- How many [Model] do you have for [Filter(s)]?<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; - Returns number of records</p>
</blockquote>
<p>A possible SQL statement for this operation is shown below. &quot;COUNT(*)&quot; if the SQL statement to the number of records that match the specified filters. TableName is defined by the desired Model. &quot;RecordSet=Execute(Query)&quot; returns a record set with the first field in the first record equal to the number of records that match the filter. Returning &quot;RecordSet(1)&quot; returns this field. </p>
<blockquote>
<p>- Query=&quot;SELECT COUNT(*) TableName WHERE Filters&quot;<br />
- RecordSet=Execute(Query)<br />
- Return RecordSet(1)</p>
</blockquote>
<p>Note: This operation should be used sparingly since this operation causes the database to search for all the records for a given filter and may be as time consuming as requesting all the actual records for the filter. This operation should not be called each time a block of records is requested, instead call this operation once at the start of a series of requests. </p>
<h4>3.4.2 Determine the records available within each Model </h4>
<p>Using the Inventory operation with a list of Concepts allows the client to determine the type and number of records that are available for a given Model and set of filters. Examples include:</p>
<ul>
<li> What species do you have BioStatuses for where the origin is not indigenous and the species is harmful for the country of New Zealand?</li>
<li>What locations do you have BioStatuses for members of the genus <i>Tamarix</i>? </li>
<li>What species do you have Occurrences for? </li>
</ul>
<p>This operation will return either a set of records with the specified Concepts and has general form shown below. Concepts indicate the desired content of the response records and how to group the Concepts for counting. ScientificName or Location information is typical. Limit is the maximum number of records the client should return while Start is a zero-referenced index to the first record to return. Model and Filters are the same as defined earlier. </p>
<ul>
<li>Get at most [Limit] records for [Model] containing [Concepts] starting at [Start] with [Filters]</li>
<li>Returns species list or location list</li>
</ul>
<p>The general form can be translated by the server into a SQL statement of the form below. &quot;DISTINCT&quot; term will limit the result to just the distinct species or locations. Fields will select either the scientific name or the appropriate location fields. The &quot;LIMIT Start, Limit&quot; clause will have the database start at Start and return at most Limit. The server should then return the resulting records encoded as XML.</p>
<ul>
<li> Query=&rdquo;SELECT DISTINCT Fields,COUNT(*) LIMIT Start, Limit FROM Table WHERE Filters GROUP BY Fields &rdquo;</li>
<li>RecordSet=Execute(Query)</li>
<li>Return all records in the RecordSet as XML tags</li>
</ul>
<p>Limit, Start, Count and Filters are optional. </p>
<h3>3.4 Search </h3>
<p> Search is very similar to Inventory except that it returns individual records instead of grouping them. The operation returns a block of records containing the BioStatuses, ProfileURL, or Occurrence data based on a specified Model and set of Filters. Examples include:</p>
<ul>
<li>Get all the first 20 BioStatuses for non-native and harmful species for New Zealand</li>
<li>Get from the 21st through the 40th ProfileURL for Tamarix </li>
<li>Get all the Occurrences for Tamarix </li>
</ul>
<p> The general form of this operation is shown below. The parameters have been defined in the sections above.</p>
<ul>
<li>Get at most [Limit] records for [Model] containing [Concepts] starting at [Start] with [Filters]</li>
<li>Returns records</li>
</ul>
<p>The general form can have the SQL form shown below. </p>
<ul>
<li>SELECT * LIMIT Limit,Start FROM Table WHERE Filters</li>
<li>RecordSet=Execute(Query)</li>
<li>Return all records in the RecordSet as XML tags</li>
</ul>
<p>Limit, Start, and Filters are optional. </p>
<h2>4. Details</h2>
<h3>4.1 Ping </h3>
<p>4.1.1 Ping Example</h4>
<p>Request:</p>
<div class="exampleInner">
<pre>http://example.org/service.php?op=Ping
</pre>
</div class="exampleInner">
<p>Response:</p>
<div class="exampleInner">
<pre>
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;response&gt;
&lt;header&gt;
&lt;source accesspoint=&quot;http://example.org/service.php&quot;
sendtime=&quot;2005-11-11T12:23:56&quot;/&gt;
&lt;/header&gt;
&lt;pong/&gt;
&lt;/response&gt;</pre>
</div class="exampleInner"></p>
<h3>4.2 Metadata </h3>
<p>The GISIN metadata elements include same elements as TAPIR (t), some of which are derived (dct) from the Dublin Core Metadata Standard (dc):</p>
<table width="100%" border="1">
<tr>
<th>Name</th>
<th>Type</th>
<th>Required</th>
<th>Description</th>
</tr>
<tr>
<td>&lt;dc:title&gt;</td>
<td>String</td>
<td>Yes</td>
<td>The name or names of the service, which may be in multiple languages (using the xml:lang attribute to identify the language code).</td>
</tr>
<tr>
<td>&lt;dc:type&gt;</td>
<td>String</td>
<td>Yes</td>
<td>The type of resource according to the Dublin Core Type Vocabulary. This value should be the same for all TAPIR providers: http://purl.org/dc/dcmitype/Service, unless the type vocabulary is refined or changed in the future. The purpose is to indicate that the resource is actually a service.</td>
</tr>
<tr>
<td>&lt;t:accesspoint&gt;</td>
<td>String</td>
<td>Yes</td>
<td>(synonym of &lt;dc:identifier&gt;). The URL of the service.</td>
</tr>
<tr>
<td>&lt;dc:description&gt;</td>
<td>String</td>
<td>&nbsp;</td>
<td>The description may include, but is not limited to, an abstract, a table of contents, a reference to a graphical representation of content, or a free-text account of the content. Can be provided in different languages.</td>
</tr>
<tr>
<td>&lt;dc:language&gt;</td>
<td>String</td>
<td>Yes</td>
<td>The primary language of the data provided by the service. It is recommended to use codes defined by the IANA Language Subtag Registry.</td>
</tr>
<tr>
<td>&lt;dc:subject&gt;</td>
<td>String</td>
<td>No</td>
<td><br />
Subject and Keywords. Typically, a subject will be expressed as keywords, key phrases or classification codes that describe content provided by the resource. Recommended best practice is to select a value from a controlled vocabulary or formal classification scheme.</td>
</tr>
<tr>
<td>&lt;dc:bibliographicCitation&gt;</td>
<td>String</td>
<td>No</td>
<td>Recommended practice is to include sufficient bibliographic detail to identify the resource as unambiguously as possible, whether or not the citation is in a standard form. Can be provided in different languages. </td>
</tr>
<tr>
<td>&lt;t:rights&gt;</td>
<td>String</td>
<td>No</td>
<td>(homonym of &lt;dc:rights&gt; a statement about property rights)<br />
Information about who can access the resource or about its security status, access regulations, etc. Can be provided in different languages.</td>
</tr>
<tr>
<td>&lt;dct:modified&gt;</td>
<td>Date</td>
<td>No</td>
<td>Date on which the service was last modified</td>
</tr>
<tr>
<td>&lt;dct:created&gt;</td>
<td>Date</td>
<td>No</td>
<td>Date on which the service was created</td>
</tr>
<tr>
<td>&lt;t:indexingPreferences&gt;</td>
<td>Element</td>
<td>No</td>
<td><p>Used to inform data aggregators and indexers about the preferred start time, duration and frequency for performing this operation.</p>
<p>Has three attributes: <br />
@@startTime: In the XML Schema time format. <br />
@@maxDuration: In the XML Schema duration format. <br />
@@Frequency: In the XML Schema duration format. </p></td>
</tr>
<tr>
<td>&lt;t:relatedEntity&gt;</td>
<td>Element</td>
<td>Yes</td>
<td>A complex element indicating the entities related to the service. </td>
</tr>
<tr>
<td>&lt;t:custom&gt;</td>
<td>Element</td>
<td>No</td>
<td>Element of any type to include any additional information that goes beyond the standard TAPIR metadata. </td>
</tr>
</table>
<p><br />
Please see the <a href="http://www.tdwg.org/dav/subgroups/tapir/1.0/docs/TAPIRSpecification_2007-02-24.html#toc38">TAPIR specification</a> for more information on the Metadata operation, as well as the <a href="http://dublincore.org/documents/dces/">Dublin Core Metadata Element Set, version 1.1</a> and the <a href="http://dublincore.org/documents/library-application-profile/index.shtml#BibliographicCitation">Dublin Core BibliographicCitation</a>.</p>
<h3>4.3 Capabilities </h3>
<p>This function allows the user to determine the types of information (Models) available through a GISIN system provider, and its degree of detail (Concepts).</p>
<p>4.3.1 Capabilities Example</p>
<p>Request:</p>
<div class="exampleInner">
<pre>http://example.org/service.php?op=Capabilities
</pre>
</div class="exampleInner">
<p>Response:</p>
<div class="exampleInner">
<pre>
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;response&gt;
&lt;header&gt;
&lt;source accesspoint=&quot;http://example.org/service.php&quot;
sendtime=&quot;2005-11-11T12:23:56&quot;/&gt;
&lt;/header&gt;
&lt;operations&gt;
&lt;ping/&gt;
&lt;metadata/&gt;
&lt;capabilities/&gt;
&lt;inventory&gt;
&lt;template location='http://example.org/InventoryTemplates.html'/&gt;
&lt;/inventory&gt;
&lt;search&gt;
&lt;template location='http://example.org/SearchTemplates.html'/&gt;
&lt;/search&gt;
&lt;/response&gt;</pre>
</div class="exampleInner">
<h3>4.4 Inventory and Search </h3>
<p>The difference between the inventory and search operations is that the inventory operation aggregates data and the search operation returns data from individual records. The parameters are the same for these operations except that the inventory operation can specify a &quot;count&quot; parameter. Below are the common Concepts and parameters for inventory and search operations that are supported by one or more data Models. The specifics for each data Model follow. </p>
<h4>4.4.1 Common Concepts </h4>
<p>The following Concepts are used to identify the Date, Taxonomy, Location, and the Language for text results within the data for all Models. </p>
<table width="100%" border="1" cellspacing="0" cellpadding="2">
<tr>
<th>Name</th>
<th>Data Type</th>
<th>Values/Range</th>
<th>Description</th>
</tr>
<tr>
<td>DateLastModified</td>
<td>Date</td>
<td>YYYY-MM-DD</td>
<td>See section 4.4.1.1</td>
</tr>
<tr>
<td>StartValidDate</td>
<td>Date</td>
<td>YYYY-MM-DD</td>
<td>See section 4.4.1.1</td>
</tr>
<tr>
<td>EndValidDate</td>
<td>Date</td>
<td>YYYY-MM-DD</td>
<td>See section 4.4.1.1</td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>Kingdom</td>
<td>String</td>
<td>Monera, Protista, Fungi, Plantae, Animalia </td>
<td>See section 4.4.1.2</td>
</tr>
<tr>
<td>ScientificName</td>
<td>String</td>
<td>See section 4.4.1.2</td>
<td>See section 4.4.1.2</td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>DecimalLatitude</td>
<td>Float</td>
<td>-90 to 90 degrees </td>
<td>See section 4.4.2</td>
</tr>
<tr>
<td>DecimalLongitude</td>
<td>Float</td>
<td>-180 to 180 </td>
<td>See section 4.4.2</td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>CountryCode</td>
<td>String</td>
<td>See section 4.4.1.3 </td>
<td>&nbsp;</td>
</tr>
<tr>
<td>StateName</td>
<td>String</td>
<td>See section 4.4.1.3 </td>
<td>&nbsp;</td>
</tr>
<tr>
<td>CountyName</td>
<td>String</td>
<td>See section 4.4.1.3 </td>
<td>&nbsp;</td>
</tr>
<tr>
<td>LocalityName</td>
<td>String</td>
<td>See section 4.4.1.3 </td>
<td>&nbsp;</td>
</tr>
<tr>
<td>USA_FIPSCode</td>
<td>String</td>
<td>See section 4.4.1.3 </td>
<td>&nbsp;</td>
</tr>
<tr>
<td>USA_HUC</td>
<td>String</td>
<td>See section 4.4.1.3 </td>
<td>&nbsp;</td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>LanguageCode</td>
<td>String</td>
<td>See section 4.4.1.4</td>
<td>&nbsp;</td>
</tr>
</table>
<EFBFBD>
<p>Note: If a provider does not support a particular Concept it should simply not return that Concept as an element of the record. </p>
<h5>4.4.1.1 Dates<a href="http://www.loc.gov/standards/iso639-2/"></a></h5>
<p>Dates are represented as documented in International Standard ISO 8601. This format is YYYY-MM-DD where YYYY is the decimal year in the Gregorian calendar. See <a href='http://www.cl.cam.ac.uk/~mgk25/iso-time.html'>Markus's</a> web page for a quick summary. At least a year is required, month and day are preferred as well. </p>
<p>The DateLastModified is the last date that the record was changed. This will be used by data consumers of if they cache data. If the provider does not maintain a DateLastModfiied in their database they should always return the current date.</p>
<p>The StartValidDate and EndValidDate represent the range of when a &quot;status&quot; data Model is valid. Data providers should return an empty element for the EndValidDate if the status is still current. </p>
<h5>4.4.1.2 Taxa</h5>
<p>ScientificName is the primary means of filtering by taxa. At least a Genus is required. Species, subspecies, variety, author, and date may be provided in standard taxonomic notation. Kingdom is recommended to be included in all requests with ScientificName's to resolve the few conflicts where the same genus appears in more than one Kingdom. </p>
<p>Examples of scientific names include:</p>
<ul>
<li><i>Tamarix</i></li>
<li><i>Tamarix ramossissima</i></li>
<li><i>Tamarix ramossissima&nbsp;</i>Ledeb<i>. </i></li>
<li><i>Boiga irregularis</i>&nbsp;Merrem, 1802</li>
<li><em>Moerckia</em> <em>hibernica</em> var. <em>wilsoniana</em> Gottsche </li>
<li><em>Epipenaeon</em> <em>ingens</em> <em>latifrons</em> Bourdon, 1979 </li>
<li><em>Symphyotrichum</em> <em>lanceolatum</em> ssp. <em>hesperium</em> var. <em>hesperium</em> (Gray) Nesom </li>
</ul>
<p>Note: We need to define how Taxonomic Concepts will be included. </p>
<h5>4.4.1.3 Locations</h5>
<p>Invasive species location data can be in one of four forms: 1) international codes, 2) locality names, 3) locality codes, and 4) geographic coordinates. International codes exist for countries and are available from the <a href='http://unstats.un.org/unsd/methods/m49/m49alpha.htm'>United Nations. </a>Once a country code is specified, locality names can be used within that country. The first subdivision below a country should be province which includes states. The second should be counties (which includes cantons). If names are not associated with a LanguageCode then they are assumed to be in the default language of the provider. Locality codes are defined with a country code as a prefix, e.g. &quot;USA_HUC&quot; for the United States Hydrologic Unit Codes. </p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Location Type</th>
<th>Synonyms</th>
</tr>
<tr>
<td>State</td>
<td>Province, commonwealth </td>
</tr>
<tr>
<td>County</td>
<td>Shire, canton </td>
</tr>
<tr>
<td>WaterBody</td>
<td>Lake, stream, river, ocean, sea </td>
</tr>
<tr>
<td>Locality</td>
<td>City, town, burg,municipality </td>
</tr>
<tr>
<td>Island</td>
<td>Isle</td>
</tr>
</table>
<center>
<b>Table 1. Complete list of supported Location Name Types</b>
</center>
<p>Filtering for geographic coordinates is only supported for geographic bounding boxes.</p>
<p>Readers should recognize that certain providers will have only local names while others will have only geographic coordinates (of a variety of types). Consumers may request just LocationNames, just Geographic coordinates, or both. The data provider should provide all the information it has available that meets the requested content.</p>
<h5>4.4.1.4 Languages</h5>
<p>Languages are specified with <a href="http://www.loc.gov/standards/iso639-2/"><strong>IS0 639-2</strong></a> codes. These are 3-letter codes. In some cases a bibliographic code and a terminology code is provided. In this case GISIN uses the terminology code. Some examples are below. </p>
<ul>
<li>English: eng</li>
<li>French: fra </li>
<li>Spanish: spa </li>
<li>German: deu</li>
<li>Chinese: zho</li>
<li>Italian: ita</li>
<li>Dutch: nld </li>
<li>Portuguese: por</li>
</ul>
<h4>4.4.2 Common Parameters </h4>
<p>Below are parameters that can be applied to either Inventory or Search operations and with one or more data Models. </p>
<table width="100%" border="1" cellspacing="0" cellpadding="2">
<tr>
<th>Name</th>
<th>Data Type</th>
<th>Filter</th>
<th>Description</th>
</tr>
<tr>
<td>DateLastModifiedMin</td>
<td>Date</td>
<td>DateLastModified &gt;= Value</td>
<td>Defines the start of the date range for modified records </td>
</tr>
<tr>
<td>DateLastModifiedMax</td>
<td>Date</td>
<td>DateLastModified &lt;= Value</td>
<td>Defines the end of the date range for modified records </td>
</tr>
<tr>
<td>ValidDateMin</td>
<td>Date</td>
<td>StartLastModified &gt;= Value</td>
<td>Defines the first date of interest for status reports </td>
</tr>
<tr>
<td>ValidDateMax</td>
<td>Date</td>
<td>EndLastModified &lt;= Value</td>
<td>Defines the last date of interest for status reports </td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>Kingdom</td>
<td>String</td>
<td>Kingdom = Value</td>
<td>Defines the Kingdom of interest</td>
</tr>
<tr>
<td>ScientificName</td>
<td>String</td>
<td>ScientificName LIKE Value</td>
<td> Defines a complete or partial scientific name</td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>DecimalLatitudeMin</td>
<td>Float</td>
<td>DecimalLatitude &gt;= Value</td>
<td> Minium latitude of interest for bounding box or points </td>
</tr>
<tr>
<td>DecimalLatitudeMax</td>
<td>Float</td>
<td>DecimalLatitude &gt;= Value</td>
<td>Maximum latitude of interest for bounding box or points </td>
</tr>
<tr>
<td>DecimalLongitudeMin</td>
<td>Float</td>
<td>DecimalLongitude &gt;= Value</td>
<td> Minimum longitude of interest for bounding box or points </td>
</tr>
<tr>
<td>DecimalLongitudeMax</td>
<td>Float</td>
<td>DecimalLongitude &gt;= Value</td>
<td>Maximum longitude of interest for bounding box or points </td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>CountryCode</td>
<td>String</td>
<td>CountryCode = Value </td>
<td>&nbsp;</td>
</tr>
<tr>
<td>StateName</td>
<td>String</td>
<td>Province LIKE Value</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>CountyName</td>
<td>String</td>
<td>County LIKE Value</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>LocalityName</td>
<td>String</td>
<td>Locality LIKE Value</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>USA_FIPSCode</td>
<td>String</td>
<td>USA_FIPSCode = Value</td>
<td>Federal Information Processing Standard Code (for places, counties, states)</td>
</tr>
<tr>
<td>USA_HUC</td>
<td>String</td>
<td>USA_HUC = Value</td>
<td> Hydrologic Unit Code</td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>LanguageCode</td>
<td>String</td>
<td>LanguageCode = Value </td>
<td>See <a href="http://www.loc.gov/standards/iso639-2/"><strong>IS0 639-2</strong></a></td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>Start</td>
<td>Integer</td>
<td>Record index &gt;=0 </td>
<td>Zero-based index from first record in the record set derived from the specified filters </td>
</tr>
<tr>
<td>Limit</td>
<td>Integer</td>
<td>Number of records &lt;= Limit </td>
<td>Maximum number of records to return</td>
</tr>
<tr>
<td>Count</td>
<td>String</td>
<td>&nbsp;</td>
<td>Adds a &quot;count&quot; attribute to each record element </td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>Concept</td>
<td>String</td>
<td>&nbsp;</td>
<td>Defines w hich fields to return. Multiple Concepts can be specified with multiple Concept parameters. </td>
</tr>
<tr>
<td>OrderBy</td>
<td>String</td>
<td>&nbsp;</td>
<td>How to order the response data. Multiple &quot;OrderBy&quot; parameters can be specified, e.g. OrderBy=DateLastModified&amp;OrderBy=StateName </td>
</tr>
</table>
<p>The default operation for the service is to return all the data contained in the service, in other words the default for each filter parameter is the entire valid range. </p>
<h4>4.4.3 BioStatus </h4>
<p>The BioStatus model contains information on the status of a species within a specific location, and within a specific date range. </p>
<h5>4.4.3.1 BioStatus Concepts </h5>
<p>BioStatuses are required to support the following general Concepts:</p>
<ul>
<li> Taxon: At least a scientific name</li>
<li>Location: At least one code or name, coordinates do not apply to BioStatus (coordinates would imply an Occurrence) </li>
<li>DateLastModified </li>
<li>ValidDate</li>
</ul>
<p>BioStatuses support the following additional Concepts. Possible values for the Concepts are listed below this table. </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>Source</td>
<td>No</td>
<td>String</td>
<td>&nbsp;</td>
<td>Citation for the source of the data </td>
</tr>
<tr>
<td>Origin</td>
<td>Yes</td>
<td>String</td>
<td>Indigenous, Nonindigenous, Unknown </td>
<td>Whether the species is considered to be native to a particular location or not. </td>
</tr>
<tr>
<td>Presence</td>
<td>Yes</td>
<td>String</td>
<td>Absent, Sometimes, Present, Unknown </td>
<td>There is supporting evidence to show the species is present within the valid date </td>
</tr>
<tr>
<td>Persistence</td>
<td>No</td>
<td>String</td>
<td>Persistent, Temporary [let's delete this value. MB], Transient, DiedOut, Unknown </td>
<td>How successful the organism is at surviving and reproducing </td>
</tr>
<tr>
<td>Distribution</td>
<td>No</td>
<td>String</td>
<td>Widespread, Moderate, Localized, Unknown </td>
<td>Whether the species is limited to a local area or covers vast tracks of land or water </td>
</tr>
<tr>
<td>Abundance</td>
<td>No</td>
<td>String</td>
<td>Dominant, Common, Rare, Zero, Unknown </td>
<td>How abundant the organism is </td>
</tr>
<tr>
<td>Trend</td>
<td>No</td>
<td>String</td>
<td>Expanding, Stable, Declining, Unknown </td>
<td>Whether the range of the organism is increasing or decreasing </td>
</tr>
<tr>
<td>RateOfSpread</td>
<td>No</td>
<td>String</td>
<td>Rapid, Moderate, Slow, Unknown </td>
<td>How quickly the range of the organism is expanding </td>
</tr>
<tr>
<td>Harmful</td>
<td>Yes</td>
<td>String</td>
<td>Yes, No, Potentially, Unknown</td>
<td>Whether the organism is considered harmful. More detailed 'harm' information is dealt with in the Impact Status element </td>
</tr>
<tr>
<td>RegulartoryListing</td>
<td>No</td>
<td>String</td>
<td>Prohibited, Restricted, NotConsidered, Unknown </td>
<td>The legal regulatory status of the organism </td>
</tr>
</table>
<p><strong>Origin Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Indigenous</td>
<td>Naturally distributed within the region of interest, with a long-term presence extending into the pre-historic record</td>
</tr>
<tr>
<td>Nonindigenous</td>
<td>(Alien, foreign, exotic, introduced, non-native) Means a species, subspecies, or lower taxon occurring outside of its natural range (past or present) and dispersal potential (i.e. outside the range it occupies naturally or could not occupy without direct or indirect introduction or care by humans) and includes any part, gametes or propagule of such species that might survive and subsequently reproduce (IUCN 2000). Includes aboriginal introductions and archeozoa/archeophytes (early introductions of organisms into Europe by humans that are strongly integrated in European ecosystems) </td>
</tr>
<tr>
<td>Unknown</td>
<td>Includes 'Cryptogenic' i.e. a species which is neither demonstratively native nor introduced in a region because its origin/native range is unknown, and 'Uncertain' i.e. the native range is known but this occurrence lies somewhere between its known native and nonindigenous ranges. </td>
</tr>
</table>
<p><strong>Presence Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Absent</td>
<td>Known to be absent. This may be due to Eradication, Interception at border, Presumed extinct (see Persistence) or Recorded in error. These 'Reasons for absence' may become part of an expanded schema</td>
</tr>
<tr>
<td>Sometimes present</td>
<td>Vagrant, migratory or an otherwise &quot;casual&quot; presence</td>
</tr>
<tr>
<td>Present</td>
<td>Known or reported to be present at the date of publication or last update of records. Please note that for aggregated data (e.g. a collection of historic reports), the date of publication or last update of records provides no indication of when the organism was present.</td>
</tr>
<tr>
<td>Unknown</td>
<td>&nbsp;</td>
</tr>
</table>
<p><strong>Persistence Values</strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Persistent</td>
<td>Surviving and reproducing in perpetuity. Synonymous with 'naturalized'.</td>
</tr>
<tr>
<td>Temporary</td>
<td>Surviving and reproducing for a limited period [let's delete this value. MB]</td>
</tr>
<tr>
<td>Transient</td>
<td>Surviving but not reproducing (e.g. remnant species from old gardens). Synonymous with 'established' </td>
</tr>
<tr>
<td>Died out</td>
<td>Not surviving. Presumed extinct at the referenced location.&nbsp;</td>
</tr>
<tr>
<td>Unknown</td>
<td>&nbsp;</td>
</tr>
</table>
<p><strong>Distribution Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Widespread</td>
<td>Occurs in most of the referenced location.&nbsp;</td>
</tr>
<tr>
<td>Moderate</td>
<td>Occurs in some but not all parts of the referenced location.&nbsp;</td>
</tr>
<tr>
<td>Localized</td>
<td>Occurs in only a few parts of the referenced location.&nbsp;</td>
</tr>
<tr>
<td>Unknown</td>
<td>&nbsp;</td>
</tr>
</table>
<p><strong>Abundance Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Dominant</td>
<td>Numerically dominant in the referenced location. Depending on the nature of the referenced location, this information could be at the individual, population, community, ecosystem or landscape scale.</td>
</tr>
<tr>
<td>Common</td>
<td>Common in the referenced location. Moderate abundance&nbsp;</td>
</tr>
<tr>
<td>Rare</td>
<td>Numerically rare in the referenced location.&nbsp;</td>
</tr>
<tr>
<td>Zero</td>
<td>Zero abundance means absent. It's ok to have parameters overlap (but not the values within a parameter).&nbsp;</td>
</tr>
<tr>
<td>Unknown</td>
<td>&nbsp;</td>
</tr>
</table>
<p><strong>Trend Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Expanding</td>
<td> Biomass is increasing</td>
</tr>
<tr>
<td>Stable</td>
<td>Zero, or close to zero, trend</td>
</tr>
<tr>
<td>Declining</td>
<td>Biomass is decreasing</td>
</tr>
<tr>
<td>Unknown</td>
<td>&nbsp;</td>
</tr>
</table>
<p><strong>RateOfSpread Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Rapid</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>Moderate</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>Slow</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>Unknown</td>
<td>&nbsp;</td>
</tr>
</table>
<p><strong>Harmful Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Yes</td>
<td>Any kind of harm has been identified. Could be environmental, social/economic or harmful to human or animal health.</td>
</tr>
<tr>
<td>No</td>
<td>Benign. Not harmful</td>
</tr>
<tr>
<td>Potentially</td>
<td>Has been known to be harmful elsewhere or displays tendencies which could become harmful.</td>
</tr>
<tr>
<td>Unknown</td>
<td>&nbsp;</td>
</tr>
</table>
<p><strong>RegulartoryListing Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Prohibited</td>
<td>Banned organism</td>
</tr>
<tr>
<td>Restricted</td>
<td>Organism with some regulatory restriction or control</td>
</tr>
<tr>
<td>Not considered</td>
<td>Not considered for listing at the date of publication or last update of records</td>
</tr>
<tr>
<td>Unknown</td>
<td>&nbsp;</td>
</tr>
</table>
<h5>4.4.3.2 BioStatus Filters</h5>
<p>BioStatuses are required to support the following general filters:</p>
<ul>
<li> Taxon: At least a scientific name</li>
<li>Location: At least one code or name, coordinates do not apply to BioStatus</li>
<li>DateLastModified </li>
<li>ValidDate</li>
</ul>
<p>BioStatuses support the following additional filters: </p>
<table width="100%" border="1" cellspacing="0" cellpadding="2">
<tr>
<th>Name</th>
<th>Data Type</th>
<th>Returns records with</th>
</tr>
<tr>
<td>Presence</td>
<td>String</td>
<td>Presence = Value</td>
</tr>
<tr>
<td>Persistence</td>
<td>String</td>
<td>Persistence = Value</td>
</tr>
<tr>
<td>Distribution</td>
<td>String</td>
<td>Distribution = Value </td>
</tr>
<tr>
<td>Abundance</td>
<td>String</td>
<td>Abundance = Value </td>
</tr>
<tr>
<td>Trend</td>
<td>String</td>
<td>Trend = Value </td>
</tr>
<tr>
<td>RateOfSpread</td>
<td>String</td>
<td>RateOfSpread = Value </td>
</tr>
<tr>
<td>Harmful</td>
<td>String</td>
<td>Harmful = Value </td>
</tr>
<tr>
<td>RegulartoryListing</td>
<td>String</td>
<td>RegulartoryListing = Value </td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
</table>
</p>
<h5>4.4.3.3 BioStatus Example </h5>
<p>The following example will provide all the BioStatuses within the United States for all species that are both non-native (Native=No) and are considered harmful (this could be considered synonymous with invasive). </p>
<p>Request:</p>
<div class="exampleInner">
<pre>http://example.org/service.php?op=search&amp;Model=BioStatus<br>
&amp;ScientificName=Tamarix&amp;CountryCode=USA&amp;Presence=Present&amp;Harmful=Yes
</pre>
</div class="exampleInner">
<p>Response:</p>
<div class="exampleInner">
<PRE>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;response&gt;
&lt;header&gt;
&lt;source accesspoint="http://example.org/GISIN.asp"
sendtime="2005-11-11T12:23:56"/&gt;
&lt;/header&gt;
&lt;search&gt;
&lt;record&gt;
&lt;scientificName&gt;Tamarix ramossissima&lt;/scientificName&gt;
&lt;countryCode&gt;USA&lt;/countryCode&gt;
&lt;presence&gt;Present&lt;/presence&gt;
&lt;origin&gt;Indigenous&lt;/origin&gt;
&lt;harmful&gt;Yes&lt;/harmful&gt;
&lt;/record&gt;
&lt;summary start="0" totalReturned="1"/&gt;
&lt;/search&gt;
&lt;/response&gt;</PRE>
</div class="exampleInner">
<h4>4.4.4 ProfileURLs </h4>
<h5>4.4.4.1 ProfileURL Concepts </h5>
<p>ProfileURLs are required to support the following general Concepts:</p>
<ul>
<li> Taxon: At least a scientific name</li>
<li>DateLastModified </li>
<li>LanguageCode</li>
</ul>
<p>BioStatuses support the following additional Concepts: </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>URL</td>
<td>Yes</td>
<td>String</td>
<td>&nbsp;</td>
<td>Fully qualified URL to reach the profile over the Internet </td>
</tr>
</table>
<h5>4.4.4.2 ProfileURL Filters</h5>
<p>ProfileURLs can be filtered by the following general filters:</p>
<ul>
<li> Taxon: At least a scientific name</li>
<li>DateLastModified </li>
<li>LanguageCode</li>
</ul>
<h5>4.4.4.3 ProfileURL Example </h5>
<p>The following example will return all the ProfileURLs available for members of the genus <i>Tamarix</i>. </p>
<p>Request:</p>
<div class="exampleInner">
<pre>http://example.org/service.php?op=search&amp;Model=ProfileURL
&amp;ScientificName=Tamarix
</pre>
</div class="exampleInner">
<p>Response:</p>
<div class="exampleInner">
<pre>
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;response&gt;
&lt;header&gt;
&lt;source accesspoint=&quot;http://example.org/GISIN.asp&quot;
sendtime=&quot;2005-11-11T12:23:56&quot;/&gt;
&lt;/header&gt;
&lt;search&gt;
&lt;record&gt;
&lt;scientificName&gt;Tamarix ramossissima&lt;/scientificName&gt;
&lt;url&gt;http://www.invasivespecies.org?ScientificName=Tamarix ramossissima&lt;/url&gt;
&lt;/record&gt;
&lt;summary start=&quot;0&quot; totalReturned=&quot;1&quot;/&gt;
&lt;/search&gt;
&lt;/response&gt;
</pre>
</div class="exampleInner">
<h4>4.4.5 Occurrences </h4>
<p>Occurrence data are especially important for modeling present and future distributions of species. The GISIN system utilized other TDWG standards in the management of occurrence information. </p>
<h5>4.4.5.1 Occurrence Concepts </h5>
<p>Occurrences are required to support the following general Concepts:</p>
<ul>
<li> Taxon: At least a scientific name</li>
<li>Location: At least one code or name, or coordinates</li>
<li>DateLastModified </li>
</ul>
<p>Occurrences support the following additional Concepts: </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>HorizontalDatum</td>
<td>Yes</td>
<td>String</td>
<td>WGS84, HARN</td>
<td>The Datum used to collection the Latitude and Longitude coordinates </td>
</tr>
<tr>
<td>StartCollectionDate</td>
<td>Yes</td>
<td>Date</td>
<td>&nbsp;</td>
<td>First date when the occurrence data for the record was being collected </td>
</tr>
<tr>
<td>EndCollectionDate</td>
<td>Yes</td>
<td>Date</td>
<td>&nbsp;</td>
<td>Last date of collections. Typically StartCollectionDate and EndCollectionDate will be the same </td>
</tr>
<tr>
<td>Accuracy</td>
<td>No</td>
<td>Float</td>
<td>&nbsp;</td>
<td>As close an approximation to the standard deviation of the coordinates expressed in meters. </td>
</tr>
</table>
<h4>Datums</h4>
<p>The preferred datums are World Geodetic System 1984 (WGS84) or High Accuracy Reference Network (<strong>HARN</strong>) but providers may have data in datums that are not global and may not have the facilities to convert them to a global datum. Ignoring the datum can cause errors of thousands of meters! We highly encourage providers to provide data in WGS84 or HARN and consumers should always check the datum or else filter to choose just the datums they accept. </p>
<h5>4.4.5.2 Occurrence Filters</h5>
<p>Occurrences can be filtered by Taxon, Location, DateLastModified and the following:</p>
<table width="100%" border="1" cellspacing="0" cellpadding="2">
<tr>
<th>Name</th>
<th>Data Type</th>
<th>Returns records with</th>
</tr>
<tr>
<td>HorizontalDatum </td>
<td>String</td>
<td>HorizontalDatum = Value </td>
</tr>
<tr>
<td>CollectionDateMin</td>
<td>Date</td>
<td>StartCollectionDate &gt;= Value </td>
</tr>
<tr>
<td>CollectionDateMax</td>
<td>Date</td>
<td>EndCollectionDate &lt;= Value </td>
</tr>
<tr>
<td>AccuracyMin</td>
<td>Float</td>
<td>Accuracy &gt;= Value </td>
</tr>
<tr>
<td>AccuracyMax</td>
<td>Float</td>
<td>Accuracy &lt;= Value </td>
</tr>
</table>
</p>
<h5>4.4.5.3 Example </h5>
<p>The following example will provide all the data within the United States where members of the Genus <i>Tamarix</i> are considered non-native and harmful. </p>
<p>Request:</p>
<div class="exampleInner">
<pre>http://example.org/service.php?op=search&amp;Model=BioStatus
&amp;ScientificName=Tamarix&amp;CountryCode=USA&amp;Native=No&amp;Harmful=Yes
</pre>
</div class="exampleInner">
<p>Response:</p>
<div class="exampleInner">
<pre>
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;response&gt;
&lt;header&gt;
&lt;source accesspoint=&quot;http://example.org/GISIN.asp&quot;
sendtime=&quot;2005-11-11T12:23:56&quot;/&gt;
&lt;/header&gt;
&lt;search&gt;
&lt;record&gt;
&lt;scientificName&gt;Luzula luzuloides&lt;/scientificName&gt;
&lt;latitude&gt;40&lt;/latitude&gt;
&lt;longitude-105&lt;/longitude&gt;
&lt;longitude&gt;Luzula luzuloides&lt;/longitude&gt;
&lt;startCollectionDate&gt;10-5-2006&lt;/startCollectionDate&gt;
&lt;endCollectionDate&gt;10-5-2006&lt;/endCollectionDate&gt;
&lt;/record&gt;
&lt;summary start=&quot;0&quot; totalReturned=&quot;1&quot;/&gt;
&lt;/search&gt;
&lt;/response&gt;
</pre>
</div class="exampleInner">
<h4>4.4.6 ImpactStatus </h4>
<h5>4.4.6.1 ImpactStatus Concepts </h5>
<p>ImpactStatus represents the type of impact a species is having on a habitat. Multiple ImpactStatues should be provided for species that impact multiple habitats (i.e. marine and terrestrial). </p>
<p>ImpactStatuses are required to support the following general Concepts:</p>
<ul>
<li> Taxon: At least a scientific name</li>
<li>Location: At least one code or name, coordinates do not apply to BioStatus</li>
<li>DateLastModified </li>
<li>ValidDate</li>
</ul>
<p>ImpactStatuses support the following additional Concepts: </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>HabitatImpacted</td>
<td>Yes</td>
<td>String</td>
<td>Freshwater, Brackish, Marine, Terrestrial</td>
<td>The habitat being impacted </td>
</tr>
<tr>
<td>EcosystemImpacted</td>
<td>No</td>
<td>String</td>
<td>Natural, HumanModified</td>
<td>Type of ecosystem being impacted</td>
</tr>
<tr>
<td>HarmType</td>
<td>No</td>
<td>String</td>
<td>HarmfulToEnvironment, HarmfulToHumanHealth, HarmfulToEconomy</td>
<td>What values the species is impacting </td>
</tr>
<tr>
<td>ImpactStrength</td>
<td>No</td>
<td>String</td>
<td>Massive, Strong, Moderate, Weak, None, Unknown </td>
<td>How strong the impact is by the species </td>
</tr>
</table>
<p><strong>HabitatImpacted Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Freshwater</td>
<td>A primarily freshwater habitat including streams, rivers, and freshwater lakes </td>
</tr>
<tr>
<td>Brackish</td>
<td>A habitat with a mix of fresh and salt water, typically estuaries but also includes salt marshes and salt lakes </td>
</tr>
<tr>
<td>Marine</td>
<td>A primarily marine habitat including oceans, seas, and bays </td>
</tr>
<tr>
<td>Terrestrial</td>
<td>An impact exhibited primarily on land. </td>
</tr>
</table>
<p><strong>EcosystemImpacted Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Natural</td>
<td>Few environments are pristine. "Natural" includes semi-natural environments.</td>
</tr>
<tr>
<td>HumanModified</td>
<td>Includes urban environments as well as ecosystems modified by forestry, agriculture, horticulture, aquaculture, etc.</td>
</tr>
</table>
<p><strong>HarmType Values</strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>HarmfulToEnvironment</td>
<td>Natural or semi-natural environments and/or the species they contain. Includes, changes to ecosystem functioning and composition, habitat availability, species interactions, hybridization, predation, competition etc.</td>
</tr>
<tr>
<td>HarmfulToHumanHealth</td>
<td>In the future, expansion may be needed to distinguish between e.g. diseases and allergens.</td>
</tr>
<tr>
<td>HarmfulToEconomy</td>
<td>Includes livelihood, cultural, medicinal, amenity and social activities</td>
</tr>
</table>
<p><strong>ImpactStrength Values* </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Massive</td>
<td>Causes the extinction of keystone native species, or loss of key habitat, or an extreme ecosystem-wide shift in the food web </td>
</tr>
<tr>
<td>Strong</td>
<td>Causes population extinctions within the ecosystem, or the alien species is the dominant species, or it causes the alteration of a key habitat, or causes a severe shift in ecosystem functioning within the assessed area </td>
</tr>
<tr>
<td>Moderate</td>
<td>Causes a large-scales shift in native species abundance, or noticeable changes in type-specific communities, or the alteration and reduction of a habitat; or a moderate modification of an ecosystem&#8217;s performance </td>
</tr>
<tr>
<td>Weak</td>
<td>Causes local displacement of native species but no extinctions, or alteration of a habitat with no change in habitat size, or weak changes in ecosystem function </td>
</tr>
<tr>
<td>None</td>
<td>Causes no displacement of native species, no habitat alteration, and no change in ecosystem functioning </td>
</tr>
<tr>
<td>Unknown</td>
<td>The strength of impact is unknown </td>
</tr>
</table>
<p>*This table is based on: Olenin S, Minchin D, Daunys D (2007) Assessment of biopollution in aquatic ecosystems. Marine Pollution Bulletin (in print).</p>
<h5>4.4.6.2 ImpactStatus Filters</h5>
<p>ImpactStatuses are required to support the following general filters:</p>
<ul>
<li> Taxon: At least a scientific name</li>
<li>Location: At least one code or name, coordinates do not apply to ImpactStatus</li>
<li>DateLastModified </li>
<li>ValidDate</li>
</ul>
<p>ImpactStatuses support the following additional filters: </p>
<table width="100%" border="1" cellspacing="0" cellpadding="2">
<tr>
<th>Name</th>
<th>Data Type</th>
<th>Returns records with</th>
</tr>
<tr>
<td>Habitat</td>
<td>String</td>
<td>Habitat = Value</td>
</tr>
<tr>
<td>Ecosystem</td>
<td>String</td>
<td>Ecosystem = Value</td>
</tr>
<tr>
<td>HarmType</td>
<td>String</td>
<td>HarmType = Value </td>
</tr>
<tr>
<td>ImpactStrength</td>
<td>String</td>
<td>ImpactStrength = Value </td>
</tr>
</table>
</p>
<h5>4.4.6.3 ImpactStatus Example </h5>
<p>The following example will provide all the ImpactStatuses within the United States for all records for a species that are having a moderate impact on terrestrial habitats. </p>
<p>Request:</p>
<div class="exampleInner">
<pre>http://example.org/service.php?op=search&amp;Model=ImpactStatus<br />
&amp;ScientificName=Tamarix&amp;CountryCode=USA&amp;Habitat=Terrestrial&amp;ImpactStrength=Moderate
</pre>
</div class="exampleInner">
<p>Response:</p>
<div class="exampleInner">
<pre>
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;response&gt;
&lt;header&gt;
&lt;source accesspoint=&quot;http://example.org/GISIN.asp&quot;
sendtime=&quot;2005-11-11T12:23:56&quot;/&gt;
&lt;/header&gt;
&lt;search&gt;
&lt;record&gt;
&lt;scientificName&gt;Euphorbia estula&lt;/scientificName&gt;
&lt;countryCode&gt;USA&lt;/countryCode&gt;
&lt;habitat&gt;Terrestrial&lt;/habitat&gt;
&lt;impactStrength&gt;Present&lt;/impactStrength&gt;
&lt;/record&gt;
&lt;summary start=&quot;0&quot; totalReturned=&quot;1&quot;/&gt;
&lt;/search&gt;
&lt;/response&gt;</pre>
</div class="exampleInner">
<h4>4.4.7 DispersalStatus </h4>
<p>DispersalStatus represents the type of Dispersal a species is having on a habitat. Multiple DispersalStatuses should be provided for species that Dispersal multiple habitats (i.e. marine and terrestrial). </p>
<h5>4.4.7.1 DispersalStatus Concepts </h5>
<p>DispersalStatuses are required to support the following general Concepts:</p>
<ul>
<li> Taxon: At least a scientific name</li>
<li>Location: At least one code or name, coordinates do not apply to DispersalStatus. This location identifies the area for this dispersal event. A 'FromCountryCode' can be specified for the country of origin. </li>
<li>DateLastModified </li>
<li>ValidDate</li>
</ul>
<p>DispersalStatuses support the following additional Concepts: </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>DateOfIntroduction</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>A textual description of any date (day, month, year, decade, etc.) of introduction</td>
</tr>
<tr>
<td>Method</td>
<td>Yes</td>
<td>String</td>
<td>Natural, Deliberate, Accidental, Unknown </td>
<td>A high-level categorization of how the organism is dispersing </td>
</tr>
<tr>
<td>Cause</td>
<td>No</td>
<td>String</td>
<td>See below </td>
<td>The enterprise, activity, trade, endeavor, commerce, motive, rationale, incentive, or reason of accidental (unintentional, inadvertent, escape, chance) or of deliberate (intentional, planned, purposeful, premeditated, planted, direct) dispersal.</td>
</tr>
<tr>
<td>Vector</td>
<td>No</td>
<td>String</td>
<td>See below </td>
<td>The physical means, agent or mechanism which facilitates the transfer of organisms or their propagules from one place to another. Synonyms = pathway, mode, dispersal mechanism, transport mechanism, manner, carrier, bearer, method.</td>
</tr>
<tr>
<td>FromCountryCode</td>
<td>No</td>
<td>String</td>
<td>See section 4.4.1.3 </td>
<td>The country the organism is dispersing from </td>
</tr>
<tr>
<td>Route</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>A textual description of the route the organism took from the FromCountryCode. If used, a LanguageCode must be specified. </td>
</tr>
</table>
<p><strong>Method Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Natural</td>
<td>Dispersal by an organisms' natural mechanisms and strategies without direct or indirect human intervention</td>
</tr>
<tr>
<td>Deliberate</td>
<td>Dispersal resulting from intentional human activity</td>
</tr>
<tr>
<td>Accidental</td>
<td>Unintentional dispersal in association with human activity</td>
</tr>
<tr>
<td>Unknown</td>
<td>&nbsp;</td>
</tr>
</table>
<p><strong>Cause Values </strong></p>
<p>These represent the reasons that an organism was introduced into an area. </p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Agriculture</td>
<td> Not horticulture or forestry </td>
</tr>
<tr>
<td>Aid</td>
<td>Assistance to humans in disaster situations </td>
</tr>
<tr>
<td>AnimalsForaging</td>
<td>Spread by animals seeking food and other resources </td>
</tr>
<tr>
<td>Aquaculture</td>
<td>Specifically fresh water </td>
</tr>
<tr>
<td>AquariumTrade</td>
<td>Trade in exotic plants or animals for aquariums </td>
</tr>
<tr>
<td>BiologicalControl</td>
<td>To biologically control other problematic species (as predators, parasites, etc.) </td>
</tr>
<tr>
<td>BotanicalGardens</td>
<td>Collection and public display of exotic plants; does not include horticulture </td>
</tr>
<tr>
<td>Breeding</td>
<td>For breeding purposes </td>
</tr>
<tr>
<td>ConsumptionExcretion</td>
<td>For example, birds dispersing seeds after they eat fruit </td>
</tr>
<tr>
<td>CulturalUse</td>
<td>Includes, e.g., the use of feathers and herbs by traditional cultures </td>
</tr>
<tr>
<td>CutFlowerTrade</td>
<td>Commercial trade in cut flowers </td>
</tr>
<tr>
<td>Disturbance</td>
<td>A human natural or anthropogenic disturbance which creates the potential for an organism to establish </td>
</tr>
<tr>
<td>DuneStabilisation</td>
<td>Exotic plants planted to prevent movement of dunes through wind erosion </td>
</tr>
<tr>
<td>ErosionControl</td>
<td>Exotic vegetation planted to prevent soil erosion </td>
</tr>
<tr>
<td>EscapeFromConfinement</td>
<td>Escaped from a controlled environment </td>
</tr>
<tr>
<td>Flooding</td>
<td>Dispersal in association with sudden or regular (e.g. seasonal) innundation </td>
</tr>
<tr>
<td>Food</td>
<td>Food for humans </td>
</tr>
<tr>
<td>Forage</td>
<td>Plants used as food for both wild animals and live stock </td>
</tr>
<tr>
<td>Forestry</td>
<td>Exotic species planted in forestry, or weeds, pests, or pathogens associated with foresty/logging operations </td>
</tr>
<tr>
<td>GardenEscape</td>
<td>Plants or seeds allowed to escape from gardens; not horticulture </td>
</tr>
<tr>
<td>GardenWasteDisposal</td>
<td>Organisms spread via garden waste </td>
</tr>
<tr>
<td>HarvestingFur</td>
<td>Includes harvesting wool and hair </td>
</tr>
<tr>
<td>Hedges</td>
<td>Includes windbreak </td>
</tr>
<tr>
<td>Horticulture</td>
<td>Study sites and commercial sites that grow fruits, vegetables, herbs. Not garden escape. Not nursery trade.</td>
</tr>
<tr>
<td>IndustrialPurposes</td>
<td>Organisms used for industrial purposes </td>
</tr>
<tr>
<td>IntentionalRelease</td>
<td>Includes release for hunting and stocking for fishing </td>
</tr>
<tr>
<td>InterconnectedWaterways</td>
<td>Man-made connections of waterways (e.g. canals) that nullify natural geographic barriers </td>
</tr>
<tr>
<td>InternetSales</td>
<td>Promotion and trade of exotic organisms via the internet </td>
</tr>
<tr>
<td>LandscapeImprovement</td>
<td>flora or fauna &quot;improvement&quot;</td>
</tr>
<tr>
<td>LandscapingIndustry</td>
<td>Promotion, import and planting of exotic species by landscaping specialists </td>
</tr>
<tr>
<td>LiveFoodTrade</td>
<td>Promotion, import and distribution of live food and/or potential associated contaminants </td>
</tr>
<tr>
<td>Mariculture</td>
<td>Marine aquaculture </td>
</tr>
<tr>
<td>MedicinalUse</td>
<td>For the treatment of illness </td>
</tr>
<tr>
<td>MilitaryActivity</td>
<td>Dispersal associated with military activities </td>
</tr>
<tr>
<td>NaturalDisaster</td>
<td>Dispersal as a direct result of natural disaster; not caused by the relief response (see ReliefAid) </td>
</tr>
<tr>
<td>NaturalDispersal</td>
<td>The natural dispersal tendencies and strategies of organisms </td>
</tr>
<tr>
<td>NurseryTrade</td>
<td>Dispersal, especially of diseases and accidental weeds, caused by nursery trade actvities </td>
</tr>
<tr>
<td>OffSitePreservation</td>
<td>Dispersal associated with conservation activities <td>
</tr>
<tr>
<td>OrnamentalPurposes</td>
<td>Decorative plants and animals dispersed for ornamental purposes </td>
</tr>
<tr>
<td>Other</td>
<td> </td>
</tr>
<tr>
<td>OtherRecreational</td>
<td>Dispersal as people move through natural landscapes or aquatic environments for outdoor recreational activities such as tramping, off-road vehicles, boating or yachting, hunting, fishing (Does not include intentional release of animals) </td>
</tr>
<tr>
<td>PeopleForaging</td>
<td>Spread by people seeking resources </td>
</tr>
<tr>
<td>PeopleSharingResources</td>
<td>Example include the exchange of seed, livestock or water from contaminated sources </td>
</tr>
<tr>
<td>PetTrade</td>
<td>Trade in exotic animals as pets </td>
</tr>
<tr>
<td>ReliefAid</td>
<td>Assistance to humans or livestock in disaster situations</td>
</tr>
<tr>
<td>Research</td>
<td>The introduction of exotic specimens for scientific research </td>
</tr>
<tr>
<td>SeedTrade</td>
<td>Dispersal in association with the exotic seed trade </td>
</tr>
<tr>
<td>Smuggling</td>
<td>Intentional illegal introduction for profit </td>
</tr>
<tr>
<td>TimberTrade</td>
<td>Sawn timber (not logs) can be contaminated with pests and pathogens </td>
</tr>
<tr>
<td>VegetativeGrowth</td>
<td>Natural plant propagation including reproduction by root suckers and regeneration from rhizome fragments </td>
</tr>
<tr>
<td>WormCultivation</td>
<td>Dispersal in association with worm cultivation </td>
</tr>
<tr>
<td>Zoos</td>
<td>The collection of exotic animal specimens </td>
</tr>
</table>
<p><strong>Vector Values</strong></p>
<p>These values represent the mechanism the organism is using to disperse. The values are listed alphabeticallyin the table below but can be categoried into the following groups for reference:</p>
<p>Vehicles:</p>
<ul>
<li>Aircraft</li>
<li>Human</li>
<li>LandTransportationVehicles</li>
</ul>
<p>Item that carried the organism: </p>
<ul>
<li>AnimalCaptive</li>
<li>FreshAnimalProduct</li>
<li>FreshProduce</li>
<li>GermPlasm</li>
<li>ManufacturedAnimalFeed</li>
<li>OtherConsumable</li>
<li>PlantMaterial</li>
</ul>
<p>Free movement:</p>
<ul>
<li>AnimalFree</li>
<li>FloatingDebris</li>
<li>Water</li>
<li>Wind</li>
</ul>
<p>Freight:</p>
<ul>
<li>AirFreight</li>
<li>BulkFreight</li>
<li>Container</li>
<li>GeneralFreight</li>
<li>Packaging</li>
<li>Postal</li>
</ul>
<p>Other:</p>
<ul>
<li>Other </li>
</ul>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Aircraft</td>
<td>The aircraft itself. This does not include airfreight, passengers or crew </td>
</tr>
<tr>
<td>AirFreight</td>
<td>Brought in by aircraft as freight </td>
</tr>
<tr>
<td>AnimalCaptive</td>
<td>Pets, animals for agri/mari/aqua/culture, fur trade, hunting, fishing, zoo, biocontrol, etc. </td>
</tr>
<tr>
<td>AnimalFree</td>
<td>Naturally occurring or introduced animals</td>
</tr>
<tr>
<td>BulkFreight</td>
<td>Includes timber, soil, sand, tyres, rubbish, etc. Does not include airfreight </td>
</tr>
<tr>
<td>Container </td>
<td>Shipping container (loaded or empty) used for land, sea or air transport</td>
</tr>
<tr>
<td>FloatingDebris</td>
<td>Includes vegetation </td>
</tr>
<tr>
<td>FreshAnimalProduct</td>
<td>Includes bait</td>
</tr>
<tr>
<td>FreshProduce</td>
<td>Fresh fruit and vegetables </td>
</tr>
<tr>
<td>FloatingDebris</td>
<td>Includes vegetation </td>
</tr>
<tr>
<td>GeneralFreight</td>
<td>Includes machinery, products and household goods. </td>
</tr>
<tr>
<td>GermPlasm</td>
<td>Includes specimens, plants, animals, bacteria, etc. </td>
</tr>
<tr>
<td>Human</td>
<td>Includes passengers, crew, tourists, and their souvenirs, clothing, equipment and footware. </td>
</tr>
<tr>
<td>LandTransportVehicle</td>
<td>The vehicle itself - motorised or non-motorised. Includes trailers and machinery, gear, etc. </td>
</tr>
<tr>
<td>ManufacturedAnimalFeed</td>
<td>Does not include pure plant feed such as grain, hay or straw. </td>
</tr>
<tr>
<td>Other </td>
<td>&nbsp;</td>
</tr>
<tr>
<td>OtherConsumable</td>
<td>Honey, dried meat, live (sea)food etc. </td>
</tr>
<tr>
<td>Packaging</td>
<td>Includes solid wood packing material such as pallets </td>
</tr>
<tr>
<td>PlantMaterial</td>
<td>Vegatation or seeds. Not produce or germplasm. Includes cut flowers, plant stock and habitat material, garden waste, mulch, straw </td>
</tr>
<tr>
<td>Postal</td>
<td>Postal or courier item </td>
</tr>
<tr>
<td>Ship</td>
<td>The ship/boat itself. Includes hull, superstructure, gear, ballast and bilge water </td>
</tr>
<tr>
<td>Water</td>
<td>Floating on or in the water </td>
</tr>
<tr>
<td>Wind</td>
<td>Floating or flying on the wind </td>
</tr>
</table>
<h5>4.4.7.2 DispersalStatus Filters</h5>
<p>DispersalStatuses are required to support the following general filters:</p>
<ul>
<li> Taxon: At least a scientific name</li>
<li>Location: Identifies where the dispersal started from, this can be the initial area of introduction into a country or a previous area wihtin the same country. Coordinates do not apply to DispersalStatus.</li>
<li>DateLastModified </li>
<li>ValidDate</li>
</ul>
<p>DispersalStatuses support the following additional filters: </p>
<table width="100%" border="1" cellspacing="0" cellpadding="2">
<tr>
<th>Name</th>
<th>Data Type</th>
<th>Returns records with</th>
</tr>
<tr>
<td>Method</td>
<td>String</td>
<td>Method = Value</td>
</tr>
<tr>
<td>Cause</td>
<td>String</td>
<td>Cause = Value</td>
</tr>
<tr>
<td>Vector</td>
<td>String</td>
<td>Vector = Value </td>
</tr>
<tr>
<td>FromCountryCode</td>
<td>Integer</td>
<td>CountryCode = Value </td>
</tr>
</table>
</p>
<h5>4.4.7.3 DispersalStatus Example </h5>
<p>The following example will provide all the DispersalStatuses within the United States for all species that are naturally dispersing.</p>
<p>Request:</p>
<div class="exampleInner">
<pre>http://example.org/service.php?op=search&amp;Model=DispersalStatus<br />
&amp;CountryCode=USA&amp;Method=Natural
</pre>
</div class="exampleInner">
<p>Response:</p>
<div class="exampleInner">
<pre>
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;response&gt;
&lt;header&gt;
&lt;source accesspoint=&quot;http://example.org/GISIN.asp&quot;
sendtime=&quot;2005-11-11T12:23:56&quot;/&gt;
&lt;/header&gt;
&lt;search&gt;
&lt;record&gt;
&lt;scientificName&gt;Euphorbia estula&lt;/scientificName&gt;
&lt;countryCode&gt;USA&lt;/countryCode&gt;
&lt;method&gt;Natural&lt;/method&gt;&lt;/record&gt;
&lt;summary start=&quot;0&quot; totalReturned=&quot;1&quot;/&gt;
&lt;/search&gt;
&lt;/response&gt;</pre>
</div class="exampleInner">
<h4>4.4.8 ManagementStatus </h4>
<h5>4.4.8.1 ManagementStatus Concepts </h5>
<p>ManagementStatus represents the type of management activities involved with a species in a specified area. Multiple ManagementStatues should be provided for if multiple activities are engaged in the same time period. </p>
<p>ManagementStatuses are required to support the following general Concepts:</p>
<ul>
<li> Taxon: At least a scientific name</li>
<li>Location: At least one code or name, coordinates do not apply to BioStatus</li>
<li>DateLastModified </li>
<li>ValidDate</li>
</ul>
<p>ManagementStatuses support the following additional Concepts: </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>Action</td>
<td>Yes</td>
<td>String</td>
<td>Prevention, Eradication, Control, Containment, Mitigation, Interception </td>
<td>The action taken by management </td>
</tr>
<tr>
<td>Status</td>
<td>No</td>
<td>String</td>
<td>Proposed, Executing, Completed, Unknown </td>
<td>The current status of the specified action </td>
</tr>
</table>
<p><strong>Action Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Prevention</td>
<td>Measures taken to stop a species from entering an area.</td>
</tr>
<tr>
<td>Eradication</td>
<td>Actions taken that eliminate all occurrences of a species</td>
</tr>
<tr>
<td>Control</td>
<td>Measures taken to reduce a species&rsquo; biomass</td>
</tr>
<tr>
<td>Containment</td>
<td>Measures taken to keep a species within a defined area</td>
</tr>
<tr>
<td>Mitigation</td>
<td>Actions taken to reduce the harmful effects of a species</td>
</tr>
<tr>
<td>Interception</td>
<td>Detection of a species at a border and prevention of its entering an area.</td>
</tr>
</table>
<p><strong>Status Values </strong></p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Proposed</td>
<td>Includes even the suggestion that the activity would be a good idea, because this indicates concern about the organism</td>
</tr>
<tr>
<td>Executing</td>
<td>Includes e.g. prevention systems in place and/or public education</td>
</tr>
<tr>
<td>Completed</td>
<td>Prevention projects are usually ongoing, completed implies no further control effort.</td>
</tr>
</table>
<h5>4.4.8.2 ManagementStatus Filters</h5>
<p>ManagementStatuses are required to support the following general filters:</p>
<ul>
<li> Taxon: At least a scientific name</li>
<li>Location: At least one code or name, coordinates do not apply to ManagementStatus</li>
<li>DateLastModified </li>
<li>ValidDate</li>
</ul>
<p>ManagementStatuses support the following additional filters: </p>
<table width="100%" border="1" cellspacing="0" cellpadding="2">
<tr>
<th>Name</th>
<th>Data Type</th>
<th>Returns records with</th>
</tr>
<tr>
<td>Habitat</td>
<td>String</td>
<td>Habitat = Value</td>
</tr>
<tr>
<td>Ecosystem</td>
<td>String</td>
<td>Ecosystem = Value</td>
</tr>
<tr>
<td>ManagementType</td>
<td>String</td>
<td>ManagementType = Value </td>
</tr>
<tr>
<td>ManagementStrength</td>
<td>String</td>
<td>ManagementStrength = Value </td>
</tr>
</table>
</p>
<h5>4.4.8.3 ManagementStatuses Example </h5>
<p>The following example will provide all the ManagementStatuses within the United States for all species that have records of being eradicated. </p>
<p>Request:</p>
<div class="exampleInner">
<pre>http://example.org/service.php?op=search&amp;Model=ManagementStatus<br />
&amp;Type=Eradication
</pre>
</div class="exampleInner">
<p>Response:</p>
<div class="exampleInner">
<pre>
&lt;?xml version="1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;response&gt;
&lt;header&gt;
&lt;source accesspoint=&quot;http://example.org/GISIN.asp&quot;
sendtime=&quot;2005-11-11T12:23:56&quot;/&gt;
&lt;/header&gt;
&lt;search&gt;
&lt;record&gt;
&lt;scientificName&gt;Euphorbia estula&lt;/scientificName&gt;
&lt;countryCode&gt;USA&lt;/countryCode&gt;
&lt;habitat&gt;Terrestrial&lt;/habitat&gt;
&lt;type&gt;Eradication&lt;/type&gt;
&lt;/record&gt;
&lt;summary start=&quot;0&quot; totalReturned=&quot;1&quot;/&gt;
&lt;/search&gt;
&lt;/response&gt;</pre>
</div class="exampleInner">
<h3>4.5 Error Reporting</h3>
<p>Errors are returned in an XML response as shown below. The content of the &quot;error&quot; element should be an error that is appropriate for end-users. This should include information on what happened in end-user terminology and enough information for them to know what they should do next. Additional information for technical users to know how to resolve the problem should also be included. </p>
<div class="exampleInner">
<PRE>
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;response&gt;
&lt;header&gt;
&lt;source accesspoint=&quot;http://example.org/GISIN.asp&quot;
sendtime=&quot;2005-11-11T12:23:56&quot;/&gt;
&lt;/header&gt;
&lt;error&gt;
Sorry, there is a technical problem and our staff has been notified.
Please try again tomorrow.
&lt;/error&gt;
&lt;/response&gt;
</PRE>
</div class="exampleInner">
<h2>References</h2>
<p>Carlton, J.T. and G.M. Ruiz. 2002. Principles of Vector Science and Integrated Vector Management. In Mooney, H. et al. (eds.) Best Practices for the Prevention and Management of Alien Invasive Species. Island Press</p>
<p>IUCN 2000. Guidelines for the prevention of biodiversity loss due to biological invasion. IUCN &ndash; The World Conservation Union, Gland, Switzerland</p>
<h2>Appendix A - Issues</h2>
<p><br />
1. Do we specify taxonomic hierarchy or just kingdom/scientific name </p>
<p>- Just kingdom/scientific name for now </p>
<p>2.Can ask service: do you supported hierarchical taxon queries?</p>
<p>- Later addition </p>
<p>3. Need a method to determine if a record is from its original data set or is a duplicate</p>
<p>4. Need a method to determine the original source of a duplicated record</p>
<p>5. Need to include LSIDs for each record. Will LSIDs address issues 3 and 4? </p>
<p>6. The Metadata in TAPIR uses' 2 letter language codes. Should we do the same? </p>
<p><br />
<h4>&#8220;Issues List&#8221; with numbered issues, current recommendations, current status, and associated discussions.</h4>
The &#8220;Status&#8221; fields have the following values:
<ul>
<li>Investigation &#8211; we&#8217;re trying to come up with a proposal</li>
<li>Proposed &#8211; we have a proposal and are seeing if anyone objects</li>
<li>Resolved &#8211; the issue has been decided but is not yet in the protocol documentation</li>
<li>Existing &#8211; the issue is represented in the documentation</li>
</ul>
<p>
1. PROPOSAL: Add a new data model for EnvironmentalInfo<br>
Status: Proposed<br>
This datamodel will help distinguish between species that occur in natural or human modified environments, and/or in freshwater, brackish, marine and terrestrial habitats. Multiple values are possible. These concepts are different from EcosystemImpacted and HabitatImpacted (a terrestrial species can impact aquatic environments). At the GISIN portal someone could filter by &#8216;terrestrial&#8216; to get all terrestrial species &#8211; whether or not the habitat impacted might be both terrestrial and aquatic.<br>
<p>EnvironmentalInfo supports the following additional Concepts: Possible values for the additional Concepts are listed in the table.</p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>SpeciesEnvironment</td>
<td>No</td>
<td>String</td>
<td>Natural, HumanModified</td>
<td>The environment in which the species occurs</td>
</tr>
<tr>
<td>SpeciesHabitat</td>
<td>No</td>
<td>String</td>
<td>Freshwater, Brackish, Marine, Terrestrial</td>
<td>The habitat in which the species occurs</td>
</tr>
</table>
<p>
2. PROPOSAL: Change Harmful back to Invasive in BioStatus<br>
Status: Proposed<br>
Discussion: Many believe that &#8216;Harm&#8217; is subjective and that it is the culmination of the invasion process, which begins with establishment, then persistence and spread. If we provided the word &#8216;Invasive&#8217; instead of &#8216;Harmful&#8217; in the BioStatus concept, most providers would be able to map to its possible values, but each provider might mean something different. The key differences are between;<br>
1. Scientific uses of the word &#8216;Invasive&#8217; meaning ability to spread (i.e. Distribution = Widespread or Moderate, and/or Abundance= Dominant or Common) and <br>
2. Policy uses of the word &#8216;Invasive&#8217; meaning ability to cause harm.<br>
Different meanings or usages can be deduced from the additional concepts for which data is provided. Currently, the first group can select &#8216;Invasive&#8217; then map their data to Distribution = (Widespread or Moderate), and/or Abundance= (Dominant or Common) and/or Harmful= (Yes or Potentially). <br>
The second group can select &#8216;Invasive&#8217; then map their data to ImpactStatus concepts as well as those of group 1.<p>
More Discussion: Folks had major issues with the term &#8220;Invasive&#8221;. We decided to use &#8220;Harmful=Yes&#8221;. However, invasiveness data would not be mapped to the &#8216;Harmful&#8217; concept if there is only evidence of establishment, persistence and spread (e.g. when harm has not been confirmed). A search at the GISIN portal on Harmful = yes would miss this invasiveness data.
</p>
<p>BioStatuses support the following additional Concepts. Possible values for the Concepts are listed below this table. </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>Source</td>
<td>No</td>
<td>String</td>
<td>&nbsp;</td>
<td>Citation for the source of the data </td>
</tr>
<tr>
<td>Origin</td>
<td>Yes</td>
<td>String</td>
<td>Indigenous, Nonindigenous, Unknown </td>
<td>Whether the species is considered to be native to a particular location or not. </td>
</tr>
<tr>
<td>Presence</td>
<td>Yes</td>
<td>String</td>
<td>Absent, Sometimes, Present, Unknown </td>
<td>There is supporting evidence to show the species is present within the valid date </td>
</tr>
<tr>
<td>Persistence</td>
<td>No</td>
<td>String</td>
<td>Persistent, Temporary [let's delete this value. MB], Transient, DiedOut, Unknown </td>
<td>How successful the organism is at surviving and reproducing </td>
</tr>
<tr>
<td>Distribution</td>
<td>No</td>
<td>String</td>
<td>Widespread, Moderate, Localized, Unknown </td>
<td>Whether the species is limited to a local area or covers vast tracks of land or water </td>
</tr>
<tr>
<td>Abundance</td>
<td>No</td>
<td>String</td>
<td>Dominant, Common, Rare, Zero, Unknown </td>
<td>How abundant the organism is </td>
</tr>
<tr>
<td>Trend</td>
<td>No</td>
<td>String</td>
<td>Expanding, Stable, Declining, Unknown </td>
<td>Whether the range of the organism is increasing or decreasing </td>
</tr>
<tr>
<td>RateOfSpread</td>
<td>No</td>
<td>String</td>
<td>Rapid, Moderate, Slow, Unknown </td>
<td>How quickly the range of the organism is expanding </td>
</tr>
<tr>
<td>Invasive</td>
<td>Yes</td>
<td>String</td>
<td>Yes, No, Potentially, Unknown</td>
<td>Whether the organism is considered invasive. 'Spread' information is dealt with here. 'Harm' information in the ImpactStatus element</td>
</tr>
<tr>
<td>RegulartoryListing</td>
<td>No</td>
<td>String</td>
<td>Prohibited, Restricted, NotConsidered, Unknown </td>
<td>The legal regulatory status of the organism </td>
</tr>
</table>
<p>
3. ImpactStatus<p>
3.1 PROPOSAL: Introduce an ImpactMechanism concept<br>
Status: Proposed<br>
Introduce an ImpactMechanism concept to handle information about competition, predation, etc. i.e. how IAS damage species habitats and ecosystems. This kind of information is widely available and ImpactMechanism allows us to make assumptions about which kinds of native species may be threatened. <br>
3.2 PROPOSAL: Change HarmType values from HarmfulToEconomy to HarmfulToLivelihoods.<br>
Status: Proposed<br>
3.3 PROPOSAL: Make HabitatImpacted non-mandatory<br>
Status: Proposed<br>
<p>ImpactStatuses support the following additional Concepts: </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>HabitatImpacted</td>
<td>No</td>
<td>String</td>
<td>Freshwater, Brackish, Marine, Terrestrial</td>
<td>The habitat being impacted </td>
</tr>
<tr>
<td>EcosystemImpacted</td>
<td>No</td>
<td>String</td>
<td>Natural, HumanModified</td>
<td>Type of ecosystem being impacted</td>
</tr>
<tr>
<td>HarmType</td>
<td>No</td>
<td>String</td>
<td>HarmfulToEnvironment, HarmfulToHumanHealth, HarmfulToLivelihoods</td>
<td>What values the species is impacting </td>
</tr>
<tr>
<td>ImpactMechanism</td>
<td>No</td>
<td>String</td>
<td>Allergenic, Competition, DiseaseTransmission, Herbivory, Hybridisation, InteractionWithOtherInvasiveSpecies, Pathogenic/Parasite, PhysicalDisturbance, Predation, SoilTransformation, Transpiration, Other, Unknown
</td>
<td>Mechanism by which negative impacts occur </td>
</tr>
<tr>
<td>*ImpactStrength</td>
<td>No</td>
<td>String</td>
<td>Massive, Strong, Moderate, Weak, None, Unknown </td>
<td>How strong the impact is</td>
</tr>
</table>
*ImpactStrength values and descriptions are adapted from: Olenin S, Minchin D, Daunys D (2007) Assessment of biopollution in aquatic ecosystems. Marine Pollution Bulletin (Volume 55, Issues 7-9, 2007, Pages 379-394). <br>
*Some ImpactMechanism values come from the IUCN Red List&#8217;s Authority Files.<br>
<p>
4. DispersalStatus<p>
4.1 PROPOSAL: Introduce a DispersalStatus Concept called MovementStatus<br>
Status: Investigation<br>
Discussion: DispersalStatus applies to species movements at all scales &#8211; introduction across international borders as well as dispersal from one watershed to the next. We could introduce a DispersalStatus Concept called MovementStatus with possible values = Pre-borderMovement and Post-borderMovement.<br>
4.2 PROPOSAL: Introduce Concepts for DispersalMechanisms and DisperslPathways<br>
Status: Proposed<br>
Discussion: The problem with the original Cause and Vector concepts is that it would have been difficult for providers to map to values as there are so many. Now they can map to 1 of 3 dispersal mechanisms and/or 1 of 6 dispersl pathways. This simplified approach lends itself to comparative analysis across a wide range of taxa and to policy applications (see the &#8216;responsibility&#8217; statement in the Descriptions for Pathway values). <br>
4.3 PROPOSAL: Introduce a DateOfFirst Report concept<br>
Status: Proposed<br>
Discussion: This date is sometimes available when date of introduction is unknown.<br>
4.4 PROPOSAL: Change Method concept to 'Mode' and make it not mandatory<br>
Status: Proposed<br>
4.5 PROPOSAL: What format should we use for dates?<br>
Proposal: Use the TAPIR standard date format<br>
Status: Existing<br>
Discussion: Michael: YYYY-MM-DD is usually unavailable for &#8216;Date of introduction&#8217;. Typically providers have a year or a decade. How do we handle the lack of MM-DD?
Discussion: Michael: You often get pre- or post- a year or a decade. Could we implement something modelled on DAISIE, which uses 2 fields: If the date is precise, the same date appears in both fields. If the first field alone is populated, the meaning = &#8216;post the date&#8217;, if only the second field is populated, the meaning = &#8216;pre the date&#8217;.<br>
Discussion: Jim:We can setup the toolkit to map years (including a decade) to a date field. Mapping multiple columns into a date is more complicated. All databases have standard date fields that can be automatically mapped to the protocol. On this one I think I would suggest we recommend the providers use the SQL standard date fields if at all possible.<br>
<p>DispersalStatuses support the following additional Concepts: </p>
<table width="100%" cellspacing="0" cellpadding="2" border='1'>
<tr>
<th>Concept</th>
<th>Required</th>
<th>Type</th>
<th>Values</th>
<th>Description</th>
</tr>
<tr>
<td>DateOfIntroduction</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>A textual description of any date (day, month, year, decade, etc.) of introduction</td>
</tr>
<tr>
<td>DateOfFirstReport</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>A textual description of any date (day, month, year, decade, etc.) of first report</td>
</tr>
<tr>
<td>Mode</td>
<td>No</td>
<td>String</td>
<td>Natural, Deliberate, Accidental, Unknown </td>
<td>A high-level categorization of how the organism is dispersing </td>
</tr>
<tr>
<td>MovementStatus</td>
<td>No</td>
<td>String</td>
<td>Pre-borderMovement, Post-borderMovement</td>
<td>A high-level categorization of how the organism is dispersing </td>
</tr>
<tr>
<td>*Mechanism</td>
<td>No</td>
<td>String</td>
<td>Commodity, Vector, NaturalDispersal, Unknown</td>
<td>Mechanism of arrival, entry and/or dispersal.</td>
</tr>
<tr>
<td>*Pathway</td>
<td>No</td>
<td>String</td>
<td>Release, Escape, Contaminant, Stowaway, Corridor, Unaided, Unknown</td>
<td>Process that results in the introduction of alien species from one location to another</td>
</tr>
<tr>
<td>FromCountryCode</td>
<td>No</td>
<td>String</td>
<td>See section 4.4.1.3 </td>
<td>The country the organism is dispersing from</td>
</tr>
<tr>
<td>Route</td>
<td>No</td>
<td>String</td>
<td>(undefined)</td>
<td>A textual description of the route the organism took from the FromCountryCode. If used, a LanguageCode must be specified. </td>
</tr>
</table>
<p>
<p><strong>Mechanism Values</strong></p>
<p>Mechanism of arrival, entry and dispersal</p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Commodity</td>
<td>Importation of a commodity</td>
</tr>
<tr>
<td>Vector</td>
<td>Arrival of a transport vector. Vector means the physical means, agent or mechanism which facilitates the transfer of organisms or their propagules from one place to another.</td>
</tr>
<tr>
<td>NaturalDispersal</td>
<td>Natural spread from a neighbouring region where the species is alien</td>
</tr>
</table>
<p>
<p><strong>Pathways Values</strong></p>
<p>Process that results in the introduction of alien species from one location to another</p>
<table width="100%" border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Name</th>
<th>Description</th>
</tr>
<tr>
<td>Release</td>
<td>Intentional introduction as a commodity for release (examples include biocontrol agents, game animals and plants for erosion control - responsibility should be the applicant&#8217;s)</td>
</tr>
<tr>
<td>Escape</td>
<td>Intentional introduction as a commodity but escapes unintentionally (examples include feral crops and livestock, pets, garden plants, live baits - responsibility should be the importer&#8217;s) [should this include illegal release of e.g. pets, fish for stocking, biocontrol agents, game animals?]</td>
</tr>
<tr>
<td>Contaminant</td>
<td>Unintentional introduction with a specific commodity (examples include parasites, pests and commensals of traded plants and animals - responsibility should be the exporter&#8217;s)</td>
</tr>
<tr>
<td>Stowaway</td>
<td>Unintentional introduction attached to or within a transport vector (examples include hull fouling, ballast water/soil/sediment/organisms - responsibility should be the carrier&#8217;s)</td>
</tr>
<tr>
<td>Corridor</td>
<td>Unintentional introduction via human infrastructures linking previously unconnected regions (examples include Lessepsian migrants, Ponto-Caspian aliens in the Baltic- responsibility should be the developer&#8217;s)</td>
</tr>
<tr>
<td>Unaided</td>
<td>Unintentional introduction through natural dispersal of alien species across political borders (potentially all alien taxa are capable of dispersal - responsibility should be the polluter&#8217;s)</td>
</tr>
</table>
*Mechanism and Pathway values and descriptions are adapted from: Hulme PE, Bacher S, Kenis M, Klotz S, K<>hn I, Minchin D, Nentwig W, Olenin S, Panov V, Pergl J, Py*ek P, Roques A, Sol D, Solarz W & Vil<69>, M (2008) Grasping at the routes of biological invasions: a framework to better integrate pathways into policy. Journal of Applied Ecology, 45 (in press).
<p>
6. PROPOSAL: Have a Metadata DataModel.<br>
Status: Investigating<br>
Jim: Does TDWG have something we can use here? The TAPIR MetaData DataModel is for the entire data source so it does not fit well.<br>
<p>
7. PROPOSAL: Have a Citation DataModel. <br>
Status: Investigating<br>
Jim: Does TDWG have something we can use here?<br>
<p>
8. PROPOSAL: Add GUIDs to each record using LSIDs where appropriate<br>
Status: Proposed<br>
<p>
9. PROPOSAL: We need a method to add general text to each record for comments, descriptions, etc.<br>
Status: Proposed<br>
Discussion: Add a &#8220;Comments&#8221; text field to each DataModel but insure that the documentation indicates it should not be used for information that is covered in elsewhere in the protocol and cannot be queried at the same level of performance or reliability.<br>
<p>
<h2>Appendix B - Changes</h2>
<h4>18-May-2007</h4>
<ul>
<li>Added values for DispersalStatus Cause and Vector </li>
</ul>
<h4>20-May-2007</h4>
<ul>
<li>Added ImpactStatus, DispersalStatus, and ManagementStatus</li>
<li>Added LanaguageCode to ProfileURL </li>
</ul>
<h4>29-May-2007</h4>
<ul>
<li>Added acknowledgements</li>
<li>Added additional definitions to values </li>
<li>Added issue 6 </li>
</ul>
<p>&nbsp;</p>
</body>
</html>
-- Main.AnnieSimpson - 04 Aug 2007
added DateOfIntroduction into Table 4.4.7; added detailed descriptions for 'cause' and 'vector'; added detailed scriptio
-- Main.AnnieSimpson - 05 Aug 2007
Added ImpactStrength values (and reference) to table at end of section 4.4.6.1.
-- Main.AnnieSimpson - 06 Aug 2007
Removed AbundanceValue = monoculture
-- Main.AnnieSimpson - 09 Aug 2007
@
1.10
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MichaelBrowne" date="1194484376" format="1.1" version="1.10"}%
d2119 347
d2497 1
a2497 1
-- Main.AnnieSimpson - 09 Aug 2007@
1.9
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MichaelBrowne" date="1194479295" format="1.1" version="1.9"}%
d3 1
a3 1
persistence<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
d1257 1
a1257 1
<td>Habitat</td>
d1264 1
a1264 1
<td>Ecosystem</td>
d1285 1
a1285 1
<p><strong>Habitat Values </strong></p>
d1308 1
a1308 1
<p><strong>Ecosystem Values </strong></p>
@
1.8
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MichaelBrowne" date="1193532814" format="1.1" version="1.8"}%
d3 1
a3 1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
d712 1
a712 1
<td>Persistent, Temporary, Transient, DiedOut, Unknown </td>
@
1.7
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="MichaelBrowne" date="1190937743" format="1.1" reprev="1.7" version="1.7"}%
d813 1
a813 1
<td>Surviving and reproducing for a limited period</td>
d817 1
a817 1
<td>Surviving but not reproducing (e.g., remnant species from old gardens). </td>
d2150 1
a2150 1
-- Main.AnnieSimpson - 09 Aug 2007
@
1.6
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="AnnieSimpson" date="1186696799" format="1.1" version="1.6"}%
d1260 1
a1260 1
<td>Freshwater</td>
d1267 2
a1268 2
<td>Natural,HumanModified</td>
<td>Level of human impact to the habitat </td>
d1275 1
a1275 1
<td>Who the species is impacting </td>
d1316 1
a1316 1
<td>Few environments are pristine. Most conservation efforts are focused on natural or semi-natural environments.</td>
d1320 1
a1320 1
<td>Includes urban environments as well as forestry, agriculture, horticulture, second growth </td>
d2150 1
a2150 1
-- Main.AnnieSimpson - 09 Aug 2007@
1.5
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="AnnieSimpson" date="1186426915" format="1.1" version="1.5"}%
d42 1
a42 1
<li>BioStatus - BioStatus for a species, in a particular location, at a particular date. This includes data on origin, presence, distribution, abundance, rate of spread, whether the species is harmful . </li>
d726 1
a726 1
<td>Monoculture, Dominant, Common, Rare, Zero, Unknown </td>
a857 4
<td>Monoculture</td>
<td>Exists at a high level of abundance which has resulted in virtually no other species being present in the referenced location.</td>
</tr>
<tr>
d859 1
a859 1
<td>Numerically dominant in the referenced location. Depending on the nature of the referenced location, this information could be at the individual, population, community, ecosystem or landscape scale.</td>
d871 1
a871 1
<td>Zero abundance means absent. It's ok to have parameters overlap (but not the values within a parameter).&nbsp;</td>
d2147 4
a2150 1
-- Main.AnnieSimpson - 06 Aug 2007@
1.4
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="AnnieSimpson" date="1186291655" format="1.1" version="1.4"}%
d1346 1
a1346 1
<p><strong>ImpactStrength Values </strong></p>
d1354 1
a1354 1
<td>Causes the extinction of other species </td>
d1358 1
a1358 1
<td>Causes significant mortality in other species </td>
d1362 1
a1362 1
<td>Has a noticeable change on the habitat </td>
d1366 1
a1366 1
<td>&nbsp;</td>
d1370 1
a1370 1
<td>&nbsp;</td>
d1374 1
a1374 1
<td>&nbsp;</td>
d1377 1
a1377 1
<p>Note: we need more quantifiable terms here </p>
d2148 4
a2151 1
-- Main.AnnieSimpson - 05 Aug 2007@
1.3
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="AnnieSimpson" date="1186286086" format="1.1" reprev="1.3" version="1.3"}%
d15 2
a16 2
<h4>Version: 1.8, ProtocolSpecGISIN</h4>
<h4>Last Update: 3rd of June, 2007</h4>
d2148 1
a2148 1
-- Main.AnnieSimpson - 05 Aug 2007
@
1.2
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="AnnieSimpson" date="1186279209" format="1.1" version="1.2"}%
d936 1
a936 1
<td>Any kind of harm has been identified. Could be environmental, social/economic or harmful to human or animal health.</td>
d1335 1
a1335 1
<td>Natural or semi-natural environments and/or the species they contain. Includes, changes to ecosystem functioning and composition, habitat availability, species interactions, hybridization, predation, competition etc.</td>
d1339 1
a1339 1
<td>In the future, expansion may be needed to distinguish between e.g. diseases and allergens.</td>
d1481 1
a1481 1
<td>The reason the organism was introduced </td>
d1488 1
a1488 1
<td>The mechanism the organism is using to disperse </td>
d1544 4
d1553 1
a1553 1
<td>&nbsp;</td>
d1557 1
a1557 1
<td>To control problematic species </td>
d1561 1
a1561 1
<td>Does not incude horticulture </td>
d1565 1
a1565 1
<td>&nbsp;</td>
d1568 2
a1569 2
<td>Consumption</td>
<td>General consumption not including food or forage or medicinal use</td>
d1573 1
a1573 1
<td>Includes the use of feathers and herbs by traditional cultures </td>
d1577 1
a1577 1
<td>Cut flower trade</td>
d1585 1
a1585 1
<td>&nbsp;</td>
d1589 1
a1589 1
<td>&nbsp;</td>
d1595 1
a1595 5
<tr>
<td>Fishing</td>
<td>&nbsp;</td>
</tr>
<tr>
d1597 1
a1597 1
<td>&nbsp;</td>
d1605 1
a1605 1
<td>Food for both wild animals and live stock </td>
d1609 1
a1609 1
<td>&nbsp;</td>
d1613 1
a1613 1
<td>Not horticulture.</td>
d1617 1
a1617 1
<td>&nbsp;</td>
a1631 4
<td>Hunting</td>
<td>&nbsp;</td>
</tr>
<tr>
d1633 1
a1633 1
<td>&nbsp;</td>
d1637 1
a1637 1
<td>&nbsp;</td>
d1641 1
a1641 1
<td>&nbsp;</td>
d1645 1
a1645 1
<td>&nbsp;</td>
d1653 1
a1653 1
<td>&nbsp;</td>
d1657 1
a1657 1
<td>&nbsp;</td>
d1665 1
a1665 1
<td>&nbsp;</td>
d1669 1
a1669 1
<td>&nbsp;</td>
d1673 1
a1673 1
<td>&nbsp;</td>
d1677 1
a1677 1
<td>The natural tendancy for this organism to disperse</td>
d1681 1
a1681 1
<td>&nbsp;</td>
d1685 1
a1685 1
<td>&nbsp;</td>
d1689 1
a1689 1
<td>&nbsp;</td>
d1693 1
a1693 1
<td>&nbsp;</td>
d1697 1
a1697 1
<td>Outdoor recreational activity other than hunting and fishing </td>
d1701 1
a1701 1
<td>&nbsp;</td>
d1705 1
a1705 1
<td>&nbsp;</td>
d1709 1
a1709 1
<td>&nbsp;</td>
d1711 3
a1713 7
<tr>
<td>Propagation</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>Racing&nbsp;</td>
<td>&nbsp;</td>
d1717 1
a1717 1
<td>&nbsp;</td>
d1721 1
a1721 1
<td>&nbsp;</td>
d1725 1
a1725 1
<td>&nbsp;</td>
d1729 1
a1729 1
<td>&nbsp;</td>
d1733 1
a1733 1
<td>&nbsp;</td>
d1737 1
a1737 1
<td>&nbsp;</td>
d1741 1
a1741 1
<td>&nbsp;</td>
d1801 1
a1801 1
<td>&nbsp;</td>
d1809 1
a1809 1
<td>&nbsp;</td>
d2147 2
a2148 2
added DateOfIntroduction into Table 4.4.7.
-- Main.AnnieSimpson - 05 Aug 2007@
1.1
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="AnnieSimpson" date="1186198032" format="1.1" reprev="1.1" version="1.1"}%
d1462 8
a1469 1
<tr>
d1501 2
a1502 2
<td>&nbsp;</td>
<td>A textural description of the route the organism took from the FromCountryCode. If used, a LanguageCode must be specified. </td>
d2154 3
@