Geogram  Version 1.9.1
A programming library of geometric algorithms
mesh_manifold_harmonics.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2000-2022 Inria
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *
8  * * Redistributions of source code must retain the above copyright notice,
9  * this list of conditions and the following disclaimer.
10  * * Redistributions in binary form must reproduce the above copyright notice,
11  * this list of conditions and the following disclaimer in the documentation
12  * and/or other materials provided with the distribution.
13  * * Neither the name of the ALICE Project-Team nor the names of its
14  * contributors may be used to endorse or promote products derived from this
15  * software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
18  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
21  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
22  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
25  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27  * POSSIBILITY OF SUCH DAMAGE.
28  *
29  * Contact: Bruno Levy
30  *
31  * https://www.inria.fr/fr/bruno-levy
32  *
33  * Inria,
34  * Domaine de Voluceau,
35  * 78150 Le Chesnay - Rocquencourt
36  * FRANCE
37  *
38  */
39 
40 #ifndef GEOGRAM_MESH_MESH_MANIFOLD_HARMONICS
41 #define GEOGRAM_MESH_MESH_MANIFOLD_HARMONICS
42 
47 #include <geogram/basic/common.h>
48 #include <geogram/basic/numeric.h>
49 #include <geogram/basic/memory.h>
50 
51 namespace GEO {
52  class Mesh;
53 
54  enum LaplaceBeltramiDiscretization {
55  COMBINATORIAL, // 1.0 everywhere
56  UNIFORM, // combinatorial divided by node degree
57  FEM_P1, // Linear finite elements
58  FEM_P1_LUMPED // Linear finite elements with lumped mass matrix
59  };
60 
77  Mesh& M, index_t nb_eigens,
78  LaplaceBeltramiDiscretization discretization,
79  const std::string& attribute_name = "eigen",
80  double shift = 0.0,
81  bool print_spectrum = false
82  );
83 
84 
89  typedef void (*ManifoldHarmonicsCallback)(
90  index_t eigen_index,
91  double eigen_val, const double* eigen_vector,
92  void* client_data
93  );
94 
109  Mesh& M, index_t nb_eigens,
110  LaplaceBeltramiDiscretization discretization,
111  ManifoldHarmonicsCallback callback,
112  index_t nb_eigens_per_band = 30,
113  double initial_shift = 0.0,
114  void* client_data = nullptr
115  );
116 
117 }
118 
119 #endif
Represents a mesh.
Definition: mesh.h:2701
Common include file, providing basic definitions. Should be included before anything else by all head...
Types and functions for memory manipulation.
Global Vorpaline namespace.
Definition: basic.h:55
void(* ManifoldHarmonicsCallback)(index_t eigen_index, double eigen_val, const double *eigen_vector, void *client_data)
A function pointer to be used with mesh_compute_manifold_harmonics_by_bands()
void mesh_compute_manifold_harmonics(Mesh &M, index_t nb_eigens, LaplaceBeltramiDiscretization discretization, const std::string &attribute_name="eigen", double shift=0.0, bool print_spectrum=false)
Computes the Manifold Harmonics basis functions.
geo_index_t index_t
The type for storing and manipulating indices.
Definition: numeric.h:329
void mesh_compute_manifold_harmonics_by_bands(Mesh &M, index_t nb_eigens, LaplaceBeltramiDiscretization discretization, ManifoldHarmonicsCallback callback, index_t nb_eigens_per_band=30, double initial_shift=0.0, void *client_data=nullptr)
Computes Laplacian eigenfunctions band by band.
Types and functions for numbers manipulation.