Scan tutorial

Ensure Java 1.8 is installed on your system in a terminal:

If not, see the FAQ

Run the Scan installer by double clicking on it.

Open a terminal, change directory to where AMAPstudio is installed, then :

• under windows, type 'scan'
• under Linux or Mac, type 'sh scan.sh'

You may build a shortcut on your desktop to start Scan faster.

File > Import a scan > choose a file to be imported

e.g. format (extract):

Edit > Sub sample

Choose the max number of points of the complete scan to be rendered to get a responsive user interface.

Note: this is only for viewing, all algorithms hereafter are run on the complete scan

Note : Scan is based on OpenGL and advanced viewing techniques, but sub sampling is generally interesting to be able to load big scans and keep a responsive user interface. Scan was built to work on a single plant / tree point cloud at a time.

File > Import a SimpleTree CSV

Select one of the viewing tools and click / drag in the 3D view

Select the focus tool in the lateral bar

Select a focus sphere by clicking its center then dragging the mouse for the chosen radius. On click release, the view is restricted to the inside of the sphere

Right click or click unfocus to unfocus.

Select the 'Add a vertex' tool

Click at the center of a branch and drag the mouse to the border of the branch, then release the mouse button → a vertex is added in the topology according to the current strategy and gesture

Options:

• Rerun the same strategy with a lower / larger radius by clicking on the '-' and '+' buttons to check is the result is better
• Select an alternative strategy then click the refresh button

Select the 'Add edges' tool

Click on the first vertex, then on the second, third… Finish the gesture by a right click.

Choose the 'Selection' tool, click on th edge / vertex, then press the 'Delete' key or click on the trash button.

To undo your action, press Ctrl-Z. To redo your action, press Ctrl-Y.

Use the 3D view configuration button: to open the configuration dialog

Click on the render line to configure the rendering for a given type

e.g. select the 'Edge' line, right click on it and choose the 'Cylinder renderer'

Select an edge to be set as a ramification on its bearer edge, then chose the 'Ramification' tool .

Select the Edge and press 'Delete'

Undo available: Ctrl-Z

Select an edge and chose the saw tool

Undo available: Ctrl-Z

Choose File > Save project if you want to reopen it later in Scan with 'Open project'.

Choose File > Export OPF File if you want to reopen the topology later in Xplo.