Introduction
The Deformation Profiles page allows you to create, view, and edit profiles that define how deformation or displacement images are displayed and measured. Each profile typically contains settings for image dimensions, scaling, canvas size, and reference points—these parameters are crucial for accurate measurements and visualization in Geosens.
To access this page: Click on the top left corner to open the side bar, click on ‘Settings’ - 'Project Info' to access the page.
On this page, several sections are available for configuration:
Deformation Profiles Section: to create a new deformation profile. This function will be introduced in this Manual.
Mark Points Section: to map the monitoring points on each profile. Please refer to Manual - Tunnel Sketch Mark VD/LD Points.
1. Page & Fields Introduction
This section provides introductions on how to set up each field of deformation profiles and the steps to create/edit/delete any existing deformation profiles.
Profile Name
A descriptive title for the profile (e.g., “Tunnel East Wall,” “TV010,” etc.).
Used throughout the system to identify this particular deformation profile.
Profile Code
A unique code or reference for the profile.
Helps with searching and indexing profiles within the system.
Profile Image
The path or name of the reference image used to visualize the deformation.
Often displayed as a thumbnail in the main table.
Fit Canvas (checkbox)
When checked, the system automatically scales the image to fit the canvas dimensions.
Overrides manual settings for image size if enabled.
Is Project? (checkbox)
Indicates whether the profile is associated with a specific project or is a general-purpose profile.
Used for organizational or filtering purposes.
More fields can be dragged and displayed into the table by clicking on the 'Column Chooser 
' button, dragging the fields and dropping them into the table.
projDisplacementProfileId: The unique identifier for the displacement profile of a project.
Prj Image Id: The unique identifier for the project image.
Image Ratio
The aspect ratio or scale factor used when rendering the image.
If left blank or set to 1, the system may automatically calculate the ratio based on width and height.
Image Width
The real-world width of the reference image, typically in millimeters (mm) or another unit.
Used for scaling measurements on the image.
Image Height
The real-world height of the reference image, in the same unit as Image Width.
Ensures accurate vertical scaling.
Image Pixel Width
The width of the reference image in pixels.
Typically extracted from the image file itself or entered manually if known.
Image Pixel Height: The height of the profile image in pixels.
Canvas Width
The width of the “canvas” or display area in which the image will be placed, in pixels.
This determines how the image is rendered on-screen.
Canvas Height
The height of the canvas in pixels.
Must be set to match your desired display area for the image.
Canvas Pixel Width
Used to specify how many pixels in the system correspond to one real-world unit of width on the canvas.
Can be left at default if the system automatically calculates scaling.
Canvas Pixel Height: The height of the canvas in pixels.
Image Top Left Point X / Image Top Left Point Y
The X and Y coordinates for the top-left corner of the image in relation to a reference or origin point on the canvas.
Helps position the image correctly within the canvas.
Rep Image Top Left Point X / Rep Image Top Left Point Y
Additional reference points for a “representative” or overlay image.
Used if multiple images or overlays must align in a consistent position.
Notes
A free-form text field for any additional information, comments, or special instructions regarding the deformation profile.
Updated By / Created By / Date (read-only)
System-generated fields showing who created or last updated the profile and when.
Useful for audit trails and version tracking
2. Create a New Deformation Profile
Click on the '+New' button above the table.
A New Deformation Profile panel will appear on the right side of the screen.
Fill in the fields as needed (see the above section 1 for details on each field).
For the setting of profile image, you can either upload new images by clicking on 'Image File'; or select from existing image by clicking on the 'Existing Image' drop-down list. The existing image list can be configured referring to the instructions on Image Management.
Click Create to add the new profile to the table.
3. Editing an Existing Deformation Profile
In the Deformation Profiles table, locate the row corresponding to the profile you want to edit. Tick to select it.
Click Edit (or the pencil icon) on the top-right corner of the table.
The Edit Deformation Profile panel will open, displaying the current settings for that profile.
Modify the fields as necessary (see section 1 above for field descriptions).
Click Save to confirm your changes.
4. Delete an Existing Deformation Profile
Locate the profile in the table. Tick to select it.
Click the Delete button (or trash icon).
Confirm the deletion in the prompt that appears.
The profile is removed from the table and cannot be used in measurements or analysis.
5. Best Practices
Use clear naming conventions for Profile Name and Code to easily identify the location or type of deformation being tracked.
Keep field units consistent (e.g., if Image Width and Height are in millimeters, ensure all other dimension fields match).
Regularly review and update notes and reference points to ensure accurate alignment, especially if new instruments or new site conditions arise.
Document changes in the Notes field to maintain an audit trail for future reference.
6. Troubleshooting
Images not displaying correctly:
Check Canvas Width/Height vs. Image Width/Height.
Ensure the Fit Canvas checkbox is correctly set.
Incorrect scaling in measurements:
Verify the Image Width and Image Height fields are accurate real-world dimensions.
Re-check the Image Pixel Width if the system relies on pixel-to-real-world conversion.
Coordinates misaligned:
Adjust Image Top Left Point X/Y or Rep Image Top Left Point X/Y.
Make sure the reference origin is correct.
Please refer to Tunnel Sketch Mark VD/LD Points for further configurations on adding profile points and displacement direction arrows on the tunnel sketch image.