GUDHI 2.1.0 as released by upstream in a tarball.upstream/2.1.0

5 files changed, 237 insertions, 0 deletions

diff --git a/concept/Persistence_representations/Real_valued_topological_data.h b/concept/Persistence_representations/Real_valued_topological_data.h
new file mode 100644
index 00000000..1d3595ad
--- /dev/null
+++ b/concept/Persistence_representations/Real_valued_topological_data.h
@@ -0,0 +1,51 @@
+/*    This file is part of the Gudhi Library. The Gudhi library
+ *    (Geometric Understanding in Higher Dimensions) is a generic C++
+ *    library for computational topology.
+ *
+ *    Author(s):       Pawel Dlotko
+ *
+ *    Copyright (C) 2016  INRIA (France)
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, either version 3 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef CONCEPT_REAL_VALUED_TOPOLOGICAL_DATA_H_
+#define CONCEPT_REAL_VALUED_TOPOLOGICAL_DATA_H_
+
+namespace Gudhi {
+
+namespace Persistence_representations {
+
+/** \brief The concept Real_valued_topological_data describes the requirements
+  * for a type to implement a container that allows computations of its projections to R.
+  */
+class Real_valued_topological_data {
+ public:
+  /**
+* Typically there are various ways data can be projected to R. This function gives us the number of functions for
+* vectorization provided by a given class.
+  **/
+  size_t number_of_projections_to_R();
+  /**
+* This is a function to compute the projection from this container to reals. The parameter of a function have to
+* be between 0 and the value returned by number_of_projections_to_R().
+**/
+  double project_to_R(size_t number_of_projection);
+};
+
+}  // namespace Persistence_representations
+
+}  // namespace Gudhi
+
+#endif  // CONCEPT_REAL_VALUED_TOPOLOGICAL_DATA_H_
diff --git a/concept/Persistence_representations/Topological_data_with_averages.h b/concept/Persistence_representations/Topological_data_with_averages.h
new file mode 100644
index 00000000..9ebd105f
--- /dev/null
+++ b/concept/Persistence_representations/Topological_data_with_averages.h
@@ -0,0 +1,44 @@
+
+/*    This file is part of the Gudhi Library. The Gudhi library
+ *    (Geometric Understanding in Higher Dimensions) is a generic C++
+ *    library for computational topology.
+ *
+ *    Author(s):       Pawel Dlotko
+ *
+ *    Copyright (C) 2016  INRIA (France)
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, either version 3 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef CONCEPT_TOPOLOGICAL_DATA_WITH_AVERAGES_H_
+#define CONCEPT_TOPOLOGICAL_DATA_WITH_AVERAGES_H_
+
+namespace Gudhi {
+
+namespace Persistence_representations {
+
+/** \brief The concept Topological_data_with_averages describes the requirements
+  * for a type to implement a container that allows computations of averages.
+  * Note that the average object after being computed is stored in *this.
+  */
+class Topological_data_with_averages {
+ public:
+  void compute_average(const std::vector<Topological_data_with_averages*>& to_average);
+};
+
+}  // namespace Persistence_representations
+
+}  // namespace Gudhi
+
+#endif  // CONCEPT_TOPOLOGICAL_DATA_WITH_AVERAGES_H_
diff --git a/concept/Persistence_representations/Topological_data_with_distances.h b/concept/Persistence_representations/Topological_data_with_distances.h
new file mode 100644
index 00000000..a6a62307
--- /dev/null
+++ b/concept/Persistence_representations/Topological_data_with_distances.h
@@ -0,0 +1,49 @@
+/*    This file is part of the Gudhi Library. The Gudhi library
+ *    (Geometric Understanding in Higher Dimensions) is a generic C++
+ *    library for computational topology.
+ *
+ *    Author(s):       Pawel Dlotko
+ *
+ *    Copyright (C) 2016  INRIA (France)
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, either version 3 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef CONCEPT_TOPOLOGICAL_DATA_WITH_DISTANCES_H_
+#define CONCEPT_TOPOLOGICAL_DATA_WITH_DISTANCES_H_
+
+namespace Gudhi {
+
+namespace Persistence_representations {
+
+/** \brief The concept Topological_data_with_distances describes the requirements
+  * for a type to implement a container that allows computations of distance to another contained of that type.
+  * \details
+  * The second parameter of the distance function allow to declare power of a distance. The exact meaning of that
+  * number will be different for different distances. A few examples are given below:
+  * In case of p-Wasserstein distance, the power is equal to p. power = std::limit<double>::max() for bottleneck
+  * distance.
+  *
+  * In case of L^p landscape distance, the power is equal to p. s
+  */
+class Topological_data_with_distances {
+ public:
+  double distance(const Topological_data_with_distances& second, double power = 1);
+};
+
+}  // namespace Persistence_representations
+
+}  // namespace Gudhi
+
+#endif  // CONCEPT_TOPOLOGICAL_DATA_WITH_DISTANCES_H_
diff --git a/concept/Persistence_representations/Topological_data_with_scalar_product.h b/concept/Persistence_representations/Topological_data_with_scalar_product.h
new file mode 100644
index 00000000..2e506ca9
--- /dev/null
+++ b/concept/Persistence_representations/Topological_data_with_scalar_product.h
@@ -0,0 +1,42 @@
+/*    This file is part of the Gudhi Library. The Gudhi library
+ *    (Geometric Understanding in Higher Dimensions) is a generic C++
+ *    library for computational topology.
+ *
+ *    Author(s):       Pawel Dlotko
+ *
+ *    Copyright (C) 2016  INRIA (France)
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, either version 3 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef CONCEPT_TOPOLOGICAL_DATA_WITH_SCALAR_PRODUCT_H_
+#define CONCEPT_TOPOLOGICAL_DATA_WITH_SCALAR_PRODUCT_H_
+
+namespace Gudhi {
+
+namespace Persistence_representations {
+
+/** \brief The concept Topological_data_with_scalar_product describes the requirements
+  * for a type to implement a container that allows computations of scalar products.
+  */
+class Topological_data_with_scalar_product {
+ public:
+  double compute_scalar_product(const Topological_data_with_scalar_product& second);
+};
+
+}  // namespace Persistence_representations
+
+}  // namespace Gudhi
+
+#endif  // CONCEPT_TOPOLOGICAL_DATA_WITH_SCALAR_PRODUCT_H_
diff --git a/concept/Persistence_representations/Vectorized_topological_data.h b/concept/Persistence_representations/Vectorized_topological_data.h
new file mode 100644
index 00000000..b6b5b109
--- /dev/null
+++ b/concept/Persistence_representations/Vectorized_topological_data.h
@@ -0,0 +1,51 @@
+/*    This file is part of the Gudhi Library. The Gudhi library
+ *    (Geometric Understanding in Higher Dimensions) is a generic C++
+ *    library for computational topology.
+ *
+ *    Author(s):       Pawel Dlotko
+ *
+ *    Copyright (C) 2016  INRIA (France)
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, either version 3 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef CONCEPT_VECTORIZED_TOPOLOGICAL_DATA_H_
+#define CONCEPT_VECTORIZED_TOPOLOGICAL_DATA_H_
+
+namespace Gudhi {
+
+namespace Persistence_representations {
+
+/** \brief The concept Vectorized_topological_data describes the requirements
+  * for a type to implement a container that allows vectorization.
+  */
+class Vectorized_topological_data {
+ public:
+  /**
+   * There are various ways data can be vectorized. This function give us the number of functions for vectorization
+   *provided by a given class.
+  **/
+  size_t number_of_vectorize_functions();
+  /**
+   * This is a function to vectorize given container. The parameter of a function have to be between 0 and the value
+   *returned by number_of_vectorize_functions().
+  **/
+  std::vector<double> vectorize(int number_of_function);
+};
+
+}  // namespace Persistence_representations
+
+}  // namespace Gudhi
+
+#endif  // CONCEPT_VECTORIZED_TOPOLOGICAL_DATA_H_