cs_lagr_event.h File Reference

#include "cs_defs.h"
#include "cs_lagr_particle.h"
#include "assert.h"

Include dependency graph for cs_lagr_event.h:

Go to the source code of this file.

Data Structures
struct	cs_lagr_event_attribute_map_t
struct	cs_lagr_event_set_t

Macros
#define	CS_EVENT_INFLOW   (1 << 0)
#define	CS_EVENT_OUTFLOW   (1 << 1)
#define	CS_EVENT_REBOUND   (1 << 2)
#define	CS_EVENT_DEPOSITION   (1 << 3)
#define	CS_EVENT_RESUSPENSION   (1 << 4)
#define	CS_EVENT_ROLL_OFF   (1 << 5)
#define	CS_EVENT_ROLL_ON   (1 << 6)
#define	CS_EVENT_FOULING   (1 << 7)

Enumerations
enum	cs_lagr_event_attribute_t {   CS_LAGR_E_FLAG = CS_LAGR_N_ATTRIBUTES, CS_LAGR_E_CELL_ID, CS_LAGR_E_FACE_ID, CS_LAGR_E_VELOCITY,   CS_LAGR_N_E_ATTRIBUTES }

Functions
void	cs_lagr_event_initialize (void)
	Define event map based on defined options. More...
void	cs_lagr_event_finalize (void)
	Destroy event set map if it exists. More...
const cs_lagr_event_attribute_map_t *	cs_lagr_event_get_attr_map (void)
	Return const pointer to the main event attribute map structure. More...
const char *	cs_lagr_event_get_attr_name (cs_lagr_event_attribute_t attr)
	Return name associated with a given attribute. More...
cs_lagr_event_set_t *	cs_lagr_event_set_create (void)
void	cs_lagr_event_set_destroy (cs_lagr_event_set_t **events)
void	cs_lagr_event_get_attr_info (const cs_lagr_event_set_t *events, cs_lagr_event_attribute_t attr, size_t *extents, size_t *size, ptrdiff_t *displ, cs_datatype_t *datatype, int *count)
	Get data extents for a given event attribute. More...
void	cs_lagr_event_attr_in_range (int attr)
	Check if an event attribute is in a valid range. More...
void	cs_lagr_event_set_resize (cs_lagr_event_set_t *event_set, cs_lnum_t min_size)
void	cs_lagr_event_set_dump (const cs_lagr_event_set_t *events)
	Dump a cs_lagr_event_set_t structure. More...
void	cs_lagr_event_init_from_particle (cs_lagr_event_set_t *events, cs_lagr_particle_set_t *particles, cs_lnum_t event_id, cs_lnum_t particle_id)
cs_lagr_event_set_t *	cs_lagr_event_set_boundary_interaction (void)

Macro Definition Documentation

CS_EVENT_DEPOSITION

#define CS_EVENT_DEPOSITION   (1 << 3)

deposistion event

CS_EVENT_FOULING

#define CS_EVENT_FOULING   (1 << 7)

fouling

CS_EVENT_INFLOW

#define CS_EVENT_INFLOW   (1 << 0)

Flags specifying general event attributes

inflow event

CS_EVENT_OUTFLOW

#define CS_EVENT_OUTFLOW   (1 << 1)

outflow event

CS_EVENT_REBOUND

#define CS_EVENT_REBOUND   (1 << 2)

rebound on wall

CS_EVENT_RESUSPENSION

#define CS_EVENT_RESUSPENSION   (1 << 4)

resuspension event

CS_EVENT_ROLL_OFF

#define CS_EVENT_ROLL_OFF   (1 << 5)

roll off

CS_EVENT_ROLL_ON

#define CS_EVENT_ROLL_ON   (1 << 6)

roll on

Enumeration Type Documentation

cs_lagr_event_attribute_t

enum cs_lagr_event_attribute_t

Prefedined event attributes

Enumerator
CS_LAGR_E_FLAG	local flag
CS_LAGR_E_CELL_ID	local cell id
CS_LAGR_E_FACE_ID	local face id (-1 if not on boundary)
CS_LAGR_E_VELOCITY	velocity following event
CS_LAGR_N_E_ATTRIBUTES

Function Documentation

cs_lagr_event_attr_in_range()

void cs_lagr_event_attr_in_range

(

int

attr

)

Check if an event attribute is in a valid range.

If this is not the case, a fatal error is provoked.

Parameters

[in]

attr

event attribute

cs_lagr_event_finalize()

void cs_lagr_event_finalize

(

void

)

Destroy event set map if it exists.

Destroy event set map if it exists.

cs_lagr_event_get_attr_info()

void cs_lagr_event_get_attr_info	(	const cs_lagr_event_set_t *	events,
		cs_lagr_event_attribute_t	attr,
		size_t *	extents,
		size_t *	size,
		ptrdiff_t *	displ,
		cs_datatype_t *	datatype,
		int *	count
	)

Get data extents for a given event attribute.

For attributes not currently present, the displacement and data size should be -1 and 0 respectively.

Parameters

[in]	events	associated event set
[in]	attr	event attribute
[out]	extents	size (in bytes) of event structure, or NULL
[out]	size	size (in bytes) of attribute in event structure, or NULL
[out]	displ	displacement (in bytes) in event structure, or NULL
[out]	datatype	datatype of associated attribute, or NULL
[out]	count	number of type values associated with attribute, or NULL

Get data extents for a given event attribute.

For attributes not currently present, the displacement and data size should be -1 and 0 respectively.

Parameters

[in]	events	associated event set
[in]	attr	event attribute
[out]	extents	size (in bytes) of event structure, or NULL
[out]	size	size (in bytes) of attribute in event structure, or NULL
[out]	displ	displacement (in bytes) in event structure, or NULL
[out]	datatype	datatype of associated attribute, or NULL
[out]	count	number of type values associated with attribute, or NULL

cs_lagr_event_get_attr_map()

const cs_lagr_event_attribute_map_t* cs_lagr_event_get_attr_map

(

void

)

Return const pointer to the main event attribute map structure.

Returns

pointer to current event attribute map, or NULL

Return const pointer to the main event attribute map structure.

Returns

pointer to current particle event attrbute map, or NULL

cs_lagr_event_get_attr_name()

const char* cs_lagr_event_get_attr_name

(

cs_lagr_event_attribute_t

attr

)

Return name associated with a given attribute.

Parameters

[in]

attr

event attribute

cs_lagr_event_init_from_particle()

void cs_lagr_event_init_from_particle	(	cs_lagr_event_set_t *	events,
		cs_lagr_particle_set_t *	particles,
		cs_lnum_t	event_id,
		cs_lnum_t	particle_id
	)

cs_lagr_event_initialize()

void cs_lagr_event_initialize

(

void

)

Define event map based on defined options.

This function should only be called after cs_lagr_particle_attr_initialize, as it may use elements from the main particle attributes map.

Define event map based on defined options.

This function should only be called after cs_lagr_particle_attr_initialize, as it may use elements from the main particle attributes map.

cs_lagr_event_set_boundary_interaction()

cs_lagr_event_set_t* cs_lagr_event_set_boundary_interaction

(

void

)

Return a cs_lagr_event_set_t structure for particle/boundary interactions.

The event set is created if not present yet.

This event set is automatically freed and destroyed at the end of the computation.

Returns

pointer to event set

cs_lagr_event_set_create()

cs_lagr_event_set_t* cs_lagr_event_set_create

(

void

)

Create a cs_lagr_event_set_t structure.

Returns

pointer to event set

cs_lagr_event_set_destroy()

void cs_lagr_event_set_destroy

(

cs_lagr_event_set_t **

events

)

Destroy a cs_lagr_event_set_t structure.

Parameters

[in,out]

events

pointer to pointer to event set to destroy

cs_lagr_event_set_dump()

void cs_lagr_event_set_dump

(

const cs_lagr_event_set_t *

events

)

Dump a cs_lagr_event_set_t structure.

Parameters

[in]	events	cs_lagr_event_t structure to dump
[in]	events	cs_lagr_event_set_t structure to dump

cs_lagr_event_set_resize()

void cs_lagr_event_set_resize	(	cs_lagr_event_set_t *	event_set,
		cs_lnum_t	min_size
	)