Gudhi::persistence_matrix Namespace Reference

Persistence matrix namespace. More...

Classes

class  FieldOperators
 Concept of the field operator classes needed for the class Matrix. More...
 
class  PersistenceMatrixColumn
 Concept of the column classes used by the Matrix class. The classes the columns inheritates from are either real or dummy classes, see Row_access_option, Column_dimension_option, Chain_column_option. If used with column compression, the column type has to have its std::hash method. More...
 
struct  PersistenceMatrixOptions
 Concept of the template parameter for the class Matrix. More...
 
class  Matrix
 Data structure for matrices, and in particular thought for matrices representing filtered complexes in order to compute persistence and/or representative cycles. More...
 
struct  New_cell_constructor
 Cell factory. Constructs and destroyes cell pointers with new and delete. More...
 
struct  Pool_cell_constructor
 Cell factory. Uses Gudhi::Simple_object_pool, which is based on boost::object_pool, to construct and destroy cell pointer. More...
 
class  Base_matrix
 A basic matrix structure allowing to easily manipulate and access entire columns and rows, but not individual cells. More...
 
class  Base_matrix_with_column_compression
 A base matrix (also see Base_matrix), but with column compression. That is, all identical columns in the matrix are compressed together as the same column. For matrices with a lot of redundant columns, this will save a lot of space. Also, any addition made onto a column will be performed at the same time on all other identical columns, which is an advantage for the cohomology algorithm for example. More...
 
struct  Dummy_base_pairing
 Empty structure. Inheritated instead of Base_pairing, when the computation of the barcode was not enabled or if the pairing is already managed by the vine update classes. More...
 
class  Base_pairing
 Class managing the barcode for Boundary_matrix if the option was enabled. More...
 
struct  Dummy_base_swap
 Empty structure. Inheritated instead of Base_swap, when the column and row swaps are not enabled. More...
 
class  Base_swap
 Class managing the column and row swaps in Base_matrix and Boundary_matrix. More...
 
class  Boundary_matrix
 Matrix structure to store the ordered boundary matrix \( R \) of a filtered complex in order to compute its persistent homology. Provides an access to its columns and rows as well as the possibility to remove the last faces of the filtration while maintaining a valid barcode. More...
 
class  Chain_matrix
 Matrix structure storing a compatible base of a filtered chain complex. See [41]. The base is constructed from the boundaries of the faces in the complex. Allows the persistent homology to be computed, as well as representative cycles. Supports vineyards (see [21]) and the removal of maximal faces while maintaining a valid barcode. Provides an access to its columns and rows. More...
 
struct  Dummy_chain_pairing
 Empty structure. Inheritated instead of Chain_pairing, when the computation of the barcode was not enabled or if the pairing is already managed by the vine update classes. More...
 
class  Chain_pairing
 Class managing the barcode for Chain_matrix if the option was enabled. More...
 
struct  Dummy_chain_representative_cycles
 Empty structure. Inheritated instead of Chain_representative_cycles, when the computation of the representative cycles were not enabled. More...
 
class  Chain_representative_cycles
 Class managing the representative cycles for Chain_matrix if the option was enabled. More...
 
struct  Dummy_chain_vine_swap
 Empty structure. Inheritated instead of Chain_vine_swap, when vine swappes are not enabled. More...
 
struct  Dummy_chain_vine_pairing
 Empty structure. Inheritated instead of Chain_barcode_swap, when the barcode is not stored. More...
 
class  Chain_barcode_swap
 Class managing the barcode for Chain_vine_swap. More...
 
class  Chain_vine_swap
 Class managing the vine swaps for Chain_matrix. More...
 
struct  Dummy_cell_column_index_mixin
 Empty structure. Inheritated instead of Cell_column_index, when the row access is disabled. More...
 
struct  Dummy_cell_field_element_mixin
 Empty structure. Inheritated instead of Cell_field_element, when PersistenceMatrixOptions::is_z2 is true. More...
 
class  Cell_column_index
 Class managing the column index access of a cell. More...
 
class  Cell_field_element
 Class managing the value access of a cell. More...
 
class  Cell
 Matrix cell class. Stores by default only the row index it belongs to, but can also store its column index when the row access is enabled, as well as its value when they are different from only 0 and 1. Zero-valued cells are never explicited in the matrix. More...
 
struct  Dummy_chain_properties
 Empty structure. Inheritated instead of Chain_column_extra_properties, when the columns are not meant for chain matrices. More...
 
class  Chain_column_extra_properties
 Class managing the pivot and partitioning of columns in Chain_matrix. More...
 
struct  Dummy_dimension_holder
 Empty structure. Inheritated instead of Column_dimension_holder, when the columns are not storing a dimension. More...
 
class  Column_dimension_holder
 Class managing the dimension access of a column. More...
 
class  Heap_column
 Column class following the PersistenceMatrixColumn concept. Not compatible with row access. More...
 
class  Intrusive_list_column
 Column class following the PersistenceMatrixColumn concept. More...
 
class  Intrusive_set_column
 Column class following the PersistenceMatrixColumn concept. More...
 
class  List_column
 Column class following the PersistenceMatrixColumn concept. More...
 
class  Naive_vector_column
 Column class following the PersistenceMatrixColumn concept. More...
 
struct  Dummy_row_access
 Empty structure. Inheritated instead of Row_access, if the row access is not enabled. More...
 
class  Row_access
 Class managing the row access for the columns. More...
 
class  Set_column
 Column class following the PersistenceMatrixColumn concept. More...
 
class  Unordered_set_column
 Column class following the PersistenceMatrixColumn concept. More...
 
class  Vector_column
 Column class following the PersistenceMatrixColumn concept. More...
 
struct  Dummy_matrix_dimension_holder
 Empty structure. Inheritated instead of Matrix_max_dimension_holder or Matrix_all_dimension_holder, when the maximal dimension of a matrix is not stored. More...
 
class  Matrix_max_dimension_holder
 Class managing the maximal dimension of a face represented in the inheritating matrix, when the option of face removal is not enabled. More...
 
class  Matrix_all_dimension_holder
 Class managing the maximal dimension of a face represented in the inheritating matrix, when the option of face removal is enabled. More...
 
struct  Dummy_matrix_row_access
 Empty structure. Inheritated instead of Matrix_row_access, when the the row access is not enabled. More...
 
class  Matrix_row_access
 Class managing the row access for the inheritating matrix. More...
 
class  Id_to_index_overlay
 Overlay for non-basic matrices replacing all input and output MatIdx indices of the original methods with IDIdx indices. More...
 
class  Position_to_index_overlay
 Overlay for chain matrices replacing all input and output MatIdx indices of the original methods with PosIdx indices. The overlay is useless for boundary matrices as MatIdx == PosIdx for them. More...
 
class  RU_matrix
 Matrix structure to store the ordered boundary matrix \( R \cdot U \) of a filtered complex in order to compute its persistent homology, as well as representative cycles. Supports vineyards (see [21]) and the removal of maximal faces while maintaining a valid barcode. Provides an access to its columns and rows. More...
 
struct  Dummy_ru_pairing
 Empty structure. Inheritated instead of RU_pairing, when the computation of the barcode was not enabled or if the pairing is already managed by the vine update classes. More...
 
class  RU_pairing
 Class managing the barcode for RU_matrix if the option was enabled. More...
 
struct  Dummy_ru_representative_cycles
 Empty structure. Inheritated instead of RU_representative_cycles, when the computation of the representative cycles were not enabled. More...
 
class  RU_representative_cycles
 Class managing the representative cycles for RU_matrix if the option was enabled. More...
 
struct  Dummy_ru_vine_swap
 Empty structure. Inheritated instead of RU_vine_swap, when vine swappes are not enabled. More...
 
struct  Dummy_ru_vine_pairing
 Empty structure. Inheritated instead of RU_pairing, when the barcode is not stored. More...
 
class  RU_vine_swap
 Class managing the vine swaps for RU_matrix. More...
 
struct  Default_options
 Default option structure for Matrix class. See the PersistenceMatrixOptions concept for a more detailed description of the fields. Produces a base matrix with no enabled option. More...
 
struct  Zigzag_options
 Options used for the Zigzag persistence module. More...
 
struct  Representative_cycles_options
 Options needed to use the representative cycles. More...
 
struct  Multi_persistence_options
 Options used by the Multipersistence module. More...
 
struct  Cohomology_persistence_options
 Options used by the cohomology module. More...
 

Typedefs

using Row_access_option = Row_access
 If PersistenceMatrixOptions::has_row_access is true, then Row_access. Otherwise Dummy_row_access. Can eventually be removed if the structure of the column does not allow row access (as for Heap_column), but then it needs to be notified in the documentation of Column_types and as static_assert in Matrix::_assert_options.
 
using Column_dimension_option = Column_dimension_holder
 If PersistenceMatrixOptions::has_column_pairings or PersistenceMatrixOptions::has_vine_update or PersistenceMatrixOptions::can_retrieve_representative_cycles is true, then Column_dimension_holder. Otherwise Dummy_dimension_holder.
 
using Chain_column_option = Chain_column_extra_properties
 If PersistenceMatrixOptions::is_of_boundary_type is false, and, PersistenceMatrixOptions::has_column_pairings or PersistenceMatrixOptions::has_vine_update or PersistenceMatrixOptions::can_retrieve_representative_cycles is true, then Chain_column_extra_properties. Otherwise Dummy_chain_properties.
 

Enumerations

enum  Column_types {
  LIST , SET , HEAP , VECTOR ,
  NAIVE_VECTOR , UNORDERED_SET , INTRUSIVE_LIST , INTRUSIVE_SET
}
 List of column types. More...
 
enum  Column_indexation_types { CONTAINER , POSITION , IDENTIFIER }
 List if indexation schemes. See description of indexation schemes for more details about the meaning of the indexation types. More...
 

Functions

constexpr bool _no_G_death_comparator ([[maybe_unused]] unsigned int columnIndex1, [[maybe_unused]] unsigned int columnIndex2)
 Default death comparator. Simply assumes that two positive paired columns are never swapped. Which is true for the use case in zigzag persistence for example. More...
 

Detailed Description

Persistence matrix namespace.