1. Introduction
The INIT-NEW page provides a streamlined view of INIT data for project instruments, showing key metadata like name, category, and operational status (e.g., on-hold or quarantine). It helps users understand the initial setup and current state of instruments.
This page allows you to:
View INIT data in a structured table
Check instrument name, category, and status
Identify instruments on-hold or in quarantine
Filter data for easier review
Get a snapshot of instrument setup across the project
Manually create a new instrument by adding an INIT record
2. Page Navigation
Sign in to GeoSens.
Click on left-hand corner icon 'Setting', click to expand 'INIT | REV | CALI | DATA'→ click INIT - NEW.
3. Interface Overview
The Project Instruments interface consists of the following main components:
Instrument Type Filter: Dropdown filter for instrument types
Function Bar: Functional buttons for creating, editing, exporting, etc.
Instrument INIT Table: data grid to show INIT data.
4. Instrument Type Filter
The "Select a Project Instrument Type" dropdown helps focus on specific instrument types.
To use the filter:
Open the dropdown by clicking the field with the down arrow
Select a type by scrolling or typing to search (e.g., BOS, Piezometer, Inclinometer, Tiltmeter, Extensometer, Strain Gauge, Crack Meter, Load Cell, Weather Station)
Apply the selection by clicking the desired type; the table updates automatically
Clear the filter by clicking the "X" to show all instruments again
Strategic use:
Select specific types to narrow down the list before reviewing or exporting data for targeted instruments
Combine with column filters for precise data views
5. Instruments INIT Table Introduction
5.1 Table Field Introduction
This section introduces the Instruments INIT Table fields and how to read the table.
Field Name | Introduction |
Instrument Type | Defines the type of the monitoring instrument. |
Instrument Name | Name assigned to the instrument. |
Category | Describes the instrument’s location or monitoring purpose. |
Sensor ID | Unique code identifying the sensor hardware. |
On Hold | Tick means the instrument is temporarily inactive. |
Admin Only | Tick means marking instruments restricted to admin-level access. |
In Quarantine | Tick means flagging instruments with data quality issues. |
Date-Time Installed | Records the exact date and time the instrument was installed. |
Notes | Field for additional comments or relevant details. |
5.2 Additional Information Columns
Additional columns can be dragged and dropped from the column chooser '' into the data table to customize the view and add more information.
Field Name | Introduction |
prjInstrulId | Internal ID used to uniquely identify the project instrument. |
prjInsTypeId | Internal ID referencing the instrument type. |
Instrument Code | A short code or label assigned to the instrument for quick reference. |
instruDisplay Name | The name displayed in the interface to represent the instrument. |
Ground Level | The elevation or surface level where the instrument is installed. |
Depth | The vertical distance from ground level to the instrument’s position. |
Angle | The orientation angle of the instrument, if applicable. |
Status | Indicates the current operational state of the instrument. |
setupBy | The user or technician who configured or set up the instrument. |
Ref Set | A reference group or set associated with the instrument. |
Ref Obj 1–3 | Linked reference objects used for positioning or alignment. |
Icon | Visual symbol used to represent the instrument on maps or diagrams. |
Disqualified | Marks instruments excluded from analysis due to issues or invalid data. |
Last Reading Date-Time | Timestamp of the most recent data reading from the instrument. |
Created By | User who initially created the instrument record. |
Created On | Date and time when the instrument record was created. |
Updated By | User who last modified the instrument record. |
Updated On | Date and time of the most recent update to the instrument record. |
5.3 Filtering
Column filters let you narrow down displayed instruments based on specific criteria.
Accessing Filters:
Click the funnel icon next to a column header to open filter options.
Creating and Managing Filters:
Basic Filter:
Click the filter icon, choose a filter type, enter criteria, and click Apply
A blue icon shows the filter is active
Advanced Filter:
Click Create Filter at the bottom of the table
Combine multiple conditions using AND/OR
Save filters for reuse
Managing Multiple Filters:
Apply filters to several columns for precise results
Filters combine using AND logic
Clear individual filters via the icon, or click Clear All Filters to reset
5.4 Sorting Function
Sorting organizes instrument data in ascending or descending order based on column values.
Basic Sorting Operations:
Click a column header to sort by that column
First click: ascending (A–Z, oldest–newest)
Second click: descending (Z–A, newest–oldest)
Third click: removes sorting
Sort indicators:
▲ = ascending
▼ = descending
No arrow = not sorted
Multi-Column Sorting:
Hold Shift and click additional headers to add secondary sort criteria
Primary sort shows solid arrow; secondary shows outlined arrow
Sort priority follows the order of selection
Practical Applications:
Date-Time Installed: View recent installations
Instrument Type: Group similar instruments
Installed By: Review team activity
Category: Organize by location or section
In Quarantine / On Hold: Identify instruments needing attention
6. Function Bar Introduction
Function | Description |
Edit Grid | Enables inline editing of instrument data directly within the table. |
Export | Opens options to export instrument data into downloadable files. |
New | Starts the INIT-NEW process to add a new instrument record. |
Edit | Opens selected configuration form to modify selected instrument details. |
Copy | Duplicates the selected instrument configuration for reuse. |
Upload | Allows uploading of instrument-related data files to the system.
|
ENRL | Click to open ENRL panel to configure Easting, Northing, Level, etc. |
Calibration | Accesses calibration tools to adjust or verify instrument accuracy. |
Delete | Permanently removes selected instrument configurations from the project. |
7. How to Create New Instruments (INIT-NEW)
The INIT-NEW process is used to add new instruments to your monitoring system.
Click the "New" button in the top-right function bar
Fill in the fields as necessary and click on 'create' to manually create the new instrument.
Field Name | Introduction |
Instrument Code | A short, unique code used to identify the instrument. |
Instrument Name | The full name or label assigned to the instrument. |
Instrument Type | Dropdown to select the category of the instrument (e.g., piezometer, inclinometer). |
Parent Instrument | Dropdown to link this instrument to a parent device, if applicable. |
Category | Dropdown to classify the instrument by location or monitoring purpose. |
Sensor ID | Unique identifier for the sensor hardware. |
Ground Level | Elevation at the installation point of the instrument. |
Depth | Vertical distance from ground level to the instrument’s position. |
Date-Time Installed | Timestamp indicating when the instrument was installed. |
Installed By | Name of the person or team who installed the instrument. |
setupBy | User who configured or registered the instrument in the system. |
Angle | Orientation angle of the instrument, if relevant. |
Status | Current operational state of the instrument. |
Ref Set | Reference group associated with the instrument. |
Ref Obj 1–3 | Reference objects used for alignment or positioning. |
Notes | Free-text field for additional comments or context. |
In Quarantine | Checkbox to flag instruments with data quality concerns. |
Disqualified | Checkbox to mark instruments excluded from analysis. |
Admin Only | Checkbox to restrict visibility to admin users. |
On Hold | Checkbox to indicate the instrument is temporarily inactive. |
8. How to Edit Existing Instruments
Modify instrument configurations as project needs evolve.
8.1 Accessing Edit Mode
Two methods to edit instruments:
Select instrument(s) and click the "Edit" button
Enable "Edit Grid" and modify cells directly in the table
8.2 Edit Options
Individual Instrument Edit:
Select a single instrument and click "Edit"
A form opens with all configuration options
Make changes to any field
Save changes with "Apply" or "Save"
Bulk Edit via Edit Grid:
Click "Edit Grid" to enable table editing
Click directly in cells to modify values
Use drag-and-fill for applying changes to multiple rows
Click "Save" when complete
Common Edit Operations:
Update status flags (On Hold, Admin Only, In Quarantine)
Modify Category assignments
Update Notes with new information
Change sensor associations
8.3 Edit Restrictions
Some fields may be locked after initial creation
Historical data fields typically cannot be changed
System-generated IDs are not editable
9. How to Copy Instruments
Duplicate existing instrument configurations to speed up setup of similar instruments.
Select one or more instruments to copy
Click the "Copy" button in the top action bar
Newly copied instruments appear with "(copy)" in their name. Edit the copied instrument to configure its specific settings.
10. How to Delete Instruments
Remove instrument configurations from the system when no longer needed.
NOTE: Please be cautious with deleting function, as the instrument will be permanently deleted.
Select one or more instruments to delete
Click the "Delete" button in the top action bar
A confirmation dialog appears with options:
Delete configuration only: Removes setup but keeps historical data
Delete all data: Removes configuration and all associated readings
Confirm the deletion
Delete Alternatives
Consider using "On Hold" status instead of deletion for temporary situations
Use "In Quarantine" for instruments with suspect data
Archive instruments instead of deleting when historical record is important
11. How to Export Instrument Data
The Export feature creates downloadable files of instrument configurations for reporting, backup, or transfer.
Preparing for Export:
Select specific rows or apply filters to export targeted data
If nothing is selected, all visible instruments will be exported
Initiating Export:
Click the Export button in the top action bar
Choose export options in the dialog
By Selection: all selected rows will be exported
By Type: all instruments belong to the selected project instrument type in the instrument type filter bar will be exported.
The exported file will be sent via email
12. How to Configure ENRL
The ENRL function configures instrument coordinates, Easting, Northing, Reduce Level, etc.
Select Instruments: Choose one instrument to enroll
Initiate Enrollment: Click the "ENRL" button in the top action bar. The enrollment dialog opens
Enrollment Options:
Click on 'Edit Grid', and click on '+Add' to create a new row for creation.
Fill in the instrument's Easting, Northing, Reduce Level, Point X, Point Y, Point Z.
Click on 'Save' to finish the creation.
13. How to Configure Calibration
The Calibration function manages instrument accuracy through regular verification.
NOTE: Calibration setting is only required for certain instrument types, e.g. vibrating wire piezometer.
Select Instruments: Tick to choose one instrument for calibration
Initiate Calibration: Click the "Calibration" button in the top action bar. The calibration dialog opens
Fill in calibration fields as necessary.
Click 'Create' to create calibration record.
14. Best Practices
14.1 Naming Conventions
Use consistent prefixes for instrument types
Include location references in names
Use sequential numbering for similar instruments
Document naming convention in project manual
14.2 Quality Control
Double-check all new instrument entries
Verify imports before confirming
Document all calibration activities
Regular audit of instrument configurations