Tangential complex reference manual#

class gudhi.TangentialComplex#

Bases: object

The class Tangential_complex represents a tangential complex. After the computation of the complex, an optional post-processing called perturbation can be run to attempt to remove inconsistencies.

__init__()#

TangentialComplex constructor.

Parameters:

intrisic_dim¶ (integer) – Intrinsic dimension of the manifold.
points¶ (list of list of double) – A list of points in d-Dimension.

Or

Parameters:: off_file¶ (string) – An OFF file style name.

__new__(**kwargs)#

compute_tangential_complex()#

This function computes the tangential complex.

Raises:: ValueError – In debug mode, if the computed star dimension is too low. Try to set a bigger maximal edge length value with set_max_squared_edge_length() if this happens.

create_simplex_tree()#

Exports the complex into a simplex tree.

Returns:: A simplex tree created from the complex.
Return type:: SimplexTree

fix_inconsistencies_using_perturbation(max_perturb, time_limit=-1.0)#

Attempts to fix inconsistencies by perturbing the point positions.

Parameters:

max_perturb¶ (double) – Maximum length of the translations used by the perturbation.
time_limit¶ (double) – Time limit in seconds. If -1, no time limit is set.

get_point(vertex)#

This function returns the point corresponding to a given vertex.

Parameters:: vertex¶ (int.) – The vertex.
Returns:: The point.
Return type:: list of float

num_inconsistent_simplices()#

Returns:: The number of inconsistent simplices.
Return type:: unsigned

num_inconsistent_stars()#

Returns:: The number of stars containing at least one inconsistent simplex.
Return type:: unsigned

num_simplices()#

Returns:: Total number of simplices in stars (including duplicates that appear in several stars).
Return type:: unsigned

num_vertices()#

Returns:: The number of vertices.
Return type:: unsigned

set_max_squared_edge_length(max_squared_edge_length)#

Sets the maximal possible squared edge length for the edges in the triangulations.

Parameters:: max_squared_edge_length¶ (double) – Maximal possible squared edge length.

If the maximal edge length value is too low compute_tangential_complex() will throw an exception in debug mode.