Reviver: A Practical Provable Reconstructor

1  Simple Usage

Reviver is currently run from the Command line. On Windows NT you need to go to the MS-DOS Prompt to run Reviver.
Basic Usage:

reviver -i Input -o Output -of Format

where:
        

Input	Input File of 3D Points. This file must be specified to run Reviver.
Output	Output File Name. Output File name must be specified to run Reviver.
Format	Output Format. Default output format is VRML 1.0. Currently Supported Formats are: DXF STL STLB VRML OBJ IV RAW

To run a demo of Reviver you could use:

reviver -i ./Inputs/epcot.dat -o Output.wrl -of VRML

• The Input Precision Reviver can handle is 32 bits(float). Doubles(64 bit) are not guaranteed to work properly with Reviver.

2  Advanced Options

If Reviver does not perform well on a point set you should consider reading this section.
Advanced Options Available in Reviver are:

reviver [-a Alpha] [-j yes/no] ...

where:

Alpha	Alpha Value for Triangles. The Default value of this option is Infinity. This option Lets you use Herbert Edelsbrunner's Alpha Shapes Algorithm inside Reviver. If you set a value for Alpha, Reviver does not output any triangles whose edge length exceeds Alpha. By Default Reviver does not use Alpha Shapes. To Find out Alpha Values you could use any 3D modeller that computes Distances between two points. For Example When I get a wrong Reconstruction I generally go to AutoCAD find out the largest edge length of the triangles that are safe to delete and then refeed it to Reviver with the -a Value set where Value corresponds to the edge length output by AutoCAD.
Joggle	This option shakes the Input Point Set slightly. It does not affect the output surface because the displacement of each point is very very small. Default value is yes. Say no for point sets which have a lot of cocircularities on the surface. Note that saying NO to Joggling can sometimes increase runtime by 10x. Use it only when Joggling gives erreneous outputs. The Default rule is that if you do not get a good output from Joggling, Turn it off.

Here's an example of Reviver with an advanced option:

reviver -i ./Inputs/epcot.dat -o ./Outputs/Output.stl -of STLB -j yes
reviver -i ./Inputs/rareface.dat -o ./Output/Output.stl -of STLB -a 20.0

3  Change LOG

• Beta 1.0 [June 8th 2000]
  • Fixed the Alpha Value Bug in the Demo Version
  • Fixed the problem of Joggled Input Points.