multipers 2.2.3__cp312-cp312-win_amd64.whl

multipers/gudhi/Persistence_slices_interface.h

@@ -0,0 +1,132 @@
+#pragma once
+
+#include "mma_interface_h0.h"
+#include "mma_interface_matrix.h"
+#include "mma_interface_coh.h"
+#include <type_traits>  // For static_assert
+#include "truc.h"
+#include <gudhi/Simplex_tree_multi.h>
+#include <gudhi/One_critical_filtration.h>
+#include <gudhi/Multi_critical_filtration.h>
+
+template <typename Filtration>
+using SimplexTreeMultiOptions = Gudhi::multi_persistence::Simplex_tree_options_multidimensional_filtration<Filtration>;
+
+enum Column_types_strs { LIST, SET, HEAP, VECTOR, NAIVE_VECTOR, UNORDERED_SET, INTRUSIVE_LIST, INTRUSIVE_SET };
+
+using Available_columns = Gudhi::persistence_matrix::Column_types;
+
+template <Available_columns col>
+using BackendOptionsWithVine = Gudhi::multiparameter::truc_interface::Multi_persistence_options<col>;
+template <Available_columns col>
+using BackendOptionsWithoutVine = Gudhi::multiparameter::truc_interface::No_vine_multi_persistence_options<col>;
+
+template <Available_columns col>
+using ClementBackendOptionsWithVine = Gudhi::multiparameter::truc_interface::Multi_persistence_Clement_options<col>;
+
+using SimplicialStructure = Gudhi::multiparameter::truc_interface::SimplicialStructure;
+using PresentationStructure = Gudhi::multiparameter::truc_interface::PresentationStructure;
+
+template <Available_columns col, class Structure = SimplicialStructure>
+using MatrixBackendNoVine =
+    Gudhi::multiparameter::truc_interface::Persistence_backend_matrix<BackendOptionsWithoutVine<col>, Structure>;
+
+template <Available_columns col, class Structure = SimplicialStructure>
+using MatrixBackendVine =
+    Gudhi::multiparameter::truc_interface::Persistence_backend_matrix<BackendOptionsWithVine<col>, Structure>;
+
+template <Available_columns col, class Structure = SimplicialStructure>
+using ClementMatrixBackendVine =
+    Gudhi::multiparameter::truc_interface::Persistence_backend_matrix<ClementBackendOptionsWithVine<col>, Structure>;
+using GraphBackendVine = Gudhi::multiparameter::truc_interface::Persistence_backend_h0<SimplicialStructure>;
+
+using Filtration_value = Gudhi::multi_filtration::One_critical_filtration<float>;
+
+template <Available_columns col = Available_columns::INTRUSIVE_SET>
+using SimplicialNoVineMatrixTruc =
+    Gudhi::multiparameter::truc_interface::Truc<MatrixBackendNoVine<col>, SimplicialStructure, Filtration_value>;
+
+template <Available_columns col = Available_columns::INTRUSIVE_SET>
+using GeneralVineTruc = Gudhi::multiparameter::truc_interface::
+    Truc<MatrixBackendVine<col, PresentationStructure>, PresentationStructure, Filtration_value>;
+
+template <Available_columns col = Available_columns::INTRUSIVE_SET>
+using GeneralNoVineTruc = Gudhi::multiparameter::truc_interface::
+    Truc<MatrixBackendNoVine<col, PresentationStructure>, PresentationStructure, Filtration_value>;
+
+template <Available_columns col = Available_columns::INTRUSIVE_SET>
+using GeneralVineClementTruc = Gudhi::multiparameter::truc_interface::
+    Truc<ClementMatrixBackendVine<col, PresentationStructure>, PresentationStructure, Filtration_value>;
+
+template <Available_columns col = Available_columns::INTRUSIVE_SET>
+using SimplicialVineMatrixTruc =
+    Gudhi::multiparameter::truc_interface::Truc<MatrixBackendVine<col>, SimplicialStructure, Filtration_value>;
+using SimplicialVineGraphTruc =
+    Gudhi::multiparameter::truc_interface::Truc<GraphBackendVine, SimplicialStructure, Filtration_value>;
+
+// multicrititcal
+using Multi_critical_filtrationValue = Gudhi::multi_filtration::Multi_critical_filtration<float>;
+template <Available_columns col = Available_columns::INTRUSIVE_SET>
+using KCriticalVineTruc = Gudhi::multiparameter::truc_interface::
+    Truc<MatrixBackendVine<col, PresentationStructure>, PresentationStructure, Multi_critical_filtrationValue>;
+
+template <bool is_vine, Available_columns col = Available_columns::INTRUSIVE_SET>
+using Matrix_interface = std::conditional_t<is_vine,
+                                            MatrixBackendVine<col, PresentationStructure>,
+                                            MatrixBackendNoVine<col, PresentationStructure>>;
+
+template <bool is_kcritical, typename value_type>
+using filtration_options = std::conditional_t<is_kcritical,
+                                              Gudhi::multi_filtration::Multi_critical_filtration<value_type>,
+                                              Gudhi::multi_filtration::One_critical_filtration<value_type>>;
+
+template <bool is_vine,
+          bool is_kcritical,
+          typename value_type,
+          Available_columns col = Available_columns::INTRUSIVE_SET>
+using MatrixTrucPythonInterface = Gudhi::multiparameter::truc_interface::
+    Truc<Matrix_interface<is_vine, col>, PresentationStructure, filtration_options<is_kcritical, value_type>>;
+
+enum class BackendsEnum { Matrix, Graph, Clement, GudhiCohomology };
+
+// Create a template metafunction to simplify the type selection
+template <BackendsEnum backend, bool is_vine, Available_columns col>
+struct PersBackendOptsImpl;
+
+template <bool is_vine, Available_columns col>
+struct PersBackendOptsImpl<BackendsEnum::Matrix, is_vine, col> {
+  using type = Matrix_interface<is_vine, col>;
+};
+
+template <bool is_vine, Available_columns col>
+struct PersBackendOptsImpl<BackendsEnum::Clement, is_vine, col> {
+  static_assert(is_vine, "Clement is vine");
+  using type = ClementMatrixBackendVine<col, PresentationStructure>;
+};
+
+template <bool is_vine, Available_columns col>
+struct PersBackendOptsImpl<BackendsEnum::GudhiCohomology, is_vine, col> {
+  static_assert(!is_vine, "Gudhi is not vine");
+  using type = Gudhi::multiparameter::truc_interface::Persistence_backend_cohomology<PresentationStructure>;
+};
+
+template <bool is_vine, Available_columns col>
+struct PersBackendOptsImpl<BackendsEnum::Graph, is_vine, col> {
+  static_assert(is_vine, "Graph backend requires is_vine to be true");
+  using type = GraphBackendVine;
+};
+
+// Helper alias to extract the type
+template <BackendsEnum backend, bool is_vine, Available_columns col>
+using PersBackendOpts = typename PersBackendOptsImpl<backend, is_vine, col>::type;
+
+template <BackendsEnum backend>
+using StructureStuff = std::conditional_t<backend == BackendsEnum::Graph, SimplicialStructure, PresentationStructure>;
+
+template <BackendsEnum backend,
+          bool is_vine,
+          bool is_kcritical,
+          typename value_type,
+          Available_columns col = Available_columns::INTRUSIVE_SET>
+using TrucPythonInterface = Gudhi::multiparameter::truc_interface::
+    Truc<PersBackendOpts<backend, is_vine, col>, StructureStuff<backend>, filtration_options<is_kcritical, value_type>>;

multipers/gudhi/Simplex_tree_interface.h

@@ -0,0 +1,245 @@
+/*    This file is part of the Gudhi Library - https://gudhi.inria.fr/ - which is released under MIT.
+ *    See file LICENSE or go to https://gudhi.inria.fr/licensing/ for full license details.
+ *    Author(s):       Vincent Rouvreau
+ *
+ *    Copyright (C) 2016 Inria
+ *
+ *    Modification(s):
+ *      - YYYY/MM Author: Description of the modification
+ */
+
+#ifndef INCLUDE_SIMPLEX_TREE_INTERFACE_H_
+#define INCLUDE_SIMPLEX_TREE_INTERFACE_H_
+
+#include <gudhi/graph_simplicial_complex.h>
+#include <gudhi/distance_functions.h>
+#include <gudhi/Simplex_tree.h>
+#include <gudhi/Points_off_io.h>
+#include <gudhi/Flag_complex_edge_collapser.h>
+
+#include <vector>
+#include <utility>  // std::pair
+#include <tuple>
+
+namespace Gudhi {
+
+/** Model of SimplexTreeOptions.
+ * 
+ * Specific to python interfaces of the Simplex_tree */
+struct Simplex_tree_options_for_python {
+  typedef linear_indexing_tag Indexing_tag;
+  typedef int Vertex_handle;
+  typedef double Filtration_value;
+  typedef std::uint32_t Simplex_key;
+  static const bool store_key = true;
+  static const bool store_filtration = true;
+  static const bool contiguous_vertices = false;
+  static const bool link_nodes_by_label = false;
+  static const bool stable_simplex_handles = false;
+  static const bool is_multi_parameter = false;
+};
+
+template<class Simplex_tree_options_for_python = Simplex_tree_options_for_python>
+class Simplex_tree_interface : public Simplex_tree<Simplex_tree_options_for_python> {
+ public:
+  using Base = Simplex_tree<Simplex_tree_options_for_python>;
+  using Filtration_value = typename Base::Filtration_value;
+  using Vertex_handle = typename Base::Vertex_handle;
+  using Simplex_handle = typename Base::Simplex_handle;
+  using Insertion_result = typename std::pair<Simplex_handle, bool>;
+  using Simplex = std::vector<Vertex_handle>;
+  using Simplex_and_filtration = std::pair<Simplex, Filtration_value>;
+  using Filtered_simplices = std::vector<Simplex_and_filtration>;
+  using Skeleton_simplex_iterator = typename Base::Skeleton_simplex_iterator;
+  using Complex_simplex_iterator = typename Base::Complex_simplex_iterator;
+  using Extended_filtration_data = typename Base::Extended_filtration_data;
+  using Boundary_simplex_iterator = typename Base::Boundary_simplex_iterator;
+  using Siblings = typename Base::Siblings;
+  using Node = typename Base::Node;
+  typedef bool (*blocker_func_t)(Simplex simplex, void *user_data);
+
+ public:
+
+  Extended_filtration_data efd;
+  
+  bool find_simplex(const Simplex& simplex) {
+    return (Base::find(simplex) != Base::null_simplex());
+  }
+
+  void assign_simplex_filtration(const Simplex& simplex, Filtration_value filtration) {
+    Simplex_handle sh = Base::find(simplex);
+    if (sh == Base::null_simplex())
+      throw std::invalid_argument("Cannot assign a filtration to a simplex that is not in the complex");
+    Base::assign_filtration(sh, filtration);
+    Base::clear_filtration();
+  }
+
+  bool insert(const Simplex& simplex, Filtration_value filtration = 0) {
+    Insertion_result result = Base::insert_simplex_and_subfaces(simplex, filtration);
+    if (result.first != Base::null_simplex())
+      Base::clear_filtration();
+    return (result.second);
+  }
+
+  void insert_matrix(double* filtrations, int n, int stride0, int stride1, double max_filtration) {
+    // We could delegate to insert_graph, but wrapping the matrix in a graph interface is too much work,
+    // and this is a bit more efficient.
+    auto& rm = this->root()->members_;
+    for(int i=0; i<n; ++i) {
+      char* p = reinterpret_cast<char*>(filtrations) + i * stride0;
+      double fv = *reinterpret_cast<double*>(p + i * stride1);
+      if(fv > max_filtration) continue;
+      auto sh = rm.emplace_hint(rm.end(), i, Node(this->root(), fv));
+      Siblings* children = nullptr;
+      // Should we make a first pass to count the number of edges so we can reserve the right space?
+      for(int j=i+1; j<n; ++j) {
+        double fe = *reinterpret_cast<double*>(p + j * stride1);
+        if(fe > max_filtration) continue;
+        if(!children) {
+          children = new Siblings(this->root(), i);
+          sh->second.assign_children(children);
+        }
+        children->members().emplace_hint(children->members().end(), j, Node(children, fe));
+      }
+    }
+    this->set_dimension(1, false);
+  }
+
+  // Do not interface this function, only used in alpha complex interface for complex creation
+  bool insert_simplex(const Simplex& simplex, Filtration_value filtration = 0) {
+    Insertion_result result = Base::insert_simplex(simplex, filtration);
+    return (result.second);
+  }
+
+  // Do not interface this function, only used in strong witness interface for complex creation
+  bool insert_simplex(const std::vector<std::size_t>& simplex, Filtration_value filtration = 0) {
+    Insertion_result result = Base::insert_simplex(simplex, filtration);
+    return (result.second);
+  }
+
+  Filtration_value simplex_filtration(const Simplex& simplex) {
+    return Base::filtration(Base::find(simplex));
+  }
+
+  void remove_maximal_simplex(const Simplex& simplex) {
+    Base::remove_maximal_simplex(Base::find(simplex));
+    Base::clear_filtration();
+  }
+
+  Simplex_and_filtration get_simplex_and_filtration(Simplex_handle f_simplex) {
+    Simplex simplex;
+    for (auto vertex : Base::simplex_vertex_range(f_simplex)) {
+      simplex.insert(simplex.begin(), vertex);
+    }
+    return std::make_pair(std::move(simplex), Base::filtration(f_simplex));
+  }
+
+  Filtered_simplices get_star(const Simplex& simplex) {
+    Filtered_simplices star;
+    for (auto f_simplex : Base::star_simplex_range(Base::find(simplex))) {
+      Simplex simplex_star;
+      for (auto vertex : Base::simplex_vertex_range(f_simplex)) {
+        simplex_star.insert(simplex_star.begin(), vertex);
+      }
+      star.push_back(std::make_pair(simplex_star, Base::filtration(f_simplex)));
+    }
+    return star;
+  }
+
+  Filtered_simplices get_cofaces(const Simplex& simplex, int dimension) {
+    Filtered_simplices cofaces;
+    for (auto f_simplex : Base::cofaces_simplex_range(Base::find(simplex), dimension)) {
+      Simplex simplex_coface;
+      for (auto vertex : Base::simplex_vertex_range(f_simplex)) {
+        simplex_coface.insert(simplex_coface.begin(), vertex);
+      }
+      cofaces.push_back(std::make_pair(simplex_coface, Base::filtration(f_simplex)));
+    }
+    return cofaces;
+  }
+
+  void compute_extended_filtration() {
+    this->efd = this->extend_filtration();
+    return;
+  }
+
+  Simplex_tree_interface* collapse_edges(int nb_collapse_iteration) {
+    using Filtered_edge = std::tuple<Vertex_handle, Vertex_handle, Filtration_value>;
+    std::vector<Filtered_edge> edges;
+    for (Simplex_handle sh : Base::skeleton_simplex_range(1)) {
+      if (Base::dimension(sh) == 1) {
+        typename Base::Simplex_vertex_range rg = Base::simplex_vertex_range(sh);
+        auto vit = rg.begin();
+        Vertex_handle v = *vit;
+        Vertex_handle w = *++vit;
+        edges.emplace_back(v, w, Base::filtration(sh));
+      }
+    }
+
+    for (int iteration = 0; iteration < nb_collapse_iteration; iteration++) {
+      edges = Gudhi::collapse::flag_complex_collapse_edges(std::move(edges));
+    }
+    Simplex_tree_interface* collapsed_stree_ptr = new Simplex_tree_interface();
+    // Copy the original 0-skeleton
+    for (Simplex_handle sh : Base::skeleton_simplex_range(0)) {
+      collapsed_stree_ptr->insert({*(Base::simplex_vertex_range(sh).begin())}, Base::filtration(sh));
+    }
+    // Insert remaining edges
+    for (auto remaining_edge : edges) {
+      collapsed_stree_ptr->insert({std::get<0>(remaining_edge), std::get<1>(remaining_edge)}, std::get<2>(remaining_edge));
+    }
+    return collapsed_stree_ptr;
+  }
+
+  void expansion_with_blockers_callback(int dimension, blocker_func_t user_func, void *user_data) {
+    Base::expansion_with_blockers(dimension, [&](Simplex_handle sh){
+      Simplex simplex(Base::simplex_vertex_range(sh).begin(), Base::simplex_vertex_range(sh).end());
+      return user_func(simplex, user_data);
+    });
+  }
+
+  // Iterator over the simplex tree
+  Complex_simplex_iterator get_simplices_iterator_begin() {
+    // this specific case works because the range is just a pair of iterators - won't work if range was a vector
+    return Base::complex_simplex_range().begin();
+  }
+
+  Complex_simplex_iterator get_simplices_iterator_end() {
+    // this specific case works because the range is just a pair of iterators - won't work if range was a vector
+    return Base::complex_simplex_range().end();
+  }
+
+  typename std::vector<Simplex_handle>::const_iterator get_filtration_iterator_begin() {
+    // Base::initialize_filtration(); already performed in filtration_simplex_range
+    // this specific case works because the range is just a pair of iterators - won't work if range was a vector
+    return Base::filtration_simplex_range().begin();
+  }
+
+  typename std::vector<Simplex_handle>::const_iterator get_filtration_iterator_end() {
+    // this specific case works because the range is just a pair of iterators - won't work if range was a vector
+    return Base::filtration_simplex_range().end();
+  }
+
+  Skeleton_simplex_iterator get_skeleton_iterator_begin(int dimension) {
+    // this specific case works because the range is just a pair of iterators - won't work if range was a vector
+    return Base::skeleton_simplex_range(dimension).begin();
+  }
+
+  Skeleton_simplex_iterator get_skeleton_iterator_end(int dimension) {
+    // this specific case works because the range is just a pair of iterators - won't work if range was a vector
+    return Base::skeleton_simplex_range(dimension).end();
+  }
+
+  std::pair<Boundary_simplex_iterator, Boundary_simplex_iterator> get_boundary_iterators(const Simplex& simplex) {
+    auto bd_sh = Base::find(simplex);
+    if (bd_sh == Base::null_simplex())
+      throw std::runtime_error("simplex not found - cannot find boundaries");
+    // this specific case works because the range is just a pair of iterators - won't work if range was a vector
+    auto boundary_srange = Base::boundary_simplex_range(bd_sh);
+    return std::make_pair(boundary_srange.begin(), boundary_srange.end());
+  }
+};
+
+}  // namespace Gudhi
+
+#endif  // INCLUDE_SIMPLEX_TREE_INTERFACE_H_