Add unitary tests and documentation

Fix debug exception mechanism



git-svn-id: svn+ssh://scm.gforge.inria.fr/svnroot/gudhi/branches/alpha_complex_3d_module_vincent@3712 636b058d-ea47-450e-bf9e-a15bfbe3eedb

Former-commit-id: 43f66f3843981ab9cd74c117c2b1c6bb9b94810b

1 files changed, 2 insertions, 42 deletions

diff --git a/src/Alpha_complex/utilities/alphacomplex.md b/src/Alpha_complex/utilities/alphacomplex.md
index 7ae5f913..7fc6cc0c 100644
--- a/src/Alpha_complex/utilities/alphacomplex.md
+++ b/src/Alpha_complex/utilities/alphacomplex.md
@@ -94,6 +94,8 @@ where `<input OFF file>` is the path to the input point cloud in
 * `-h [ --help ]` Produce help message

 * `-o [ --output-file ]` Name of file in which the persistence diagram is

 written. Default print in standard output.

+* `-r [ --max-alpha-square-value ]` (default = inf) Maximal alpha square value

+for the Alpha complex construction.

 * `-p [ --field-charac ]` (default=11) Characteristic p of the coefficient

 field Z/pZ for computing homology.

 * `-m [ --min-persistence ]` (default = 0) Minimal lifetime of homology feature

@@ -120,45 +122,3 @@ N.B.:
 [Alpha shape](https://doc.cgal.org/latest/Alpha_shapes_3/index.html#title0)

 and

 [Regular triangulation](https://doc.cgal.org/latest/Triangulation_3/index.html#Triangulation3secclassRegulartriangulation) documentation.

-

-

-

-

-

-

-

-

-## periodic_alpha_complex_3d_persistence ##

-Same as `alpha_complex_3d_persistence`, but using periodic alpha shape 3d.

-Refer to the [CGAL's 3D Periodic Triangulations User Manual](https://doc.cgal.org/latest/Periodic_3_triangulation_3/index.html) for more details.

-

-**Usage**

-

-```

-   periodic_alpha_complex_3d_persistence [options] <input OFF file> <cuboid file>

-```

-

-where

-

-* `<input OFF file>` is the path to the input point cloud in [nOFF ASCII format](http://www.geomview.org/docs/html/OFF.html).

-* `<cuboid file>` is the path to the file describing the periodic domain. It must be in the format described

-[here](/doc/latest/fileformats.html#FileFormatsIsoCuboid).

-

-**Allowed options**

-

-* `-h [ --help ]` Produce help message

-* `-o [ --output-file ]` Name of file in which the persistence diagram is written. Default print in standard output.

-* `-p [ --field-charac ]` (default=11) Characteristic p of the coefficient field Z/pZ for computing homology.

-* `-m [ --min-persistence ]` (default = 0) Minimal lifetime of homology feature to be recorded. Enter a negative value to see zero length intervals

-

-

-**Example**

-

-```

-periodic_alpha_complex_3d_persistence ../../data/points/grid_10_10_10_in_0_1.off ../../data/points/iso_cuboid_3_in_0_1.txt -p 3 -m 1.0

-```

-

-N.B.:

-

-* Cuboid file must be in the format described [here](/doc/latest/fileformats.html#FileFormatsIsoCuboid).

-* Filtration values are alpha square values.