1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166
|
.. _reconstruction_system_make_fragments:
Make fragments
-------------------------------------
The first step of the scene reconstruction system is to create fragments from
short RGBD sequences.
Input arguments
``````````````````````````````````````
The script runs with ``python run_system.py [config] --make``. In ``[config]``,
``["path_dataset"]`` should have subfolders ``image`` and ``depth`` to store the
color images and depth images respectively. We assume the color images and the
depth images are synchronized and registered. In ``[config]``, the optional
argument ``["path_intrinsic"]`` specifies the path to a json file that stores
the camera intrinsic matrix (See
:ref:`/tutorial/pipelines/rgbd_odometry.ipynb#read-camera-intrinsic` for
details). If it is not given, the PrimeSense factory setting is used instead.
.. _make_fragments_register_rgbd_image_pairs:
Register RGBD image pairs
``````````````````````````````````````
.. literalinclude:: ../../../examples/python/reconstruction_system/make_fragments.py
:language: python
:pyobject: register_one_rgbd_pair
:linenos:
:lineno-match:
The function reads a pair of RGBD images and registers the ``source_rgbd_image``
to the ``target_rgbd_image``. The Open3D function ``compute_rgbd_odometry`` is
called to align the RGBD images. For adjacent RGBD images, an identity matrix is
used as the initialization. For non-adjacent RGBD images, wide baseline matching
is used as the initialization. In particular, the function ``pose_estimation``
computes OpenCV ORB feature to match sparse features over wide baseline images,
then performs 5-point RANSAC to estimate a rough alignment, which is used as
the initialization of ``compute_rgbd_odometry``.
.. _make_fragments_make_a_posegraph:
Multiway registration
``````````````````````````````````````
.. literalinclude:: ../../../examples/python/reconstruction_system/make_fragments.py
:language: python
:pyobject: make_posegraph_for_fragment
:linenos:
:lineno-match:
This script uses the technique demonstrated in
:ref:`/tutorial/pipelines/multiway_registration.ipynb`. The function
``make_posegraph_for_fragment`` builds a pose graph for multiway registration of
all RGBD images in this sequence. Each graph node represents an RGBD image and
its pose which transforms the geometry to the global fragment space.
For efficiency, only key frames are used.
Once a pose graph is created, multiway registration is performed by calling the
function ``optimize_posegraph_for_fragment``.
.. literalinclude:: ../../../examples/python/reconstruction_system/optimize_posegraph.py
:language: python
:pyobject: optimize_posegraph_for_fragment
:linenos:
:lineno-match:
This function calls ``global_optimization`` to estimate poses of the RGBD images.
.. _make_fragments_make_a_fragment:
Make a fragment
``````````````````````````````````````
.. literalinclude:: ../../../examples/python/reconstruction_system/make_fragments.py
:language: python
:pyobject: integrate_rgb_frames_for_fragment
:linenos:
:lineno-match:
Once the poses are estimated, :ref:`/tutorial/pipelines/rgbd_integration.ipynb`
is used to reconstruct a colored fragment from each RGBD sequence.
Batch processing
``````````````````````````````````````
.. literalinclude:: ../../../examples/python/reconstruction_system/make_fragments.py
:language: python
:start-at: def process_single_fragment(fragment_id, color_files, depth_files, n_files,
:linenos:
:lineno-match:
The ``process_single_fragment`` function calls each individual function explained above.
The ``run`` function determines the number of fragments to generate based on the number
of images in the dataset and the configuration value ``n_frames_per_fragment``.
Subsequently, it invokes ``process_single_fragment`` for each of these fragments.
Furthermore, it leverages multiprocessing to speed up computation of all fragments.
.. _reconstruction_system_make_fragments_results:
Results
``````````````````````````````````````
.. code-block:: sh
Fragment 000 / 013 :: RGBD matching between frame : 0 and 1
Fragment 000 / 013 :: RGBD matching between frame : 0 and 5
Fragment 000 / 013 :: RGBD matching between frame : 0 and 10
Fragment 000 / 013 :: RGBD matching between frame : 0 and 15
Fragment 000 / 013 :: RGBD matching between frame : 0 and 20
:
Fragment 000 / 013 :: RGBD matching between frame : 95 and 96
Fragment 000 / 013 :: RGBD matching between frame : 96 and 97
Fragment 000 / 013 :: RGBD matching between frame : 97 and 98
Fragment 000 / 013 :: RGBD matching between frame : 98 and 99
The following is a log from ``optimize_posegraph_for_fragment``.
.. code-block:: sh
[GlobalOptimizationLM] Optimizing PoseGraph having 100 nodes and 195 edges.
Line process weight : 389.309502
[Initial ] residual : 3.223357e+05, lambda : 1.771814e+02
[Iteration 00] residual : 1.721845e+04, valid edges : 157, time : 0.022 sec.
[Iteration 01] residual : 1.350251e+04, valid edges : 168, time : 0.017 sec.
:
[Iteration 32] residual : 9.779118e+03, valid edges : 179, time : 0.013 sec.
Current_residual - new_residual < 1.000000e-06 * current_residual
[GlobalOptimizationLM] total time : 0.519 sec.
[GlobalOptimizationLM] Optimizing PoseGraph having 100 nodes and 179 edges.
Line process weight : 398.292104
[Initial ] residual : 5.120047e+03, lambda : 2.565362e+02
[Iteration 00] residual : 5.064539e+03, valid edges : 179, time : 0.014 sec.
[Iteration 01] residual : 5.037665e+03, valid edges : 178, time : 0.015 sec.
:
[Iteration 11] residual : 5.017307e+03, valid edges : 177, time : 0.013 sec.
Current_residual - new_residual < 1.000000e-06 * current_residual
[GlobalOptimizationLM] total time : 0.197 sec.
CompensateReferencePoseGraphNode : reference : 0
The following is a log from ``integrate_rgb_frames_for_fragment``.
.. code-block:: sh
Fragment 000 / 013 :: integrate rgbd frame 0 (1 of 100).
Fragment 000 / 013 :: integrate rgbd frame 1 (2 of 100).
Fragment 000 / 013 :: integrate rgbd frame 2 (3 of 100).
:
Fragment 000 / 013 :: integrate rgbd frame 97 (98 of 100).
Fragment 000 / 013 :: integrate rgbd frame 98 (99 of 100).
Fragment 000 / 013 :: integrate rgbd frame 99 (100 of 100).
The following images show some of the fragments made by this script.
.. image:: ../../_static/reconstruction_system/make_fragments/fragment_0.png
:width: 325px
.. image:: ../../_static/reconstruction_system/make_fragments/fragment_1.png
:width: 325px
.. image:: ../../_static/reconstruction_system/make_fragments/fragment_2.png
:width: 325px
.. image:: ../../_static/reconstruction_system/make_fragments/fragment_3.png
:width: 325px
|