Difference between revisions of "PhoXi Control Application"

From 3D scanning Knowledge base - Photoneo wiki
Jump to: navigation, search
(Retrieving intrinsic parameters of the scanner)
(Retrieving intrinsic parameters of the scanner)
Line 24: Line 24:
 
Extract the zip file and follow the README.txt file.
 
Extract the zip file and follow the README.txt file.
  
 
The camera matrix values are written in succession by rows from left to right.
 
The distortion coefficients are in the order k1,k2,p1,p2,k3. The rest are zeros.
 
All values in length are in millimeters.
 
 
All of the coefficients are compatible with the OpenCV standard, you can read about the OpenCV standard [https://docs.opencv.org/2.4/modules/calib3d/doc/camera_calibration_and_3d_reconstruction.html here]
 
All of the coefficients are compatible with the OpenCV standard, you can read about the OpenCV standard [https://docs.opencv.org/2.4/modules/calib3d/doc/camera_calibration_and_3d_reconstruction.html here]
  

Revision as of 15:09, 27 November 2018

PhoXi Control Application: Downloads and information

Known issues

  • Intel HD 3000 graphic card - the driver should be updated so it supports OpenGL extension GL_EXT_gpu_shader4

FAQ

How do I save the point cloud?

To save the current point cloud, use the button "SavePointCloud" in the top panel. The file will be stored in selected file format. To choose what data will be stored in the file, click "Recording options" button and then button "Options" next to the desired file format.

Most general file format is PLY. Useful data to save are PointCloud, NormalMap, Texture and use BinaryFormat.

When you want to save all information about the scan, use Photoneo's Raw data format.

To automatically store every captured frame, use the "Record" button. Point clouds will be saved in the directory and file formats set in "Recording Options".

Retrieving intrinsic parameters of the scanner

Download the following zip file for Windows here.

Download the following zip file for Ubuntu here.

Extract the zip file and follow the README.txt file.

All of the coefficients are compatible with the OpenCV standard, you can read about the OpenCV standard here

Using script to set the IP address for a Photoneo PhoXi 3D Scanner with firmware v1.1.x

If you need to set the IP address for a scanner with firmware v1.1.x and all you have is a Ubuntu PC (16.04) with avahi-tools installed you can do so using the phoxi_3d_scanner_set_ip.sh script. The script works also on the scanner itself. To set static IP address use it like this:

./phoxi_3d_scanner_set_ip.sh 2018-08-011-LC3 1 10.0.0.10 10.0.0.1 255.255.255.0 10.0.0.1

If you want to set dynamic address:

./phoxi_3d_scanner_set_ip.sh 2018-08-011-LC3 1 dhcp


The second parameter, CHANGE_REQUEST_ID, is a sequential integer number that needs to be incremented with each subsequent change. To find out what is the current value use the avahi-browse tool, for example:

$ avahi-browse -r -t _3d-camera._tcp 

The terminal will show the following output:

+ enp0s31f6 IPv4 PhoXi3DScan-2018-08-011-LC3                   _3d-camera._tcp      local 
= enp0s31f6 IPv4 PhoXi3DScan-2018-08-011-LC3 _3d-camera._tcp local
hostname = [ytrium1.local]
address = [10.0.0.10]
port = [65499]
txt = ["Occupied_By: ::ffff:10.0.0.1" "changeId: 2" "version: 1.1.62" "status: Occupied" "description: Photoneo 3D Scanner" "id: 2018-08-011-LC3"]

So in this case we would use value 3 in next change IP request.

Scanning reflective materials

PhoXi 3D scanner uses diffuse reflection of the projected 3D pattern to reconstruct the surface of objects.

The following scheme depicts the difference between a beam reflected diffusely and specularly.

Diffuse.png

(source: Wikipedia )

In general, there are two main reasons for lower quality 3D reconstruction of reflective surfaces:

1) Reflective materials prevent diffuse reflection, this causes the projected laser pattern to have lower contrast between the dark and light stripes.

2) Interference, the specularly reflected laser pattern interferes with the diffusely reflected laser pattern and leads to incorrect pattern perception.

The following can be done to increase the quality:

1) Try changing the scanning angle, if the scanner is scanning the object from the side move it so that it is directly above the scanned object. This will cause more beams that are totally reflected to not be reflected back to the camera unit and therefore, not interfere with the diffusely reflected laser pattern. In general, the best method to get the best scan through trial and error and finding the optimal scanning position.

2) If sides the bin in which the object is inside of is reflective, then this utility can be used. (Please follow the README.txt, incorrect use of this utility can cause your scanner to be improperly calibrated) It will narrow the range of the projected laser pattern and therefore the red beam shown in the picture below will not be projected.

Draft 2.png

Corrupted Image Error

If during your scanning you are not able to get scans because "Image was corrupted" error, in most cases, this is caused when the coordinate space is set to markerspace and recognize markers is turned on, even though there is no marker pattern in the scene.

Imagecorr.png

Be sure that you have set these settings.

Cameraspace.png

Also, the second most common cause, is due to slow ethernet connection. The scanner requires a 1Gbit/s connection.

You can test your connection speed in PhoXi Control v1.2.X.

Testspeed.png

With 1Gbit connection your speed should be around 100MB/s.

How do I change settings of the scanner using API?

From PhoXi API v1.2.X and with Firmware v1.2.X it is possible to change scanning parameters using the API. The modified FullAPIExample that shows how this is done can be found here.

The resulting point cloud contains artefacts

To remove noise artefacts from the scene, it is recommended using this (Ubuntu this) utility, which to turns on the guided filter. You can read about the guided filter here . For more advanced users, you can also modify the input values for the guided filter and also the bilateral filter. You can download the advanced utility here (Ubuntu here). You can read about the bilateral filter here.

Upgrading firmware on your scanner

This method only works with PhoXiControl release candidate v1.2.3 or higher and with scanner firmware v1.1.62 or higher. DO NOT USE THIS GUIDE, if your firmware version is lower than v1.1.62 (If you would like to upgrade firmware lower than v1.1.62 contact us at support@photoneo.com)

1) Contact us at support@photoneo.com and we will provide you with a .deb file, this is the installer for the firmware.
2) Open PhoXiControl and connect to the scanner you want upgrade your firmware on.
3) Click on the tools pane at the middle of the toolbar (it is represented by a wrench icon)

Pane 2.png

4) The following window will open, find the .deb file on your computer, then click open.

Fw upg 3.png

5) The cofirmation window will pop-up and your scanner will restart and upgrade.

Restart.png

Connecting multiple scanners to one computer

Using PhoXi Control

In PhoXi Control it is possible to connect to two scanners at the same time and trigger the scans one after another.

Connect to the first scanner, then click menu -> network discovery and then click the second scanner you want to connect to. You will then have two tabs as you can see in the picture below and then you can change between the two tabs by clicking on them. Pane wiki.png

Using the PhoXi API

Connecting mutliple scanners can also be done using the PhoXi API, you can download the example code for this here.

Important points to note are: 1) Define SCANNER_HWID_1 and SCANNER_HWID_2 to the correct Hardware identification strings of your scanners

2) Do not attempt to create 2 instances of pho::api::PhoXiFactory, instead create just 1 factory and call CreateAndConnect method twice to get 2 pointers to different scanners

Make PhoXi Control automatically connect to a specific scanner

You can download this utility, which will allow you to run PhoXi Control and automatically connect to one specific scanner. Please follow the readme.txt. The utility uses the PhoXi API and the source is included in the .zip file.