Introduction

Instrument page allows users to search for specific instruments to view / manage instrument’s INIT / REV / DATA. It provides initial information on each instrument, including initial data such as easting, northing, elevation. Users can also access revision data, which includes level updates, alarm limits, carry-over factors, and other parameters. Additionally, the page features a data table that displays readings at various times and indicates whether the readings have reached predefined alarm limits.

The Zone Area Fields can be access: Click on the top left corner to open the Setting side bar, click on ‘Instrument tab, and then click on ‘Instrument sub tab to access the page.

The sections are briefly introduced below:

Section Name	Function
Filter section	Use the filter section to search for specific instruments based on category, type, station, and date-time range.
INIT section	The INIT section shows the initial data of the instruments, including easting, northing, etc.
REV section	The REV section provides revision parameters, including instrument level, alarm limits, and carry-over factors, etc.
Data Table section	The data table displays instrument readings over time and also highlights if any alarm limits are reached.

Please use the navigation bar on the right side to quickly find the content you need.

1. Filter Section

In this section, users can use the filter function to select certain instruments to be displayed.

1.1 Functions overview

Category: click to filter out all instruments belong to a certain category. The category list is customized based on projects.

Instrument type: click to filter out a certain instrument type you are looking for. The instrument type list is customized based on projects.

Station-Group Type: click to filter out a certain station-group type, if you are looking for instruments in a station-group. The station-group type list is customized based on projects.
From / To Date-Time: enter a certain time period to filter out the instrument data within the certain time frame.

NOTE: Geosens system will auto-load 3,000 data of one instrument. For those instruments that exceeds 3,000 rows of data, this function can be used to check data in a certain time frame.

Stations: All the station groups are shown in this list. If Category / Station-group type is selected, only the filtered station groups will be shown. Use the search function and click on one station group to add it to the Selected stations list for further steps.
Selected Stations: all the selected station groups, clicked from stations list, will be displayed here in a list. Tick to show instruments that within the group to be displayed in the selected instruments.
Instruments: All the instruments are shown in this list. If Category / instrument type is selected, only the filtered instruments will be shown. Use the search function and click on one instrument to add it to the selected instrument list for further steps.

Selected Instruments: all the selected instruments, either clicked from selected stations lists or clicked from instrument list, will be displayed here in a list. Tick to select the instruments to be loaded and viewed in the next step.

Cross and Bin button: click the cross ‘’ to delete the instrument in this selected instrument list. Click the bin button ‘’ to clear the whole selected instrument list and remain empty.

Load: Click load to load and view the ticked instruments in the selected instruments list.
Evaluate: Click "Evaluate" to prompt the Geosens system to recalculate the readings and update the data results for the selected and checked instruments.

NOTE: The "Evaluate" button is typically used after changes have been made to an instrument's INIT or REV data. By clicking "Evaluate," the Geosens system recalculates and updates the readings using the new parameters.

1.2 How to filter instruments by category / instrument type / instruments

Click a category to filter out all the instruments inside this category. Click on an instrument type to further filter out all the instruments that in this instrument type and also inside the selected category.
All the available instruments will be displayed in the instruments list. Click one or multiple instruments to add it to the selected instruments list.
Tick to select one or multiple instruments in the selected instrument list to be viewed.
Click Load to load the instrument data and view it on the page.

1.3 How to filter instruments by station-group

Click to select one station group type and filter out all the eligible station groups inti the Stations list.
In the Station list, click to add one or multiple station groups into the Selected Stations list.
Tick to select one or multiple station groups. All the instruments inside the selected station groups will be displayed in the Selected Instruments list.
In the Selected Instruments list, tick to select one or multiple instruments to be viewed.
Click on ‘Load’ button to load all the selected instruments on this page.

1.4 How to filter instruments by date-time

In the from / to date-time field, set a certain time frame.
Select from the Category / Instrument Type / Station group type / Station Names / Instrument Names to filter out the instrument(s) you are looking for.
Tick to select the instruments in the Selected Instrument list.
Click on ‘load’ to load the data and show the selected instrument’s data on the page. All the readings that are shown on this page will be filtered out to the certain time frame.

NOTE: Geosens system will auto-load 3,000 data of one instrument. For those instruments that exceeds 3,000 rows of data, this function can be used to check data in a certain time frame.

2. To view loaded instruments after filtering

NOTE: It is worth noting that after selecting and loading the instruments, users should open the dropdown list and select a single instrument to view at a time. The Data Table, INIT, REV sections won’t show and update to the selected instruments, until user click and select one instrument from the drop down list.

3. INIT Section

After selecting instruments following the steps in Chapter 1 and 2, the INIT section will display the INIT data of selected instruments.

3.1 Fields introduction

Instrument Name: The unique identifier for each instrument, used for tracking and referencing specific devices.
Instrument Type: Specifies the category or model of the instrument, useful for classifying and differentiating among various devices.
Category: The general classification of the instrument, indicating its application area, such as geotechnical or environmental.
Easting (m): The eastward coordinate of the instrument's location in meters, used in geospatial mapping.
Northing (m): The northward coordinate of the instrument's location in meters, crucial for precise location referencing.
Level (mRL): The elevation level of the instrument in meters.
Ground Level (mRL): The ground elevation at the instrument site in meters.
Sensor Code Id: A unique identifier assigned to each sensor, used for data management and tracking purposes.
Parent Instrument Id: Identifies the main instrument associated with the sensor, useful for understanding hierarchical relationships.
Installed On: The date and time the instrument was installed.
Installed By: email address details of the person responsible for the installation.
Admin Only: Indicates fields that are restricted to administrative use, typically for management and control purposes.
On-Hold: Denotes whether the instrument is temporarily inactive, helping to monitor its operational status.
Ref. Information: Additional reference details or notes about the instrument, aiding in documentation.
Notes: A field for any relevant remarks or extra context about the instrument, helpful for detailed record-keeping.

To bring up more INIT columns, click on '' , Column Chooser, at the top right corner of the INIT table, drag to add and view more column info (Ground Level, Depth, Setup By, etc…).

Instrument Code: Unique identifier for the instrument.
Depth (m): Measurement of how deep the instrument is in meters.
Face Angle: The angle at which the instrument is positioned or faced.
Setup By: email address of the person who set up the instrument.
Instrument Status: Current operational status of the instrument.
Reference Set: The set of reference data related to the instrument.
Quarantined: Indicates if the instrument is under quarantine for inspection or issues.
Disqualified: Whether the instrument has been disqualified from use.
Ref. Info. Object 2: Additional reference information related to the instrument.
Ref. Info. Object 3: Further reference information related to the instrument.
Created By: email address of the person who created the record.
Created On: The date when the record was created.
Updated By: email address of the person who last updated the record.
Updated On: The date when the record was last updated.
prjInstrulId: The project instrument identifier.
prjInsTypeId: The project instrument type identifier.
Created By: email address of the person who created the project record.
Created On: The date when the project record was created.
Updated By: email address of the person who last updated the project record.
Updated On: The date when the project record was last updated.

3.2 To edit INIT table

To edit column data, tick the existing INIT record, click on ‘Edit Grid’ to enter edit mode, and by clicking directly and typing in the INIT table grid to edit this INIT table; Alternatively, tick this INIT row at the left-hand side of the INIT table, and select ‘Edit’ to open the editable INIT data form.

3.3 To view/edit Easting/Northing/Level

To further review/edit Easting/Nothing/Level, click on ‘ENRL’ to open a side bar for reviewing this Instrument’s location/position, e.g. Easting, Nothing and Elevation.

The side bar will display the ENRL data for this instrument.

Edit: Click on ‘Edit Grid’ to enter the edit mode and make any necessary changes to the easting / northing / level data and click Save to save all the changes.
Import: Click to upload a new set of ENRL data by using the format and upload the file to the system
Export: Click on this button to download a file of existing instrument ENRL to your local device.
Delete: Tick to select the existing instrument ENRL and click to delete this ENRL permanently.
Copy: Tick to select the existing instrument ENRL and click to copy another set of ENRL.

NOTE: In most of the cases only one set of ENRL will be recorded.

In some extreme cases, when more than one ENRL records are displayed, Geosens will take the initial record as the ENRL data for this instrument.

3.3 To Upload Documents

To upload related documents in the instrument, tick the existing INIT record, click on ‘Upload’, and select either Instrument Attachment / Instrument Location Images / Instruction Images to upload corresponding files.

3.4 To export the INIT record data

To export the INIT record data, tick the existing INIT record, click on ‘Export’ and click on ‘By Selection’ or ‘By Type’ to download the file to your local device.

3.5 To view / Edit Calibration data

NOTE: The Calibration Data section is available only for inclinometer instruments, as they require calibration data as part of their configuration.

To view / edit calibration data, tick the INIT record and select ‘Calibration’ to access the data panel. In the Calibration data panel, users can view all the cali-base parameters, and by clicking ‘Edit Grid’, users can enter edit mode, make necessary changes or create a new set of cali-base parameter.

3.6 To delete an existing INIT record

To delete an existing INIT record, tick the existing INIT record, click on ‘Delete’ to permanently delete this record. Please make deleting action with caution.

4. REV Section

After selecting instruments following the steps in Chapter 1 and 2, the REV section will display the REV data of selected instruments.

4.1 Fields Introduction

Instrument Name: Identifies the name or code of the measurement instrument (e.g., M110-393-M1).
Revision: Represents the version or update number of the data entry.
Date-Time: Indicates the date and time when the revision was recorded.
Easting: Refers to the eastward coordinate in a geographic coordinate system.
Northing: Refers to the northward coordinate in a geographic coordinate system.
Instrument Init: The initial measurement value recorded by the instrument.
Instrument Level: The current level or reading taken by the instrument.
Surface Level: The level or elevation of the surface where the measurement was taken.
Unit: Specifies the unit of measurement used (e.g., mm).
Factor: A multiplication factor for adjusting measurements / measurements calculations.
Invert: N/A.
Alarm On: Shows whether the alarm is active or not.
Alarm Type: Describes the type of alarm applied (e.g., STATIC).
Reference Info: Any additional reference information pertinent to the measurement.
Notes: Allows for the entry of additional comments or observations related to the measurement.

To bring up more REV columns, click on '' Column Chooser, at the top right corner of the REV table, drag to add and view more column info (Instrument Code, Quarantined, etc…).

Instrument Code: The unique identifier assigned to each instrument for tracking and identification purposes.
Depth (m): The measurement of how deep the instrument is situated in meters.
Face Angle: The orientation angle at which the instrument is positioned or faced.
Setup By: The name or ID of the person who set up the instrument.
Instrument Status: The current operational status of the instrument (e.g., active, inactive).
Reference Set: A set of reference data related to the instrument for calibration or baseline purposes.
Quarantined: Indicates whether the instrument is under quarantine for inspection or due to issues.
Disqualified: Specifies if the instrument has been disqualified from use or measurement.
Ref. Info. Object 2: Additional reference information related to the instrument or its operation.
Ref. Info. Object 3: Further reference information pertinent to the instrument.
Created By: The email address of the person who created the record.
Created On: The date and time when the record was created.
Updated By: The email address of the person who last updated the record.
Updated On: The date and time when the record was last updated.
prjInstrulId: The project instrument identifier for tracking within the specific project.
prjInsTypeId: The project instrument type identifier, specifying the type within the project.
Created By: The email address of the person who created the project record.
Created On: The date when the project record was initially created.
Updated By: The email address of the person who last updated the project record.
Updated On: The date when the project record was last updated.

4.2 REV EXTRA – Create / Edit Alarm limits

To view more REV property data, tick a REV set and click ‘Extra ’ to access additional REV properties pop-up window.

4.2.1 To create alarm limits:

Normally Geosens supports bulk-upload of alarm limits for multiple instruments on the Data-Entry page. In the meantime, Geosens also supports single set up for one particular instrument, by using this REV – EXTRA page.

On the pop-up window of Extra Page, navigate to the Alarm Limit tab. Click on ‘Edit Grid’ to enter the edit mode, and users can click on ‘+Add’ to add a new alarm limit for this instrument.

Alarm Level: this alarm level is pre-set on Setting-Alarm Level Set page. Click to configure an alarm level for this instrument.
Data Column: Define the type of data to be monitored and alarmed by the alarm trigger limit. The available items depend on the instrument type and the corresponding data type.
Trigger Limit: Defines the threshold value at which an alarm is triggered.
Trigger Limit 2: An additional threshold value for triggering alarms under different conditions.
Trigger Applied To:
- Negative: means make the alarm trigger in a negative value of trigger limit. (e.g. trigger limit is 12, trigger applied to 0:Negative, then the actual trigger limit will be -12).
- Positive: means make the alarm trigger in a positive value of trigger limit. (e.g. trigger limit is 12, trigger applied to 1:Positive, then the actual trigger limit will be 12).
- Both: means make the alarm trigger in both the negative and positive value of trigger limit. (e.g. trigger limit is 12, trigger applied to 2:Both, then the actual trigger limit will be -12, and 12).
Alarm On: Specifies whether the alarm is currently active or not.
Notes: Provides space for additional comments or details regarding the alarm.

NOTE: After making any changes to the REV data, please click on ‘Evaluate’ button on the top right corner of the filter section, to make the changes taken into calculation and make them in effect.

4.2.2 To view / edit Alarm limits

Edit: Tick an existing alarm trigger limit and click on ‘Edit Grid’ to make any necessary changes and click on Save.
Export: Tick an existing alarm trigger limit and export the existing alarm trigger limits into a file and download to local device.
Delete / copy: Tick an existing alarm trigger limit and click on ‘delete’ / ‘copy’ to delete / copy this alarm trigger limit settings.

4.3 REV EXTRA – Create / Edit Carry Over Factors

4.3.1 To Add-Missing carry over factors

Click the Carry Over tab, when this section is blank, or it seems missing any carry over items, select ‘Add Missing’ and click on ‘Update’ to update and view the carry over factors for the instrument. These factors are typically used for calculations between revisions during re-baselining.

NOTE: Please be cautions to click on ‘Add Missing’ instead of ‘Overwrite’ or ‘Clean & RE-Import’ for most of the cases, in order to avoid overwriting and losing any data.

NOTE: Carry over parameters are preset as default values for all instruments within this project and will be auto-loaded from Setting – Property Type and Code. It is customized based on projects.

It is recommended to make changes in Setting – Property Type and Code for CARRY OVER changes that affects the whole project; make changes in this page if only one / a few instruments will need a customized CARRY OVER different from other majority instruments.

4.3.2 To edit the CARRY OVER factor

Click on ‘Edit Grid’ to enter the edit mode.
Make any necessary changes to the Carry Over table grid.
- Carry Type: This field specifies the type of carry operation. For instance, "AUTOCARRY" indicates an automated carry operation, and "MANUALCARRY" indicates a manual carry operation.
- Carry Code: This field provides a unique code for each carry operation. Examples include "AutoCarryDE" (Delta Easting for auto carry), "AutoCarryDN" (Delta Northing for auto carry), etc.
- Carry Name: This field gives a descriptive name to each carry operation. It includes a brief explanation of the measurement or the adjustment being applied. For instance, "Auto Carry Value (Delta Easting)(mm)" provides more context about the type and unit of the carry value.
- Carry Value: This field represents the numerical value associated with the carry operation. It usually contains a measurement or a calculation pertinent to the carry operation.
- Notes: This field is for any additional remarks or observations related to the carry operation.
Click on ‘Save’ to save any changes. If needed, click on ‘Export’ to download existing carry over factors to your local device.

4.3.3 To add a new Carry Over factor

Click on ‘Edit Grid’ to enter the edit mode.
Click on ‘+Add’ to add a new carry over parameter.
To select / fill in the fields to complete the creation. The fields’ introduction please refer to the above section 4.3.2.

4.4 REV EXTRA – Create / Edit Parameters

4.4.1 To Add-Missing parameters

On the pop-up window of Extra Page, navigate to the Parameter tab to view and/or edit Parameter values for this Instrument. When this section is blank, or it seems missing any parameter items, please select the ‘Add Missing’ option and click on ‘Update’ to update the REV Parameter Items for the instrument. The default value or blank for each parameter item is inherited from the Property Types and Codes section.

NTOE: The number of records for both CHART and REPORT CHART is set to a preferred value, e.g. 3600. Since monitoring occurs in every certain period, increasing this value excessively or leaving it unset can lead to export or reporting not working properly. Adjust this setting carefully to maintain system performance. When this value is unset/blank, the system will use the entire dataset for export and reporting.

NOTE: Please be cautions to click on ‘Add Missing’ instead of ‘Overwrite’ or ‘Clean & RE-Import’ for most of the cases, in order to avoid overwriting and losing any data.

NOTE: Parameters are preset as default values for all instruments within this project and will be auto-loaded from Setting – Property Type and Code. It is customized based on projects.

For parameter changes affecting the entire project, it is recommended to make adjustments in the Settings – Property Type and Code section. Make changes on this page only if one or a few instruments require customized carry-overs different from the majority.

4.4.2 To view / edit Parameters

Click on ‘Edit Grid’ to enter the edit mode.
Make any necessary changes to the Carry Over table grid.
- Param Type: Indicates the type of the parameter, specifying its category or nature.
- Param Code: A unique code or identifier assigned to the parameter for identification.
- Param Name: The name or label of the parameter, used for easy reference.
- Param Value: The numerical or coded value assigned to the parameter.
- Param Text Value: A textual representation of the parameter's value, often used for descriptive purposes.
- Notes: Additional information or comments related to the parameter.
Click on ‘Save’ to save any changes. If needed, click on ‘Export’ to download existing carry over factors to your local device.

4.4.3 To create new parameters

Click on ‘Edit Grid’ to enter the edit mode.
Click on ‘+Add’ to add a new parameter setting row.
To select / fill in the fields to complete the creation. The fields’ introduction please refer to the above section 4.4.2.

4.3 To edit REV table

To edit any details, click on ‘Edit Grid’ to enter the edit mode, and edit this REV table by directly clicking and typing in the REV table grid; Alternatively, tick this REV record at the left-hand side of the REV table, and select ‘Edit’ to bring up its data form for editing.

4.4 To create a new REV

To add any new set of REV, click on ‘New’ to add corresponding new information about this new REV record.

NOTE: After creating or making any changes to the REV data, please click on ‘Evaluate’ button on the top right corner of the filter section, to make the changes taken into calculation and make them in effect.

4.5 To export REV record data

To export the REV data records, click on ‘Export’ and click on ‘By Selection’ or ‘By Type’ to download the file.

4.6 To delete an existing REV record

To delete an existing REV record, tick the existing REV record, click on ‘Delete’ to permanently delete this record. Please make deleting action with caution.

5. Data Table Section

After selecting instruments following the steps in Chapter 1 and 2, the Data Table section will display the readings and calculations of selected instruments.

5.1 Fields Introduction

Instrument Name: Identifier for the specific measuring device.
Revision: Version number or update identifier for the data.
Date-Time: Timestamp marking when the data was recorded.
Easting (m): Horizontal coordinate in meters, indicating eastward position.
Northing (m): Horizontal coordinate in meters, indicating northward position.
Level (mRL): Elevation or vertical position in meters Reduced Level (mRL).
Change in Easting (mm): Variation in the eastward position, measured in millimeters.
Change in Northing (mm): Variation in the northward position, measured in millimeters.
Change in Level (mm): Variation in elevation, measured in millimeters.
Lateral Displacement (mm): Total horizontal shift, measured in millimeters.
Vertical Displacement (mm): Total vertical shift, measured in millimeters.
Parallel Displacement (mm): Displacement in a direction parallel to a reference line, measured in millimeters.
Horizontal Displacement (mm): Overall change in horizontal position, measured in millimeters.
XYZ (3D) Displacement (mm): Total three-dimensional displacement, combining all axes, measured in millimeters.
On-Hold: Indicator if the item or data point is currently paused or under review.
Notes: Additional comments or relevant details regarding the data entry.

To view more details, click on Column Chooser ‘’ at the top right corner of the DATA table, drag to add and view more column data (InstruData ID, In Quarantine status, etc…).

InstruData ID: Unique identifier for the instrument data entry.
Convergence (mm): Measurement of convergence in millimeters.
In Quarantine: Status indicating if the data is in quarantine.
Created By: The person or system that created the entry.
Created On: Date and time the entry was created.
Updated By: The person or system that last updated the entry.
Updated On: Date and time the entry was last updated.
Ref. Action Code: Reference code for the associated action.
Elevation (mRL): Measurement of elevation in meters above reference level.

NOTE: The reading fields above will vary depending on the instrument type, such as settlement, groundwater level, and others.

5.2 To view Data table – Filtering & Ordering

Filtering for any specific info by clicking on the filter icon right next to the column names. By using filtering function, users can quickly locate to a certain time period / certain revision / etc for data checking.

Sort categories alphabetically by clicking the column header, and an arrow will display next to the header and show ascending / descending order.

5.2 To Edit Data Table

To edit any data, click on ‘Edit Grid’ to enter the edit mode. Make any necessary changes by directly clicking and typing in the data table grid. Click ‘Save’ to save all the changes.

NOTE: Please be aware of that only raw data fields can be editable. This can be controlled by the project administrators via the Instrument Data Columns page.

5.3 To Add a new set of readings

NOTE: Instrument data can only be input by Data Entry Page / Data Acquisition Jobs.

5.4 To delete an existing reading

To delete an existing data record, tick the existing data record, click on ‘Delete’ to permanently delete this record. Please make deleting action with caution.

Instrument/Station-Group Audit