Professional Documents
Culture Documents
Users Manual
May , 2014
SurphExpress Users Manual
Windows, Windows NT, and DirectX are registered trademarks, and .NET is a
trademark, of Microsoft Corporation.
Contents
Conventions Used in This Manual ............................ viii
Introduction ................................................................... 1
Features ........................................................................................................1
Theory of Operation .....................................................................................2
Typical Workflows ......................................................................................3
Scanning ...................................................................... 21
Loading a Scanners Scan Parameters .......................................................21
Viewing Scanner Parameters with No Scanner Connected .......................22
Pre-Scan Setup ...........................................................................................23
Specifying the Scanners ZeroReference Point ................................24
Defining the Scan Region ..................................................................25
iii
Contents
iv
SurphExpress Users Manual
v
Contents
vi
SurphExpress Users Manual
vii
SurphExpress Users Manual
Menu options:
e.g. Select the Tools | Regular Scan menu option.
Buttons:
e.g. Click the button in the toolbar.
viii
SurphExpress Users Manual
Introduction
SurphExpress is a powerful 3D modeling application suite designed to
provide:
Features
NOTE: To reduce scanning time, reduce the scan area and/or scan
density. (See Pre-Scan Setup)
1
Introduction
User Editable masks. These masks allow you to limit the scan
viewing to an area of interest or according to the scan image
properties.
Theory of Operation
2
SurphExpress Users Manual
A 2D image can be created from the C3D data to preview the image data
and create masks for processing the 3D image. Image processing
parameters can be saved for processing other C3D data sets.
Once the image masks and processing filters are selected, SurphExpress
can produce and export 3D Image Data in a variety of industry standard
formats.
Typical Workflows
Scan only. You can perform a scan and save the scan data for
processing at a later time.
Scan and automatically create the 3D image data. You can perform
a scan and automatically create the 3D image data using preset
processing parameters. This can also include automatically exporting
the 3D image data to an industry standard 3D format. A project is
created as part of the scan data processing. The project can be saved if
you want to load the processed data at a later time, or not saved if the
goal of the processing is to create only the exported 3D format file.
Load existing scan data for processing. You can load an existing
C3D scan data file and process it to create the 3D image data.
Optionally, you reprocess the scan data with different processing
parameters, save the project, or export the 3D image data to an
industry standard 3D format.
3
Introduction
4
SurphExpress Users Manual
Scanning Concepts
Accuracy Considerations
The accuracy of the scan depends on many factors, for example, the
environment conditions, temperature variation in electronic circuits that
can result in changes in scanner parameters, specific properties of the
objects surface, lighting conditions, and so on. The processing software
uses sophisticated correction methods to minimize the accuracy loss.
Transparency
The accuracy of distance measuring (and, consequently, of the scan itself)
is influenced by the properties of the object being scanned. For instance, if
the surface is semi-transparent for the laser beam, it is not possible to
measure the distance to a point on the object surface with great precision.
5
Scanning Concepts
Note that while some surfaces seem non-transparent to the human eye, the
laser beam may penetrate these surfaces to a certain extent.
You can roughly test the objects degree of transparency by using a laser
pointer and inspecting the spot of the laser beam on the object surface:
If the spot is rather large and has blurred contours, it is likely that the
material is transparent.
The surface reflects the beam mostly in one direction (and this
direction does not coincide with the direction of the laser beam).
Direct reflection of the signal from the surface will not allow
measurement of the distance as it causes the signal level to be too high
in most cases.
Low incidence angles (10 or less) at the object surfaces result in a low
accuracy and may also cause ambiguity errors.
Note that some surfaces, like dark green or blue, may be black in red laser
light while they seem to be not black to the human eye. As with
transparency issues, powdering the object can help minimize errors due to
the targets surface reflectance and incidence angles by scattering the
reflected light.
6
SurphExpress Users Manual
From the factory, the scanner is calibrated to its current hardware state,
and the calibration data is included in the initial scan parameter file,
xrprscxxx.rpr, where xxx is a unique number identifying your scanner.
The scan parameter file can also contain preset configurations that are
optimized for scanning a specific signal level ranges and resolution, based
on the expected use of the application.
NOTE: The scan parameter files contain encoded data to protect its
integrity. Manual changing of the parameter file will result in an integrity
data mismatch and will make it unusable until the original version is
restored.
When starting the SurphExpress application for the first time after
installation, you will select this file to register the scanners factory-set
parameters with the application. The application uses these scan
parameters when processing scan data to accurately create 3D image data.
7
Scanning Concepts
Older scanners may be operated either in one pass or two-pass modes (see
Selecting the Scan Group, p. 29). Newer scanners achieve accuracies in
one pass equal to older scanners in two passes. Because of this, newer
scanners do not have a two pass mode.
For two pass mode, information from two passes for the same scan area is
combined in the following way:
However, on surface areas where the readings are for some reason
inaccurate (e.g., the light goes through the window and reflects from the
surface behind the window and the light from the window and the surface
behind it combines), there is a chance of an incorrect ambiguity resolution,
as shown in the following illustration.
8
SurphExpress Users Manual
Scanning Operation
Prior to starting the scan operation, you use controls in the SurphExpress
application to set the scan region, or field of view (FOV), by:
9
Scanning Concepts
10
SurphExpress Users Manual
11
SurphExpress Application Installation
12
SurphExpress Users Manual
5. Read through the license agreement. If you agree with the conditions,
select the I Agree option, then click .
From this screen you can change the default path for the installation
destination by modifying the path in the Folder field, or clicking
the button and navigating to it.
13
SurphExpress Application Installation
14
SurphExpress Users Manual
15
SurphExpress Application Installation
1. Make sure that the scanner is connected to a USB port on the PC.
When the PC detects the scanner, it starts the Found New Hardware
Wizard, prompting you to start the driver installation process.
16
SurphExpress Users Manual
4. If this is a first time the scanner is connected to this PC, select the
Install from a List of Specific Locations option; otherwise, select the Install
Software Automatically option. Then click .
5. Select the Search for the best drive in these locations and the Include this
location in the search options, then enter the installation directory for the
SurphExpress and drivers:
17
SurphExpress Application Installation
7. Click .
18
SurphExpress Users Manual
Or
19
SurphExpress Application Installation
If this is the first time you have started the application, you must load the
scanner parameters so that the application is aware of them for scanning
operations. (Refer to Loading a Scanners Scan Parameters on page 21.)
20
SurphExpress Users Manual
Scanning
Loading a Scanners Scan Parameters
Under either of these conditions, the application will prompt you to locate
the scanner parameter file for the corresponding scanner.
You can also initiate the loading of a scanners scan parameters file:
To load a scanners scan parameters file, select the File | Update Scanner
Parameters menu option. You will be prompted to locate the file.
21
Scanning
You can view a scanners parameters when the scanner is not connected or
online:
Once you have located and opened the parameters file, the scanners
parameters are loaded and can be viewed and edited in the Scan tab.
22
SurphExpress Users Manual
Pre-Scan Setup
Before performing the scan operation, you must specify certain scan
parameters. These are defined in the following topics.
The scan parameters are accessible from the Scan and Scan Options tab.
NOTE: The scanner must be connected to the PC and turned on for the
scan parameters to be enabled.
23
Scanning
The Absolute Angle will be defined either after the first scan (select the
Find Azimuth Reference Before the First Scan option on the Scan Options
tab), or after pressing the button Locate Zero Reference (see below). Below
we are discussing in more details working with azimuth angles.
Rotate Scanner
To rotate the scanner to a position
relative to its current zero
reference point, enter the angle
here, then click this button.
Set 0 Angle:
To set the User zero reference
point to the current azimuth
position of the scanner, click
here
24
SurphExpress Users Manual
Full Volume Scan. The scan will be performed by rotating the scanner
head for 180effectively covering 360as the scanner looks 2
ways, front and back.. You can also force the full volume scan to start
from the current scanner head position by selecting the Start a full
volume scan from the current position option in the Preview Scan Options
panel on the Options tab. otherwise the scanner will turn to User 0
angle before the scan starts. For further discussion, refer to
Determining the Scan Region (Field of View) on p. 9.
Sector Scan. The sector defined by the From and To azimuth angles
will be scanned. For a sector scan, the From and To pan angles are
measured relative to the User 0reference point (the From value should
be less than the To value). The To value may be 0 to 359 degrees. (In
case of the scan sector covering more than 180 degrees, some angles
will be covering more than once, scanned from scanner front and
Rear positions. These two different views of the same position are
often referred to as Conjugate views).
25
Scanning
You can also force the full volume scan to start at the current scanner head
position by selecting the Start a full volume scan from the current position
option in the Scan Options panel on the Scan Options tab.
To modify the settings for one of the density presets, select the presets
radio button, then click the button. The Scan parameters dialog
(spherical) dialog box displays.
26
SurphExpress Users Manual
Set the horizontal and vertical scan densities using the sliders or
increment/decrement fields. Note that as you change these values, the
values for the Scan Time, Number of Lines, Points per Mirror
Revolution, Full Number of Points, and Scan File Size change. Sliders
and Edit boxs for the density are expressed in Lines Per Degree and
Points per Degree. For reference, horizontal and vertical point
separation is shown for a surface located at the Nominal Distance.
Nominal Distance can be adjusted via Scan Resolution Units dialog
discussed below.
You can force the vertical density to match the horizontal density
automatically by selecting the Equal Grid Aspect Ratio option. If this
option selected, the vertical density slider will be hidden.
Set the unit of measure used for the resolution data by clicking the
button. The Scan Resolution Units dialog box
displays.
27
Scanning
Set the nominal distance to the target object in the Nominal Distance
field in the Scan Resolution Units dialog box. This value will be used
only to display the resolution in linear form and does not affect
scanner operation in any other way. For further discussion, refer to
Angular vs. Linear Scan Resolution on p. 5.
Specify a name for the preset in the Density Mode Name field.
Depending on the Mode radio button selection corresponding radio
button label will be changed.
To specify the name of the scan data file, click the button next to
the Output Filename field.
The Save As dialog box displays, with the default path displayed:
/Documents and Settings/user subfolder/Application
Data/Surphaser/C3Dfiles. From this dialog, you can navigate to the
destination folder and name the C3D file, or overwrite an existing C3D
file.
28
SurphExpress Users Manual
29
Scanning
Each group option has one or more configuration options from which to
choose. The configuration choices will be different for different scanners.
These preset configurations are optimized for specific signal ranges and
scan resolutions that are being used by your site. For more information,
refer to Specifying the Scanners ZeroReference Point
on p. 24.
30
SurphExpress Users Manual
Preview Scan
If, during the current session, a preview scan was already performed, it
can be used to re-select the scan area.
To set the density for the preview scan data, increase or decrease the
Horizontal and Vertical density settings in the Preview tab. The density is
expressed in Lines per Degree (lpd) for horizontal density (referencing to
the vertical line scan pattern of this hemispherical scanner) or Points Per
Degree (ppd) for the vertical density. Typically Horizontal density should
be 4lpd or higher for reliable image processing.
31
Scanning
Choosing a lower density also will shorten the preview processing time.
To delete the preview scan data after the actual scan is performed,
select the Delete Preview Scan After Selection option in the Preview tab.
Otherwise, the low-density Preview scan data is saved with the standard
high-density scan data. The Preview scan data file name consists of the
current scan name with the suffix _preview appended to it. Selection of
this option will prevent possibility of using the button Select new scan
area from last preview scan for this preview scan.
Using the options in the Preview Region panel, you can specify the
preview scan :
Sector Scan: The sector defined by the From and To azimuth terms
will be scanned for the preview. The From value should be less than
the To value. The To value may be 0 to 359 degrees. (In case of the
scan sector covering more than 180 degrees, some angles will be
covering more than once, scanned from scanner front and Back
positions).
32
SurphExpress Users Manual
This function allows you to reselect the area for the scan from the last
preview scan. A single preview scan can then be used to scan different
areas with different settings, without the need to do the preview several
times. This button is disabled if there were no preview Scans in current
session, or Delete Preview Scan after Selection check box was checked
for the last preview scan processing.
When the scan is done, it is automatically processed and the Mask Edit
window displays with the Preview 2D image.
33
Scanning
You can then specify the area to include in the full scan using the tools
described in Specifying the Area to Be Scanned Using Masks on p. 36.
After specifying the scan area, you have the following options:
Start the scan (refer to Performing the Scan on p. 40). The scan
uses the parameters that are currently selected in Configuration or
Scan tabs (for example, the density).
Save the scan selection area but not start the scan. To do this, click
. This enables the Scan from Preview Selection option in the
Scan Area panel and allows you to change scan parameters before
starting the actual scan. Several scans (with possibly different
parameters) can be performed from a single preview selection or
successive selections from the same preview scan.
Discard the scan selection area without saving it or starting the scan.
To do this, click .
34
SurphExpress Users Manual
You can also use the Navigate/Zoom tab to navigate the image and change
the magnification.
To open the Navigate/Zoom tab, click the Navigate/Zoom tab at the right
of the Mask Edit window.
To navigate (pan) on the image, click on and drag the white pan box
displayed over the thumbnail of the image. When you release the
mouse button, the image area within the pan box is displayed in the
panel.
35
Scanning
To specify the area to be scanned in the Preview image, use one of the
drawing tools ( ) to draw the area.
To erase a drawn area, select one of the drawing tools. Then, hold down
the right mouse button and drag over the area to be erased. For example,
dragging the rectangle tool with the right mouse button down will clear the
current mask within selected rectangle.
Tool Description
36
SurphExpress Users Manual
Tool Description
The drawing tool controls on the Options tab of the Mask Edit window
allow you to set parameters that control the behavior of the drawing tools.
To open the Options tab, click the Options tab at the right of the Mask
Edit window. To close the tab, click the button at the upper right.
37
Scanning
To open the Background tab, click the Background tab at the right of the
Mask Edit window. To close the tab, click the button at the upper
right.
Background Parameters
Parameter Description
38
SurphExpress Users Manual
Background Parameters
Parameter Description
39
Scanning
When you have completed setting the scan parameters, you are ready to
start the scan operation.
Scan times vary depending on the FOV (Scan Sector), scan configuration
(1 pass or 2 pass) and scan density; typical scans take 5 to 20 minutes. The
estimated scan time and size of the scan data file are displayed in the Scan
tab.
To start the scan operation, click the button in the toolbar (or
select the Tools | Regular Scan menu option).
All controls except the button are disabled, and status messages
and a progress bar are displayed in the Status bar at the bottom of the main
window.
NOTE: You can stop the scan operation by clicking the button.
40
SurphExpress Users Manual
To park the scanner head, click the Park button on the Scan tab. The
scanner head will rotate to the position when the connector plate is facing
front and the mirror will turn down. Parking angle is controlled by
optional parameter stored in the scanner parameter file. This button is
disabled if the parking position is not available. If absolute azimuth
reference was not located prior to pressing the Park button, the scanner
first will rotate 360 degrees to locate azimuth reference. User can add
information on parking angle using Corr2rpr utility supplied with software
package version 2.30 or later.
41
SurphExpress Users Manual
You can select from the following horizontal (azimuth) angles options:
42
SurphExpress Users Manual
You can select from the following vertical (mirror) angles options:
Front. Processesonly the scan data from the front hemisphere of the
scanned volume, as defined by the sector degree values in the Low and
High fields. Low and High angles are defined relative to the horizon.
Rear. Processes only the scan data from the rear hemisphere of the
scanned volume, as defined by the sector degree values in the Low and
High fields. Low and High angles are defined relative to the horizon.
Both. Processes all data defined by the sector degree values in the Low
and High fields. Low and High angles are defined relative to the
horizon.
NOTE: The vertical angles options are used only if the Show Express View
option in the Processing Modes tab has not been selected.
You can define the low and high angles used for the Express View image
using the Low and High fields in the Vertical Angles for Express View
panel.
43
Creating 2D and 3D Image Data
The Points Info panel at the top of the Filtering tab lists the number of data
points in the scan data and in the processed data (depending on the
processing filters specified).
44
SurphExpress Users Manual
2D Processing Parameters
2D Processing Options
Option Description
45
Creating 2D and 3D Image Data
2D Processing Options
Option Description
Only Export Express View If selected, the low-density Express View scan data
will be used when exporting 2D image data, instead of
the high-density 2D image data. The Point Cloud
Export settings will be ignored. No further scan
processing will be performed. This option is
convenient for making an "image catalog" for
navigation of sets of scans.
To set the 2D image pixel separation, click the button next to the
field in the 2D Processing panel. The Select Image
Pixel separation
Resolution dialog box is displayed.
46
SurphExpress Users Manual
The dialog box displays the pixel separation, image size in pixels, and
image file size, based on the currently selected resolution. If the projected
image file size is too large to be processed given the PCs current amount
of RAM, the size is displayed in red and the button is disabled.
Set the resolution in pixels per inch at the nominal scan distance using
the Pixels per inch option.
Set the unit of measure used for the resolution data in the 2D
image by clicking the button. The Image Resolution Units
dialog box displays.
Set the nominal distance to the target object in the Nominal Distance
field in the Image Resolution Units dialog box. This value should be
the average distance between the scanner and the target object. The
nominal distance value is used in the internal conversion of angular
resolution units to linear resolution units for display purposes only; it
does not affect processed data. For more information about angular
and linear resolutions, refer to Angular vs. Linear Scan Resolution
on p. 5.
When you are done changing the resolution settings, click in the
Select Image Resolution dialog box to save them and close the dialog box.
47
Creating 2D and 3D Image Data
3D Processing Parameters
3D Processing Options
Option Description
48
SurphExpress Users Manual
If you choose to automatically process the data after scanning, you should
set the processing parameters before starting the scan operation.
Select the User rpr from c3d file option to have SurphExpress extract rpr file
data and use it for processing the current scan.
If this option is not selected, then SurphExpress will check the scanner
serial number from the c3d file and will use the rpr file data currently
registered for the scanner, or you will be asked to provide one if no rpr file
for the scanner is registered on the machine used for scan being processed
49
Creating 2D and 3D Image Data
The 3D image data Export function allows you to export the 3D image
data to a file as part of the image processing operation. You would
select this option if you are ready to create the 3D image data file.
50
SurphExpress Users Manual
Option Description
Force Export in File Select this option to export the 3D image data to a file
as part of the image processing.
Specify a directory and file name by clicking the
button.
The Choose File to Export In dialog box opens, with
the default folder /Documents and Settings/user
subfolder/Application
Data/Surphaserversion/C3Dfiles selected. If
desired, navigate to a different destination folder,
change the default file name. When you are done
specifying the file name and folder, click the
button.
Cloud/Mesh Select the data type in which the 3D image data will
be exported.
Units for exported points The unit of measure to use for exported points.
51
Creating 2D and 3D Image Data
NOTE: When saving the 3D image data to the Leica Cyclone format (.ptx),
use the following Point Cloud Export settings: Points on Grid selected,
Z Up selected, Units = meter.
Option Description
52
SurphExpress Users Manual
Distance Resolution
Option Description
53
Creating 2D and 3D Image Data
54
SurphExpress Users Manual
To force the full volume scan to start from the current scanner head
position, select the Start a full volume scan from the current position option. If
this option is not selected, the scanner will turn to User 0 angle before
the scan starts. For further discussion, refer to Determining the Scan
Region (Field of View)
The mirror parking position has the mirror pointing down, When the
option Put Mirror in the Park Position is selected, the mirror is rotated to the
parking position after each scan.
When the option Return to Original Azimuth Position After Each Scan is
selected, the scanner will rotate to the same azimuth position it had before
starting the scan.
The Calibration Section is a short data section that is collected with the
scanner set in special state. A Calibration Section can improve the overall
scan quality, especially if there are dark surfaces within the scanned area.
The three calibration options in the Preview Scan Options panel on the
Scan Options tab allow you to select whether the calibration section
should be collected as part of the scan and, and if so, when it should be
performed. Each calibration section may take up to few seconds. Typically
the calibration section should be collected once, before the scan is
performed. Taking calibration section before and after the scan may be
beneficial for very long scans taking more than 10 minutes, though this
scan configuration is not supported as standard (only a calibration section
taken before the scan is processed in standard software).
Pressing this button will rotate the mirror to the parking position.
55
Creating 2D and 3D Image Data
The three calibration options in the Preview Scan Options panel on the
Scan Options tab allow you to select whether calibration section should be
collected as part of the preview scan and, if so, when it should be
performed. A calibration section is not typically required for Preview
Scan, unless preview scans are retained for processing as a regular scan
later.
2. In the dialog box, select the Off (or On) option and click the OK button.
56
SurphExpress Users Manual
57
Creating 2D and 3D Image Data
You can also save the scanning and image processing parameter settings,
along with export and import filters, as a user profile set. For more
information, refer to Saving and Loading User Profiles on p. 102.
58
SurphExpress Users Manual
When you have completed setting the processing parameters, you are
ready to start processing the scan data to generate the 2D image data and
3D image data.
59
Creating 2D and 3D Image Data
NOTE: If you selected the Show Express View option in the Processing
Modes tab, a Mask Edit window is displayed after the initial pass of image
processing. For more information, refer to Express View on p. 61.
For information about how to view the displayed 2D and 3D image data
images, refer to Viewing Image Data on p. 67.
ProcessC3D [arguments]
60
SurphExpress Users Manual
Express View
The Express View of the scan data can be opened in two ways:
If the scan data has already been processed, and Show Express View
option on the Processing Modes tab is selected (checked), click the
button to open the existing low-density 2D scan data in a
Mask Edit window.
61
Exporting and Saving Image Data
If the image is acceptable and you are finished selecting the area of the
scan to be fully processed, click to continue with the standard
processing of the selected scan data.
You can also use the Navigate/Zoom tab to navigate the image and change
the magnification.
To open the Navigate/Zoom tab, click the Navigate/Zoom tab at the right
of the Mask Edit window.
To navigate (pan) on the image, click on and drag the white pan box
displayed over the thumbnail of the image. When you release the
mouse button, the image area within the pan box is displayed in the
panel.
62
SurphExpress Users Manual
To specify the area to be processed in the Express View image, use one
of the drawing tools ( ) to draw the area to be included in
the image processing.
To erase a drawn area, select one of the drawing tools. Then, hold down
the right mouse button and drag over the area to be erased. For example,
dragging the rectangle tool with the right mouse button down will clear the
current mask within selected rectangle.
The Express Views toolbar functions, shown below, are described in the
following table. The drawing tools are used when defining the area to be
processed.
Tool Description
63
Exporting and Saving Image Data
Tool Description
The drawing tool controls on the Options tab of the Mask Edit window
allow you to set parameters that control the behavior of the drawing tools.
To open the Options tab, click the Options tab at the right of the Mask
Edit window. To close the tab, click the button at the upper right.
64
SurphExpress Users Manual
To open the Background tab, click the Background tab at the right of the
Mask Edit window. To close the tab, click the button at the upper
right.
Background Parameters
Parameter Description
65
Exporting and Saving Image Data
Background Parameters
Parameter Description
You can regenerate 2D image data or 3D image data at any time. For
example, you may want to regenerate image data after you have made
changes to the processing parameters or image filters.
66
SurphExpress Users Manual
You display the 2D intensity image by selecting the 2D Intensity tab in the
View panel, or by selecting the View | 2D intensity data menu option.
The following topics explain how to navigate (pan) and zoom on the
image, and how to create masks.
67
Exporting and Saving Image Data
To: Do This:
Zoom in
Click the button in the toolbar.
Zoom out
Click the button in the toolbar.
Click and drag in the direction you want to pan. When you
release the mouse button, the area of the image on which
you initially clicked is moved to the hand pointer location at
which you released the mouse button.
68
SurphExpress Users Manual
To open the Navigate/Zoom tab, click the Navigate/Zoom tab at the right
of the View panel.
To navigate (pan) on the image, click on and drag the white pan box
displayed over the thumbnail of the image. When you release the
mouse button, the image area within the pan box is displayed in the
panel.
You can use the drawing tools in the Mask Tools toolbar to draw masks
over the 2D image data. Data within the drawn masks will not be included
in exported 3D image data. These tools are similar to those found in
popular draw and paint applications.
NOTE: The User Mask must be visible to see the drawn masks. For more
information, refer to Setting the Export Masks Parameters on p. 95 and
Setting the Visibility Rank for Filter Layers on p. 97.
69
Exporting and Saving Image Data
Tool Description
The drawing tool controls on the Options tab of the View panel allow you
to set parameters that control the behavior of the drawing tools.
To open the Options tab, click the Options tab at the right of the View
panel. To close the tab, click the button at the upper right.
To view the effect of the 2D mask on the 3D image data, click the
button in the toolbar (you can also use the
buttons on the Processing Modes tab).
70
SurphExpress Users Manual
Adding Markers
You can add markers to the image in the 2D view to indicate the location
of targets in the scanned image. These can be helpful when merging
multiple scans.
To add a marker:
1. In the text field in the Pick panel, enter a root name for the marker.
Incremented numbers will be added to this root name for each marker
that is created. If root name is null, then the markers will be just
numbered.
2. Click the Pick button that corresponds to the type of target you are
identifying: Pick Rectangular, Pick Circular, Pick Spherical, or Pick
Unknown. The mouse pointer switches to Pick mode and the pointer
shape changes to crosshair shape. Respective pick button switches to
Pressed state. Normal operation with the mouse is suspended until
the corresponding Pick is clicked and switches back to Unpressed
state.
71
Exporting and Saving Image Data
3. Position the crosshair cursor over the center of the target in the 2D
image and click left mouse button.
4. Each click (or Pick) within 2D scan image (or 3D Scan Image)
window will result in addition of next marker to the table control and
the small white circular shape (referred to as marker indicator or
glyph)will be drawn in the 2D window at the position of the click. A
spherical glyph will be drawn in the corresponding point in 3D
window.
5. If With improve option box is checked, then immediately after pick the
software will try to recognize the marker shape, This process is
referred to as improve and is discussed below in more details.
To exit from the Pick mode, click again the button that is in a
Pressed position.
To Improve marker(s):
Using the mouse pointer, select the name of one or several markers in the
Name column of the tabular control and press the Improve button. The
software will try to recognize the marker shape. If the shape recognition is
successful (that is the improve process succeeds), the software will compute
and update the center of the shape, then will change the text in the improved
column for the marker from False to Improved, and change the color of the
marker glyph to red. If necessary, position of the glyph is updated in 2D and
3D windows.
The Size box defines the search area (relative to the original pick location, in
degrees) for the improve.
72
SurphExpress Users Manual
If the improve process succeeds then the marker glyph color changes
to red
For the rectangular markers, a larger circle that indicates the image
area used by the software to determine the center of the target is
drawn. The larger circle also includes a crosshair indicating the border
between the dark and light areas of the target
Rectangular marker
Click the same Pick button again to exit the marker placement mode.
The quality of the data on which the target center determination was based
is indicated by the following:
73
Exporting and Saving Image Data
If the larger circle is only small portion of the target area, that indicates
that target image was compromised (e.g, part of the target might have
been obscured during the scan or the target image might be distorted).
In the previous screen example, the circle has the maximum diameter
that fits in the target image, indicating that a sufficient area was able to
be used.
The cross-hair on the larger circle should align with the target
dark/light boundaries or the target centerline.
If there are dark marks on the target within the circle that are not part
of the actual target image, or part of the target within the circle is
obscured, the target calculation might not provide accurate results.
You can also perform the following functions using the marker tools.
Function Description
Size spin box Set the size, in degrees, within which the improve
function will operate.
This parameter controls how accurately you need to
pick the center of the marker for the Improve function
to work properly. If the pick point is further away from
the center of the marker, the Improve function might
not find the center of the marker and will fail.
Size slider Use this slider to adjust the size of the marker.
74
SurphExpress Users Manual
Function Description
75
Exporting and Saving Image Data
You display the cloud points image by selecting the 3D Points tab in the
View panel, or by selecting the View | 3D Points menu option.
76
SurphExpress Users Manual
To hide or show the tool tabs along the panel, right-click in the 3D
Points view and select the Pages | Settings , | Navigation ,
or | Picture option from the pop-up menu to toggle the tool tab on and
off.
Select the color you want and then click to apply that color to the
background or foreground.
77
Exporting and Saving Image Data
To set the light parameters, select the View | 3D Options | Light menu
option. The standard Windows Light dialog box displays.
78
SurphExpress Users Manual
Perspective projection
Orthogonal projection
Or
If the Cull back faces option is selected, then the triangles in the mesh
are hidden when viewed from the back side.
79
Exporting and Saving Image Data
If the Cull back faces option is not selected, then triangles are visible
from both the front and back side, but are rendered with a uniform
dark color when viewed from the back direction.
3D data that is outside the range defined by Znear and Zfar are not
processed. Typically, the default settings are sufficient for processing the
3D image data.
To have the application set the Znear and Zfar parameters using
default values based on the scan data, select the Dynamic option. You
can still change the ratio value.
To manually set the Znear and Zfar parameters, deselect the Dynamic
option. This enables the Znear and Zfar fields, allowing you to
modify their values.
80
SurphExpress Users Manual
Setting Image Brightness and Contrast for the 3D Image Data Image
You can set the brightness and contrast of the 3D image data image.
To set the brightness and contrast, use either of the following methods:
The buttons on the Brightness/Contrast toolbar
Contrast controls
Brightness controls
Or
The slider controls in the Picture tab. To open the Picture tab, click on
its tab.
The Z axis points from the viewer and is perpendicular to the screen
plane.
81
Exporting and Saving Image Data
To set the 3D Points view mode, use one of the following methods:
By right-clicking on the 3D Points view and selecting it from the
pop-up menu.
Select it from the options in the Mode panel on the Settings tab.
Examine/Walkthrough
toggle option
82
SurphExpress Users Manual
Rotate around
the Y axis
83
Exporting and Saving Image Data
From the Navigation tab, you can set parameters related to the navigation
behavior for shifting your view position along one of the three axes,
rotating your view position around an axis, and zooming on the image in
Examine mode. You can also set the action repeat behavior when clicking
one of the control buttons in the Navigation toolbar.
To open the Navigation tab, click on the Navigation tab on the left side of
the View panel. The Navigation tab opens.
84
SurphExpress Users Manual
Setting Description
Shift: Auto repeat multiplier Specifies the step multiplier for multiple key presses
when using the keyboard-based Shift control.
Zoom: Auto repeat multiplier Specifies the zoom step multiplier for multiple key
presses when using the keyboard-based Zoom
control.
Toolbar: Auto repeat rate Determines the frequency of auto repeating when
clicking and holding on a toolbar control.
You can use the buttons on the View Position toolbar to choose the
direction from which to view the 3D Points image. The buttons have
different uses, depending on whether you are in Walkthrough or Examine
mode.
Face Left
In Examine mode, your point of view is, by default, from outside the
scanned scene. You use the View Direction controls to move your point of
view so that you are facing one of the sides of the scene.
You can use the buttons in the Shift Position toolbar to move your position
along the X, Y, and Z axes relative to the 3D Points image. You can click
and hold the mouse on these controls to auto repeat the operation.
You can use the buttons in the Rotate Position toolbar to rotate your
position around the X, Y, and Z axes relative to the 3D Points image. You
can click and hold the mouse on these controls to auto repeat the
operation.
With the Point-n-Rotate function enabled, you can click the pointer at a
spot on the image, and the image will rotate that point to the center of the
View panel.
86
SurphExpress Users Manual
You can use the buttons in the Center-of-Rotation Point toolbar to set the
location of the center-of-rotation point in the View panel.
You can use the buttons in the Zoom toolbar to zoom on the 3D Points
image. You can click and hold the mouse on these controls to auto repeat
the operation.
Reset to standard zoom
Zoom in factor
Zoom out
With the pointer over the image, you can use the keyboard and mouse
actions to navigate through the "3D points" image. The keyboard/mouse
controls are explained in the following two tables, using a camera
metaphor to represent the source of the view you see in the View panel.
87
Exporting and Saving Image Data
Rotate the camera around the Click and drag the pointer with the left mouse button.
Y axis, using the camera
position as the rotation center,
and move the camera along
the Z axis [point of view
(POV) moves with the
camera].
Rotate the camera around the Hold the X key as you click and drag the pointer.
X and Y axes.
Rotate the camera around the Hold the Z key as you click and drag the pointer.
Z axis, and move the camera
along the Z axis (POV moves
with the camera).
Shift the camera along the X Left and Right Arrow keys.
axis.
Shift the camera along the Y Shift+Up and Shift+Down Arrow keys.
axis.
88
SurphExpress Users Manual
Rotate the camera around the Click and drag the pointer with the left mouse button.
X and Y axis.
Rotate the camera around the Hold the X key as you click and drag the pointer.
X axis.
Rotate the camera around the Hold the Y key as you click and drag the pointer.
Y axis.
Rotate the camera around the Hold the Z key as you click and drag the pointer.
Z axis.
Shift the camera along the X Use the Left and Right Arrow keys.
axis.
Shift the camera along the Y Use the Shift+Up and Shift+Down Arrow keys.
axis.
Zoom in and out Hold the Shift and Ctrl keys, and click and drag the
pointer.
Solid Points
Wireframe
89
Exporting and Saving Image Data
Data from target surfaces that are outside the distance range of interest
SurphExpress also includes two Background filters that indicate the signal
intensity and distance from the scanner. The color blending between
colors assigned to the minimum and maximum signal intensities or
distances can be used in the 2D Intensity view to indicate the rate of
change in signal intensities or distances.
In the 2D Intensity view, the mask filters are displayed in layers, like those
used in graphics applications, with the Background intensity and distance
layers always being the bottom layers. Making the mask layers viewable
allows you to see the data included in the masks, and thus potentially left
out of the exported 3D image data.
90
SurphExpress Users Manual
The Background and mask filter parameters are set in the Export Filter tab
in the Settings window.
91
Exporting and Saving Image Data
From this dialog box, you can specify the various Background Intensity
parameters. To change a parameter, click in its value field; the field
becomes either a text field or a drop-down list.
You can set the Background Intensity Min and Max Values using an
intensity histogram of the image data.
To set the Background Intensity Min and Max Values using the
histogram, right-click on Intensity, then select Show hist from the pop-up
menu.)
Use the sliders to set the Min (bottom slider) and Max (top slider) values,
then click to save your changes.
92
SurphExpress Users Manual
The Distance layer is the distance map, where the proportion Color
Min/Color Max represents the distance between a point and the Zero point
(that is, the center-of-scanning point). The Distance layer is used for
qualitative checking of distances to scan points (from the Zero point).
From this dialog box, you can specify the various Background Distance
parameters. To change a parameter, click in its value field; the field
becomes either a text field or a drop-down list.
93
Exporting and Saving Image Data
Background Parameters
The following table explains each of the Background parameters.
Background Parameters
Parameter Description
Units (selectable only for Specifies the units to be used for the Min and Max
Distance) Values and for the Step value.
94
SurphExpress Users Manual
In addition to the predefined mask filters, you can create your own masks
using drawing tools. For more information, refer to Drawing Mask Areas
Using the Mask Toolbars on p. 69.
95
Exporting and Saving Image Data
Filter Description
Small Areas Image areas that are smaller than the specified size
will be considered noisy data (for example, streaks) to
be masked. The threshold units are in arc minutes.
Incidence Angle This is the incidence angle of the laser beam relative
to the surface. Typically data became less reliable
when the angle between the laser beam and the
surface becomes small.
Contradictory Data Data that has been determined to be not reliable (not
necessarily wrong, but might be).
User Mask The mask drawn in the 2D Intensity view using the
Mask tools.
To set the mask parameters for one of the image data categories,
double-click on the category entry in the Name column of the
Backgrounds panel.
96
SurphExpress Users Manual
From this dialog box, you can specify the various mask filter parameters.
To change a parameter, click in its value field; the field becomes either a
text field or a drop-down list.
The mask filter parameters are explained in the following table. Note that
not all parameters are used with each filter type.
Parameter Description
Units The unit of measure used for the entry in the Value
field.
UseIn3D If set to False, data in this mask filter category are not
included in the exported 3D image data file.
Value Specifies the value for this category of data (e.g., the
intensity value for Intensity Max and Intensity Min).
To change a filters visibility rank, select the filter entry in the Name
column of the Backgrounds or Masks panel, then click the or
button to move the filter up or down in rank. (You can also
right-click on the filter entry, then select Rank Up or Rank Down from the
pop-up menu.)
97
Exporting and Saving Image Data
To make a filter layer invisible, right-click on the filter entry in the Name
column of the Backgrounds or Masks panel, then select Set Invisible from
the pop-up menu. The entrys visibility rank is set to 0.
After clicking the button, the visibility rank for all layers
becomes 0.
After clicking the button, the visibility rank for all layers
returns to their previously set values.
For a description of the filters file XML format and a description of the
filter parameters that are defined in it, refer to ??????? on p. nn.
98
SurphExpress Users Manual
You can also save export and import filters, along with the scanning and
image processing parameter settings, to user preference sets. For more
information, refer to Saving and Loading User Profiles on p. 102.
99
Exporting and Saving Image Data
You can save the 2D intensity image data as a raster file. Any Background
Intensity and Mask filter are applied and saved with the 2D raster image
file. You can also choose to save a distance map in a binary format file,
along with the raster image file.
Select a raster file format from the Save as type drop-down list (GIF, JPG,
PNG, and TIFF are available), then click the button.
Note that, if you are also saving a distance map, the distance map file
name is the same as the raster file name you entered, but with the
extension .dmap.
100
SurphExpress Users Manual
You can save the 3D image data to an industry-standard file. Data that
match a mask filter criteria and for which the mask filters UseIn3D
parameter is set to False will not be included in the exported file.
101
Exporting and Saving Image Data
Select a 3D image data file format from the Save as type drop-down
list.
NOTE: You can also have the 3D image data exported automatically as
part of the 3D processing. For more information, refer to 3D Image Data
Export on p. 50.
You can save the current settings in the settings tabs, and the export and
import filters, as user preference sets. This allows you to load these
settings and filters as a starting point for other scans and processing.
102
SurphExpress Users Manual
2. Enter a name for the profile in the New User Preferences Set field, then
click the button.
To load a profile, select the File | Load User Preferences menu option, and
then select the profile from the submenu.
You can open a new or existing scan at any time. The procedures for these
tasks are described in the following topics.
Note that the scanner must be online, as indicated in the Scan tab, to start
a new scan.
103
Exporting and Saving Image Data
Navigate to the projects folder, select the C3D scan data file, then click
the button. The selected scan is loaded into SurphExpress.
As you change scan, image processing, and filter parameters and process
images, the settings and image data are saved in the project folder for the
current session. When a new scan is started or if the application is closed,
this folder is deleted.
project.xml
processing.xml
preference.xml
*.bsp files
*.bst files
Trash subfolder
104
SurphExpress Users Manual
Troubleshooting
SurphExpress reports session activity in the Log window.
As you perform operations on the application, the log window entries will
indicate the progress of those activities. This provides a check that the
application is processing operations as expected.
105
SurphExpress Users Manual
Appendix
Supported 3D Export File Formats
SurphExpress supports the following 3D image data file formats. Note that
mesh formats are available only when the Point Cloud Export Mesh option
on the Processing Mode tab is selected.
Format (file
extension) 3D Format Description
106
SurphExpress Users Manual
Format (file
extension) 3D Format Description
Argument Description
-units:{mm, m, um, in, ft} Units for the coordinate data in output file.
Default: meters.
-fullscan Process the full scan (take the bottom angle from filters file or rpr file).
Default option
Incompatible with arguments: -hsector, -vsector, -sector.
107
Appendix
Argument Description
-excludebase:<n> Integer n (degrees) is half angle of the bottom part of the scan to be
excluded.
Default: 0
-hsector:<L>:<R> Left and right angles of the sector to process in the range [0,360]
(integer, degrees).
Default: process full horizontal range
Incompatible with arguments: -sector, -fullscan.
-vsector:<L>:<H> Low and High (from horizon) angles of the sectors to process in the
range [-90 to 90] (integer, degrees).
Default: process full vertical range
-minarea:<n> Exclude small areas. Small area is defined as a contiguous area which
size is smaller then the specified value (floating point, angle minutes
squared).
Default: 200.0
-info Output to log file information on the scan (as in c3dinfo.exe). If -log
option is not specified, information is printed on the console.
Default: Do not output
-keepproject Retain the project and temporary files for further use.
-project:<directory> Use the project and temporary files from previous runs. Incompatible
with -rpr and -c3d arguments. This option implicitly turns on the -
keepproject option.
108
SurphExpress Users Manual
Usage:
ProcessC3d [options...]
-rpr:rprfile scanner parameters file name
-c3d:c3dfile source file name
-out:outfile output file name
-filters:fltfile filters parameter file name
-fullscan process whole scan (default)
-hsector:L:R left and right boundaries for image processing
Default is 0:180 (integer, degrees)
-vsector:Lo:Hi low and high boundaries for image processing
Default is 0:360 (integer, degrees).
-sector:L:R:Lo:Hi define solid angle for processing (integer, degrees)
-excludebase:<n> exclude lowest part of the scan (integer, degrees)
-export:<s> output format. Values: ptx, btx, ,spt, ptb, xyz, xyzt, gpd,
dxf, mns, pts, ptc, tzs, msh, stl, dxfm
-minarea:<n> small area size
-units:<s> measurement unit for output. Values: um, mm, m, in, ft
-amin:<n> minimum intensity value
-aspect:<n> aspect ratio for output.
1 - square grid (default), 0 - keep original aspect.
-subsample:<n> percentage of point to output
-prj:dirname use specified name for project directory
-keepproject save project for later use
-project:dirname use saved project from specified directory
-ignoreerrors ignore processing errors
-info display information on the scan
-log:logfile log file for processing data
-verbose turn on verbose mode, default: off
-ongrid export points on grid
-saveimage:<s> save amplitude picture. Supported formats bmp, gif, jpg, tif,
png. Default - png.
-sph save amplitude picture in spherical coordinates, else in
scanner.
-ZUp z axis is in up direction
Examples.
ProcessC3d -rpr:d:\sc.rpr -c3d:scan.c3d -out:save.out -export:ptx -
filters:filter.xml -hsector:30:210 -keepproject
ProcessC3d -project:Scan001_19.05.2005 -filters:filter.xml -out:save.ptx -
log:f:c3d2ptx.log
109
Appendix
Diagnostic Messages
Following is a list of error and warning messages that could be returned
during the ProcessC3D command execution.
Some error messages may have second line with original systems exception
message.
Also, in case of exception while parsing the command line, the following
information will be displayed:
110
SurphExpress Users Manual
111
Appendix
112
SurphExpress Users Manual
113
Appendix
Default
Filter Name Value Parameter Units Default Value Toggle Parameter Toggle
Points with intensity less than AMin (intensity units) are not exported, but
marked as missed in Export / 3D View.
Points with intensity greater than AMax (intensity units) are not exported,
but marked as missed in Export / 3D View.
114
SurphExpress Users Manual
Points with distance less than DMin (micrometers) are not exported, but
marked as missed in Export / 3D View.
Default value: 0
Default value: 3
Contradictory Data
Data that has been determined to be not reliable (not necessarily wrong, but
might be).
115
Appendix
During the processing the algorithm analyzes the connectivity of the data
points. For the points that belong to small continuous areas there is high
probability that these points are inaccurate. Small Areas filters control the
output of points in small continuous areas.
Intensity Adjustment
AdjustAmp
Controls the Intensity vs. distance correction (for scanners
that have the correction table available in rpr file).
116
SurphExpress Users Manual
Algorithm
Algorithm
Has two possible values: Heuristic 1D for heuristic
algorithm of distance resolution, and Direct is for the direct
algorithm. Heuristic algorithm can work in wide
conditions, including dark areas and minor scanner
movements, but sometimes it gives in result sudden errors
like misplaced parts of surface (usually at the edge). Point
by Point requires more stable scanning conditions and in its
current version fails in dark areas, but the probability of the
wrong result is much less, than for Heuristic.
i
Remote Desktop, GoToMyPC, WebEx, GoToMeeting are Trademarks of their
respective owners
117