Introduction – Map Page Sections
The Maps Page within the Geosens Monitoring System offers users the ability to visualize instrument, station-group, and geotechnical tests data in a geographical context and map view. The page supports instruments / Station-group display filter, map layers and legends display, instrument and station-group alarm status check, control line and tunnelling trackers check, measuring tool, and instrument/Station-group INIT/REV/CALI/DATA check on the map view.
To access this page: Click on the top left corner to open the side bar, click on ‘Map’ tab to access the page.
Table below briefly describes functions and purposes for each section on this page.
Section name | Functions |
Map Canvas | A display window that displays a dynamic map with various layers (roads, terrain, etc.) overlaid with instrument and station data. |
Map Tool Set | Utilize tools to zoom, rescale and reset the map, assisting in navigation and customization of your map view. |
Map Toolbox sidebar | Includes toolbox functions for filtering and viewing of instruments and station-groups, layer and legend adjustment, instrument alarm limit status check, pin or clear pin status for instrument check, control line and tunnelling trackers check, alongside measuring tools, and displaying survey and InSAR data. |
Section 1 - Map Tool Set
The map tool set provides zooming, panning, and other interaction options to navigate the geographic area of interest.
Zoom In / Zoom Out buttons: are located on the top left of the map, to zoom in or out the map view, and there is a Reset View button to reset the map to its original zoom level.
Map Type Selection Button: is in the tool set (usually marked by a layer icon or similar symbol), and this button allows you to change the base map type according to your preference and needs.
Enter Fullscreen Button: located at the top-right corner of the map view, this button expands the map to Fullscreen mode, providing a larger, more detailed view of the selected area.
Section 2 - Map Toolbox Sidebar – Instruments
This section allows users to select one or multiple instruments to be displayed on the map view.
1) Select instrument(s) to be plotted / pinned
Fill in the following fields to select instruments:
Category (Optional): To filter out the instrument if belongs to any category. Example: If looking for instruments installed in the category of 'M2 Tunnel', typing in the search box or click to open the drop-down list and select the corresponding category.
Instrument Type (Optional): To filter out the instruments by specific instrument Types. By typing the instrument type in the search box or click to open the drop-down list and select the corresponding type(s).
Instrument Search Field: To filter out the instruments by typing specific instrument name (Optional). Begin typing the instrument’s name or code. The system will auto-suggest matching instruments. Example: If looking for “M110-2148-M2,” type “M110” to narrow down the list.
NOTE: All instruments filtered by the above Category/Type/Tool Name will appear in the Instrument Search field list. If no filter is applied, the full list of Instruments will be displayed in this list. Click to select certain tools to add them to the Instrument Selection list to further narrow the scope.
Instrument Selection List: Scroll to select one or multiple instrument(s) from the list by ticking the box. The ticked instrument(s) will be selected for displaying. Click on 'cross' button to remove the instrument from the list.
2) Plot the selected Instrument(s)
This function is used to load and visualize the data based on the selected instruments and filters.
Fields Introduction:
From Date-Time and To Date-Time:
The function is sued to filter and plot data by a specific time range. Enter a time period to filter out and plot the data particularly within this time period.
Example: Enter “2025-01-01 08:00” in the “From Date-Time” field and “2025-01-28 17:00” in the “To Date-Time” field to retrieve data for this period.
Last Number of Days:
Automatically calculate the date range based on the specified number of past days. Enter the desired number of days.
Example: Enter “7” to fetch data from the last 7 days.
Last Number of Records:
Specify how many records to retrieve, regardless of date. Enter the desired number of records.
Example: Enter “50” to retrieve the latest 50 records.
Steps to Use:
Use category/type/instrument name filter function to filter out the instrument(s) if needed.
Tick to select one or multiple instrument(s) from the “Instrument Selection List”.
Apply filters using “Date-Time” or “Last Number of Records” to filter out certain range of data if necessary.
Click the Data button and a chart window will display.
Example:
Typing in the instrument search field and select the instrument “APM1-6-M1”
Tick to select the instrument in the instrument selection list.
Set the time range from “2023-01-01 00:00” to “2023-12-31 00:00”
Click on 'Data' to show all relevant readings for this time period.
A charts page will be displayed, the selected instrument will be auto filled into the charts page, and the charts and data table will be displayed automatically. Please refer to Chart for further functions on viewing readings.
3) Pin instrument(s) in map
Pin Alarm Status:
Shows the alarm status of instruments on the map (e.g., instruments exceeding thresholds). If the instrument triggered an alarm, the instrument point will be flashing on the map.
Example: A red pin indicates an instrument in an alarm state, while green indicates normal operation.
Pin Instruments:
Displays selected instruments on the map for easy location and monitoring.
Example: If you selected “OPRMAN-9007” in the instrument list, and click on 'Pin Instrument', a pin will appear at its location on the map.
Pin by Category:
Groups instruments by category and displays them on the map.
Example: Optical Convergence Prisms (CVO) is shown with blue pins, and Inclinometers (DGSI) with yellow pins.
Pin by Type:
Displays instruments grouped by their type.
Example: All “Benchmark Extensometers” may be grouped together under a specific pin type.
Clear Pin Instrument: Removes all instrument pins from the map. Click this option to reset the map view.
Section 3 - Map Toolbox Sidebar – Station-Group
The Station-Group tab allows users to select and view predefined station groups (e.g., Tunnel Convergence or Tunnel Face Convergence groups) on the map. This tab is used for monitoring specific stations within a project, providing spatial context, and analyzing associated instruments.
1) Select station-group to be plotted / pinned
Category: To filter out the station-group if belongs to any category. Example: If looking for station-group installed in the category of 'M2 Tunnel', typing in the search box or click to open the drop-down list and select the corresponding category.
Station Type: To filter out the station-group by specific instrument Type. By typing the station-group type in the search box or click to open the drop-down list and select the corresponding type(s).
Stations (Station-Group Search Field): To filter out the station-group by typing specific station-group name (Optional). Begin typing the station-group’s name or code. The system will auto-suggest matching station-groups. Click on the sketch icon '
' to view the pre-set tunnel sketch image, in order to help with selection.
NOTE: All station groups filtered by the above category/type/station group name will be displayed in the station group search field list. If no filter is applied, the full list of station groups will be displayed. Click to select a station group to add all instruments within that station group to the instrument selection list.
Station Instruments (Station Instrument Selection list): All instruments within the selected station-group will be displayed here. Tick to select one or multiple instrument(s) from the list to plot / pin the data or click on 'cross' button to remove the instrument from the list.
2) Plot the data
The Data function allows users to retrieve and visualize data from selected stations and instruments.
Steps to Use:
Use category/type/station-group name filter function to filter out the station-group if needed.
Tick to select a station-group, and all instruments within the station-group will be displayed into the “Station Instrument Selection List”.
Click the Data button and a chart window will display. It will be able to view the retrieved data in a table or graph or export the data for reporting or further analysis.
Example:
Type and select Station Group “M110-253 (vd) array”. All instruments in this group will be displayed in the Station Instruments list.
Click Data to show all relevant readings in a chart page.
A charts page will be displayed, the selected instruments will be auto filled into the charts page, and the charts and data table will be displayed automatically. Please refer to Chart for further functions on viewing readings.
3) Pin function
Pin Alarm Status:
• Purpose: Highlights stations or instruments in an alarm state on the map.
• Example: If an instrument exceeds threshold limits, a red pin is displayed for immediate attention.
Pin Instruments:
• Purpose: Adds pins to the map for all selected instruments.
• Example: Click to select a station group 'EMP_003 004' in the Stations field, and all the instruments within the group will be displayed in the Station Instruments Field. Tick to select both instruments and click on 'Pin Instruments' to view both instruments on the map.
Pin by Category:
• Purpose: Groups pins on the map by category (e.g., LD-VD Tunnel Convergence).
• Example: All Tunnel Face Convergence instruments are grouped together under a specific map layer.
Clear Pin Instrument:
• Purpose: Removes all pins associated with the selected instruments from the map.
• Example: Use this option to reset the map view after analyzing a station group.
Section 4 - Map Toolbox Sidebar – Toolbox
The Toolbox tab is designed to provide advanced map functionalities for analyzing geotechnical data, monitoring control lines, checking alarm statuses, managing tunneling trackers, customizing instrument displays, and performing measurements on the map.
Overview of each sub-function:
Alarm Indicator: Highlight instruments in alarm states or XYZ Reference lines.
Control Lines: Manage and view control lines with associated chainages.
Tunnelling Trackers: Visualize tunneling trackers and timestamps.
Pin/Un-Pin: Configure how instruments can be pinned on the map and decommissioned instruments to be shown on the map.
Measuring Tool: Measure distances or areas directly on the map.
1) Check Alarm Status on the map
Alarm Status On: Turns on visual indicators for instruments in an alarm state on the map.
Show XYZ Ref. Lines: Displays reference lines (X, Y, Z axes) to assist in spatial analysis.
Example:
• Click Alarm Status On to view red-highlighted pins for instruments exceeding threshold limits.
• Use Show XYZ Ref. Lines to align data points with spatial reference axes.
2) Check control lines
Control Lines with Chainages On/Off: Toggles the visibility of control lines and their chainages on the map.
Control Line Name: Displays the names of control lines.
Chainages: Highlights specific chainage points along control lines.
Example:
• Enable Control Lines with Chainages On/Off to visualize tunnel alignment.
• Check Chainages to locate specific distances (e.g., every 100m) along the tunnel.
• Use Control Line Name to label control lines for easy identification.
3) Check tunnelling trackers
Tunnelling Trackers On/Off: Displays tunneling progress and related data (e.g., excavation status).
Tunnelling Chainage & Timestamp: Shows chainages and timestamps for tunneling activities.
Load: Refreshes and updates tunneling data.
Example:
• Activate Tunnelling Trackers On/Off to monitor current tunneling progress.
• Check Tunnelling Chainage & Timestamp to display excavation milestones and their completion times.
• Use Load after selecting options to ensure the latest data is displayed.
4) Instrument display settings
Clear Instrument Pins: Removes all instrument markers from the map.
Re-Pin Instruments: Re-adds all selected instruments to the map.
Show Instrument Names: Displays the names of instruments on the map.
Show Decommissioned Instruments: Shows instruments that are no longer active.
Example:
• Click Clear Instrument Pins to reset the map view.
• Use Re-Pin Instruments to re-add previously cleared instruments.
• Enable Show Instrument Names to see labels for each instrument.
• Check Show Decommissioned Instruments to analyze legacy instruments for historical comparisons.
5) Measuring tool
• Show Measure: Activates the measurement tool, allowing users to draw lines or areas for measurement.
• Hide Measure: Deactivates the measurement tool and clears the map of any measurement overlays.
Example:
• Click Show Measure to measure the distance between two tunnel sections or the area of a specific site.
• Use Hide Measure once the analysis is complete to return to a clean map view.
Section 5 - Map Toolbox Sidebar – Layers
The layer tab in the GIS tool is used for managing and visualizing different layers of geographic data. Here's a brief introduction and explanation of its functions:
The layer tab is designed to help users manage various data layers that can be overlaid on a map. Each layer represents different types of geographic or design data, such as street maps and topographic maps. The purpose of this tab is to allow users to toggle the visibility of these layers, customize their display, and analyze spatial relationships between different data sets.
Layer Information: Click to show Layer ID, map extent, etc.
Opacity: Adjust layer transparency.
Layer Visibility Function: click to show/hide the layer.
Section 6 - Map Toolbox Page – Legend
The Legend tab in the Map Toolbox is designed to help users visualize different types of geotechnical instruments used for monitoring ground movements, structural stability, and other geotechnical parameters.
This tab allows users to toggle the visibility of various instruments on the map, providing a clear and organized way to interpret the data collected from these instruments.
Potential application scenario could be: toggle off all the instrument types but only toggle on one specific instrument type, in order to quickly locate and view this specific instrument type only.
Each button in the Legend tab represents a different type of instrument. By using the toggling button, the instrument type icon can be displayed/hidden.
Section 7 - Map Toolbox Page – Data Tools
This section provides tools to access and view InSAR data on the map.
1) Key Functions and How to Use
Show InSAR Map Tools: click to show the InSAR Map Tools on the map. Please zoom in to show the full set of tools. Those tools can be used to select certain InSAR points for further viewing purpose. The detailed instructions are displayed in the following section of Use InSAR Toolbar to select interest InSAR point or survey point.
Using Polyline: Draw a straight line and input buffer zone to select points.
Using Polygon: Define a custom-shaped area for selection.
Using Rectangular Tool: Draw a rectangular selection area.
Using Circle: Draw a circular selection area.
Color Ramp: The color ramp (contour) to display a certain range of data. From the Color Ramp dropdown menu, choose the desired color ramp for visualizing the data. Different color ramps can be configured in the ‘Setting – InSAR – Resolution Color Ramps’ Page.
Monitoring Period: The time period when the data is recorded. Select the relevant monitoring period from the InSAR Monitoring Period dropdown menu.
Data Point: Choose the type of data to display (e.g., displacement) from the Data Point dropdown menu.
Load the Data: Click Load Data to visualize the selected data set on the map. Use the Clear button to reset the display.
Example of configuring and displaying InSAR data:
For example, after selecting the color ramp, monitoring period, and data point, the InSAR displacement points are displayed on the map below, based on the selected color ramp. In this way, users are able to view the InSAR points in a large area, and overview the displacements status in this area, for example.
2) Use InSAR Toolbar to select interest InSAR point or survey point
The interest InSAR Point or survey point on the map can be selected by using the selection toolbar for further viewing purpose.
Option 1: Select Using Polyline
Draw a straight line and input buffer zone to select points.
The panel below the selection tools displays the number of selected InSAR Data Points and Survey Points.
Straight Line: The length of this polyline
Buffer RIGHT / LEFT: Specify buffer distances on the Right and Left of the line to include areas adjacent to the line.
Track Cells Builder (From Zero Position): Optional choose among Average / Maximum / Minimum.
NOTE: The purpose of the track cell: To use only one data point (which has the Average / Maximum / Minimum value) to represent all other points inside the cell.
Length along the Track Line – Interval: To set up the interval for selection cell.
NOTE: If no other different cells are specified in ‘Length along the Track Lines’, the interval here will be set as the length of the selection cell.
Length along the Track Lines: Click ‘+’ to add track cells and define their lengths in the numeric box. Each cell separates data for specific areas, such as a building in one cell and construction in another, allowing for independent data plotting.
Option 2: Select Using Free Form
Define a custom-shaped area for selection.
The panel below the selection tools displays the number of selected InSAR Data Points and Survey Points.
Radius (optional): Set a red selection circle with certain radius, automatically selecting all InSAR and survey points inside the circle or inside the free form selection area.
InSAR monitoring points must be inside the selected Area: Tick this box to auto-select InSAR point that is in the intersection area of circle and free form selection area.
Click Plot Chart to visualize the aggregated data.
Hit ‘bin’ icon to delete this selection area, if needed.
Option 3: Select Using Rectangular Tool
Draw a rectangular selection area.
The panel below the selection tools displays the number of selected InSAR Data Points and Survey Points.
Radius (optional): Set a red selection circle with certain radius, automatically selecting all InSAR and survey points inside the circle or inside the rectangular selection area.
InSAR monitoring points must be inside the selected Area: Tick this box to auto-select InSAR point that is in the intersection area of circle and rectangular selection area.
Click Plot Chart to visualize the aggregated data.
Hit ‘bin’ icon to delete this selection area, if needed.
Option 4: Select Using Circle
Draw a circular selection area.
The panel below the selection tools displays the number of selected InSAR Data Points and Survey Points.
Radius (optional): Set a red selection circle with certain radius, automatically selecting all InSAR and survey points inside the new circle or inside the original circle selection area.
InSAR monitoring points must be inside the selected Area: Tick this box to auto-select InSAR point that is in the intersection area of new circle and original circle selection area.
Click Plot Chart to visualize the aggregated data.
Hit ‘bin’ icon to delete this selection area, if needed.
3) Plot Chart Function
After selected interest InSAR and/or survey point in above section of Use InSAR Toolbar to select interest InSAR point or survey point, click on ‘Plot Chart’ to plot all the data into graph.
Function descriptions and steps are shown below.
Survey data type: Type of selected survey points. This field is pre-filled by the system.
Survey data name: name of selected survey points. This field is pre-filled by the system.
InSAR data name: name of selected InSAR points. This field is pre-filled by the system.
Plot Type: select a data type to be plotted. Use the dropdown menu to select the desired data type, such as Displacement.
Aggregation: select a data aggregation to be plotted. Use the dropdown menu to select the desired aggregation type, such as average data.
Time Period: select a time period of data to be plotted.
Click ‘Plot’ button, and a graph will be plotted on the same page.
Series & Aggregation: Allows you to move curves for better comparison. Enter a value in millimetres (mm) or hours (hrs) to shift the curve, aligning it with others for clearer analysis.
Example: select the blue curve of InSAR named 'ADGK59V' and enter +10mm to be moved. The blue curve in the below image will be moved up by 10mm for better viewing purpose.
Section 8 - Map Toolbox Page – Geotechnical Test
This section will be integrated into geotechnical digital data collection.
