Environment Menu

The KDManage Environment Menu contains tools for environmental data. These tools are located within the Layers Page.


Layers Page

Layers refers to the data group that handles environmental data. A layer can cover multiple locations and include multiple attributes for data collection. The Layers Page is pictured below:


Layers Page (select to zoom)


The following table describes the contents of the Layers Page:

Elements of the Layers Page
Field Description
ID A unique system identifier of the layer.
Layer Name The user provided name of the layer.
Create Date/Time Create Date/Time of Layer
Action Provides actions for the relevant layer. See the section below for more information.

The image below is an example of a layer at a site called ‘Narrabri’:


Layer Example (select to zoom)



Layer Actions

The following table lists all the actions that can be performed for the selected Layer in KDManage.

Layer Actions
Action Description Parent button
View Layer View layer in a single page. Selecting the layer name from the Layer Name Column will also open the layer in a single page.  
Download Add a layer attribute (such as rain or humidity) to the layer.  
Edit List all layer attributes in layer. View layer
Import Layer Data Import layer attribute data from a CSV file. Add a layer attribute to Layer
Export Layer Data Export layer attribute data to various file formats.  

Note

The presence of action types is dependant upon the layer state - not all action types will be available for all layers.


Adding Layers

To add a layer, select the Add Layer Button which will display the Add Layer Window.

The following image shows the Add Layer Window, displaying the description fields:


Add Layer Window (select to zoom)


The fields for the Add Trial Window are described in the following table:

Add Layer Window Fields
Field Mandatory? Description
Layer Name Mandatory The name of the layer. A naming convention is suggested (e.g. a concatenation of site, type, date, number).
Layer Alias   An alias for Layers
Layer Type Mandatory Either layer, layer2d or layering. These three values refer to the base name of the real layer.
Layer Metadata   Metadata for layers
Is editable? Mandatory Flag for whether layer can be edited.
Geometry Type Mandatory For internal layers, this is the type of the geometry and have to match OGC standards (POINT, MULTIPOINT, POLYGON .. etc)
Description   Description of the layer.
Access Fields Mandatory Access Settings and Permissions


Add Layer Attribute to a Layer

Layer attributes define the measurements that are collected in a layer such as humidity. Users can define the size, type, unit name and any validation rule they require.


Add Layer Attribute Window (select to zoom)


The fields for the Add Layer Attribute Window are described in the following table:

Field Mandatory? Description
Unit Mandatory Unit of uploaded data (refer to the Units topic).
Attribute Column Name Mandatory Name of attribute e.g. rain.
Attribute Column Type Mandatory Type of attribute.
Attribute Column Size Mandatory Data size of attribute data.
Validation Rule   Validation rule.
Attribute Column Unit Name Mandatory Unit name of column.

Import Data to a Layer

While most environmental data will be uploaded via applications like KDSens, users can upload data via CSV through KDManage.

For each layer attribute, users will need to include a column in uploaded CSV.


Import Layer Data Window (select to zoom)


The fields for the Import Layer Data Window are described in the following table:

Field Mandatory? Description
Layer data file Mandatory File of layer data to be imported.
Geometry Column Mandatory The column in the CSV that contains the geometry of each data point.
Time Stamp Mandatory The column in the CSV that contains the timestamp of each data point.
All Layer Attributes in Layer Columns Mandatory Each layer attribute (RAIN and HUMIDITY in the above example) will appear as a field and users will need to specify each column in the CSV for each layer attribute. Users may not skip any of the layer attributes.


Layers Page

Single layers can be viewed as a single view which includes a live feed of the average attribute values from a set time.


Layer Example (select to zoom)


The live feed of the layer data can be started by pressing the KDMan-Start-Btn Start Button and stopped by pressing the KDMan-Stop-Btn Stop Button.


Map Device to Attribute

Devices can be mapped to an attribute. This connects a device (usually a sensor) to a layer attribute which specifies the device that is collecting data for an attribute.

To map a device to an attribute, select the Map Device Button for the appropriate attribute as seen in the image below:


Mapping a Device (select to zoom)


That will open the Map Device Window as seen in the image below:


Map Device Window (select to zoom)


The fields for the Map Device Window are described in the following table:

Map Device Window Fields
Field Mandatory? Description
Device Id Mandatory ID for device. This is not to be confused with Device Register ID.
Parameter Mandatory Name of parameter from the device for that attribute.
Is Active Mandatory Flag to determine whether mapping is active.