MatCreateHtoolFromKernel

Creates a MATHTOOL from a user-supplied kernel.

Synopsis

#include "petscmat.h" 
PetscErrorCode MatCreateHtoolFromKernel(MPI_Comm comm, PetscInt m, PetscInt n, PetscInt M, PetscInt N, PetscInt spacedim, const PetscReal coords_target[], const PetscReal coords_source[], MatHtoolKernelFn *kernel, void *kernelctx, Mat *B)

Input Parameters

• comm - MPI communicator

• m - number of local rows (or PETSC_DECIDE to have calculated if M is given)

• n - number of local columns (or PETSC_DECIDE to have calculated if N is given)

• M - number of global rows (or PETSC_DETERMINE to have calculated if m is given)

• N - number of global columns (or PETSC_DETERMINE to have calculated if n is given)

• spacedim - dimension of the space coordinates

• coords_target - coordinates of the target

• coords_source - coordinates of the source

• kernel - computational kernel (or NULL)

• kernelctx - kernel context (if kernel is NULL, the pointer must be of type htool::VirtualGenerator*)

Output Parameter

• B - matrix

Options Database Keys

• -mat_htool_min_cluster_size <PetscInt> - minimal leaf size in cluster tree

• -mat_htool_max_block_size <PetscInt> - maximal number of coefficients in a dense block

• -mat_htool_epsilon <PetscReal> - relative error in Frobenius norm when approximating a block

• -mat_htool_eta <PetscReal> - admissibility condition tolerance

• -mat_htool_min_target_depth <PetscInt> - minimal cluster tree depth associated with the rows

• -mat_htool_min_source_depth <PetscInt> - minimal cluster tree depth associated with the columns

• -mat_htool_compressor <sympartialACA, fullACA, SVD> - type of compression

• -mat_htool_clustering <PCARegular, PCAGeometric, BounbingBox1Regular, BoundingBox1Geometric> - type of clustering

See Also

Matrices, Mat, MatCreate(), MATHTOOL, PCSetCoordinates(), MatHtoolSetKernel(), MatHtoolCompressorType, MATH2OPUS, MatCreateH2OpusFromKernel()

Level

intermediate

Location

src/mat/impls/htool/htool.cxx

Examples

src/ksp/ksp/tutorials/ex82.c

---

Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages