Functions to handle extended definitions of quantities thanks to the cs_xdef_t structures. More...

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <assert.h>
#include "bft_mem.h"
#include "cs_array.h"
#include "cs_field.h"
#include "cs_flag.h"
#include "cs_log.h"
#include "cs_mesh_location.h"
#include "cs_xdef.h"

Include dependency graph for cs_xdef.cpp:

Macros
#define	CS_XDEF_DBG 0

Functions
cs_xdef_t *	cs_xdef_volume_create (cs_xdef_type_t type, int dim, int z_id, cs_flag_t state, cs_flag_t meta, void *context)
	Allocate and initialize a new cs_xdef_t structure based on volumic elements. More...

cs_xdef_t *	cs_xdef_boundary_create (cs_xdef_type_t type, int dim, int z_id, cs_flag_t state, cs_flag_t meta, void *context)
	Allocate and initialize a new cs_xdef_t structure based on boundary elements. More...

cs_xdef_t *	cs_xdef_timestep_create (cs_xdef_type_t type, cs_flag_t state, cs_flag_t meta, void *context)
	Allocate and initialize a new cs_xdef_t structure for setting the time step. More...

cs_xdef_t *	cs_xdef_free (cs_xdef_t *d)
	Free a cs_xdef_t structure. More...

cs_xdef_t *	cs_xdef_copy (cs_xdef_t *src)
	copy a cs_xdef_t structure More...

void	cs_xdef_set_input_context (cs_xdef_t d, void input)
	In the case of a definition by an analytic function, a time function or a function relying on degrees of freedom (DoFs), this function allows one to set a more or less complex input data structure. This call should be done before the first evaluation of the associated cs_xdef_t structure. More...

void	cs_xdef_set_free_input_function (cs_xdef_t d, cs_xdef_free_input_t free_input)
	In case of a definition by an analytic function, a time function or a function relying on degrees of freedom (DoFs). One can set a function to free a complex input data structure (please refer to cs_xdef_free_input_t) for more details. More...

void	cs_xdef_set_quadrature (cs_xdef_t *d, cs_quadrature_type_t qtype)
	Set the type of quadrature to use for evaluating the given description. More...

cs_quadrature_type_t	cs_xdef_get_quadrature (cs_xdef_t *d)
	Get the type of quadrature to use for evaluating the given description. More...

cs_xdef_type_t	cs_xdef_get_type (const cs_xdef_t *d)
	Retrieve the flag dedicated to the state. More...

cs_flag_t	cs_xdef_get_state_flag (const cs_xdef_t *d)
	Retrieve the flag dedicated to the state. More...

void	cs_xdef_log_setup (const char prefix, const cs_xdef_t d)
	Output the settings related to a cs_xdef_t structure in the setup logging file. More...

void	cs_xdef_log (cs_log_t log_type, const char prefix, const cs_xdef_t d)
	Output the settings related to a cs_xdef_t structure. More...

const char *	cs_xdef_type_get_name (cs_xdef_type_t xdef_type)
	Retrieve a pointer to the cs_xdef_type's name string. More...

void	cs_xdef_array_set_values (cs_xdef_t d, bool is_owner, cs_real_t values)
	In case of definition by array, set the array values after having added this definition. More...

void	cs_xdef_array_set_zone_id (cs_xdef_t *d, int z_id)
	In case of definition by array, set the zone id related to the size of the array. By default, the zone id is the same as the zone id related to the definition so that there is no need to call this function. More...

void	cs_xdef_array_build_full2subset (const cs_xdef_t *d)
	In case of definition by array, build the full2subset array. The direct members of the cs_xdef_t structure are not modified but the context dedicated to definition by array is updated. d is declared as const to avoid a compiler warning. More...

void	cs_xdef_array_set_adjacency (cs_xdef_t d, const cs_adjacency_t adj)
	In case of definition by array, set the optional adjacency structure. More...

void	cs_xdef_array_set_sublist (cs_xdef_t *d, cs_lnum_t n_elts, const cs_lnum_t elt_ids[])
	In case of definition by array, set the optional sub-list of elements used to link elements in the partial view and in the full-length view. More...

cs_real_t *	cs_xdef_field_get_values (cs_xdef_t *def)
	Get the current field values in case of definition by field. More...

Variables
static const char *	_xdef_type_name []

Detailed Description

Functions to handle extended definitions of quantities thanks to the cs_xdef_t structures.

Macro Definition Documentation

◆ CS_XDEF_DBG

#define CS_XDEF_DBG 0

Function Documentation

◆ cs_xdef_array_build_full2subset()

void cs_xdef_array_build_full2subset ( const cs_xdef_t * d )

In case of definition by array, build the full2subset array. The direct members of the cs_xdef_t structure are not modified but the context dedicated to definition by array is updated. d is declared as const to avoid a compiler warning.

Parameters

[in,out] d pointer to a cs_xdef_t structure

◆ cs_xdef_array_set_adjacency()

void cs_xdef_array_set_adjacency	(	cs_xdef_t *	d,
		const cs_adjacency_t *	adj
	)

In case of definition by array, set the optional adjacency structure.

Parameters

[in,out]	d	pointer to a cs_xdef_t structure
[in]	adj	pointer to the adjacency structure

◆ cs_xdef_array_set_sublist()

void cs_xdef_array_set_sublist	(	cs_xdef_t *	d,
		cs_lnum_t	n_elts,
		const cs_lnum_t	elt_ids[]
	)

In case of definition by array, set the optional sub-list of elements used to link elements in the partial view and in the full-length view.

Parameters

[in,out]	d	pointer to a cs_xdef_t structure
[in]	n_elts	number of elements in the sub-list
[in]	elt_ids	list of element ids constituting the sub-list

◆ cs_xdef_array_set_values()

void cs_xdef_array_set_values	(	cs_xdef_t *	d,
		bool	is_owner,
		cs_real_t *	values
	)

In case of definition by array, set the array values after having added this definition.

Parameters

[in,out]	d	pointer to a cs_xdef_t structure
[in]	is_owner	manage or not the lifecycle of the array values
[in]	values	array of values

◆ cs_xdef_array_set_zone_id()

void cs_xdef_array_set_zone_id	(	cs_xdef_t *	d,
		int	z_id
	)

In case of definition by array, set the zone id related to the size of the array. By default, the zone id is the same as the zone id related to the definition so that there is no need to call this function.

Parameters

[in,out]	d	pointer to a cs_xdef_t structure
[in]	z_id	zone id associated to the array size

◆ cs_xdef_boundary_create()

cs_xdef_t * cs_xdef_boundary_create	(	cs_xdef_type_t	type,
		int	dim,
		int	z_id,
		cs_flag_t	state,
		cs_flag_t	meta,
		void *	context
	)

Allocate and initialize a new cs_xdef_t structure based on boundary elements.

Parameters

[in]	type	type of definition
[in]	dim	dimension of the values to define
[in]	z_id	volume zone id
[in]	state	flag to know if this uniform, cellwise, steady...
[in]	meta	metadata associated to this description
[in]	context	pointer to a structure

Returns: a pointer to the new cs_xdef_t structure

◆ cs_xdef_copy()

cs_xdef_t * cs_xdef_copy ( cs_xdef_t * src )

copy a cs_xdef_t structure

Parameters

[in] src pointer to a cs_xdef_t structure to copy

Returns: a pointer to a new allocated cs_xdef_t structure

◆ cs_xdef_field_get_values()

cs_real_t * cs_xdef_field_get_values ( cs_xdef_t * def )

Get the current field values in case of definition by field.

Parameters

[in] def pointer to a cs_xdef_t structure

Returns: the pointer to the current field values

◆ cs_xdef_free()

cs_xdef_t * cs_xdef_free ( cs_xdef_t * d )

Free a cs_xdef_t structure.

Parameters

[in,out] d pointer to a cs_xdef_t structure

Returns: nullptr

◆ cs_xdef_get_quadrature()

cs_quadrature_type_t cs_xdef_get_quadrature ( cs_xdef_t * d )

Get the type of quadrature to use for evaluating the given description.

Parameters

[in] d pointer to a cs_xdef_t structure

Returns: the type of quadrature

◆ cs_xdef_get_state_flag()

cs_flag_t cs_xdef_get_state_flag ( const cs_xdef_t * d )

Retrieve the flag dedicated to the state.

Parameters

[in] d pointer to a cs_xdef_t structure

Returns: the value of the flag

◆ cs_xdef_get_type()

cs_xdef_type_t cs_xdef_get_type ( const cs_xdef_t * d )

Retrieve the flag dedicated to the state.

Parameters

[in] d pointer to a cs_xdef_t structure

Returns: the value of the flag

◆ cs_xdef_log()

void cs_xdef_log	(	cs_log_t	log_type,
		const char *	prefix,
		const cs_xdef_t *	d
	)

Output the settings related to a cs_xdef_t structure.

Parameters

[in]	log_type	related log file to consider
[in]	prefix	optional string
[in]	d	pointer to a cs_xdef_t structure

◆ cs_xdef_log_setup()

void cs_xdef_log_setup	(	const char *	prefix,
		const cs_xdef_t *	d
	)

Output the settings related to a cs_xdef_t structure in the setup logging file.

Parameters

[in]	prefix	optional string
[in]	d	pointer to a cs_xdef_t structure

◆ cs_xdef_set_free_input_function()

void cs_xdef_set_free_input_function	(	cs_xdef_t *	d,
		cs_xdef_free_input_t *	free_input
	)

In case of a definition by an analytic function, a time function or a function relying on degrees of freedom (DoFs). One can set a function to free a complex input data structure (please refer to cs_xdef_free_input_t) for more details.

Parameters

[in,out]	d	pointer to a cs_xdef_t structure
[in]	free_input	pointer to a function which free the input structure

◆ cs_xdef_set_input_context()

void cs_xdef_set_input_context	(	cs_xdef_t *	d,
		void *	input
	)

In the case of a definition by an analytic function, a time function or a function relying on degrees of freedom (DoFs), this function allows one to set a more or less complex input data structure. This call should be done before the first evaluation of the associated cs_xdef_t structure.

Parameters

[in,out]	d	pointer to a cs_xdef_t structure
[in]	input	pointer to an input structure

◆ cs_xdef_set_quadrature()

void cs_xdef_set_quadrature	(	cs_xdef_t *	d,
		cs_quadrature_type_t	qtype
	)

Set the type of quadrature to use for evaluating the given description.

Parameters

[in,out]	d	pointer to a cs_xdef_t structure
[in]	qtype	type of quadrature

◆ cs_xdef_timestep_create()

cs_xdef_t * cs_xdef_timestep_create	(	cs_xdef_type_t	type,
		cs_flag_t	state,
		cs_flag_t	meta,
		void *	context
	)

Allocate and initialize a new cs_xdef_t structure for setting the time step.

Parameters

[in]	type	type of definition
[in]	state	flag to know if this uniform, cellwise, steady...
[in]	meta	metadata associated to this description
[in]	context	pointer to a structure storing the parameters (cast on-the-fly according to the type of definition)

Returns: a pointer to the new cs_xdef_t structure

◆ cs_xdef_type_get_name()

const char * cs_xdef_type_get_name ( cs_xdef_type_t xdef_type )

Retrieve a pointer to the cs_xdef_type's name string.

Parameters

[in] xdef_type type to query

Returns: a pointer to mathing name string

◆ cs_xdef_volume_create()

cs_xdef_t * cs_xdef_volume_create	(	cs_xdef_type_t	type,
		int	dim,
		int	z_id,
		cs_flag_t	state,
		cs_flag_t	meta,
		void *	context
	)

Allocate and initialize a new cs_xdef_t structure based on volumic elements.

Parameters

[in]	type	type of definition
[in]	dim	dimension of the values to define
[in]	z_id	volume zone id
[in]	state	flag to know if this uniform, cellwise, steady...
[in]	meta	metadata associated to this description
[in]	context	pointer to a structure

Returns: a pointer to the new cs_xdef_t structure

Variable Documentation

◆ _xdef_type_name

const char* _xdef_type_name[]

static

Initial value:

= {"CS_XDEF_BY_ANALYTIC_FUNCTION",
     "CS_XDEF_BY_ARRAY",
     "CS_XDEF_BY_DOF_FUNCTION",
     "CS_XDEF_BY_FIELD",
     "CS_XDEF_BY_FUNCTION",
     "CS_XDEF_BY_QOV",
     "CS_XDEF_BY_SUB_DEFINITIONS",
     "CS_XDEF_BY_TIME_FUNCTION",
     "CS_XDEF_BY_VALUE",
     "out of range"}

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ CS_XDEF_DBG

Function Documentation

◆ cs_xdef_array_build_full2subset()

◆ cs_xdef_array_set_adjacency()

◆ cs_xdef_array_set_sublist()

◆ cs_xdef_array_set_values()

◆ cs_xdef_array_set_zone_id()

◆ cs_xdef_boundary_create()

◆ cs_xdef_copy()

◆ cs_xdef_field_get_values()

◆ cs_xdef_free()

◆ cs_xdef_get_quadrature()

◆ cs_xdef_get_state_flag()

◆ cs_xdef_get_type()

◆ cs_xdef_log()

◆ cs_xdef_log_setup()

◆ cs_xdef_set_free_input_function()

◆ cs_xdef_set_input_context()

◆ cs_xdef_set_quadrature()

◆ cs_xdef_timestep_create()

◆ cs_xdef_type_get_name()

◆ cs_xdef_volume_create()

Variable Documentation

◆ _xdef_type_name