Skip to content

Commit

Permalink
update documents and remove evaluation.py
Browse files Browse the repository at this point in the history
  • Loading branch information
syncle committed Jul 12, 2018
1 parent 4654603 commit 0d98d5d
Show file tree
Hide file tree
Showing 3 changed files with 13 additions and 145 deletions.
20 changes: 13 additions & 7 deletions readme.md
Expand Up @@ -55,18 +55,20 @@ We have provided a synthetic dataset in the [dataset](dataset) folder. For examp
> FastGlobalRegistration/FastGlobalRegistration \
../dataset/pairwise_noise_xyz_level_02_01_rot_05/features_0000.bin \
../dataset/pairwise_noise_xyz_level_02_01_rot_05/features_0001.bin \
output.txt
../dataset/pairwise_noise_xyz_level_02_01_rot_05/output.txt
```

### Evaluation
To evaluate the output transformation, use [evaluate.py](source/Toolbox/evaluate.py) from the Toolbox folder.
To evaluate the output transformation, use [evaluation program](source/FastGlobalRegistration/evaluation.cpp).
```
> python evaluate.py \
../../dataset/pairwise_noise_xyz_level_01_01_rot_05/output.txt \
../../dataset/pairwise_noise_xyz_level_01_01_rot_05/gt.log \
../../dataset/pairwise_noise_xyz_level_01_01_rot_05/gt.info
> FastGlobalRegistration/Evaluation \
../dataset/pairwise_noise_xyz_level_02_01_rot_05/features_0000.bin \
../dataset/pairwise_noise_xyz_level_02_01_rot_05/features_0001.bin \
../dataset/pairwise_noise_xyz_level_01_01_rot_05/gt.log \
../dataset/pairwise_noise_xyz_level_01_01_rot_05/output.txt \
../dataset/pairwise_noise_xyz_level_01_01_rot_05/output_eval.txt
```
The evaluation method follows the protocol defined in [this page](http://redwood-data.org/indoor/registration.html).
Evaluation program will write RMSE in output_eval.txt. The error in the Table 1 shows half of average RMSE.

### Creating input

Expand Down Expand Up @@ -120,5 +122,9 @@ We measure distance relative to the diameter_of_model if **USE_ABSOLUTE_SCALE**

FastGlobalRegistration has a Matlab binding courtesy of Jordi Pont-Tuset. It can be used seamlessly with the compilation tool chains mentioned above. Follow instructions provided by CMake if you need to make additional configuration for MATLAB_ROOT environment variable. To use the Matlab binding, execute [fgr_demo.m](source/Matlab/fgr_demo.m) from source/Matlab.

### Using Open3D

This repository is maintained for providing standard alone FastGlobalRegistration application reproducing the results in the published paper. Open3D has end-to-end implementation used for FastGlobalRegistration - including point cloud I/O, feature extraction, and FastGlobalRegistration module in one place. For more details, please follow [this tutorial](http://open3d.org/docs/tutorial/Advanced/fast_global_registration.html).

### Troubleshooting
If you encounter issues with FGR, please check [troubleshooting.md](troubleshooting.md)
8 changes: 0 additions & 8 deletions source/FastGlobalRegistration/app.cpp
Expand Up @@ -488,12 +488,6 @@ double CApp::OptimizePairwise(bool decrease_mu_, int numIter_)
Eigen::Matrix4f delta = aff_mat.matrix().cast<float>();

trans = delta * trans;

//// transform point clouds
//Matrix3f R = delta.block<3, 3>(0, 0);
//Vector3f t = delta.block<3, 1>(0, 3);
//for (int cnt = 0; cnt < npcj; cnt++)
// pcj_copy[cnt] = R * pcj_copy[cnt] + t;
TransformPoints(pcj_copy, delta);

}
Expand Down Expand Up @@ -571,7 +565,6 @@ Eigen::Matrix4f CApp::ReadTrans(const char* filename)
return temp;
}


void CApp::BuildDenseCorrespondence(const Eigen::Matrix4f& trans,
Correspondences& corres)
{
Expand Down Expand Up @@ -606,7 +599,6 @@ void CApp::Evaluation(const char* gth, const char* estimation, const char *outpu
std::vector<std::pair<int, int>> corres;
Eigen::Matrix4f gth_trans = ReadTrans(gth);
BuildDenseCorrespondence(gth_trans, corres);
//visualize_matching(corres, m, nFrames);
printf("Groundtruth correspondences [%d-%d] : %d\n", fi, fj,
(int)corres.size());

Expand Down
130 changes: 0 additions & 130 deletions source/Toolbox/evaluate.py

This file was deleted.

0 comments on commit 0d98d5d

Please sign in to comment.