modified document(Tutorial)

Sirokujira · Dec 7, 2017 · Oct 6, 2017 · Oct 6, 2017 · Oct 6, 2017 · Oct 6, 2017
commit a7b542116b6eff3889c050ba0c73039f66fb9f0b
diff --git a/docs/source/tutorial/features.rst b/docs/source/tutorial/features.rst
@@ -29,46 +29,46 @@ Point Feature Histograms (PFH) descriptors
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 This tutorial introduces a family of 3D feature descriptors called PFH (Point Feature Histograms) and discusses their implementation details from PCL�fs perspective.
 
-* `Original <http://pointclouds.org/documentation/tutorials/pfh_estimation.php#pfh-estimation>`
+* `Original <http://pointclouds.org/documentation/tutorials/pfh_estimation.php#pfh-estimation>`_ \
 * TestCode : None
 
 
 Fast Point Feature Histograms (FPFH) descriptors
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 This tutorial introduces the FPFH (Fast Point Feature Histograms) 3D descriptor and discusses their implementation details from PCL�fs perspective.
 
-* `Original <http://pointclouds.org/documentation/tutorials/fpfh_estimation.php#fpfh-estimation>`
+* `Original <http://pointclouds.org/documentation/tutorials/fpfh_estimation.php#fpfh-estimation>`_ \
 * TestCode : None
 
 
 Estimating VFH signatures for a set of points
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 This document describes the Viewpoint Feature Histogram (VFH) descriptor, a novel representation for point clusters for the problem of Cluster (e.g., Object) Recognition and 6DOF Pose Estimation.
 
-* `Original <http://pointclouds.org/documentation/tutorials/vfh_estimation.php#vfh-estimation>`
+* `Original <http://pointclouds.org/documentation/tutorials/vfh_estimation.php#vfh-estimation>`_ \
 * TestCode : None
 
 
 How to extract NARF features from a range image
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to extract NARF features from a range image.
 
-* `Original <http://pointclouds.org/documentation/tutorials/narf_feature_extraction.php#narf-feature-extraction>`
+* `Original <http://pointclouds.org/documentation/tutorials/narf_feature_extraction.php#narf-feature-extraction>`_ \
 * TestCode : None
 
 Moment of inertia and eccentricity based descriptors
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial we will learn how to compute moment of inertia and eccentricity of the cloud. In addition to this we will learn how to extract AABB and OBB.
 
-* `Original <http://pointclouds.org/documentation/tutorials/moment_of_inertia.php#moment-of-inertia>`
+* `Original <http://pointclouds.org/documentation/tutorials/moment_of_inertia.php#moment-of-inertia>`_ \
 * TestCode : examples\official\Features\moment_of_inertia.py
 
 
 RoPs (Rotational Projection Statistics) feature
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial we will learn how to compute RoPS feature.
 
-* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`
+* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`_ \
 * TestCode : examples\official\Features\rops_feature.py
 
 
diff --git a/docs/source/tutorial/filtering.rst b/docs/source/tutorial/filtering.rst
@@ -1,50 +1,50 @@
 Filtering Tutorials
-======================
+===================
 
 Filtering a PointCloud using a PassThrough filter
-~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to remove points whose values fall inside/outside a user given interval along a specified dimension.
 
-* `Original <http://pointclouds.org/documentation/tutorials/passthrough.php#passthrough>`_ 
+* `Original <http://pointclouds.org/documentation/tutorials/passthrough.php#passthrough>`_ \ 
 * TestCode : None
 
 Downsampling a PointCloud using a VoxelGrid filter
-~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to downsample (i.e., reduce the number of points) a Point Cloud.
 
-* `Original <http://pointclouds.org/documentation/tutorials/voxel_grid.php#voxelgrid>`_ 
+* `Original <http://pointclouds.org/documentation/tutorials/voxel_grid.php#voxelgrid>`_ \ 
 * TestCode : None
 
 
 Removing outliers using a StatisticalOutlierRemoval filter
-~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to remove sparse outliers from noisy data, using StatisticalRemoval.
 
-* `Original <http://pointclouds.org/documentation/tutorials/statistical_outlier.php#statistical-outlier-removal>`_
+* `Original <http://pointclouds.org/documentation/tutorials/statistical_outlier.php#statistical-outlier-removal>`_ \
 * TestCode : None
 
 
 Projecting points using a parametric model
-~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to project points to a parametric model (i.e., plane).
 
-* `Original <http://pointclouds.org/documentation/tutorials/project_inliers.php#project-inliers>`
+* `Original <http://pointclouds.org/documentation/tutorials/project_inliers.php#project-inliers>`_ \
 * TestCode : None
 
 
 Extracting indices from a PointCloud
-~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to extract a set of indices given by a segmentation algorithm.
 
-* `Original <http://pointclouds.org/documentation/tutorials/extract_indices.php#extract-indices>`
+* `Original <http://pointclouds.org/documentation/tutorials/extract_indices.php#extract-indices>`_ \
 * TestCode : None
 
 
 Removing outliers using a Conditional or RadiusOutlier removal
-~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to remove outliers from noisy data, using ConditionalRemoval, RadiusOutlierRemoval.
 
-* `Original <http://pointclouds.org/documentation/tutorials/remove_outliers.php#remove-outliers>`
+* `Original <http://pointclouds.org/documentation/tutorials/remove_outliers.php#remove-outliers>`_ \
 * TestCode : None
 
 
diff --git a/docs/source/tutorial/io.rst b/docs/source/tutorial/io.rst
@@ -5,79 +5,79 @@ The PCD (Point Cloud Data) file format
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 This document describes the PCD file format, and the way it is used inside PCL.
 
-* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`
+* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`_ \
 * TestCode : None
 
 
 Reading Point Cloud data from PCD files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to read a Point Cloud from a PCD file.
 
-* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`
+* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`_ \
 * TestCode : None
 
 
 Writing Point Cloud data to PCD files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to write a Point Cloud to a PCD file.
 
-* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`
+* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`_ \
 * TestCode : None
 
 
 Concatenate the points of two Point Clouds
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to concatenate both the fields and the point data of two Point Clouds. When concatenating fields, one PointClouds contains only XYZ data, and the other contains Surface Normal information.
 
-* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`
+* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`_ \
 * TestCode : None
 
 
 The OpenNI Grabber Framework in PCL
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to acquire point cloud data from an OpenNI camera.
 
-* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`
+* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`_ \
 * TestCode : None
 
 
 The Velodyne High Definition LiDAR (HDL) Grabber
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to acquire point cloud data from a Velodyne HDL.
 
-* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`
+* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`_ \
 * TestCode : None
 
 
 The PCL Dinast Grabber Framework
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to acquire point cloud data from a Dinast camera.
 
-* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`
+* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`_ \
 * TestCode : None
 
 
 Grabbing point clouds from Ensenso cameras
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to acquire point cloud data from an IDS-Imaging Ensenso camera.
 
-* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`
+* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`_ \
 * TestCode : None
 
 
 Grabbing point clouds / meshes from davidSDK scanners
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to acquire point cloud or mesh data from a davidSDK scanner.
 
-* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`
+* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`_ \
 * TestCode : None
 
 
 Grabbing point clouds from DepthSense cameras
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial we will learn how to setup and use DepthSense cameras within PCL on both Linux and Windows platforms.
 
-* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`
+* `Original <http://pointclouds.org/documentation/tutorials/how_features_work.php>`_ \
 * TestCode : None
 
 
diff --git a/docs/source/tutorial/kdtree.rst b/docs/source/tutorial/kdtree.rst
@@ -6,5 +6,5 @@ How to use a KdTree to search
 
 In this tutorial, we will learn how to search using the nearest neighbor method for k-d trees
 
-* `Original <http://pointclouds.org/documentation/tutorials/kdtree_search.php#kdtree-search>`
+* `Original <http://pointclouds.org/documentation/tutorials/kdtree_search.php#kdtree-search>`_ \
 * TestCode : None
diff --git a/docs/source/tutorial/keypoint.rst b/docs/source/tutorial/keypoint.rst
@@ -6,7 +6,7 @@ How to extract NARF keypoint from a range image
 
 In this tutorial, we will learn how to extract NARF keypoints from a range image.
 
-* `Original <http://pointclouds.org/documentation/tutorials/narf_keypoint_extraction.php#narf-keypoint-extraction>`
+* `Original <http://pointclouds.org/documentation/tutorials/narf_keypoint_extraction.php#narf-keypoint-extraction>`_ \
 * TestCode : None
 
 
diff --git a/docs/source/tutorial/octree.rst b/docs/source/tutorial/octree.rst
@@ -5,23 +5,23 @@ Point Cloud Compression
 ~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to compress a single point cloud and streams of point clouds.
 
-* `Original <http://pointclouds.org/documentation/tutorials/compression.php#octree-compression>`
+* `Original <http://pointclouds.org/documentation/tutorials/compression.php#octree-compression>`_ \
 * TestCode : None
 
 
 Spatial Partitioning and Search Operations with Octrees
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to use octrees for spatial partitioning and nearest neighbor search.
 
-* `Original <http://pointclouds.org/documentation/tutorials/compression.php#octree-compression>`
+* `Original <http://pointclouds.org/documentation/tutorials/compression.php#octree-compression>`_ \
 * TestCode : None
 
 
 Spatial change detection on unorganized point cloud data
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In this tutorial, we will learn how to use octrees for detecting spatial changes within point clouds.
 
-* `Original <http://pointclouds.org/documentation/tutorials/compression.php#octree-compression>`
+* `Original <http://pointclouds.org/documentation/tutorials/compression.php#octree-compression>`_ \
 * TestCode : None
 
 
diff --git a/docs/source/tutorial/rangeImage.rst b/docs/source/tutorial/rangeImage.rst
@@ -5,15 +5,15 @@ How to create a range image from a point cloud
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 This tutorial demonstrates how to create a range image from a point cloud and a given sensor position.
 
-* `Original <http://pointclouds.org/documentation/tutorials/range_image_creation.php#range-image-creation>`
+* `Original <http://pointclouds.org/documentation/tutorials/range_image_creation.php#range-image-creation>`_ \
 * TestCode : None
 
 
 How to extract borders from range images
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 This tutorial demonstrates how to extract borders (traversals from foreground to background) from a range image.
 
-* `Original <http://pointclouds.org/documentation/tutorials/range_image_border_extraction.php#range-image-border-extraction>`
+* `Original <http://pointclouds.org/documentation/tutorials/range_image_border_extraction.php#range-image-border-extraction>`_ \
 * TestCode : None
 
 
diff --git a/docs/source/tutorial/recognition.rst b/docs/source/tutorial/recognition.rst
@@ -6,23 +6,23 @@ Recognition Tutorials
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 This tutorial aims at explaining how to perform 3D Object Recognition based on the pcl_recognition module.
 
-* `Original <http://pointclouds.org/documentation/tutorials/correspondence_grouping.php#correspondence-grouping>`
+* `Original <http://pointclouds.org/documentation/tutorials/correspondence_grouping.php#correspondence-grouping>`_ \
 * TestCode : None
 
 
 Implicit Shape Model
 ~~~~~~~~~~~~~~~~~~~~
 In this tutorial we will learn how the Implicit Shape Model algorithm works and how to use it for finding objects centers.
 
-* `Original <http://pointclouds.org/documentation/tutorials/implicit_shape_model.php#implicit-shape-model>`
+* `Original <http://pointclouds.org/documentation/tutorials/implicit_shape_model.php#implicit-shape-model>`_ \
 * TestCode : None
 
 
 Tutorial: Hypothesis Verification for 3D Object Recognition
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 This tutorial aims at explaining how to do 3D object recognition in clutter by verifying model hypotheses in cluttered and heavily occluded 3D scenes.
 
-* `Original <http://pointclouds.org/documentation/tutorials/global_hypothesis_verification.php#global-hypothesis-verification>`
+* `Original <http://pointclouds.org/documentation/tutorials/global_hypothesis_verification.php#global-hypothesis-verification>`_ \
 * TestCode : None