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. |
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.
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.
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.
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.
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.
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.