1. Introduction
The Control Lines - Chainages page allows the project users to setup Control Lines and respective Chainage locations, easting, northing and level, to show on the GIS Map and used for other purposes, e.g. Zone Reporting Services, which have Zones following the Control Lines.
Navigate to Project Items and Elements and then click on Control Line Chainage.
2. Control Lines Grid Overview
The main grid lists all defined control lines across sites. You can customize columns, import or export definitions, and perform CRUD operations.
2.1 Toolbar Actions
Tool buttons | Buttons | Description |
Edit Grid | Click to change to the In-Cell editing mode. Edit the control line data in the grid. | |
Column Chooser | Click to open the Column Chooser dialog to bring out the Column to the data grid, or drag the Column from the data grid to the Column Chooser to hide it. | |
Import | Import bulk control line data from a .csv file | |
Export | Export control line data to a .csv file | |
New | Open up the data form to create a new control line dataset | |
Add | Create a new control line record in the data grid. | |
Edit | Modify the selected control line via the data Form. | |
Delete | Remove the selected control line records. | |
Create Filter | Create custom filters. See the screenshot below |
Column Chooser
Create Filters - Advanced Filter Builder
2.2 Column Definitions
Column Name | Description |
Control Line Abbreviation | Short code for the control line (e.g., M1B). |
Control Line Name | Descriptive name of the control line. |
Site | Project site or area associated with the control line. |
Enabled | Toggle indicating if the control line is active. |
Updated By | Username of the last modifier. |
Updated On | Timestamp of the last update. |
2.3 Control Line Data Form
The project user can click on the New button to open the Control Line Data Form while the Editing form can be open by selecting a record and clicking on the Edit button.
3. Control Line - Chainages Data Form Panel
Click a control line row (e.g., M1B) to show its Chainages data grid. Manage the chainage points that define the line’s geometry and appearance.
3.1 Chainages Data Grid Toolbar
Tool buttons | Buttons | Description |
Edit Grid | Toggle between View and Edit Grid modes Click to change to the In-Cell editing mode. Edit the Chainage data in the grid. | |
Import | Import bulk Chainage data from a .csv file | |
Export All | Export all the Chainage data to a .csv file | |
New | Open up the data form to create a new Chainage dataset | |
Add | Create a new Chainage record in the data grid. | |
Edit | Modify the selected Chainage record via the data Form. | |
Settings | Access advanced styling or metadata options. | |
Delete | Remove the selected Chainage records. | |
Create Filter | Create custom filters. See the screenshot below |
3.2 Editing Chainage Data Form
Chainage: Start Chainage number
Chainage 2: End Chainage number
Category: What Site/category does this Control Line - Chainage belong to.
Line Type: choose a line type (see below)
Color: Line color
Width: Line thickness in display units (e.g., 1) in the 2D dimension.
Diameter: Diameter of the chainage line in the 3D dimension, if used. | |
To specify locations of the Start and End Chainages using the project coordinate system. | |
Web Mercator (EPSG:3857) This is a projected coordinate system that transforms the curved surface of the Earth into a flat plane, which is necessary for displaying maps on computer screens and mobile devices. It's a variation of the Mercator projection.
WGS 84 (EPSG:4326) This is a geographic coordinate system that uses latitude and longitude to define locations on the Earth's surface. It's a common standard for GPS and other location-based services. | |
Direction Reversed: to reverse the line direction from End to Start Ch points.
Buffer Space: Buffer between 2 Chainage lines, which form a part of Control Line.
Disabled: to enable/disable this Chainage record. |
Line Types
In the Chainage data grid toolbar, click on Settings (⚙️) to open Chainage Settings data form.
This configures default rules and styling for all chainages within the selected control line.
3.3 Chainage Setting (⚙️) Data Form
Chainage Setting (⚙️) Data Fields
Field | Description |
Category | Assign a site/category this Chainages set belongs to |
Interval Unit | Unit of Intervals (e.g., Meter). |
Interval | Numeric value for spacing between chainage line and Control Line. |
Line Type | Line styles (e.g., Solid, Long Dash) for Chainage Lines |
Left Cover | Offset distance to the Left of the control line, in meters. |
Right Cover | Offset distance to the Right of the control line, in meters. |
Left Color | Color of the Chainage Line on the Left side (click Change to pick). |
Right Color | Color of the Chainage Line on the Right side (click Change to pick). |
Width | Line thickness in display units (e.g., 1) in the 2D dimension. |
Diameter | Diameter of the chainage line in the 3D dimension, if used. |
Joint Control Line | Toggle to whether join chainage line with adjacent control line together or not. |
Buffer With Control Line | Buffer space between the chainage line and the control line, in meters. |
Set As Default | Checkbox to apply these settings as the default for new chainage records. |
Disabled | Tick the checkbox to deactivate custom CL - Chainage line property for this line. |
Chainage Properties of the Control Line
4. Viewing Control Lines - Chainages on the GIS Map
The project users can view Control Line - Chainages on the GIS map in either the Control Line - Chainages page or the GIS Map page.
4.1 The Control Line - Chainages page
Control Line - Chainages can be setup and viewed in the Control Line - Chainages page. This section is to describe the map tools to view Control lines and Chainages.
The GIS Map section
See the screenshots below. The first icon is the project basemap and ESRI basemap layers. The project user can select to use any of these basemap layers.
See the screenshots below. The second icon is the GIS map layers setup in this project, which also include some basic layers, like Instruments, Instrument Names, Control Line Names, Control Line Chainages, etc..
The project user can toggle these map layers on or off by clicking on the Eye icon..
See the screenshot below. In this case, Layers of Instruments and Instrument Names have been turned off.
The project user can select a Control Line to show it on the GIS map
The project user can toggle Control Line Names to turn on/off CL Names.
The project user can toggle Control Line Names to turn on/off Chainage Lines, if the Chainage Settings (⚙️) are configured.
Those circle, oval and arrows are showing what it looks between Chainage Lines Joint Control Lines and there is a space buffer.
4.2 The GIS Map page
Control Line - Chainages setup in the project can be viewed in the GIS Map page. This section describes how to view it.
Toolbox in the GIS Map page
Click on the Control Lines dropdown list to Search and/or Select one or multiple Control Lines setup in the Control Line - Chainages page
Select one or multiple Control Lines to show on the GIS Map.
[ ] Control Lines with Chainages On/Off: to toggle on/off Control Lines with Chainages layers
[ ] Control Line Names: to show Control Line Names
[ ] Chainages: to show Chainage Lines, if it is configured.
5. Common Workflows
Create a New Control Line
Click New in the main grid.
Enter Abbreviation, Name, Site, and Enabled status.
Click Save.
Add Chainage dataset to the Control Line
Select a control line; click New in the Chainages data grid.
Define Chainage, coordinates, styling; click Save.
Bulk Import from the template file is also supported.
Configure Chainage style property
Select a Chainage record and click on the Settings (⚙️) to create/update its style property
Edit existing Control Lines / Chainages records
Select a row; click Edit.
Update fields; click Save.
Bulk Import Definitions
Click Import; download and populate the template.
Upload to import multiple lines/chainages.
Export
Use Export or Export All to download data of Control Lines and Chainages.
Filter and Locate Records
Click Create Filter; set conditions (e.g., Site = “XPM06”, Enabled = true); click Apply.
6. Example: Defining a Simple Control Line
Main Grid Entry
Field | Sample Value |
Abbreviation | M1B |
Name | Main Tunnel Baseline |
Site | XPM06 |
Enabled | ✔ |
Chainage Points
Chainage | Line Type | Line Color | Width | Easting | Northing | Direction Reversed |
0 | Solid | Blue | 2 | 328611.6059 | 6240334.8892 |
|
20 | Long Dash | Black | 2 | 328740.5934 | 6240389.8283 | ✔ |
7. Additional Tips and Next Steps
Use consistent abbreviations and naming conventions to simplify data recognition.
Verify coordinate accuracy after each survey or georeferencing update.
Leverage Settings in the chainage grid for custom metadata or styling.
Combine exported control lines with GIS platforms for advanced spatial analysis.
Document manual edits in project logs to maintain clear audit trails.