EdgeWise Ducting Guide
EdgeWise Ducting Guide
DISCLAIMER ........................................................................................................................................................... 4
CONVERT ............................................................................................................................................................... 6
SMARTSHEET ..............................................................................................................................................................15
Edit and Multi-Edit ..............................................................................................................................................15
Resize ..................................................................................................................................................................15
2D VIEWPORT.............................................................................................................................................................16
Navigate ..............................................................................................................................................................16
Move Cross-Section .............................................................................................................................................16
Rotate Cross-Section ...........................................................................................................................................16
Resize Cross-Section ............................................................................................................................................16
Page | 2
SAVING AND EXPORTING MODELS ...................................................................................................................... 17
SAVING ......................................................................................................................................................................17
EXPORTING .................................................................................................................................................................17
Smart Points ........................................................................................................................................................17
Remainder Cloud .................................................................................................................................................17
STEP Format ........................................................................................................................................................18
EXPORTING TO REVIT ....................................................................................................................................................18
Table of Figures
Figure 1: Open Blank Duct Model ................................................................................................................. 7
Figure 2: Deleting a Model ............................................................................................................................ 7
Figure 3: Select a model in the Model Selection Pane to activate it ............................................................ 8
Figure 4: Select the standard, and size, if desired, prior to duct extraction ................................................. 9
Figure 5: Extracting a duct using a close fitting extraction region (left) and a loose fit extraction region
(right) .......................................................................................................................................................... 10
Figure 6: Example of a selected duct (green) ............................................................................................. 11
Figure 7: The three different Extend modes represented: Center (Left) Short (Middle) or Long (Right) .. 13
Figure 8: The SmartSheet and 2D viewport ................................................................................................ 15
Figure 9: Saving and Exporting Duct Models .............................................................................................. 17
Page | 3
Disclaimer
Trimble is disclosing to you the user, this document (hereinafter “the Design”) describing the EdgeWise
software application and its use. Except as stated herein, none of the Design may be copied,
reproduced, distributed, republished, downloaded, displayed, posted, or transmitted in any form or by
any means including, but not limited to, electronic, mechanical, photocopying, recording, or otherwise,
without the prior written consent of Trimble. Any unauthorized use of the Design may violate copyright
laws, trademark laws, the laws of privacy and publicity, and communications regulations and statutes.
Trimble does not assume any liability arising out of the application or use of the Design; nor does
Trimble convey any license under its patents, copyrights, or any rights of others. You, the user, are
responsible for obtaining any rights you may require for your use or implementation of the Design.
Trimble reserves the right to make changes, at any time to the Design as deemed desirable in the sole
discretion of Trimble. Trimble assumes no obligation to correct any errors contained herein or to advise
you of any correction if such be made. Trimble will not assume any liability for the accuracy or
correctness of any engineering, technical support, or assistance provided to you in connection with the
Design.
Copyright © 2006-2019 ClearEdge3D, Inc. All rights reserved under the copyright laws of the United
States. The EdgeWise software, as well as the Design, constitute the proprietary, confidential
information of ClearEdge3D, Inc., and may not be disclosed or duplicated without the written
authorization of ClearEdge3D, Inc.
COMMERCIAL COMPUTER SOFTWARE: ALL USE GOVERNED BY THE TERMS OF PRODUCT END USER
LICENSE AGREEMENT.
Page | 4
Supported File Types
• FARO Laser Scan (.fls)
• Leica (.ptg)
• Smart Point Cloud (.ptx)
• Z+F (.zfs, .zfprj)
• E57 (.e57)
• Simple Point Cloud (.pts or .xyz)
• Dot Product (.dp)
• Trimble (.tzf)
• Gexcel (.rgp)
• Recap (.RCP)
1. Create a new point cloud database using the “Process Scans” button.
2. Open the processed point cloud database file.
3. Open an existing duct model or add a blank Duct Model to the scene.
4. Use the “Extract” button to manually extract straight duct segments in the scene.
5. Analyze the extracted ducts for accuracy using the SmartSheet and 2D ViewPort.
6. Snap, connect, resize, extend, and rotate extracted ducts to create a cohesive duct model.
7. Save the duct models to .c3duct format.
8. Export to Leica COE or to Revit.
The following chapters detail all of the tools required to do the set of steps listed above.
Page | 5
Convert
The Convert menu contains tools that enable the conversion or splitting of scan data. At this time, these
tools are not required components of the EdgeWise workflow, and should only be used if their effects
are desirable (for example, if only a subset of the scans in the file need to be processed).
Split PTX
The Split PTX tool will split multi-scan PTX files in to individual .PTX files for each scan.
E57 to PTX
E57 to PTX, as the name implies, will convert and split an .e57 file to individual .PTX files for
each scan in the original .e57 file.
While the names Split PTX and E57 to PTX may imply it, they do not delete the original file, and instead
create a split copy of it. If the input file is 10gb, the split files will also be 10gb in total. Please ensure you
have enough free hard drive space to complete the conversion, as scan files tend to be quite large.
Reminder: Split PTX and E57 to PTX are not required to Automatically Extract data from .PTX and .e57
scans in Process Scans.
Process Scans
Before EdgeWise can display a point cloud, you must first convert your scans to a .c3DB point database
model. To process your scans, first click the “Process Scans” button located under the File tab. Upon
clicking the “Process Scans” button, you will be prompted to choose the scan(s) you wish to process.
You can only load one .c3DB file into EdgeWise at a time, so we recommend processing all scans from
your entire project at the same time to create one .c3DB file, particularly when creating a point
database model; however, this is not required. Once you have chosen the scan(s) you wish to process,
you will be asked to choose which kind of models you would like to extract from the scans: point
database, ground surface, pipes, and planes. Note: To create a Duct Model, only a point cloud database
file is required.
IMPORTANT: The EdgeWise Ducting module (version 4.5.6 and later) is incompatible with.c3DB files
created by older versions of EdgeWise (older than version 4.5). Older .c3DB files must first be rebuilt
using this latest version of the software.
Page | 6
Creating a Duct Model
Open an Existing Model
Once you have processed your scan data, you are ready to add models the scene. To add a model to the
scene, simply click the “Open Model” button located under the File tab on the ribbon bar, and choose
the model you wish to open. Point databases(.c3DB), ground(.c3gm), pipe(.c3m), duct(.c3duct),
building(.c3bldg) , and structural(.c3struct) models. A Point Database (.c3DB) file is required in order to
extract ducting within a Duct Model.
Deleting a Model
To remove a model from the scene, simply select the desired model from the Model Selection Pane, and
click the “Delete Model” button located under the File tab on the ribbon bar (Figure 2). Alternatively,
you can right-click on the layer name in the Model Selection Pane, and select “Delete Layer.”
Page | 7
Using Standards
All duct elements in EdgeWise are based on standards. You must choose the standard you wish to use
before extracting any element, and then EdgeWise will create ducts that conform to that standard.
EdgeWise comes with several common standards, but you can create your own if you need to. Simply
export an existing standard to a .csv (spreadsheet) file, and use this as a template to create your own
standard. Once you have filled in the dimensional information for your custom standard, save the .csv
file to the C:\Users\MyName\Documents\Trimble\Structure\Standards folder. When creating your own
custom standards:
• The first row must be a header row, and it must be identical to that exported as your template
• The first column must contain the word “Rectangular”.
• The appropriate columns for each shape must contain values; the others must be blank. Use
one of the ClearEdge-provided standards as a template for knowing which columns are
required.
• Your final file name must be in the following format: X.Y.csv, where:
o X is the name of your standard
o Y is the type of standard (choose from “ducting”, “steel”, “concrete”, or “wood)
▪ Standard types are case sensitive.
• After saving your file to the C:\Users\MyName\Documents\Trimble\Structure\Standards folder,
restart EdgeWise. Your new standard should show up at the bottom of the Standards drop-
down.
Extract Ducts
To extract ducts within a Duct Model, first make sure that the Duct Model is selected and is active in the
Model Selection Pane and that a point cloud database file associated with the model has been loaded
into the scene (Figure 3).
Page | 8
From the respective drop-down menus located in the Tools area of the Model tab (Figure 4), select the
standard, type (always rectangular for ducting), and size (Autofit, etc.) of the duct to be extracted. The
Autofit feature will automatically select the closest standard size associated with the extracted duct.
Figure 4: Select the standard, and size, if desired, prior to duct extraction
Next, press the “Extract” button located to the right of the above drop-down lists, and then click in the
scene to outline the appropriate piece of duct to extract. Note the following tips for better results:
• Extract sections that are free and clear of touching surfaces.
• Find connections and transitions as reference locations, and then extract the straight ducts
between these connections. The “Transition” and “Elbow” tools will be used later in the
workflow to make connections automatically between the straight ducts (see “Extend
• To extend one duct to meet another, perform the following steps:
1. Select the ducts you want to extend.
2. Click Extend (Hotkey: C)
3. Click the surface of another duct to indicate how far you wish to extend the selected ducts. This
surface will be referred to as the Target Surface.
The way Extend behaves when the selected duct meets the Target Surface can be adjusted via the drop-
down menu above Extend. These options generally only apply when the selected duct will meet the
surface at an angle.
• Intersect: Center: The selected ducts will extend until their centerline intersects the Target
Surface. This is the default behavior.
• Intersect: Longest: The selected ducts will be extended until the last possible intersection
point is met. This will result in more of the selected ducts intersecting the Target Surface
• Intersect: Shortest: The selected ducts will be extended until the first possible intersection
point is met. This will result in the selected duct barely intersecting the Target Surface.
Page | 9
Figure 7: The three different Extend modes represented: Center (Left) Short (Middle) or Long (Right)
Figure 5 shows an example of an extraction close to the real edges of the actual duct compared to a duct
extracted with a loose-fitting clipping polygon. When using Autofit for initial sizing, it is especially
important to draw your polygon tightly to the actual surface edges.
Figure 5: Extracting a duct using a close fitting extraction region (left) and a loose fit extraction region (right)
Once you extract a duct that is sized correctly, you can select the “Set To Selected” button to set all
subsequent extractions to that specific standard, duct type, and size; this is especially helpful in scenes
in which numerous duct are of like material and size.
Page | 10
To exit extraction mode mid-process, simply press the ESC key or the spacebar.
IMPORTANT PRODUCTIVITY TIP: If you are modeling many instances of the same-
sized duct, extract the first duct using “AutoFit”, validate that it is modeled with the correct size, use the
“Set To Selected” button to constrain subsequent extractions to use the same size, and then extract all
of the rest of the ducts using that one size. When the extraction algorithm is constrained to a single
size, you can use loose-fit polygons and still get excellent results, which can dramatically improve the
extraction time. Having identical duct sizes is also a requirement for using elbows without transitions,
and this is by far the easiest way to ensure that you get identical duct sizes.
Select Ducts
To select a duct, activate the “Navigate” tool, and single-click on any duct (Figure 6). To select multiple
duct elements at once, press the Ctrl+Left Mouse button and click on each object to be included. You
can also draw a box around the items you wish to select by pressing Shift+Left Mouse and dragging a
box selection. Press the Tab key while a duct object is selected to select its entire connected chain.
Press the ESC key to deselect any ducts that are currently selected.
Edit Ducts
Once a duct is selected, you can perform the following actions to manipulate and edit the duct:
• To enable fine tune adjusting—the small arrows—click the “side draggers” checkbox.
• Translate a duct element by clicking and dragging on the duct. This form for translation will
break any existing connections.
• For Linear Elements:
o Extrude (lengthen/shorten) a duct by using the large red arrows.
o Translate a duct by using the small arrows—requires side draggers on—at the center of
the duct.
Page | 11
o Use the small red arrows—requires side draggers on—to perform rotational
adjustments at either end of the duct.
o Free-move an end of a duct by clicking and dragging the blue sphere at either end.
• For Elbows:
o Increase or decrease the bend radius by moving the teal sphere.
o Click and drag the large arrows to drag the elbow in that direction.
o Click and drag the little arrows—requires side draggers on—to drag the elbow’s
associated end in that direction.
• For Transitions:
o Click and drag the blue sphere at either end to drag the associated end along its local z-
axis.
o Click and drag the small arrows—requires side draggers on—at either end to drag the
transition’s associated end in that direction.
o Click and drag the small arrows—requires side draggers on—at the center to drag the
entire transition in that direction.
• To copy/paste, select a duct and press Ctrl+C/Ctrl+V.
• Press the “Rotate Left” or “Rotate Right” buttons (Error! Reference source not found.) to rotate
a duct 90-degrees left or 90-degrees right, respectively.
• Press the “Rotate to Flat” button to rotate all selected linear elements, except for elbows and
transitions, about their main axes so that their tops are as closely aligned as possible with the z-
axis. Note: If no elements are selected, all linear objects that are not connected to another
object will be rotated.
Snap Ducts
The snapping options allow duct elements to be snapped to specified orientations.
Page | 12
4) For Vertical or Horizontal, the snap will occur immediately (no other input is necessary). For
Parallel, Perpendicular, Collinear, Aligned, or Reconnect, click on a reference (target) duct
element to complete the snapping process.
Tip: After creating a duct run, it can be helpful to perform a final check to ensure that ducts,
connections, and transitions are all in alignment. It is best to start at one end of the run and work
toward the opposing end using the “Aligned” snapping option.
Extend Ducts
Extend
To extend one duct to meet another, perform the following steps:
The way Extend behaves when the selected duct meets the Target Surface can be adjusted via the drop-
down menu above Extend. These options generally only apply when the selected duct will meet the
surface at an angle.
• Intersect: Center: The selected ducts will extend until their centerline intersects the Target
Surface. This is the default behavior.
• Intersect: Longest: The selected ducts will be extended until the last possible intersection
point is met. This will result in more of the selected ducts intersecting the Target Surface
• Intersect: Shortest: The selected ducts will be extended until the first possible intersection
point is met. This will result in the selected duct barely intersecting the Target Surface.
Page | 13
Figure 7: The three different Extend modes represented: Center (Left) Short (Middle) or Long (Right)
1) Join
2) Transition
3) Radius Elbow (with or without attached transition)
4) Mitered Elbow (with or without attached transition)
Straight Connections
To create a straight connection between duct elements, select the two elements to be connected, and
then click the “Join” button on the “Tools” portion of the Model tab (Error! Reference source not
found.). Note: To create a straight connection between ducts, the duct elements must be of the same
standard size and type, and be roughly parallel to each other (within 15 degrees).
Transitions
To connect two ducts via a transition element, select the two ducts to be connected, and then click the
“Transition” button on the “Tools” area of the Model tab (Error! Reference source not found.). Note:
When creating the transition, the axes between the duct elements are forced to be parallel (if
necessary).
Copy Size
Often many of the connection tools will require that two elements have the same standard size in order
to function. The copy size tool allows you to quickly copy the standard size of another duct. To use the
Page | 14
copy size tool select a straight duct. Click the copy size button. Then click another straight duct. The
selected duct—green—will be made the same standard size as the clicked duct—blue.
Connected Ducts
To see which elements are connected in a chain of duct elements, select one element and then press
the “tab” key. This will select all connected elements.
Disconnect Ducts
To remove all connections from a selected duct element, press the “Disconnect” button on the “Tools”
toolbar of the Model tab (Error! Reference source not found.).
Delete Ducts
To delete ducts, select the duct(s) to be deleted and then press the DEL key.
Analyze Ducts
To analyze the metadata, accuracy, and fit of ducts, press the “SmartSheet” button on the Tools toolbar
(Error! Reference source not found.). This opens SmartSheet and the 2D Viewport.
Export Standard
To export the currently selected standard to a .csv file, press the “Export to Standard” button (Error!
Reference source not found.) in the Tools section of the Model tab, and then choose an output file
name. This will allow you to see the dimensions used by the standard for fitting ducts.
IMPORTANT: The 2D ViewPort will only display one cross section at a time. If no ducts are
selected, or if there are more than one duct selected, then the 2D ViewPort will be empty.
Page | 15
Figure 8: The SmartSheet and 2D viewport
SmartSheet
Each row in the SmartSheet corresponds with a duct in the scene. Clicking on a row in the SmartSheet
will display the duct’s cross-section in the 2D Viewport.
Resize
You can resize a duct to another standard size via the SmartSheet by changing the value in the “size”
column of the SmartSheet associated with the currently selected duct.
2D ViewPort
The 2D ViewPort displays the cross-section of the duct currently selected in the SmartSheet.
Navigate
Navigate within the 2D ViewPort in the following ways:
• Pan: Mouse wheel-click and drag.
• Zoom: Right-click and drag up or down, or use the mouse wheel.
Move Cross-Section
Move the cross-section to be in better alignment with the points by clicking on the white outline of the
cross-section and then dragging.
Rotate Cross-Section
Rotate the cross-section 90-degrees by clicking on either of the Rotate buttons on the Tools toolbar
(Error! Reference source not found.). Rotate the cross-section by an arbitrary amount (i.e., free rotate)
Page | 16
by shift-clicking (hold the “shift” key down) on the white outline of the cross-section and then dragging
right and left.
Resize Cross-Section
A duct can be resized in the following ways using the tools located on the Tools toolbar:
1. Press the “Resize” button on the Tools toolbar (Error! Reference source not found.), and
then click to draw a rectangle in the 2D ViewPort around the green points corresponding to
the desired bounding box of the duct.
2. Via SmartSheet: Change the value in the “size” column.
If a duct does not fit to the point cloud, you can use the resize tool to change the duct size and the the
“Refit” tool to perform a re-extraction of an existing duct. To use this tool, select a straight duct then
click the “Refit” button. EdgeWise will then try to extract an identical (in both cross-section size and
orientation) duct in the vicinity of the selected element. If the extraction succeeds, the geometry of the
selected duct will be replaced with the newly extracted geometry; if it fails then the selected element
will not be modified.
As with the Patterned Extract tool, the “Lock Orientation” checkbox can be unchecked to relax the
requirement for identical orientation when performing the extraction. Note that this operation will
never add a duct to the model; the extraction is performed merely to determine the new geometry of
the existing duct.
Page | 17
Saving
It is very important to note that ‘Save As’ does NOT save entire projects; rather it saves individual model
file and prompts the user to rename those files. When using Save As, each model in the scene must be
saved separately, or that work will be lost. To save a specific model:
1. Change the Active Model by selecting the model you wish to save in the Model Selection Pane
on the left side of the screen.
Click Save -> Save As under the File tab, and choosea file name. If you want to overwrite your
previous file, do not change the name. Save All will save all models loaded in to EdgeWise, but will
automatically overwrite existing files. If a saved version of the file does not exist (for example, if a
blank model was loaded), the user will be prompted to input a name and location.
Exporting
Duct Models can be exported to the Leica COE format, Smart Points, or STEP format. To export a duct
model, click the “Export” button (located in the Output section of the File tab as shown in Error!
Reference source not found.), select a format, and then choose an appropriate output file name.
Smart Points
The Smart Points export option finds and saves the points in the vicinity of a selected set of objects
to a “Smart Points” ReCap (.RCP) or PTS (.pts) file. If no individual model objects are currently
selected, the points associated with the entire model will be exported. The Inclusive Distance
setting allows for the export of all points within a specified radius of the selected objects or model.
Remainder Cloud
The inverse of Smart Points export, the Remainder Cloud export option will export all points outside
of a the Exclusive Distance from all loaded models (except for ground models) – essentially creating
a point cloud that only contains points that do not correspond to any object modeled EdgeWise.
The Remainder Cloud should be used to assist in modeling, in another application such as Revit,
components that cannot be modeled in EdgeWise.
STEP Format
In this version of the software, the following objects are exported: straight ducts, radius elbows,
transitions, and Mitered elbows
It should be noted that there is a known issue with importing a STEP file into AutoCAD. If a STEP
model is imported into an AutoCAD document, and then another model is imported into the same
document, AutoCAD’s importer can become confused and create bad geometry for the second
model. A workaround is to import into a new document, or to close the document (or AutoCAD) and
reopen it.
Page | 18
Exporting to Revit
In order to export the currently selected Duct Model to Revit, press the “Export to Revit” button under
the Output section of the File tab, and then choose an output file name. Then in Revit, use the “Open
Model” button under the “EdgeWise” tab to import the model. Your ducting elements will be imported
into Revit as intelligent Revit objects. The spec used to create the Ducts will be used in the Revit Family
Type.
Page | 19