YAC: src/mci/fields.h File Reference

Searching...

No Matches

#include "component.h"

Include dependency graph for fields.h:

This graph shows which files directly or indirectly include this file:

Enumerations
enum	yac_field_exchange_type { NOTHING = 0 , SOURCE = 1 , TARGET = 2 }

Functions
struct coupling_field *	yac_coupling_field_new (char const field_name, char const component_name, struct yac_basic_grid grid, struct yac_interp_field interp_fields, unsigned num_interp_fields, size_t collection_size, const char *timestep)

unsigned	yac_get_coupling_field_collection_size (struct coupling_field *field)

const char *	yac_get_coupling_field_timestep (struct coupling_field *field)

const char *	yac_get_coupling_field_name (struct coupling_field *field)

char const *	yac_get_coupling_field_comp_name (struct coupling_field *field)

struct yac_basic_grid *	yac_coupling_field_get_basic_grid (struct coupling_field *field)

enum yac_location	yac_get_coupling_field_get_interp_field_location (struct coupling_field *field, size_t interp_field_idx)

struct yac_interp_field const *	yac_coupling_field_get_interp_fields (struct coupling_field *field)

size_t	yac_coupling_field_get_num_interp_fields (struct coupling_field *field)

size_t	yac_coupling_field_get_data_size (struct coupling_field *field, enum yac_location location)

enum yac_field_exchange_type	yac_get_coupling_field_exchange_type (struct coupling_field *field)

unsigned	yac_get_coupling_field_num_puts (struct coupling_field *field)

struct event *	yac_get_coupling_field_put_op_event (struct coupling_field *field, unsigned put_idx)

struct yac_interpolation *	yac_get_coupling_field_put_op_interpolation (struct coupling_field *field, unsigned put_idx)

struct yac_interpolation_exchange *	yac_get_coupling_field_put_op_interpolation_exchange (struct coupling_field *field, unsigned put_idx)

double ***	yac_get_coupling_field_put_op_send_field_acc (struct coupling_field *field, unsigned put_idx)

double ***	yac_get_coupling_field_put_op_send_frac_mask_acc (struct coupling_field *field, unsigned put_idx)

void	yac_init_coupling_field_put_op_send_field_acc (struct coupling_field *field, unsigned put_idx, double init_value)

void	yac_init_coupling_field_put_op_send_frac_mask_acc (struct coupling_field *field, unsigned put_idx, double init_value)

int	yac_get_coupling_field_put_op_time_accumulation_count (struct coupling_field *field, unsigned put_idx)

void	yac_set_coupling_field_put_op_time_accumulation_count (struct coupling_field *field, unsigned put_idx, int count)

int	yac_get_coupling_field_put_op_use_raw_exchange (struct coupling_field *field, unsigned put_idx)

int	yac_get_coupling_field_get_op_use_raw_exchange (struct coupling_field *field)

int **	yac_get_coupling_field_put_mask (struct coupling_field *field)

int *	yac_get_coupling_field_get_mask (struct coupling_field *field)

struct event *	yac_get_coupling_field_get_op_event (struct coupling_field *field)

struct yac_interpolation *	yac_get_coupling_field_get_op_interpolation (struct coupling_field *field)

int	yac_get_coupling_field_get_op_with_frac_mask (struct coupling_field *cpl_field)

struct yac_interpolation_exchange *	yac_get_coupling_field_get_op_interpolation_exchange (struct coupling_field *field)

struct yac_interp_weights_data	yac_get_coupling_field_get_op_interp_weights_data (struct coupling_field *field)

void	yac_coupling_field_get_src_field_buffer_sizes (struct coupling_field field, size_t num_src_fields, size_t const **src_field_buffer_sizes)

void	yac_set_coupling_field_put_op (struct coupling_field field, struct event event, struct yac_interpolation *interpolation)

void	yac_set_coupling_field_put_op_raw (struct coupling_field field, struct event event, struct yac_interpolation_exchange *interpolation_exchange)

void	yac_set_coupling_field_get_op (struct coupling_field field, struct event event, struct yac_interpolation *interpolation)

void	yac_set_coupling_field_get_op_raw (struct coupling_field field, struct event event, struct yac_interpolation_exchange *interpolation_exchange, struct yac_interp_weights_data interp_weights_data)

char *	yac_coupling_field_get_datetime (struct coupling_field *cpl_field)

void	yac_coupling_field_delete (struct coupling_field *cpl_field)

Enumeration Type Documentation

◆ yac_field_exchange_type

enum yac_field_exchange_type

Enumerator
NOTHING
SOURCE
TARGET

Definition at line 12 of file fields.h.

Function Documentation

◆ yac_coupling_field_delete()

void yac_coupling_field_delete ( struct coupling_field * cpl_field )

Definition at line 763 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_coupling_field_get_basic_grid()

struct yac_basic_grid * yac_coupling_field_get_basic_grid ( struct coupling_field * field )

gets the grid_data of the coupling field

Parameters

[in] field

Returns: basic grid data of the coupling field

Definition at line 120 of file fields.c.

Here is the caller graph for this function:

◆ yac_coupling_field_get_data_size()

size_t yac_coupling_field_get_data_size	(	struct coupling_field *	field,
		enum yac_location	location )

gets the number of points in the grids associated with the coupling field

Parameters

[in]	field
[in]	location

Returns: number of grid points

Definition at line 143 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_coupling_field_get_datetime()

char * yac_coupling_field_get_datetime ( struct coupling_field * cpl_field )

get the current datetime of the coupling field

Parameters

[in] cpl_field

Returns: the datetime string

Definition at line 746 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_coupling_field_get_interp_fields()

struct yac_interp_field const * yac_coupling_field_get_interp_fields ( struct coupling_field * field )

gets the interpolation fields of the coupling field

Parameters

[in] field

Returns: interpolation fields

Remarks: dimensions: [point set idx]

Definition at line 740 of file fields.c.

Here is the caller graph for this function:

◆ yac_coupling_field_get_num_interp_fields()

size_t yac_coupling_field_get_num_interp_fields ( struct coupling_field * field )

gets the number of interpolation fields of the coupling field

Parameters

[in] field

Returns: number of interpolation fields

Definition at line 103 of file fields.c.

Here is the caller graph for this function:

◆ yac_coupling_field_get_src_field_buffer_sizes()

void yac_coupling_field_get_src_field_buffer_sizes	(	struct coupling_field *	field,
		size_t *	num_src_fields,
		size_t const **	src_field_buffer_sizes )

gets the source field buffer sizes (used for raw data exchange) of the get operation

Parameters

[in]	field
[out]	num_src_fields	number of source fields
[out]	src_field_buffer_sizes	size of the buffer for each source field

Remarks: calling this routine for a coupling field that has a different exchange type than TARGET yields undefined results

Definition at line 611 of file fields.c.

Here is the caller graph for this function:

◆ yac_coupling_field_new()

struct coupling_field * yac_coupling_field_new	(	char const *	field_name,
		char const *	component_name,
		struct yac_basic_grid *	grid,
		struct yac_interp_field *	interp_fields,
		unsigned	num_interp_fields,
		size_t	collection_size,
		const char *	timestep )

Constructs a coupling field

Parameters

[in]	field_name	name of the coupling field
[in]	component_name	component name
[in]	grid	grid
[in]	interp_fields	interpolation fields
[in]	num_interp_fields	number of entries in interp_fields
[in]	collection_size
[in]	timestep

Definition at line 61 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_collection_size()

unsigned yac_get_coupling_field_collection_size ( struct coupling_field * field )

gets the number of vertical levels or bundles for a field.

Parameters

[in] field

Returns: collection size of the field

Definition at line 93 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_comp_name()

char const * yac_get_coupling_field_comp_name ( struct coupling_field * field )

gets the component name of the coupling field

Parameters

[in] field

Returns: component name

Definition at line 126 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_exchange_type()

enum yac_field_exchange_type yac_get_coupling_field_exchange_type ( struct coupling_field * field )

gets the exchange type of the coupling field

Parameters

[in] field

Returns: exchange type of the coupling field

Definition at line 132 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_get_interp_field_location()

enum yac_location yac_get_coupling_field_get_interp_field_location	(	struct coupling_field *	field,
		size_t	interp_field_idx )

get interpolation field data location

Parameters

[in]	field
[in]	interp_field_idx	index of interpolation field

Returns: data location of requested interpolation field

Definition at line 109 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_get_mask()

int * yac_get_coupling_field_get_mask ( struct coupling_field * field )

gets a combined core and field mask

Parameters

[in] field

Returns: combined core and field mask

Definition at line 317 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_get_coupling_field_get_op_event()

struct event * yac_get_coupling_field_get_op_event ( struct coupling_field * field )

gets the event of the get operation

Parameters

[in] field

Returns: event of the get operation

Remarks: calling this routine for a coupling field that has a different exchange type than TARGET yields undefined results

Definition at line 510 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_get_op_interp_weights_data()

struct yac_interp_weights_data yac_get_coupling_field_get_op_interp_weights_data ( struct coupling_field * field )

gets the field interpolation weight data (used for raw data exchange) of the get operation

Parameters

[in] field

Returns: field interpolation weight data of the get operation

Remarks: calling this routine for a coupling field that has a different exchange type than TARGET yields undefined results

Definition at line 578 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_get_coupling_field_get_op_interpolation()

struct yac_interpolation * yac_get_coupling_field_get_op_interpolation ( struct coupling_field * field )

gets the field interpolation of the get operation

Parameters

[in] field

Returns: field interpolation of the get operation

Remarks: calling this routine for a coupling field that has a different exchange type than TARGET yields undefined results

Definition at line 544 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_get_op_interpolation_exchange()

struct yac_interpolation_exchange * yac_get_coupling_field_get_op_interpolation_exchange ( struct coupling_field * field )

gets the field interpolation exchange (used for raw data exchange) of the get operation

Parameters

[in] field

Returns: field interpolation exchange of the get operation

Remarks: calling this routine for a coupling field that has a different exchange type than TARGET yields undefined results

Definition at line 561 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_get_op_use_raw_exchange()

int yac_get_coupling_field_get_op_use_raw_exchange ( struct coupling_field * field )

returns whether a target field is configured for raw exchange

Parameters

[in] field

Returns: true if target field is configured for raw exchange

Definition at line 521 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_get_op_with_frac_mask()

int yac_get_coupling_field_get_op_with_frac_mask ( struct coupling_field * cpl_field )

returns whether a target field is configured for fractional masking

Parameters

[in] cpl_field

Returns: true if target field is configured for fractional masking

Definition at line 532 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_name()

const char * yac_get_coupling_field_name ( struct coupling_field * field )

gets the name of the coupling field

Parameters

[in] field

Returns: name of the coupling field

Definition at line 115 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_num_puts()

unsigned yac_get_coupling_field_num_puts ( struct coupling_field * field )

gets the number of put operations of the coupling field

Parameters

[in] field

Returns: number of put operations of the coupling field

Remarks: calling this routine for a coupling field that has a different exchange type than SOURCE yields undefined results

Definition at line 501 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_put_mask()

int ** yac_get_coupling_field_put_mask ( struct coupling_field * field )

gets a combined core and field mask

Parameters

[in] field

Returns: combined core and field mask

Definition at line 272 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_get_coupling_field_put_op_event()

struct event * yac_get_coupling_field_put_op_event	(	struct coupling_field *	field,
		unsigned	put_idx )

gets the event of a specified put operation

Parameters

[in]	field
[in]	put_idx	index of the put operation

Returns: event of specified put operation

Remarks: calling this routine for a coupling field that has a different exchange type than SOURCE yields undefined results

See also: get_coupling_field_num_puts

Definition at line 396 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_put_op_interpolation()

struct yac_interpolation * yac_get_coupling_field_put_op_interpolation	(	struct coupling_field *	field,
		unsigned	put_idx )

gets the field interpolation of a specified put operation

Parameters

[in]	field
[in]	put_idx	index of the put operation

Returns: field interpolation of specified put operation

Remarks: calling this routine for a coupling field that has a different exchange type than SOURCE yields undefined results

See also: get_coupling_field_num_puts

Definition at line 410 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_put_op_interpolation_exchange()

struct yac_interpolation_exchange * yac_get_coupling_field_put_op_interpolation_exchange	(	struct coupling_field *	field,
		unsigned	put_idx )

gets the field interpolation exchange (used for raw exchange) of a specified put operation

Parameters

[in]	field
[in]	put_idx	index of the put operation

Returns: field interpolation exchange of specified put operation

Remarks: calling this routine for a coupling field that has a different exchange type than SOURCE yields undefined results

See also: get_coupling_field_num_puts

Definition at line 432 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_put_op_send_field_acc()

double *** yac_get_coupling_field_put_op_send_field_acc	(	struct coupling_field *	field,
		unsigned	put_idx )

gets the send field accumulator of a specified put operation

Parameters

[in]	field
[in]	put_idx	index of the put operation

Returns: send field accumulator of specified put operation

Remarks: calling this routine for a coupling field that has a different exchange type than SOURCE yields undefined results; when this routine is called the first time for a put operation it will be allocated and initialised with zeros

See also: get_coupling_field_num_puts

Definition at line 206 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_get_coupling_field_put_op_send_frac_mask_acc()

double *** yac_get_coupling_field_put_op_send_frac_mask_acc	(	struct coupling_field *	field,
		unsigned	put_idx )

gets the fractional mask accumulator of a specified put operation

Parameters

[in]	field
[in]	put_idx	index of the put operation

Returns: fractional mask accumulator of specified put operation

Remarks: calling this routine for a coupling field that has a different exchange type than SOURCE yields undefined results; when this routine is called the first time for a put operation it will be allocated and initialised with zeros

See also: get_coupling_field_num_puts

Definition at line 216 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_get_coupling_field_put_op_time_accumulation_count()

int yac_get_coupling_field_put_op_time_accumulation_count	(	struct coupling_field *	field,
		unsigned	put_idx )

gets the time accumulation count of a specified put operation

Parameters

[in]	field
[in]	put_idx	index of the put operation

Returns: time accumulation count of specified put operation

Remarks: calling this routine for a coupling field that has a different exchange type than SOURCE yields undefined results

See also: get_coupling_field_num_puts

Definition at line 453 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_put_op_use_raw_exchange()

int yac_get_coupling_field_put_op_use_raw_exchange	(	struct coupling_field *	field,
		unsigned	put_idx )

returns whether a source field is configured for raw exchange

Parameters

[in]	field
[in]	put_idx	index of the put operation

Returns: true if source field is configured for raw exchange

Definition at line 469 of file fields.c.

Here is the caller graph for this function:

◆ yac_get_coupling_field_timestep()

const char * yac_get_coupling_field_timestep ( struct coupling_field * field )

gets the timestep or bundles for a field.

Parameters

[in] field

Returns: timestep

Definition at line 98 of file fields.c.

Here is the caller graph for this function:

◆ yac_init_coupling_field_put_op_send_field_acc()

void yac_init_coupling_field_put_op_send_field_acc	(	struct coupling_field *	field,
		unsigned	put_idx,
		double	init_value )

initialises the send field accumulator of a specified put operation

Parameters

[in]	field
[in]	put_idx	index of the put operation
[in]	init_value	value that is to be used for the initialisation of the send field accumulator

Remarks: calling this routine for a coupling field that has a different exchange type than SOURCE yields undefined results

See also: get_coupling_field_num_puts

Definition at line 354 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_init_coupling_field_put_op_send_frac_mask_acc()

void yac_init_coupling_field_put_op_send_frac_mask_acc	(	struct coupling_field *	field,
		unsigned	put_idx,
		double	init_value )

initialises the fractional mask accumulator of a specified put operation

Parameters

[in]	field
[in]	put_idx	index of the put operation
[in]	init_value	value that is to be used for the initialisation of the fractional mask accumulator

Remarks: calling this routine for a coupling field that has a different exchange type than SOURCE yields undefined results

See also: get_coupling_field_num_puts

Definition at line 375 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_set_coupling_field_get_op()

void yac_set_coupling_field_get_op	(	struct coupling_field *	field,
		struct event *	event,
		struct yac_interpolation *	interpolation )

set the get operation for the coupling field

Parameters

[in,out]	field
[in]	event	event of the operation
[in]	interpolation	interpolation to be executed

Remarks: the coupling field takes control of the input data, it will be free/deleted by the coupling field

Definition at line 703 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_set_coupling_field_get_op_raw()

void yac_set_coupling_field_get_op_raw	(	struct coupling_field *	field,
		struct event *	event,
		struct yac_interpolation_exchange *	interpolation_exchange,
		struct yac_interp_weights_data	interp_weights_data )

set the raw get operation for the coupling field

Parameters

[in,out]	field
[in]	event	event of the operation
[in]	interpolation_exchange	interpolation exchange to be executed
[in]	interp_weights_data	interpolation weight data to be executed

Remarks: the coupling field takes control of the input data, it will be free/deleted by the coupling field

Definition at line 731 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_set_coupling_field_put_op()

void yac_set_coupling_field_put_op	(	struct coupling_field *	field,
		struct event *	event,
		struct yac_interpolation *	interpolation )

sets the put operation for the coupling field

Parameters

[in,out]	field
[in]	event	event of the operation
[in]	interpolation	interpolation to be executed

Remarks: the coupling field takes control of the input data, it will be free/deleted by the coupling field

Definition at line 666 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_set_coupling_field_put_op_raw()

void yac_set_coupling_field_put_op_raw	(	struct coupling_field *	field,
		struct event *	event,
		struct yac_interpolation_exchange *	interpolation_exchange )

sets the raw put operation for the coupling field

Parameters

[in,out]	field
[in]	event	event of the operation
[in]	interpolation_exchange	interpolation exchange to be executed

Remarks: the coupling field takes control of the input data, it will be free/deleted by the coupling field

Definition at line 674 of file fields.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ yac_set_coupling_field_put_op_time_accumulation_count()

void yac_set_coupling_field_put_op_time_accumulation_count	(	struct coupling_field *	field,
		unsigned	put_idx,
		int	count )

sets the time accumulation count of a specified put operation

Parameters

[in]	field
[in]	put_idx	index of the put operation
[in]	count	new time accumulation count

Remarks: calling this routine for a coupling field that has a different exchange type than SOURCE yields undefined results

See also: get_coupling_field_num_puts

Definition at line 485 of file fields.c.

Here is the caller graph for this function:

Enumerations

Functions

Enumeration Type Documentation

◆ yac_field_exchange_type

Function Documentation

◆ yac_coupling_field_delete()

◆ yac_coupling_field_get_basic_grid()

◆ yac_coupling_field_get_data_size()

◆ yac_coupling_field_get_datetime()

◆ yac_coupling_field_get_interp_fields()

◆ yac_coupling_field_get_num_interp_fields()

◆ yac_coupling_field_get_src_field_buffer_sizes()

◆ yac_coupling_field_new()

◆ yac_get_coupling_field_collection_size()

◆ yac_get_coupling_field_comp_name()

◆ yac_get_coupling_field_exchange_type()

◆ yac_get_coupling_field_get_interp_field_location()

◆ yac_get_coupling_field_get_mask()

◆ yac_get_coupling_field_get_op_event()

◆ yac_get_coupling_field_get_op_interp_weights_data()

◆ yac_get_coupling_field_get_op_interpolation()

◆ yac_get_coupling_field_get_op_interpolation_exchange()

◆ yac_get_coupling_field_get_op_use_raw_exchange()

◆ yac_get_coupling_field_get_op_with_frac_mask()

◆ yac_get_coupling_field_name()

◆ yac_get_coupling_field_num_puts()

◆ yac_get_coupling_field_put_mask()

◆ yac_get_coupling_field_put_op_event()

◆ yac_get_coupling_field_put_op_interpolation()

◆ yac_get_coupling_field_put_op_interpolation_exchange()

◆ yac_get_coupling_field_put_op_send_field_acc()

◆ yac_get_coupling_field_put_op_send_frac_mask_acc()

◆ yac_get_coupling_field_put_op_time_accumulation_count()

◆ yac_get_coupling_field_put_op_use_raw_exchange()

◆ yac_get_coupling_field_timestep()

◆ yac_init_coupling_field_put_op_send_field_acc()

◆ yac_init_coupling_field_put_op_send_frac_mask_acc()

◆ yac_set_coupling_field_get_op()

◆ yac_set_coupling_field_get_op_raw()

◆ yac_set_coupling_field_put_op()

◆ yac_set_coupling_field_put_op_raw()

◆ yac_set_coupling_field_put_op_time_accumulation_count()