Professional Documents
Culture Documents
User’s Manual
Trimble Navigation Limited
Contents
Conventions Used in This Manual ............................................................................................ 9
Features ................................................................................................................................. 13
Typical Workflows................................................................................................................... 15
Accuracy Considerations ........................................................................................................ 19
Angular vs. Linear Scan Resolution................................................................................... 19
Scanner Operating Temperature ....................................................................................... 19
Transparency..................................................................................................................... 19
Reflective Surfaces and Incidence Angles......................................................................... 20
Scanner Dynamic Range and the Gain Factor .................................................................. 20
Maintaining Scanner Calibration Data .................................................................................... 22
Distance Ambiguity Resolution ............................................................................................... 23
Spherical Scanning Operation ................................................................................................ 24
Determining the Scan Volume (Field of View) ................................................................... 24
Spherical Scan Resolution................................................................................................. 24
System Requirements ............................................................................................................ 27
Installing .NET and DirectX .................................................................................................... 28
Installing the FX Controller Application................................................................................... 29
Installing the Trimble FX Controller IEEE 1394 Drivers ..................................................... 35
Installing the IEEE 1394 Drivers in Windows XP .......................................................... 35
Installing the IEEE 1394 Drivers in Windows 2000 ....................................................... 38
Starting the FX Controller Application ................................................................................ 43
Loading an Scanner’s Scan Parameters ................................................................................ 47
Viewing the Scanner Parameters with no Scanner Connected .............................................. 48
Performing a Spherical Scan .................................................................................................. 49
Specifying Spherical Scan Parameters.............................................................................. 49
Selecting the Automatic Processing Option .................................................................. 50
Finding the Zero Index .................................................................................................. 50
Specifying the Scanner’s Reference (0 ) Pan Angle.................................................... 50
Defining the Scan FOV ................................................................................................. 51
Specifying the Scan Resolution .................................................................................... 51
Specifying a Scan Data File Name ............................................................................... 53
Enabling Logging of Scan Processing Details............................................................... 54
Selecting the Scan Configuration and Gain Factor ............................................................ 55
Performing a Scan ............................................................................................................. 55
Interrupting a Scan ............................................................................................................ 56
Resuming an Interrupted Scan .......................................................................................... 57
Setting Processing Parameters .............................................................................................. 61
Defining the Processing Region (Filtering)......................................................................... 61
Setting the Horizontal Angles Filter............................................................................... 61
Setting the Vertical Angles Filter ................................................................................... 62
Viewing Point Information ............................................................................................. 63
Setting the Processing Mode Parameters.......................................................................... 63
2D Processing Parameters ........................................................................................... 65
Setting 2D Pixel Resolution........................................................................................... 66
3D Processing Parameters ................................................................................................ 69
3D Image Data Export ....................................................................................................... 70
5
Contents
6
Contents
7
Conventions Used in this Manual
9
CHAPTER
1
Introduction
In this chapter
Features
Typical Workflows
Introduction
Features
Trimble FX Controller is a powerful 3D modeling application suite designed to
provide:
Scan control and data collection for laser scanners with spherical
scan patterns.
Conversion of the scan data to industry-standard 3D formats for
viewing and/or further processing.
Scan image analysis and filtering.
Built-in 3D scan image viewing and navigation.
13
Chapter 1
User Editable masks are available, allowing you to limit the scan
viewing to an area of interest or according to the scan image
properties.
14
Introduction
Typical Workflows
Following are typical workflows for using FX Controller:
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.
Loading an existing saved project. You can then view the
processed 2D and 3D images, export the processed data to an
industry-standard 3D format, or change the processing parameters
and reprocess the scan data. Loading and reprocessing an existing
project could be faster than the original processing, depending on
how the processing parameters that are changed.
15
CHAPTER
2
Scanning Concepts
In this chapter
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 object’s
surface, lighting conditions, and so on. The processing software uses
sophisticated correction methods to minimize the accuracy loss.
For example, if the nominal distance is specified as 10 ft, then the resolution
is the distance between passes of the laser beam as projected on an object
surface 10 ft away. Using 10 ft as the nominal distance, an object surface 20
ft away would have half the resolution and, at 5 ft, twice the resolution. For
this reason, the closer the specified nominal distance is to the actual object
distance, the more accurate the resolution estimation reported by the
application.
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.
19
Chapter 2
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 object’s degree of transparency by using a laser pointer and
inspecting the spot of the laser beam on the object surface:
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 can seem black to the human eye, but in the red
laser light they are not black. As with transparency issues, powdering the
object can help minimize errors due to the target’s surface reflectance and
incidence angles by scattering the reflected light.
20
Scanning Concepts
The signal intensity can vary due to the target’s surface reflectance, the
incidence angle, and the distance to the target. To obtain accurate distance
readings, the scanner’s dynamic range with proper sensitivity mode
adjustment must be able to cover the actual signal levels being reflected by
the target object or scene.
The 2D Intensity view provides tools to analyze the signal intensities, and
helps locate the areas where the signal level is either too low or too high.
21
Chapter 2
The scan parameter file also can 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 FX Controller application for the first time after installation,
you will select this file to register the scanner’s factory-set parameters with
the application. The application uses the set of scan parameters when
processing scan data to accurately create 3D image data.
22
Scanning Concepts
In the first pass, the scanner performs a full dense coverage of the
object or scene. Using an approximately 7-in. (18-cm) wavelength,
the object distance is identified modulo that wavelength (in other
words, it will not tell apart points that are separated by exactly the
wavelength). This distance is referred to as partial or ambiguous
distance.
The second and third passes (also referred to as auxiliary passes)
use different frequencies and are needed to derive the absolute
distance or, as it is also called, to resolve distance ambiguity.
The internal calculation that determines the actual distance to a point on the
object surface effectively lays out copies of the first pass’ wavelength
segment and the auxiliary wavelength segments. Where the point locations
on the wavelength segments are aligned indicates the distance to the point
on the object surface. This process is referred to as Ambiguity Resolution.
However, on surface areas where the readings are for some reason
inaccurate (e.g., the reflected light intensity is too high or too low), there is a
chance of an incorrect ambiguity resolution, as shown in the following
illustration.
To resolve the absolute distance for all points in the continuous surface
patch, it is sufficient to know absolute distance for only few points on that
patch. This saves time by reducing the resolution on auxiliary passes,
typically by a ratio of 1:5 relative to the first pass. If the scanned object has a
large amount of discontinuous surfaces or you are seeing many ambiguity
errors when using masks in the 2D view, you can specify a lower ratio for the
second and third passes (for example 1:2, or 1:1 for very rough surfaces).
23
Chapter 2
A mirror inside the scanner deflects the laser beam through 360° of
the vertical plane, less a “blind” zone directly below the scanner
head.
The scanner head pans through 190° of the horizontal plane, to
allow some overlap beyond 180° for internal diagnostics. Because
the internal mirror is deflecting the laser beam in front of and behind
the scanner, the full 360° of the horizontal plane is covered with 20°
overlap.
Prior to starting the scan operation, you use controls in the FX Controller
application to set the scan volume, or field of view (FOV), by:
24
CHAPTER
3
Trimble FX Controller
Application Installation
In this chapter
System Requirements
Running the FX Controller application has the following system requirements.
27
Chapter 3
28
Trimble FX Controller Application Installation
1. Make sure that .NET 2.0 runtime and DirectX 9.0B have been
installed, in that order.
2. Insert the FX Controller USB Protection Device into a USB port on
the PC.
Note: The FX Controller USB Protection Device must be inserted at all times
when running the FX Controller application.
29
Chapter 3
30
Trimble FX Controller Application Installation
From this screen you can change the default path for the installation
destination by modifying the path in the Folder field, or clicking the
Browse button and navigating to it.
You can also determine who have access to the FX Controller program:
31
Chapter 3
10. Once you have selected the desired installation options, click Next.
You are prompted to confirm the installation.
11. To start the installation process, click Next. The software installs.
32
Trimble FX Controller Application Installation
33
Chapter 3
12. After reading the release information, click Next. The final
installation screen displays.
34
Trimble FX Controller Application Installation
3. Click the Next button. You are prompted to choose your search and
installation options.
35
Chapter 3
4. Select the Search for the best drive in these locations and the
Include this location in the search options.
5. Then click the Browse button. The Browse for Folder dialog box
displays.
36
Trimble FX Controller Application Installation
37
Chapter 3
1. Make sure that the scanner is connected to an IEEE 1394 port on the
PC.
2. Switch on the scanner. When the PC detects the scanner, it starts the
Found New Hardware Wizard, prompting you to start the driver
installation process.
38
Trimble FX Controller Application Installation
3. Click the Next button. The Install Hardware Device Drivers screen
displays.
39
Chapter 3
8. Click the Browse button. The Browse for Folder dialog box displays.
40
Trimble FX Controller Application Installation
41
Chapter 3
42
Trimble FX Controller 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.
43
CHAPTER
4
Scanning
In this chapter
Under either of these conditions, the application will prompt you to locate the
instrument parameter file for the corresponding scanner.
Tip: You can also initiate the loading of an instrument’ scan parameters file.
47
Chapter 4
To View the Parameters for a Scanner that is not Connected (or not Online):
1. Select the File > Test Scanner Parameters menu option. The
Choose Description File For Scanner dialog opens.
The scanner’s parameters are loaded and can be viewed and edited in
the Scan tab.
48
Scanning
Note: The scanner must be connected to the PC and turned on for the scan
parameters to be enabled.
49
Chapter 4
If you choose to automatically process the data after scanning, you need to
set the processing parameters before starting the scan operation. For more
information, refer to “Creating 2D and 3D Image Data”. Otherwise, the
processing will be performed with the default parameters. If the
Automatically Process After Scan option has not been chosen, the user
needs to manually process by clicking on the Process button.
1. Enter a value in the filed below the Current Angle. The default unit
of measurement is set to degree and you don’t have to enter “°”.
2. Or use the Up (or Down) button to set a value. The current value will
be incremented (or decremented) from one to one (in degree).
3. Then, click on the button.
If the value is positive, the scanner will move from left to right
from the current angle position to the new angle position (the
one set previously). This new angle position becomes after
moving the current angle.
50
Scanning
To Reset the Reference Angle to the Current Pan Position of the Scanner:
Full Volume Scan: The entire volume will be scanned. Note that a
full volume scan is not 360 degrees but 365 degrees.
Sector Scan: The sector defined in the Left and Right pan angle
measures will be scanned. For a sector scan, the Left and Right
pan angles are measured clockwise relative to the reference (0°)
angle.
Note: The left sector angle should be less than the right sector angle. Trying
to set the left value upper than the right value will open a warning dialog.
51
Chapter 4
1. Click on the Modify button in the Scan tab. The Scan Parameters
(Spherical) dialog box appears.
52
Scanning
53
Chapter 4
Check the Detailed Log option at the lower left corner of the Scan
tab.
54
Scanning
Performing a Scan
When you have completely set the scan parameters, you are ready to start
the scan operation. Scan times vary depending on the FOV (Scan Sector)
and density resolution. Typical scans take 5 to 20 minutes. The estimated
scan time and size of the scan data file are displayed in the Scan tab.
55
Chapter 4
Interrupting a Scan
This function can be used whenever required, especially when you notice that
the FOV is not correct (or for safety reasons).
Click the Stop button. The scan parameters in the Scan tab
becomes then active
56
Scanning
57
CHAPTER
5
Creating 2D and 3D Image Data
In this chapter
61
Chapter 5
Full Scan: This option processes across the entire 360° horizontal
plane.
Sector: This option processes only a sector of the full horizontal
plane, as defined by the degree values in the Left and Right fields.
Left and Right angles are defined relative to the scan’s reference
(0°) angle.
Front: This option processes only 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: This option 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: This option processes only the scan data from both the front
and 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.
62
Creating 2D and 3D Image Data
63
Chapter 5
64
Creating 2D and 3D Image Data
2D Processing Parameters
The 2D Processing panel includes the options described in the table below.
Options Description
65
Chapter 5
66
Creating 2D and 3D Image Data
From the Select Image Resolution dialog box, do one of the following:
67
Chapter 5
2. After setting the resolution and nominal distance, click OK. The
Image Resolution Units dialog closes.
3. When you are done changing the resolution settings, click OK in the
Select Image Resolution dialog to save them and close the dialog.
68
Creating 2D and 3D Image Data
3D Processing Parameters
Options Description
69
Chapter 5
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.
Options Description
Force Export in File Select this option to export the 3D image data to a file as
part of the image processing. By default, the exported file
will share the same name than the scan with TZS (or PTX
and PTS) as extension*.
70
Creating 2D and 3D Image Data
Cloud/Mesh Selected the data type in which the 3D image data will be
exported.
Select the Keep Project option if you want to save the current image
processing parameters and filters as a project that can be reloaded later.
Saving the project this way will allow for faster loading of data and faster
reprocessing when the project is reloaded.
That project folder will contain several bsw files, one cloud file (with ptb
extension) and one project file (with XML extension).
71
Chapter 5
Options Description
Distance Resolution
72
Creating 2D and 3D Image Data
Options Description
X+L
X-L
73
Chapter 5
1. Select the File > Export/Import > Import Preferences menu option.
The Choose File to Export dialog opens.
2. Navigate to the drive/folder where the preferences file is located.
3. Click Save. The Choose File to Export dialog closes.
4. Click on the file to select it.
5. Click Open.
The scanning and image processing parameter settings are loaded and can
be viewed and edited in the Scan tab.
74
Creating 2D and 3D Image Data
75
Chapter 5
If the scan data from a spherical scan is going to be too large to process in
one portion due to memory restrictions, the application will automatically use
batch processing. With batch processing, portions of the scan data are
processed in stages. You can check the status of the batch processing in the
Log window.
If the Keep Project option in the Processing Modes tab has not
been selected, this project folder is temporary. Leaving the FX
controller application will delete that project folder.
If the Keep Project option in the Processing Modes tab has been
selected, the project folder is persistent.
To stop processing, click the Stop button in the toolbar. If you do stop the
processing, the current processing parameters are saved as well as the
partial image data. This saves processing time if you decide to reprocess the
scan data and the image data will not be affected by any settings changes
you made. In the case, the project folder is empty of contents. To resume the
processing, you need to click again Process.
76
Creating 2D and 3D Image Data
If the Show Express View option in the Processing Modes tab has been
selected, an express view window (called Mask Edit window) appears after
the initial pass of image processing. For more information, refer to “Express
View”.
For information about how to view the displayed 2D and 3D image data
images, refer to “Viewing Image Data”.
Express View
If the Show Express View option on the Processing Modes tab is selected,
then FX Controller will perform an express processing of the scan data and
display a preview of the processed 2D image data in a Mask Edit window.
This preliminary view of the processed image data allows you to:
77
Chapter 5
If the Keep Project option has not been chosen, only one bws file,
If the Keep Project option has been chosen, two bsw files and one
project file (with xml extension).
78
Creating 2D and 3D Image Data
Tool Description
79
Chapter 5
Note: The 2D grid’ size cannot exceed 100 pixels and you need to check
Show Grid option if you want to view the change you performed.
To Display/Hide a 2D Grid:
80
Creating 2D and 3D Image Data
Setting Background
81
Chapter 5
Editing Marks
82
Creating 2D and 3D Image Data
Markers
83
Chapter 5
Click the Regen 2D (or the Regen 3D) button in the toolbar.
Or you can also use the Regen buttons on the Processing Modes
tab.
84
CHAPTER
6
Viewing Image Data
In this chapter
87
Chapter 6
To: Do This:
Click and drag in the direction you want to pan. Whe 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.
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 the
3D image data processing. 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” and “Setting the
Visibility Rank for Filter Layers”.
Tool Description
88
Viewing Image Data
The drawing tool controls on the Options tab allows you to set parameters
that control the behavior of the masking tools.
Sets Pen size (in pixels)
89
Chapter 6
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.
To zoom on the image, click the or buttons. The current
Zoom factor is displayed above these buttons.
90
Viewing Image Data
1. Select the View > 3D Options > Background Color menu option.
2. Or select the View > 3D Options > Foreground Color menu option.
For both, the standard Windows Color dialog opens.
91
Chapter 6
1. Select the View > 3D Options > Light menu option. The standard
Windows Light dialog box displays.
92
Viewing Image Data
Orthogonal mode
93
Chapter 6
Tip: The Settings dialog window can be opened by selecting Settings from
the pop-up menu.
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.
94
Viewing Image Data
95
Chapter 6
Contrast controls
Brightness controls
96
Viewing Image Data
1. First open the Settings dialog window (if not done). The Min and
Max intensity values are initially equal to 0.
2. Click GetInfo. The Min and Max intensity values are displayed.
1. Set the Min value by dragging and dropping the Min slider.
2. Set the Max value by dragging and dropping the Max slider.
3. Click Set.
The Z axis points from the viewer and is perpendicular to the screen
plane.
The X, Y plane is left-handed and is parallel to the screen plane: X
axis points to the left. Y axis points to the top of the screen.
97
Chapter 6
1. Click on the Navigation tab on the left side of the View panel. The
Navigation dialog window opens.
98
Viewing Image Data
Setting Description
Shift: Step Specifies how many millimeters to shift by when using the
Shift controls
Shift: Auto repeat Specifies the step multiplier for multiple key presses when
multiplier using the keyboard-based Shift control.
Rotate: Step Specifies how many degrees to rotate by when using the
Rotate controls
Zoom: Step Specifies the zoom factor to use when zooming.
Zoom: Auto repeat Specifies the zoom step multiplier for multiple key presses
multiplier when using the keyboard-based Zoom control.
Toolbar: Auto repeat Determines the frequency of auto repeating when clicking
multiplier and holding on a toolbar control.
In Walkthrough mode, your point of view is, by default, at the origin of the
scan. The View Direction controls point your view to different directions from
the origin.
Face Left
Face Right
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.
99
Chapter 6
Left
Front Top
Rear Bottom
Right
Rotate around
the Y axis
100
Viewing Image Data
1. Assign a center-of-rotation.
2. Click Show/Hide Center in the Center-of-Rotation Point
toolbar. A red cross appears over the 3D image.
101
Chapter 6
Tip: You can also check (or uncheck) the Show Center option in the Camera
(red) panel which appears after clicking on the Cameras tab.
Zoom out
102
Viewing Image Data
Rotate the camera Click and drag the pointer with the left mouse button. .
around the 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 Hold the X key as you click and drag the pointer. .
around the X and Y
axes.
Rotate the camera Hold the Z key as you click and drag the pointer. .
around the Z axis, and
move the camera along
the Z axis (POV moves
with the camera).
Shift the camera along Left and Right Arrow keys.
the X axis.
Shift the camera along Up and Down Arrow keys.
the Z axis (POV moves
with the camera
Shift the camera along Use the Shift + Up and Shift + Down keys.
the Y axis
Shift the camera along Up and Down Arrow keys.
the Z axis (POV does .
not move with the Or
camera)
Hold the Ctrl key as you click and drag the pointer.
Zoom in and out Page Up and Page Down keys.
Or
Hold the Shift and Ctrl keys, and click and drag the
pointer.
103
Chapter 6
Rotate the camera Click and drag the pointer with the left mouse button.
around the X and Y
axes
Rotate the camera Hold the X key as you click and drag the pointer. .
around the X axis
Rotate the camera Hold the Y key as you click and drag the pointer. .
around the Y axis
Rotate the camera Hold the Z key as you click and drag the pointer. .
around the Z axis
Shift the camera along Use the Left and Right Arrow keys.
the X axis
Shift the camera along Use the Shift + Up and Shift + Down keys.
the Y axis
Shift the camera along Up and Down Arrow keys.
the Z axis (POV does
not move with the Or
camera)
Hold the Ctrl key as you click and drag the pointer.
Zoom in and out Hold the Shift and Ctrl keys and click and drag the pointer.
Wireframe
104
CHAPTER
7
Exporting and Saving Image
Data
In this chapter
FX Controller 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.
The Background and mask filter parameters are set in the Export Filters tab
in the Settings window.
107
Chapter 7
108
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.
109
Chapter 7
To Set the Background Intensity Min and Max Values Using the Histogram:
1. Right-click on Intensity.
2. Then select Show List from the pop-up menu. The Brightness Hist
dialog box displays.
110
Exporting and Saving Image Data
3. Use the sliders to set the Min (bottom slider) and Max (top slider)
values.
4. Then click OK to save your changes.
111
Chapter 7
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.
112
Exporting and Saving Image Data
Background Parameters
The following table explains each of the Background parameters.
Setting Description
113
Chapter 7
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”.
Filter Description
Contradictory Data Data that has been determined to be not reliable (not
necessary wrong, but might be).
Distance High Points at or greater than this distance are included in this
mask.
Distance Low Points at or less than distance are included in this mask.
Export Mask A combination of all the other masks, marked to be used for
3D image data export. This mask shows all of the data that
would not be included.
Gaps Transitional areas between contiguous patches on the
target surface. The value field is the thickness of the line
used to indicate a gap.
Insufficient Data During one of the scan passes, these areas were covered
or obscured.
Intensity Max Pixels at or above this value will be included in this mask.
Intensity Min Pixels at or below this value will be included in this mask.
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.
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:
114
Exporting and Saving Image Data
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.
115
Chapter 7
The mask filter parameters are explained in the following table. Note that not
all parameters are used with each filter type.
Parameter Description
You can specify where in the stack of Background and Mask filter layers a
particular filter will be placed. Layers lower in the stack will be hidden by
layers higher in the stack.
116
Exporting and Saving Image Data
After clicking the Hide All button, the visibility rank for all layers becomes 0.
After clicking the Show All button, the visibility rank for all layers returns to
their previously set values.
117
Chapter 7
For a description of the filters file XML format and a description of the filter
parameters that are defined in it, refer to “XML Filter File Format and
Parameters”.
1. Select the File > Export/Import > Export Filters menu option.
2. You are prompted to specify a location and name for the file.
1. Select the File > Export/Import > Import Filters menu option.
2. You are prompted to locate and open the file.
118
Exporting and Saving Image Data
119
Chapter 7
1. Select the File > Save Bitmap > Bitmap Only (or Bitmap and
Distance Map) menu option. The Choose Bitmap File dialog box
opens with the default folder /Documents and Settings/user
subfolder/Application Data/Surphaserversion/C3Dfiles folder
selected.
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”.
120
Exporting and Saving Image Data
121
Chapter 7
The supported formats are listed and described in “Supported 3D Export File
Formats”.
122
Exporting and Saving Image Data
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
page 60. By the default 3D image files are stored to /Documents and
Settings/<user subfolder>/Application Data/Surphaser/C3Dfiles folder.
123
Chapter 7
This allows the settings to be retained and then loaded for the next scan
session. If for some reason the preference files in the FX Controller
application directory are deleted or become corrupted, the application will
revert to the default settings.
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. However, unless you select the Keep Project option on the
Processing Modes tab, these settings and image data are not permanently
saved if you start another scan, open another project, or exit the application.
Selecting the Keep Project option allows you to load the project at a later
time to continue working on it. If the project is being kept, FX Controller
creates the following files and subfolder in the project folder:
124
Exporting and Saving Image Data
1. Select the File > Load Project menu option. The Browse for Folder
dialog box opens.
125
Chapter 7
Click the New Scan button in the toolbar. The previous parameter
settings and image data are flushed from application memory.
Note that the scanner must be online, as indicated in the Scan tab in the
Settings window, to start a new scan.
1. Select the File > Load Scan menu option. The Browse for Folder
dialog box opens.
126
CHAPTER
8
Troubleshooting
Exporting and Saving Image Data
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.
In addition to status reported to the Log window, the application saves more
extensive status information about session activity to a log file. The path of
the log file is shown at the top of the scrollable list in the Log window. Service
personnel will use the scan data files and the log file when diagnosing
problems with the application.
129
CHAPTER
9
Appendix
In this chapter
bpd Cloud Point Spherical Binary ptx (format was developed in Bitwise).
pts Cloud Point Spherical Cyra Cyclone format - unorganized 3D image data
with intensity values.
ptx Cloud Point Spherical Cyra Cyclone format - gridded 3D image data.
ptxx Cloud Point Spherical Ptx with the interpolated amplitude added.
133
Chapter 9
Argument Description
134
Appendix
Argument Description
135
Chapter 9
Usage:
ProcessC3d [options...]
-prv:prvfile 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:360 (integer, degrees)
-vsector:Lo:Hi low and high boundaries for image
processing
Default is -90:90 (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, BPD, PTB, XYZ
-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
------ Parameters used for BPD format only ------
-bpdfilter BAD POINTS will be displayed in a solid color
(BLUE)
-bpdnormalize turn on intensity normalization for the
scene
-bpdrange:<n> maximum distance (in feet) to be kept in
file.
Floating point value, default: 1000.0
-bpdoffset:<n> intensity boost value. Integer value,
default: 0
Examples.
136
Appendix
137
Chapter 9
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 system’s exception message.
Also, in case of exception while parsing the command line, the following
information will be displayed:
138
Appendix
139
Chapter 9
<PARAMETERS>
<SECTION NAME="Filters">
<PRMELEMENT NAME="PF_AMax">19500</PRMELEMENT>
<PRMELEMENT NAME="PF_AMin">200</PRMELEMENT>
<PRMELEMENT NAME="PF_LMax">100000000</PRMELEMENT>
<PRMELEMENT NAME="PF_LMin">0</PRMELEMENT>
<PRMELEMENT NAME="RU_FilmWidth">0.001</PRMELEMENT>
<PRMELEMENT NAME="PF_MinArea">1600.0</PRMELEMENT>
<PRMELEMENT NAME="PF_UseAMax">False</PRMELEMENT>
<PRMELEMENT NAME="PF_UseAMin">True</PRMELEMENT>
<PRMELEMENT NAME="PF_UseZMax">False</PRMELEMENT>
<PRMELEMENT NAME="PF_UseZMin">True</PRMELEMENT>
<PRMELEMENT NAME="PF_UseGaps">True</PRMELEMENT>
<PRMELEMENT NAME="PF_UseCtrData">False</PRMELEMENT>
<PRMELEMENT NAME="PF_UseInsData">False</PRMELEMENT>
<PRMELEMENT NAME="PF_UseMinArea">True</PRMELEMENT>
</SECTION>
<SECTION NAME="Point Cloud">
<PRMELEMENT NAME="Traces_AdjustAmp">True</PRMELEMENT>
<PRMELEMENT NAME="Traces_UseIntrDist">True</PRMELEMENT>
</SECTION>
<SECTION NAME="Make Scan">
<PRMELEMENT NAME="ResolveAmbAlgorithm">Hybrid</PRMELEMENT>
<PRMELEMENT NAME="RU_CorrectPasses">1</PRMELEMENT>
</SECTION>
</PARAMETERS>
140
Appendix
Points with intensity less than AMin (intensity units) are not exported, but
marked as “missed” in PTX.
PF_AMin Defines minimum intensity in Amplitude Units.
-amin command line argument supersedes the PF_AMin value.
Default value: 200
PF_UseAMin If True, use AMin filter in export; if False, ignore.
Default value: False
Points with intensity greater than AMax (intensity units) are not exported, but
marked as “missed” in PTX.
PF_AMax Defines maximum intensity in Amplitude Units.
Default value: 1950
PF_UseAMax If True, use AMax filter in export; if False, ignore.
Default value: False
141
Chapter 9
Points with distance less than LMin (micrometers) are not exported, but
marked as “missed” in PTX.
PF_LMin Defines minimum distance in micrometers.
Default value: 0
PF_UseZMin If True, use LMin filter in export; if False, ignore.
Default value: True
Points with distance greater than PF_LMax (micrometers) are not exported,
but marked as “missed” in PTX.
PF_LMax Defines maximum distance in micrometers.
Default value: 100000000
PF_UseZMax If True, use ZMax filter in export; if False, ignore.
Default value: False
RU_FilmWidth
The gap width in radians.
Default value: False
PF_UseGaps If true, the gaps are marked for exclusion.
Default value: 0.001
Contradictory Data
Data that has been determined to be not reliable (not necessarily wrong, but
might be). Contradictory data result from the following sources:
Semitransparent surfaces (glass window with objects behind it)
Transitional areas where some data may be taken from different
distances
Saturation resulting in significant (more than few millimeters)
distortion of distance data
Multiple scattering /reflection
Objects moving between passes
Very dark (or far) objects
PF_UseCtrData
Toggles application of contradictory data filter.
Default value: False
Insufficient Data
Insufficient data condition arises when some of the auxiliary passes ended
prematurely or data was lost due to other reasons.
PF_UseInsData
Toggles application of “Insufficient data” filter.
Default value: False
142
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.
PF_MinArea Defines the size (in angle minutes^2) of minimal continuous area
that will be affected by this filter.
–minarea command line argument supersedes PF_MinArea value.
Default value: 200
PF_UseMinArea
Toggles application of “Small areas” filter.
Default value: True
Intensity Adjustment
Traces_AdjustAmp
Controls the Intensity vs. distance correction (for scanners that have the
correction table available in prv file).
Default value: True
Traces_UseIntrDist
Traces_UseIntrDist
If true, filters out points from the pixels with large intrapixel variation of
distance.
Default value: True
ResolveAmbAlgorithm
ResolveAmbAlgorithm
Has two possible values: Hybrid is for heuristic algorithm of distance
resolution, and Point by Point is for the direct algorithm. Hybrid 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 Hybrid.
Default value: Hybrid
143
Chapter 9
RU_CorrectPasses
RU_CorrectPasses
Filter is intended to compensate Pan encoder errors and minor tripod shifts
between passes. The parameter has the following possible values:
144
Index
Index
145
Index
146
Index
147