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:
  1. Visit http://iris.usc.edu/Projects/tensorvt/tensorvt.html and click on the download link.
  1. Enter your name, e-mail, and affiliation in the provided mail form.
  2. 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
  3. 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.