dolfinx Namespace Reference

Top-level namespace. More...

Namespaces
namespace	common
	Miscellaneous classes, functions and types.
namespace	MPI
	MPI support functionality.
namespace	fem
	Finite element method functionality.
namespace	mesh
	Mesh data structures and algorithms on meshes.
namespace	geometry
	Geometry data structures and algorithms.
namespace	graph
	Graph data structures and algorithms.
namespace	io
	Support for file IO.
namespace	la
	Linear algebra interface.
namespace	nls
	Nonlinear solvers.
namespace	refinement
	Mesh refinement algorithms.

Classes
struct	__unsigned_projection
class	Table
	This class provides storage and pretty-printing for tables. More...

Concepts
concept	scalar

Functions
consteval std::string_view	version ()
	Return DOLFINx version string.
consteval std::string_view	ufcx_signature ()
	Return UFC signature string.
consteval std::string_view	git_commit_hash ()
consteval bool	has_debug ()
consteval bool	has_petsc ()
	Return true if DOLFINx is compiled with PETSc.
consteval bool	has_slepc ()
	Return true if DOLFINx is compiled with SLEPc.
consteval bool	has_parmetis ()
	Return true if DOLFINx is compiled with ParMETIS.
consteval bool	has_kahip ()
	Return true if DOLFINx is compiled with KaHIP.
consteval bool	has_adios2 ()
	Return true if DOLFINX is compiled with ADIOS2.
consteval bool	has_ptscotch ()
	Return true if DOLFINX is compiled with PT-SCOTCH.
consteval bool	has_superlu_dist ()
	Return true if DOLFINx is compiled with SuperLU_DIST.
consteval bool	has_complex_ufcx_kernels ()
void	init_logging (int argc, char *argv[])
	Optional initialisation of the logging backend.
template<int BITS = 8, typename P = std::identity, std::ranges::random_access_range R>
constexpr void	radix_sort (R &&range, P proj={})
	Sort a range with radix sorting algorithm. The bucket size is determined by the number of bits to sort at a time (2^BITS).
template<typename T, int BITS = 16>
std::vector< std::int32_t >	sort_by_perm (std::span< const T > x, std::size_t shape1)
	Compute the permutation array that sorts a 2D array by row.
Table	timing_table ()
	Return a summary of timings and tasks in a Table.
void	list_timings (MPI_Comm comm, Table::Reduction reduction=Table::Reduction::max)
	List a summary of timings and tasks.
std::pair< int, std::chrono::duration< double, std::ratio< 1 > > >	timing (const std::string &task)
	Return timing (count, total wall time) for given task.
std::map< std::string, std::pair< int, std::chrono::duration< double, std::ratio< 1 > > > >	timings ()
	Logged elapsed times.

Variables
constexpr __unsigned_projection	unsigned_projection {}
	Projection from signed to signed int.

Detailed Description

Top-level namespace.

Function Documentation

git_commit_hash()

std::string_view git_commit_hash ( )

consteval

Return git changeset hash (returns "unknown" if changeset is not known)

has_complex_ufcx_kernels()

bool has_complex_ufcx_kernels ( )

consteval

Return true if DOLFINx supports UFCx kernels with arguments of type C99 _Complex. When DOLFINx was built with MSVC this returns false. This returning false does not preclude using DOLFINx with kernels accepting std::complex.

has_debug()

bool has_debug ( )

consteval

Return true if DOLFINx is compiled in debugging mode, i.e., with assertions on

init_logging()

void init_logging	(	int	argc,
		char *	argv[] )

Optional initialisation of the logging backend.

The log verbosity can be controlled from the command line using SPDLOG_LEVEL=<level>, where <level> is info, warn, debug, etc.

The full spdlog API can be used in applications to control the log system. See https://github.com/gabime/spdlog for the spdlog documentation.

Parameters

[in]	argc	Number of command line arguments.
[in]	argv	Command line argument vector.

list_timings()

void list_timings	(	MPI_Comm	comm,
		Table::Reduction	reduction = Table::Reduction::max )

List a summary of timings and tasks.

MPI_AVG reduction is printed.

Parameters

[in]	comm	MPI Communicator.
[in]	reduction	MPI Reduction to apply (min, max or average).

radix_sort()

template<int BITS = 8, typename P = std::identity, std::ranges::random_access_range R>

void radix_sort ( R && range, P proj = {} )

constexpr

Sort a range with radix sorting algorithm. The bucket size is determined by the number of bits to sort at a time (2^BITS).

This allows usage with standard range containers of integral types, for example

std::array<std::int16_t, 3> a{2, 3, 1};
dolfinx::radix_sort(a); // a = {1, 2, 3}

Additionally the projection based approach of the STL library is adapted, which allows for versatile usage, for example the easy realization of an argsort

std::array<std::int16_t, 3> a{2, 3, 1};
std::array<std::int16_t, 3> i{0, 1, 2};
dolfinx::radix_sort(i, [&](auto i){ return a[i]; }); // yields i = {2, 0,
1} and a[i] = {1, 2, 3};

Template Parameters

BITS	The number of bits to sort at a time.
P	Projection type to be applied on range elements to produce a sorting index.
R	Type of the range to sort.

Parameters

[in,out]	range	The range to sort.
[in]	proj	Element projection.

sort_by_perm()

template<typename T, int BITS = 16>

std::vector< std::int32_t > sort_by_perm	(	std::span< const T >	x,
		std::size_t	shape1 )

Compute the permutation array that sorts a 2D array by row.

Parameters

[in]	x	The flattened 2D array to compute the permutation array for (row-major storage).
[in]	shape1	The number of columns of x.

Returns

The permutation array such that x[perm[i]] <= x[perm[i +1]].

Precondition

x.size() must be a multiple of shape1.

Note

This function is suitable for small values of shape1. Each column of x is copied into an array that is then sorted.

timing()

std::pair< int, std::chrono::duration< double, std::ratio< 1 > > > timing

(

const std::string &

task

)

Return timing (count, total wall time) for given task.

Parameters

[in]

task

Name of a task

Returns

The (count, total wall time) for the task.

timing_table()

dolfinx::Table timing_table

(

)

Return a summary of timings and tasks in a Table.

Returns

Table with timings.

timings()

std::map< std::string, std::pair< int, std::chrono::duration< double, std::ratio< 1 > > > > timings

(

)

Logged elapsed times.

Returns

Elapsed [task id: (count, total wall time)].