From 7c06f80adf243492f50749a9cbd8ef4247173ad4 Mon Sep 17 00:00:00 2001 From: mkazhdan Date: Tue, 21 Jul 2015 22:25:25 -0400 Subject: [PATCH] Read me update Added figures and reference for the eagle model --- README.md | 54 ++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 40 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 74e64df..9d1d30d 100644 --- a/README.md +++ b/README.md @@ -162,26 +162,52 @@ The default value 0.001.
USAGE
-For testing purposes, two oriented point sets are provided: +For testing purposes, three point sets are provided: +
    +
  1. Eagle: +A set of 796,825 oriented point samples with color (represented in PLY format) was obtained in the EPFL Scanning 3D Statues from Photos course.
    +
      +
    • The original Poisson Reconstruction algorithm can be invoked by calling: +
      % PoissonRecon --in eagle.points.ply --out eagle.unscreened.ply --depth 10 --pointWeight 0
      +using the --pointWeight 0 argument to disable the screening.
      + +
    • By default, screening is enabled so the call: +
      % PoissonRecon --in eagle.points.ply --out eagle.screened.ply --depth 10
      +produces a reconstruction that more faithfully fits the input point positions.
      + +
    • A reconstruction of the eagle that extrapolates the color values from the input samples can be obtained by calling: +
      % PoissonRecon --in eagle.points.ply --out eagle.screened.color.ply --depth 10 --color 16
      +using the --color 16 to indicate both that color should be used, and the extent to which finer color estimates should be preferenced over coarser estimates. + +
    • Finally, a reconstruction the eagle that does not close up the holes can be obtained by first calling: +
      % PoissonRecon --in eagle.points.ply --out eagle.screened.color.ply --depth 10 --color 16 --density
      +using the --density flag to indicate that density estimates should be output with the vertices of the mesh, and then calling: +
      % SurfaceTrimmer --in eagle.screened.color.ply --out eagle.screened.color.trimmed.ply --trim 7
      +to remove all subsets of the surface where the sampling density corresponds to a depth smaller than 7. +
    + + + + + +
    +
    +
    +
    +
    Unscreened +Screened +Screened + Color +Screened + Color + Trimmed +
    +
  2. Bunny: A set of 362,271 oriented point samples (represented in PLY format) was obtained by merging the data from the original Stanford Bunny range scans. The orientation of the sample points was estimated using the connectivity information within individual range scans.
    -The original Poisson Reconstruction algorithm can be invoked by calling: -
    % PoissonRecon --in bunny.points.ply --out bunny.unscreened.ply --depth 10 --pointWeight 0
    -using the --pointWeight 0 argument to disable the screening.
    -By default, screening is enabled so the call: -
    % PoissonRecon --in bunny.points.ply --out bunny.screened.ply --depth 10
    -produces a reconstruction that more faithfully fits the input point positions.
    -A reconstruction of the bunny that does not close up the holes can be obtained by first calling: -
    % PoissonRecon --in bunny.points.ply --out bunny.screened.ply --depth 10 --density
    -to obtain a surface storing depth estimates with each vertex, and then calling: -
    % SurfaceTrimmer --in bunny.screened.ply --out bunny.screened.trimmed.ply --trim 7 --aRatio 0
    -to remove all subsets of the surface where the sampling density corresponds to a depth smaller than 7.
    -To fill in small holes in the reconstruction, the default value of the area ratio can be used instead: -
    % SurfaceTrimmer --in bunny.screened.ply --out bunny.screened.trimmed.ply --trim 7
    +The surface of the model can be reconstructed by calling the surface reconstructor as follows: +
    % PoissonRecon --in bunny.points.ply --out bunny.ply --depth 10
  3. Horse: A set of 100,000 oriented point samples (represented in ASCII format) was obtained by sampling a virtual horse model with a sampling density proportional to curvature, giving a set of non-uniformly distributed points.