#include "cs_base.h"
#include "cs_cdo_connect.h"
#include "cs_flag.h"
#include "cs_math.h"
#include "cs_mesh.h"
#include "cs_mesh_quantities.h"

Include dependency graph for cs_cdo_quantities.h:

Data Structures
struct	cs_quant_info_t

struct	cs_quant_t

struct	cs_cdo_quantities_t

Enumerations
enum	cs_cdo_quantities_cell_center_algo_t { CS_CDO_QUANTITIES_MEANV_CENTER, CS_CDO_QUANTITIES_BARYC_CENTER, CS_CDO_QUANTITIES_SATURNE_CENTER }
	Type of algorithm used to compute the cell centers. More...

enum	cs_cdo_quantities_bit_t { CS_CDO_QUANTITIES_EB_SCHEME = 1<<0, CS_CDO_QUANTITIES_FB_SCHEME = 1<<1, CS_CDO_QUANTITIES_HHO_SCHEME = 1<<2, CS_CDO_QUANTITIES_VB_SCHEME = 1<<3, CS_CDO_QUANTITIES_VCB_SCHEME = 1<<4 }
	Bit values for setting which quantities to compute. More...

Functions
void	cs_cdo_quantities_set (cs_flag_t option_flag)
	Set which quantities have to be computed. Additionnal quantities are added to cs_cdo_quantities_flag (static variable) More...

void	cs_cdo_quantities_set_algo_ccenter (cs_cdo_quantities_cell_center_algo_t algo)
	Set the type of algorithm to use for computing the cell center. More...

cs_cdo_quantities_t *	cs_cdo_quantities_build (const cs_mesh_t m, const cs_mesh_quantities_t mq, const cs_cdo_connect_t *topo)
	Build a cs_cdo_quantities_t structure. Some quantities are shared with the cs_mesh_quantities_t structure and other are not built according to the given flags in cs_cdo_quantities_flag. More...

cs_cdo_quantities_t *	cs_cdo_quantities_free (cs_cdo_quantities_t *q)
	Destroy a cs_cdo_quantities_t structure. More...

void	cs_cdo_quantities_summary (const cs_cdo_quantities_t *quant)
	Summarize generic information about the cdo mesh quantities. More...

void	cs_cdo_quantities_dump (const cs_cdo_quantities_t *cdoq)
	Dump a cs_cdo_quantities_t structure. More...

void	cs_cdo_quantities_compute_pvol_fc (const cs_cdo_quantities_t cdoq, const cs_adjacency_t c2f, cs_real_t **p_pvol_fc)
	Compute the portion of volume surrounding each face of a cell. This volume corresponds to a pyramid with base f and apex x_f The computed quantity is scanned with the c2f adjacency. More...

void	cs_cdo_quantities_compute_pvol_ec (const cs_cdo_quantities_t cdoq, const cs_adjacency_t c2e, cs_real_t **p_pvol_ec)
	Compute the portion of volume surrounding each edge of a cell The computed quantity is scanned with the c2e adjacency. More...

void	cs_cdo_quantities_compute_dual_volumes (const cs_cdo_quantities_t cdoq, const cs_adjacency_t c2v, cs_real_t *dual_vol)
	Compute the dual volume surrounding each vertex. More...

void	cs_cdo_quantities_compute_i_tef (const cs_cdo_connect_t connect, const cs_cdo_quantities_t cdoq, cs_lnum_t f_id, cs_real_t tef[])
	Compute the area of the triangles with basis each edge of the face and apex the face center. Case of interior faces. Storage in agreement with the bf2v adjacency structure. More...

void	cs_cdo_quantities_compute_b_tef (const cs_cdo_connect_t connect, const cs_cdo_quantities_t cdoq, cs_lnum_t bf_id, cs_real_t tef[])
	Compute the area of the triangles with basis each edge of the face and apex the face center. Case of boundary faces. Storage in agreement with the bf2v adjacency structure. More...

void	cs_cdo_quantities_compute_i_wvf (const cs_cdo_connect_t connect, const cs_cdo_quantities_t cdoq, cs_lnum_t f_id, cs_real_t wvf[])
	Compute the weight related to each vertex of a face. This weight ensures a 2nd order approximation if the face center is the face barycenter. Case of interior faces. More...

void	cs_cdo_quantities_compute_b_wvf (const cs_cdo_connect_t connect, const cs_cdo_quantities_t cdoq, cs_lnum_t bf_id, cs_real_t wvf[])
	Compute the weight related to each vertex of a face. This weight ensures a 2nd order approximation if the face center is the face barycenter. Case of boundary faces. More...

cs_quant_t	cs_quant_set_face (cs_lnum_t f_id, const cs_cdo_quantities_t *cdoq)
	Define a cs_quant_t structure for a primal face (interior or border) More...

cs_nvec3_t	cs_quant_set_face_nvec (cs_lnum_t f_id, const cs_cdo_quantities_t *cdoq)
	Retrieve the face surface and its unit normal vector for a primal face (interior or border) More...

cs_nvec3_t	cs_quant_set_edge_nvec (cs_lnum_t e_id, const cs_cdo_quantities_t *cdoq)
	Get the normalized vector associated to a primal edge. More...

cs_nvec3_t	cs_quant_set_dedge_nvec (cs_lnum_t shift, const cs_cdo_quantities_t *cdoq)
	Get the two normalized vector associated to a dual edge. More...

void	cs_quant_dump (FILE *f, cs_lnum_t num, const cs_quant_t q)
	Dump a cs_quant_t structure. More...

Enumeration Type Documentation

◆ cs_cdo_quantities_bit_t

enum cs_cdo_quantities_bit_t

Bit values for setting which quantities to compute.

Enumerator
CS_CDO_QUANTITIES_EB_SCHEME	Geometrical quantities related to edge-based schemes
CS_CDO_QUANTITIES_FB_SCHEME	Geometrical quantities related to face-based schemes
CS_CDO_QUANTITIES_HHO_SCHEME	Geometrical quantities related to HHO schemes
CS_CDO_QUANTITIES_VB_SCHEME	Geometrical quantities related to vertex-based schemes
CS_CDO_QUANTITIES_VCB_SCHEME	Geometrical quantities related to vertex+cell-based schemes

◆ cs_cdo_quantities_cell_center_algo_t

enum cs_cdo_quantities_cell_center_algo_t

Type of algorithm used to compute the cell centers.

Enumerator
CS_CDO_QUANTITIES_MEANV_CENTER	Center is computed as the mean of cell vertices
CS_CDO_QUANTITIES_BARYC_CENTER	Center is computed as the real cell barycenter (default choice)
CS_CDO_QUANTITIES_SATURNE_CENTER	Center is the one defined in cs_mesh_quantities_t (i.e. the one used in the legacy Finite Volume scheme).

Function Documentation

◆ cs_cdo_quantities_build()

cs_cdo_quantities_t* cs_cdo_quantities_build	(	const cs_mesh_t *	m,
		const cs_mesh_quantities_t *	mq,
		const cs_cdo_connect_t *	topo
	)

Build a cs_cdo_quantities_t structure. Some quantities are shared with the cs_mesh_quantities_t structure and other are not built according to the given flags in cs_cdo_quantities_flag.

Parameters

[in]	m	pointer to a cs_mesh_t structure
[in]	mq	pointer to a cs_mesh_quantities_t structure
[in]	topo	pointer to a cs_cdo_connect_t structure

Returns: a new allocated pointer to a cs_cdo_quantities_t structure

◆ cs_cdo_quantities_compute_b_tef()

void cs_cdo_quantities_compute_b_tef	(	const cs_cdo_connect_t *	connect,
		const cs_cdo_quantities_t *	cdoq,
		cs_lnum_t	bf_id,
		cs_real_t	tef[]
	)

Compute the area of the triangles with basis each edge of the face and apex the face center. Case of boundary faces. Storage in agreement with the bf2v adjacency structure.

Parameters

[in]	connect	pointer to a cs_cdo_connect_t structure
[in]	cdoq	pointer to a cs_cdo_quantities_t structure
[in]	bf_id	border face id
[in,out]	tef	quantities to compute (pre-allocated)

◆ cs_cdo_quantities_compute_b_wvf()

void cs_cdo_quantities_compute_b_wvf	(	const cs_cdo_connect_t *	connect,
		const cs_cdo_quantities_t *	cdoq,
		cs_lnum_t	bf_id,
		cs_real_t	wvf[]
	)

Compute the weight related to each vertex of a face. This weight ensures a 2nd order approximation if the face center is the face barycenter. Case of boundary faces.

Parameters

[in]	connect	pointer to a cs_cdo_connect_t structure
[in]	cdoq	pointer to a cs_cdo_quantities_t structure
[in]	bf_id	border face id
[in,out]	wvf	quantities to compute (pre-allocated)

◆ cs_cdo_quantities_compute_dual_volumes()

void cs_cdo_quantities_compute_dual_volumes	(	const cs_cdo_quantities_t *	cdoq,
		const cs_adjacency_t *	c2v,
		cs_real_t *	dual_vol
	)

Compute the dual volume surrounding each vertex.

Parameters

[in]	cdoq	pointer to cs_cdo_quantities_t structure
[in]	c2v	pointer to the cell–>vertices connectivity
[in,out]	dual_vol	dual volumes related to each vertex

◆ cs_cdo_quantities_compute_i_tef()

void cs_cdo_quantities_compute_i_tef	(	const cs_cdo_connect_t *	connect,
		const cs_cdo_quantities_t *	cdoq,
		cs_lnum_t	f_id,
		cs_real_t	tef[]
	)

Compute the area of the triangles with basis each edge of the face and apex the face center. Case of interior faces. Storage in agreement with the bf2v adjacency structure.

Parameters

[in]	connect	pointer to a cs_cdo_connect_t structure
[in]	cdoq	pointer to a cs_cdo_quantities_t structure
[in]	f_id	interior face id
[in,out]	tef	quantities to compute (pre-allocated)

Compute the area of the triangles with basis each edge of the face and apex the face center. Case of interior faces. Storage in agreement with the bf2v adjacency structure.

Parameters

[in]	connect	pointer to a cs_cdo_connect_t structure
[in]	cdoq	pointer to a cs_cdo_quantities_t structure
[in]	f_id	interior face id
[in,out]	tef	quantities to compute (pre-allocated)

◆ cs_cdo_quantities_compute_i_wvf()

void cs_cdo_quantities_compute_i_wvf	(	const cs_cdo_connect_t *	connect,
		const cs_cdo_quantities_t *	cdoq,
		cs_lnum_t	f_id,
		cs_real_t	wvf[]
	)

Compute the weight related to each vertex of a face. This weight ensures a 2nd order approximation if the face center is the face barycenter. Case of interior faces.

Parameters

[in]	connect	pointer to a cs_cdo_connect_t structure
[in]	cdoq	pointer to a cs_cdo_quantities_t structure
[in]	f_id	interior face id
[in,out]	wvf	quantities to compute (pre-allocated)

◆ cs_cdo_quantities_compute_pvol_ec()

void cs_cdo_quantities_compute_pvol_ec	(	const cs_cdo_quantities_t *	cdoq,
		const cs_adjacency_t *	c2e,
		cs_real_t **	p_pvol_ec
	)

Compute the portion of volume surrounding each edge of a cell The computed quantity is scanned with the c2e adjacency.

Parameters

[in]	cdoq	pointer to cs_cdo_quantities_t structure
[in]	c2e	pointer to the cell –> edges connectivity
[in,out]	p_pvol_ec	double pointer to the edge volume in each cell If not allocated before calling this function, one allocates the array storing the volumes

◆ cs_cdo_quantities_compute_pvol_fc()

void cs_cdo_quantities_compute_pvol_fc	(	const cs_cdo_quantities_t *	cdoq,
		const cs_adjacency_t *	c2f,
		cs_real_t **	p_pvol_fc
	)

Compute the portion of volume surrounding each face of a cell. This volume corresponds to a pyramid with base f and apex x_f The computed quantity is scanned with the c2f adjacency.

Parameters

[in]	cdoq	pointer to cs_cdo_quantities_t structure
[in]	c2f	pointer to the cell –> edges connectivity
[in,out]	p_pvol_fc	double pointer to the face volume in each cell If not allocated before calling this function, one allocates the array storing the volumes

◆ cs_cdo_quantities_dump()

void cs_cdo_quantities_dump ( const cs_cdo_quantities_t * cdoq )

Dump a cs_cdo_quantities_t structure.

Parameters

[in] cdoq pointer to cs_cdo_quantities_t structure

◆ cs_cdo_quantities_free()

cs_cdo_quantities_t* cs_cdo_quantities_free ( cs_cdo_quantities_t * cdoq )

Destroy a cs_cdo_quantities_t structure.

Parameters

[in] q pointer to the cs_cdo_quantities_t struct. to free

Returns: a NULL pointer

Parameters

[in] cdoq pointer to the cs_cdo_quantities_t struct. to free

Returns: a NULL pointer

◆ cs_cdo_quantities_set()

void cs_cdo_quantities_set ( cs_flag_t option_flag )

Set which quantities have to be computed. Additionnal quantities are added to cs_cdo_quantities_flag (static variable)

Parameters

[in] option_flag flag to set geometrical quantities to compute

◆ cs_cdo_quantities_set_algo_ccenter()

void cs_cdo_quantities_set_algo_ccenter ( cs_cdo_quantities_cell_center_algo_t algo )

Set the type of algorithm to use for computing the cell center.

Parameters

[in] algo type of algorithm

◆ cs_cdo_quantities_summary()

void cs_cdo_quantities_summary ( const cs_cdo_quantities_t * quant )

Summarize generic information about the cdo mesh quantities.

Parameters

[in] quant pointer to cs_cdo_quantities_t structure

◆ cs_quant_dump()

void cs_quant_dump	(	FILE *	f,
		cs_lnum_t	num,
		const cs_quant_t	q
	)

Dump a cs_quant_t structure.

Parameters

[in]	f	FILE struct (stdout if NULL)
[in]	num	entity number related to this quantity struct.
[in]	q	cs_quant_t structure to dump

◆ cs_quant_set_dedge_nvec()

cs_nvec3_t cs_quant_set_dedge_nvec	(	cs_lnum_t	shift,
		const cs_cdo_quantities_t *	cdoq
	)

Get the two normalized vector associated to a dual edge.

Parameters

[in]	shift	position in c2f_idx
[in]	cdoq	pointer to a cs_cdo_quantities_t structure

Returns: a pointer to the dual edge normalized vector

◆ cs_quant_set_edge_nvec()

cs_nvec3_t cs_quant_set_edge_nvec	(	cs_lnum_t	e_id,
		const cs_cdo_quantities_t *	cdoq
	)

Get the normalized vector associated to a primal edge.

Parameters

[in]	e_id	id related to an edge
[in]	cdoq	pointer to a cs_cdo_quantities_t structure

Returns: a pointer to the edge normalized vector

◆ cs_quant_set_face()

cs_quant_t cs_quant_set_face	(	cs_lnum_t	f_id,
		const cs_cdo_quantities_t *	cdoq
	)

Define a cs_quant_t structure for a primal face (interior or border)

Parameters

[in]	f_id	id related to the face (f_id > n_i_face -> border face)
[in]	cdoq	pointer to a cs_cdo_quantities_t structure

Returns: a initialize structure

◆ cs_quant_set_face_nvec()

cs_nvec3_t cs_quant_set_face_nvec	(	cs_lnum_t	f_id,
		const cs_cdo_quantities_t *	cdoq
	)

Retrieve the face surface and its unit normal vector for a primal face (interior or border)

Parameters

[in]	f_id	id related to the face (f_id > n_i_face -> border face)
[in]	cdoq	pointer to a cs_cdo_quantities_t structure

Returns: a pointer to the face normalized vector

Data Structures

Enumerations

Functions

Enumeration Type Documentation

◆ cs_cdo_quantities_bit_t

◆ cs_cdo_quantities_cell_center_algo_t

Function Documentation

◆ cs_cdo_quantities_build()

◆ cs_cdo_quantities_compute_b_tef()

◆ cs_cdo_quantities_compute_b_wvf()

◆ cs_cdo_quantities_compute_dual_volumes()

◆ cs_cdo_quantities_compute_i_tef()

◆ cs_cdo_quantities_compute_i_wvf()

◆ cs_cdo_quantities_compute_pvol_ec()

◆ cs_cdo_quantities_compute_pvol_fc()

◆ cs_cdo_quantities_dump()

◆ cs_cdo_quantities_free()

◆ cs_cdo_quantities_set()

◆ cs_cdo_quantities_set_algo_ccenter()

◆ cs_cdo_quantities_summary()

◆ cs_quant_dump()

◆ cs_quant_set_dedge_nvec()

◆ cs_quant_set_edge_nvec()

◆ cs_quant_set_face()

◆ cs_quant_set_face_nvec()