The XYZ Reference Lines interface integrates a map-based visualization with a data grid to facilitate the creation, management, and organization of project reference lines. These lines represent key geotechnical project data, such as alignment, location, and attributes. The tool also offers advanced options like filtering, editing, and importing/exporting data, providing users with flexibility and control.

To access this page: Click on the top left corner to open the side bar, click on ‘Settings’ - 'Project Items and Elements' - 'XYZ Reference Lines' to access the page.

The XYZ Reference Lines interface is divided into the following sections: Map Interface and Reference Lines Data Grid.

The purpose of this map visualization section is to displays the reference lines and associated markers on a geospatial map. It includes interactive tools for selecting and editing reference lines directly on the map. The basic zooming and basemap functions can be introduced as below:

Lists detailed attributes of each reference line in a tabular format.

Bring up more column data by clicking on the column chooser ‘’ at the top right corner, click on the data column you want to view, and drag it to the current category table to add it in and view the information.

The function of each field:

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

Filtering for any specific info by clicking on the filter icon ‘’ right next to the column names. Search and click on the desired categories to filter and display those categories only, for better viewing purpose.

Located at the top of the interface, providing quick access to tools like:

Edit multiple fields in the data grid simultaneously. Click on ‘Edit Grid’, and click on the cells to make any necessary changes, and click on ‘Save’ to save all the changes, or click on ‘Cancel’ to undo changes.

Import reference line data.

Export and download the current reference line data for offline use.

Manage individual reference lines by adding new / editing existing / delete existing reference lines.

If prefer, users can create a ref line by drawing a line on the map view. In this way, users can define the location of new ref line by taking the existing streets/other ref lines/instruments as reference. The detailed steps are as follows:

Step 1: Click on the polyline function in the toolbox bar. Click and drag to draw a line on the map view to create a reference line. You are able to drag the end points at both sides to adjust the location.

Step 2: Click on ‘Commit Ref Line’ to create and save the new ref line.

Step 3: A new row will appear in the data grid. Please fill in all the available fields to configure this ref line that is just created. Please note, Easting and Northing coordinates have been auto captured from the map view, but you are able to change the coordinates and further adjust the ref line location.

Step 4: After configuration, click on ‘Save’ to save all the changes and finish the ref line creation.

If prefer, users can create a ref line by entering exact coordinates in the data grid. This method is suitable if Easting and Northing coordinates are known. The detailed steps are as follows:

Step 1: Click the ‘Add’ button on the toolbar.

Step 2: Fill in the required fields in the new row of data grid.

Step 3: Click ‘Save’ to add the reference line. A new reference line will appear on the map view according to the input coordinates and other configured settings.

The existing ref line can be selected and changed by selecting on the map (if it is easier to select directly on map) or by selecting in the data grid (if the name is known for filtering), to make changes for the purpose of changing the coordinates, line color, line type, etc.

If prefer, users can use the selection tool (‘Select feature’ or ‘Select by rectangle’) in the toolbox bar or simply click on the map to choose an existing reference line to be changed. In this way, users can easily locate an existing ref line in the map view, for the purpose of changing the location of existing ref line by taking the existing streets/other ref lines/instruments/etc as reference; and for the purpose of changing other settings (line color, line type, line width, etc) if necessary. The detailed steps are as follows:

Step 1: Use the ‘Select feature’ tool / ‘select by rectangle’ tool / directly click on the map to select an existing reference line.

Step 2: Drag and move the end points to adjust the location of the ref line if necessary and if it is easier to change on the map, taken the satellite map view (streets, Instruments, other ref lines) as reference.

Step 3: Click ‘Commit Ref Line’ to save the changes on the map. The new coordinates will be auto updated in the data grid accordingly.

Step 4: Click again on the existing ref line, if other settings need to be changed. The selected ref line will be ticked and highlighted in the reference line data grid in ‘Edit Mode’. Click on the cell to make changes if necessary.

Step 5: Click on ‘Save’ to save all the changes made in the data grid.

If prefer, users can select an existing reference line by filtering the name in the data grid, if the name is known. In this way, users can easily locate an existing ref line if the name is known, for the purpose of changing the location of existing ref line by entering exact coordinates; or for the purpose of changing other settings (line color, line type, line width, etc) when the ref line name is known rather than its location on the map. The detailed steps are as follows:

Step 1: Use the filter function in the ‘Name’ column header, enter the ref line name to filter out and select the targeted existing ref line.

Step 2: Click on ‘Edit Grid' to enter the ‘Edit Mode’ / or click on ‘Edit’ to open the setting dialog, and then click on the cells to make any necessary changes of the selected ref line. (e.g. changing the coordinates by entering exact values; change the line type by selecting from the drop-down list in the line type column; etc)

Step 3: Click on ‘Save’ to save all the changes.

Users can delete a reference line by two options: either deleting the Ref Line on the map (if the Location is easier to find) or deleting it from the data grid (if the Ref Line name is known).

Users are able to delete an existing ref line by selecting and deleting on the map, if it is easier to find the location.

Step 1: Use the ‘Select feature’ tool / ‘select by rectangle’ tool / directly click on the map to select an existing reference line.

Step 2: Click Delete and confirm the action. Please delete with caution, as deleted lines cannot be recovered.

Users are able to delete an existing ref line if the name is known and it is easier to locate via name.

Step 1: Use filter function to search the name of the existing ref line if the name is known.

Step 2: Tick to Select the reference line from the data grid. The map will auto zoom-in to display the selected ref line, and please check and confirm it is the correct ref line to be targeted.

Step 3: Click ‘Delete’ and confirm the action. Please delete with caution, as deleted lines cannot be recovered.

The Reference Line is a reference object used when Geosens is calculating the settlement/displacements of the survey point. The XYZ Reference Lines Page works as a management centre for all XYZ Reference Lines that are referencing for all instruments survey points. The steps to set up a reference line for an instrument are shown below:

Step 1: On the XYZ Reference Lines Page, select the reference line you want to apply to the certain instrument (you may adjust the layer displaying setting, or turn on the instrument names to locate the corresponding instruments and the relevant reference line), and Copy the Name of the Reference Line.

Step 2: Navigate to ‘Setting – Instrument – Instrument’ Page. Use the filters function at the top of the page and type the instrument name that you want to configure the reference line for in the search box. Tick to select the instrument in the selection box, and click on the Load button next to the selection box.

Step 3: On the same page of ‘Setting – Instrument – Instrument’, at the ‘Instruments INIT’ section, click to open Column Chooser, and drag the Ref.Code to the data grid to display the code of the reference line.

Step 4: Copy the Name of the Reference Line directly to the ‘Instruments INIT’ section – Ref.Code column, and then click on ‘Save’ to save the changes. By adding the ref code, the selected instrument will take this line as the reference line for calculating the settlement/displacements of the survey point.