Tensor Voting Software Tutorial
How to get the software
We provide free
evaluation version of the 2-D and 3-D software systems on-line. Getting
the software is free and easy:
-
Visit http://iris.usc.edu/~tensorvt
and click on the download link.
-
Enter your name, e-mail, and affiliation in the provided mail form.
-
On submitting the form, you shall get the screen as shown in Figure C.1,
on which there is an installation button. Installation of the software
is just one click away
-
You should also receive by e-mail from our automatic response system the
InstallShield password required for the installation. Now, you can click
the button, and follow the instructions.
Bug reports, feedback and
comments are very welcome, and they can be forwarded to the following e-mail
address: tensorvt@iris.usc.edu.
2-D System
This is a tutorial of the
2-D system that shows the major steps involved in using the software. This
tutorial only shows the most commonly used functionalities. For complete
documentation please refer to the on-line help provided in the 2-D software
system.
Input
Use this option to open an
existing file, or draw an input. The input file can be points, points associated
with tangent, a mixture of them, or end-points. A new window will be created
that displays the input. You can right-click on the window to change the
display settings. Detailed on the input file format, and on the display
setting options are documented in the on-line help.
Edit
You can edit the input by
removing data points and/or adding random outlier noise to it. Figure C.3
shows the noisy input after adding a considerable amount of noisy points.
Again, you can right-click on the window to change display setting.
Tensor
Use this button to display
the encoded tensor, and perform the diffusion step that refines input tokens
as described in chapter 3.
See
Tensor encoding and token refinement. shows the tangents or the stick
components inferred after this step. Other options can be displayed by
right-clicking on the window.
Extract
After the tangent direction
has been estimated, you can use the "Extract" button for curve and junction
extraction, Figure C.5. You can also display the curve and junction saliency
maps by right-clicking the mouse on the active window.
This step corresponds to
the extrapolation step described in chapter 3 for feature extraction.
End-Point
If your input consists of
end-points, use this button for curve inference.
Kernel
This button allows you to
create custom voting field with different scale (sigma values),
See
Utilities.. Try various scale parameters, and use the voting fields
produced in "Tensor" and "Extract" stages.
Save
Results of any stage can
be saved to a file by clicking on the corresponding window, and click the
"save" button (the second button) in the toolbar that is identified by
an diskette icon. Explanation of the file format is also documented in
the on-line help.
3-D System
This is a tutorial of the
3-D system that shows the major steps involved in using the software. Again,
this tutorial only shows the most commonly used functionalities. For complete
documentation please refer to the on-line help provided in the 3-D software
system.
Open
Open an input file using
this button, Figure C.7. A new window will be created that displays the
input. You can right-click on the window to change the display settings.
Detailed on the input file format, and on the display setting options are
documented in the on-line help.
Edit
You can edit the input by
removing data points and/or adding random outlier noise to it. Figure C.8
shows the input from which 10% of the data points has been removed, and
100% noisy points have been added. Again, you can right-click on the window
to change display setting.
Tensor
Use this button to display
the encoded tensor, and perform the diffusion step that refines input tokens
as described in chapter 3. Figure C.9 shows the normals or the stick components
inferred after this step. Other options can be displayed by right-clicking
on the window.
Extract
After the normal
direction has been estimated, you can use the "Extract" button for surface
and curve extraction, Figure C.10. This step corresponds to the extrapolation
step described in chapter 3 for feature extraction.
Utilities
This button allows you to
create custom voting field with different scale (sigma values), Figure
C.11
. Try various scale
parameter and use the voting fields produced in "Tensor" and "Extract."
Save
Results of any stage can
be saved to a file by clicking on the corresponding window, and click the
"save" button (the second button) in the toolbar that is identified by
an diskette icon. Explanation of the file format is also documented in
the on-line help.