Contributing Data

& Sensor Types
As an Open Access, Map & Graphing tool, provided by the Argus Trust, it is freely available for amateur, educational and commercial hardware and software developers and researchers alike, to publish environmental data on Google’s World map.  All contributed and published data is automatically saved to the Argus Trust’s Central Database where it is archived, providing ongoing open access to all historic data recorded.  The Objects of the Argus Trust set out to encourage and facilitate the scientific recording of all environmental data types, together with their presentation and ease of open access.
 
You can request a New Station ID and Password to contribute and publish your station’s historic and current readings, which will automatically display on the Map. There are two methods available to contribute data, either by uploading your readings as XML data files or, if your monitoring unit is at a fixed IP address, it can be polled at regular intervals for it’s latest readings, ensuring its latest readings go live on-line.  To submit data it must conform to the Argus XML Schema, detailed below, in order to be recognised and archived by the Argus Trust’s Central Database.
 
Using the Argus XML Schema when formatting your sensor’s readings will ensure your data can be accepted into the Central Argus Database.  It will however need to pass authentication when submited and this will require a Station ID and password and must a incorporate Sensor Type reference number for each channel of data submitted or polled for. Ths can be found in the Sensor Type table below, this will determine which sensor icon design for each data type. It will also determine which type of graph be displayed below the map. While all Argus station designs have a gamma probe as a primary sensor, there is no obligation when contributing to include gamma data, all environmental data is welcomed. Where your contributing station has more than one sensor, we do need to know which sensor you choose to nominate as the “primary” sensor. This determines which of your station’s sensor icons is first seen on the map, when the page loads or HOME is selected.
XML Schema – Open Source Protocol
Designed for project developers and programmers, this is a unique Argus Trust XML protocol that defines the format for any data being uploaded and archived. The XML Schema is also used for file downloads when selecting the “Download as XML File” menu option available on each graph displayed. Data can also be downloaded for use in spreadsheets as Comma Separated Value (CSV) files using the “Download as CSV File” option. 
There are three documents below:
• The Argus Trust XML Schema
• XML Example Required to contribute data from you station
• Sensor Type Reference Table – Any additional sensor types can be added on request
The Schema below is used for data retrieval as well as data upload. Note that the location can be present both within a StationInfo and a D element. The latter will always take precedence.
The XML Schema
</xs:complexType>
<xs:schemaxmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name='Argus_Envelope'>
<xs:complexType>
<xs:sequence>
<xs:element ref='Station' maxOccurs='unbounded'/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:element name='Station'>
<xs:complexType>
<xs:sequence>
<xs:element ref='StationInfo'/>
<xs:element ref='Channels' minOccurs='0' maxOccurs='1'/>
</xs:sequence>
<xs:attribute name='id' type='xs:string' use='required'/>
</xs:complexType>
</xs:element>

<xs:element name='StationInfo'>
<xs:complexType>
<xs:sequence>
<xs:element ref='ID'/>
<xs:element ref='Name' minOccurs='0' maxOccurs='1'/>
<xs:element ref='Version' minOccurs='0' maxOccurs='1'/>
<xs:element ref='Location' minOccurs='0' maxOccurs='1'/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:element name='Channels'>
<xs:complexType>
<xs:sequence>
<xs:element ref='ChannelData' maxOccurs='unbounded'/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:element name='ChannelData'>
<xs:complexType>
<xs:sequence>
<xs:element ref='Channel'/>
<xs:element ref='Data' minOccurs='0' maxOccurs='1'/>
</xs:sequence>
<xs:attribute name='id' type='xs:string' use='required'/>
</xs:complexType>
</xs:element>

<xs:element name='Channel'>
<xs:complexType>
<xs:sequence>
<xs:element ref='Name'/>
<xs:element ref='Type'/>
<xs:element ref='Units'/>
<xs:element ref='Comments' minOccurs='0' maxOccurs='1'/>
<xs:element ref='Earliest'/>
<xs:element ref='Latest'/>
</xs:sequence>
<xs:attribute name='id' type='xs:string' use='optional'/>
/xs:element>

<xs:element name='Data'>
<xs:complexType>
<xs:sequence>
<xs:element ref='D' maxOccurs='unbounded'/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:element name='D'>
<xs:complexType>
<xs:sequence>
<xs:element ref='T'/>
<xs:element ref='V'/>
<xs:element ref='Location' minOccurs='0' maxOccurs='1'/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:element name='Location'>
<xs:complexType>
<xs:choice>
<xs:element ref='OS'/>
<xs:element ref='WSG84'/>
</xs:choice>
</xs:complexType>
</xs:element>

<xs:element name='OS'>
<xs:complexType>
<xs:sequence>
<xs:element ref='Mapsheet'/>
<xs:element ref='Easting'/>
<xs:element ref='Northing'/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:element name='WSG84'>
<xs:complexType>
<xs:sequence>
<xs:element ref='Latitude'/>
<xs:element ref='Longitude'/>
<xs:element ref='Altitude' minOccurs='0' maxOccurs='1'/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:element name='ID' type="xs:integer"/>
<xs:element name='Name' type="xs:string"/>
<xs:element name='Type' type="xs:integer"/>
<xs:element name='Version' type="xs:string"/>
<xs:element name='Units' type="xs:string"/>
<xs:element name='Comments' type="xs:string"/>
<xs:element name='Earliest' type="xs:dateTime"/>
<xs:element name='Latest' type="xs:dateTime"/>
<xs:element name='T' type="xs:dateTime"/>
<xs:element name='V' type="xs:double"/>
<xs:element name='Mapsheet' type="xs:string"/>
<xs:element name='Easting' type="xs:integer"/>
<xs:element name='Northing' type="xs:integer"/>
<xs:element name='Latitude' type="xs:string"/>
<xs:element name='Longitude' type="xs:string"/>
<xs:element name='Altitude' type="xs:double"/>
</xs:schema>
An XML Example – in the format required from a fixed site station to contribute data
<ArgusEnvelope>
   <Station id="2053">
      <StationInfo>
         <ID>2053</ID>
         <Name>Seafields</Name>
         <Version>5</Version>
         <Location>
            <WSG84>
               <Latitude>42.38675</Latitude>
               <Longitude>-39.63457</Longitude>
               <Altitude>1</Altitude>
            </WSG84>
         </Location>
      </StationInfo>
      <Channels>
         <ChannelData id="1">
            <Channel id="1">
               <Name>Gamma</Name>
               <Units>nGy/hr</Units>
               <Comment>'K' Factor is supplied by NRPB K=18.8 S/N: Argus 1502LM</Comment>
               <Type>0</Type>
            </Channel>
            <Data>
               <D>
                  <T>2016-05-25 23:10:00</T>
                  <V>111.7</V>
               </D>
               <D>
                  <T>2016-05-25 23:20:00</T>
                  <V>109.93</V>
               </D>
               <D>
                  <T>2016-05-25 23:30:00</T>
                  <V>109.04</V>
               </D>
               <D>
                  <T>2016-05-25 23:40:00</T>
                  <V>103.72</V>
               </D>
               <D>
                  <T>2016-05-25 23:50:00</T>
                  <V>102.84</V>
               </D>
               <D>
                  <T>2016-05-26 00:10:00</T>
                  <V>106.38</V>
               </D>
               <D>
                  <T>2016-05-26 00:20:00</T>
                  <V>108.16</V>
               </D>
               <D>
                  <T>2016-05-...............
                  ..........................
                  ........ //
		  
		  
		           // ..............
                  ..........................
                  ...........27 16:10:00</T>
                  <V>108.16</V>
               </D>
               <D>
                  <T>2016-05-27 16:20:00</T>
                  <V>107.27</V>
               </D>
               <D>
                  <T>2016-05-27 16:30:00</T>
                  <V>109.04</V>
               </D>
               <D>
                  <T>2016-05-27 16:40:00</T>
                  <V>107.27</V>
               </D>
            </Data>
         </ChannelData>
         <ChannelData id="2">
            <Channel id="2">
               <Name>Temperature</Name>
               <Units>C</Units>
               <Comment>Skye Integral Sensor Datahog 2 Type: SDL 5280/HS/S S/N: 0501 22592 Issued: Latest Cerificate 20-06-2008</Comment>
               <Type>7</Type>
            </Channel>
            <Data>
               <D>
                  <T>2016-05-25 23:10:00</T>
                  <V>10.76</V>
               </D>
               <D>
                  <T>2016-05-25 23:20:00</T>
                  <V>10.91</V>
               </D>
               <D>
                  <T>2016-05-25 23:30:00</T>
                  <V>11.22</V>
               </D>
               <D>
                  <T>2016-05-25 23:40:00</T>
                  <V>11.15</V>
               </D>
               <D>
                  <T>2016-05-25 23:50:00</T>
                  <V>10.84</V>
               </D>
               <D>
                  <T>2016-05-26 00:10:00</T>
                  <V>10.38</V>
               </D>
               <D>
                  <T>2016-05-26 00:20:00</T>
                  <V>9.96</V>
               </D>
               <D>
                  <T>2016-05-...............
                  ..........................
                  ........ //
		  
		  
		           // ..............
                  ..........................
                  .......... 27 16:10:00</T>
                  <V>8.16</V>
               </D>
               <D>
                  <T>2016-05-27 16:20:00</T>
                  <V>7.27</V>
               </D>
               <D>
                  <T>2016-05-27 16:30:00</T>
                  <V>7.04</V>
               </D>
               <D>
                  <T>2016-05-27 16:40:00</T>
                  <V>7.27</V>
               </D>
            </Data>
         </ChannelData>
      </Channels>
   </Station>
</ArgusEnvelope>
Sensor Types
UVB & UVA added. Last update: 2017-04-26 – if the data you wish to contribute requires a sensor type(s) not in the list, please send a request so we can add it. 
Channel:

Type          Name

  0           Gamma
  1           Longitude
  2           Latitude
  3           Height
  4           Wind Direction
  5           Wind Speed
  6           Rain
  7           Temperature
  8           Air Pressure
  9           Sunlight
 10           Humidity
 11           UVB
 12           UVA