Skip to main content
Skip table of contents

Guided Workflow | Aligning Point Cloud in CloudWorx for Revit

This guide details the workflow for adjusting a point cloud imported into CloudWorx for Revit at an incorrect angle.

This misalignment can occur, for instance, when a point cloud lacks a defined coordinate system set beforehand in legacy software or when a drafter is unaware of the data source. Therefore, it is essential to orient the coordinate system of the imported point cloud in the correct direction and ensure it aligns parallel with one of the main axes, which is typically preferred for modelling purposes.

Importing Project Data

  1. Import a dataset using an appropriate import option. Refer to the Connect To Help section for more details.

In this workflow, a dataset is saved as the LGSx file, which is then imported as follows:

1.1. In the Project panel, click Open LGS File and browse to the required file.

1.2. In the Coordinate Systems in Point Source field, select Pre-Registered.

Tip: Always review the available coordinate systems in the project, as one of them may have the correct orientation.

1.3. Click OK.

image-20250603-120740.png

As a result, the dataset has been imported; however, it is not aligned properly.

image-20250603-120448.png

Adjusting Levels and Coordinate System Points

When starting a new project in Revit, it’s essential to set a coordinate system in the correct direction. To ensure accurate model positioning, you need to adjust levels so that they align with the elevations of the imported point cloud and place the project base point and the survey point.

Creating Slice

  1. Create a slice to temporarily hide unnecessary points:

2.1. In the Clipping panel, click the Slice drop-down list and select the axis to which the view should be aligned.

2.2. Define two points for the slice planes’ location.

Recording 2025-06-03 at 15.52.20.gif

Moving Levels in Elevations

Adjusting levels in Revit is essential for the accurate visualisation of the CAD geometry at the correct elevations in the 3D view. While levels can be established using the CloudWorx Set Level command, the method described below can help to average out the floor across a large area, particularly when dealing with uneven floors.

  1. In Revit’s Project Browser, navigate to Elevations and select the desired elevation view. In this case, it’s North.

image-20250624-075716.png

3.1. Drag Level 1 to match the floor.

3.2. Drag Level 2 to match the ceiling.

Aligning levels_Updated.gif
  1. Go to CloudWorx | Rendering and click Regenerate Points to ensure all changes are reflected correctly.

Placing Project Base and Survey Points

  1. In the View Control Bar at the bottom of the Revit window, click the Reveal Hidden Elements icon image-20250603-153610.png to unhide the project base and survey points.

  2. Move the project base point to define the 0, 0, 0 origin of the project.

  3. Move the survey point to define the real-world coordinates of the project as follows:

7.1. Uncheck the paperclip before moving the survey point.

7.2. Adjust the position of the survey point. Since the project in this workflow lacks real-world coordinates, the survey point is moved to the same location as the project base point.

7.3. Recheck the paperclip after the move.

  1. Сlick image-20250603-160433.png again to exit the Reveal Hidden Elements mode.

Adjusting Survey point_Updated.gif

Disabling Active Clipping

  1. Go back to the 3D view.

  2. Open the Clipping Manager and disable the clipping used to adjust the coordinate system parameters. The whole point cloud will now be visible again.

image-20250603-161019.png

Aligning Point Cloud

Creating CAD Geometry

Before aligning a point cloud, you need to create a CAD object to which the point cloud should be adjusted. Since we are using an apartment model in this workflow, we will create CAD geometry as follows:

  1. Navigate to Revit’s Architecture tab, select the Wall tool and draw a wall.

Tip: Press and hold the Shift key while creating a wall to make it perfectly aligned with the selected axis.

Constructing wall_updated.gif
  1. Go to the Structure tab and create a foundation plane. In this case, select Slab and draw a rectangle defining a floor boundary.

Slab_Updated.gif

Matching Point Cloud with CAD Object

One of the most efficient methods for aligning a point cloud with a CAD object is through auto-alignment. While manual alignment is also an option, it requires an understanding of the distances between the point cloud and the objects that need adjustment, which can be a complex task. In this workflow, the auto-alignment by three planes will be demonstrated.

  1. Switch back to CloudWorx.

  2. Navigate to the Tools panel and select Auto Align.

  3. In the Align to model automatically dialog, take the following steps:

15.1. Select the Freeze X (East) and Freeze Y (North) check boxes to ensure the point cloud only rotates around the Z-axis and does not tilt.

15.2. Select the Align by 3 planes option.

image-20250624-111843.png
  1. Select three cloud points to grow three planes by which the point cloud should be aligned with the model.

  2. Select three points on the CAD model planes to match them with the selected point cloud planes.

Once done, the point cloud will be automatically aligned with the model.

Fine-Tuning Point Cloud Alignment

After the automatic alignment, you may notice that some structures are not built at perfectly right angles. To achieve a more accurate alignment, you may need to make additional adjustments or carefully reselect planar surfaces.

In this case, the rotation tool will be beneficial for fine-tuning.

  1. Switch to the TOP view to check for any alignment inaccuracies.

image-20250624-112939.png
  1. Go to Tools | Auto Align.

  2. In the Align to model automatically dialog, select Rotate point cloud.

image-20250624-092356.png
  1. Pick a corner point - rotation center, pick the rotation start point, and then pick the rotation end point. The adjustment will occur automatically.

Tip: Always check the bar at the lower-left corner of the Revit window for real-time instructions while using the tool.

Recording 2025-06-24 at 14.44.01.gif
  1. To better visualise the result:

22.1. In the Rendering panel, click Point Visibility to turn off the visibility of points.

22.2. Select the created CAD objects and delete them.

22.3. Click Point Visibility again to turn on the visibility of points.

image-20250605-084936.png

The point cloud is now correctly aligned with the axes.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.