Skip to content
CADground Documentation
Documentation menu

Formats, units, and preparation

Choose the correct way to upload each file. Check the units and coordinate system before taking measurements.

5 min readUpdated

Point cloud, mesh, or CAD?

RepresentationWhat it containsWhat it means in CADground
Point cloudIndividual XYZ positions, sometimes with color or other attributes.Points you can inspect, select, measure, and use to build geometry. Points do not automatically form walls or solids.
MeshVertices connected by triangles or polygons; sometimes materials and textures.A surface model. A GLB can look more solid than separate points. A mesh is not automatically CAD geometry made from planes, cylinders, or other defined surfaces.
CAD geometryDefined shapes and surfaces, such as planes, cylinders, or imported STEP geometry.Geometry you can check, change with supported tools, and export. Check that its type and detail meet your needs.
Gaussian splatA visual reconstruction using splats, sometimes stored in a PLY container.A PLY extension does not mean the file contains a supported point cloud. Export a point cloud or mesh from the capture tool.
Reference fileA PDF, drawing image, photo, table, or written specification.Information to help the agent. Uploading it does not automatically create or align a 3D scene.

Supported import paths

File typeUse it forHow to open it
PLY, PCD, E57Point-cloud scene input on Free and Pro.Start with these files, or File → Open / convert…. PLY may contain points or a mesh; confirm what the exporter wrote.
GLBA 3D scene with mesh/material data, or a model to place in an existing scene.Open / convert… for source-scene use; Import 3D Model… to add model geometry to the current scene.
LAS, LAZPoint-cloud scene input on Pro.Upload to an eligible Pro project and open/convert. Free projects reject these scene formats.
STEP, STP, STL, OBJ, PLY, GLBImport supported model geometry into an existing scene.File → Import 3D Model…. Confirm model units and placement. Support differs by format; preserve related OBJ material files when needed.
CADground JSONRestore a CADground scene document.File → Import scene JSON…. Use a CADground scene document; other JSON files are not supported by this action.
PDF, images, text, CSVPlans, photographs, requirements, and reports.Upload to Files or use Attach file in Chat, then identify the reference in your request.
RealWorks project files and ZIPPreservation of supported project files on Pro.Storing a file does not convert it or extract its contents. Export a supported point cloud from the original software for analysis.

Direct import/export of native Revit, IFC, DWG, and DXF files is not provided here. Export a supported model from the original application. You can also supply a PDF or image as a labeled reference. A PDF plan is not a BIM model aligned with the scan.

Verify units and scale

  1. Find the source units in the scan/export settings or the survey report. Do not guess from the filename.
  2. CADground uses meters, with Z pointing up. When importing a model, you may need to set its units, scale, and up-axis.
  3. Choose a known distance with clearly visible endpoints. Ask the agent to measure the same endpoints in the scene.
  4. Compare the values after converting units. For example, a real 900 mm opening is 0.9 m; a result near 900 m indicates a scale problem, not a large door.
  5. Correct the import scale before building or comparing geometry. Record the scale and reference dimension you used.

Common scale factors to meters are: millimeters × 0.001; centimeters × 0.01; feet × 0.3048; inches × 0.0254. Use the actual source unit. Do not repeatedly rescale a model until it “looks about right”.

Coordinates, orientation, and north

Scene coordinates do not automatically match survey coordinates. Ask the surveyor which direction is north and which level defines zero height. A heading measured from scene +Y is a local heading. Establish how it relates to true or grid north before reporting it as a surveyed heading.

Large geographic coordinates may need preparation in the capture or point-cloud software. Record any shift, rotation, or change of origin. Keep those details so you can place a later CAD export in the survey coordinate system.

If you rotate a view to make a level floor plan, record that change. Rotating a report image does not move the model in the scene.

Prepare a small, clear file set

  1. Keep the untouched originals outside the working copy.
  2. Name files by location, date, and purpose, for example roof-existing-2026-10.ply and ac-unit-manufacturer-dimensions.pdf.
  3. Remove accidental duplicates from the upload selection. Duplicate names are rejected rather than silently overwritten.
  4. For a first test, choose one area with a known dimension. If the original file is too large, crop or convert a copy in a suitable tool.
  5. Add a short reference note listing units, capture date, orientation, known dimensions, and gaps.

Large files and visual point density

File size, scene detail, browser memory, and network speed all affect loading. The technical upload limit can be 8 GB per file. This is not a storage allowance. A smaller file can still be difficult to view. Follow the limit and error shown in your project.

Large point clouds can load in stages. The number of displayed points depends on the view and level of detail. Fewer displayed points do not mean that source points were deleted. Check the source file information. Ask the agent to measure source coordinates, not distances between pixels on the screen.