YetAnotherCoupler 3.2.0_a
|
#include <stddef.h>
#include <mpi.h>
Go to the source code of this file.
Macros | |
#define | YAC_MAX_CHARLEN (132) |
#define | __attribute__(x) /*NOTHING*/ |
#define | TYPEDEF_YAC_FUNC_COMPUTE_WEIGHTS |
Typedefs | |
typedef void(* | yac_abort_func) (MPI_Comm comm, const char *msg, const char *source, int line) __attribute__((noreturn)) |
typedef void(* | yac_func_compute_weights) (double const tgt_coords[3], int src_cell_id, size_t src_cell_idx, int const **global_results_points, double **result_weights, size_t *result_count, void *user_data) |
Functions | |
void | yac_cmpi_handshake (MPI_Comm comm, size_t n, char const **group_names, MPI_Comm *group_comms) |
int | yac_cget_default_instance_id () |
void | yac_cinit (void) |
void | yac_cinit_instance (int *yac_instance_id) |
void | yac_cinit_comm (MPI_Comm comm) |
void | yac_cinit_comm_instance (MPI_Comm comm, int *yac_instance_id) |
void | yac_cinit_dummy (void) |
void | yac_cinit_comm_dummy (MPI_Comm comm) |
void | yac_cread_config_yaml_instance (int yac_instance_id, const char *yaml_file) |
void | yac_cread_config_yaml (const char *yaml_file) |
void | yac_cread_config_json_instance (int yac_instance_id, const char *json_file) |
void | yac_cread_config_json (const char *json_file) |
void | yac_ccleanup () |
void | yac_ccleanup_instance (int yac_instance_id) |
void | yac_cfinalize () |
void | yac_cfinalize_instance (int yac_instance_id) |
void | yac_cdef_datetime (const char *start_datetime, const char *end_datetime) |
void | yac_cdef_datetime_instance (int yac_instance_id, const char *start_datetime, const char *end_datetime) |
void | yac_cdef_calendar (int calendar) |
void | yac_cget_groupcomm (MPI_Comm *group_comm) |
void | yac_cget_groupcomm_instance (int yac_instance_id, MPI_Comm *group_comm) |
void | yac_cpredef_comp (char const *comp_name, int *comp_id) |
void | yac_cpredef_comp_instance (int yac_instance_id, char const *comp_name, int *comp_id) |
void | yac_cdef_comp (const char *comp_name, int *comp_id) |
void | yac_cdef_comp_instance (int yac_instance_id, const char *comp_name, int *comp_id) |
void | yac_cdef_comps (const char **comp_names, int num_comps, int *comp_ids) |
void | yac_cdef_comps_instance (int yac_instance_id, const char **comp_names, int num_comps, int *comp_ids) |
void | yac_cget_comp_comm (int comp_id, MPI_Comm *comp_comm) |
void | yac_cget_comps_comm (const char **comp_names, int num_comps, MPI_Comm *comps_comm) |
void | yac_cget_comps_comm_instance (int yac_instance_id, const char **comp_names, int num_comps, MPI_Comm *comps_comm) |
void | yac_cdef_points_reg2d (int const grid_id, int const *nbr_points, int const location, double const *x_points, double const *y_points, int *point_id) |
void | yac_cdef_points_curve2d (int const grid_id, int const *nbr_points, int const location, double const *x_points, double const *y_points, int *point_id) |
void | yac_cdef_points_unstruct (int const grid_id, int const nbr_points, int const location, double const *x_points, double const *y_points, int *point_id) |
void | yac_cdef_grid_reg2d (const char *grid_name, int nbr_vertices[2], int cyclic[2], double *x_vertices, double *y_vertices, int *grid_id) |
void | yac_cdef_grid_curve2d (const char *grid_name, int nbr_vertices[2], int cyclic[2], double *x_vertices, double *y_vertices, int *grid_id) |
void | yac_cdef_grid_unstruct (const char *grid_name, int nbr_vertices, int nbr_cells, int *num_vertices_per_cell, double *x_vertices, double *y_vertices, int *cell_to_vertex, int *grid_id) |
void | yac_cdef_grid_unstruct_ll (const char *grid_name, int nbr_vertices, int nbr_cells, int *num_vertices_per_cell, double *x_vertices, double *y_vertices, int *cell_to_vertex, int *grid_id) |
void | yac_cset_global_index (int const *global_index, int location, int grid_id) |
void | yac_cset_core_mask (int const *is_core, int location, int grid_id) |
void | yac_cset_mask (int const *is_valid, int points_id) |
void | yac_cdef_mask (int const grid_id, int const nbr_points, int const location, int const *is_valid, int *mask_id) |
void | yac_cdef_mask_named (int const grid_id, int const nbr_points, int const location, int const *is_valid, char const *name, int *mask_id) |
void | yac_cdef_field (char const *field_name, int const component_id, int const *point_ids, int const num_pointsets, int collection_size, const char *timestep, int time_unit, int *field_id) |
void | yac_cdef_field_mask (char const *field_name, int const component_id, int const *point_ids, int const *mask_ids, int const num_pointsets, int collection_size, const char *timestep, int time_unit, int *field_id) |
void | yac_cenable_field_frac_mask (const char *comp_name, const char *grid_name, const char *field_name, double frac_mask_fallback_value) |
void | yac_cenable_field_frac_mask_instance (int yac_instance_id, const char *comp_name, const char *grid_name, const char *field_name, double frac_mask_fallback_value) |
void | yac_cdef_component_metadata (const char *comp_name, const char *metadata) |
void | yac_cdef_component_metadata_instance (int yac_instance_id, const char *comp_name, const char *metadata) |
void | yac_cdef_grid_metadata (const char *grid_name, const char *metadata) |
void | yac_cdef_grid_metadata_instance (int yac_instance_id, const char *grid_name, const char *metadata) |
void | yac_cdef_field_metadata (const char *comp_name, const char *grid_name, const char *field_name, const char *metadata) |
void | yac_cdef_field_metadata_instance (int yac_instance_id, const char *comp_name, const char *grid_name, const char *field_name, const char *metadata) |
void | yac_cget_action (int field_id, int *action) |
const char * | yac_cget_field_datetime (int field_id) |
void | yac_cupdate (int field_id) |
void | yac_cget_ext_couple_config (int *ext_couple_config_id) |
void | yac_cfree_ext_couple_config (int ext_couple_config_id) |
void | yac_cset_ext_couple_config_weight_file (int ext_couple_config_id, char const *weight_file) |
void | yac_cget_ext_couple_config_weight_file (int ext_couple_config_id, char const **weight_file) |
void | yac_cset_ext_couple_config_mapping_side (int ext_couple_config_id, int mapping_side) |
void | yac_cget_ext_couple_config_mapping_side (int ext_couple_config_id, int *mapping_side) |
void | yac_cset_ext_couple_config_scale_factor (int ext_couple_config_id, double scale_factor) |
void | yac_cget_ext_couple_config_scale_factor (int ext_couple_config_id, double *scale_factor) |
void | yac_cset_ext_couple_config_scale_summand (int ext_couple_config_id, double scale_summand) |
void | yac_cget_ext_couple_config_scale_summand (int ext_couple_config_id, double *scale_summand) |
void | yac_cset_ext_couple_config_src_mask_names (int ext_couple_config_id, size_t num_src_mask_names, char const *const *src_mask_names) |
void | yac_cget_ext_couple_config_src_mask_names (int ext_couple_config_id, size_t *num_src_mask_names, char const *const **src_mask_names) |
void | yac_cset_ext_couple_config_tgt_mask_name (int ext_couple_config_id, char const *tgt_mask_name) |
void | yac_cget_ext_couple_config_mask_name (int ext_couple_config_id, char const **tgt_mask_name) |
void | yac_cdef_couple_custom_instance (int yac_instance_id, char const *src_comp_name, char const *src_grid_name, char const *src_field_name, char const *tgt_comp_name, char const *tgt_grid_name, char const *tgt_field_name, char const *coupling_timestep, int time_unit, int time_reduction, int interp_stack_config_id, int src_lag, int tgt_lag, int ext_couple_config_id) |
void | yac_cdef_couple_custom (char const *src_comp_name, char const *src_grid_name, char const *src_field_name, char const *tgt_comp_name, char const *tgt_grid_name, char const *tgt_field_name, char const *coupling_timestep, int time_unit, int time_reduction, int interp_stack_config_id, int src_lag, int tgt_lag, int ext_couple_config_id) |
void | yac_cdef_couple_instance (int yac_instance_id, char const *src_comp_name, char const *src_grid_name, char const *src_field_name, char const *tgt_comp_name, char const *tgt_grid_name, char const *tgt_field_name, char const *coupling_timestep, int time_unit, int time_reduction, int interp_stack_config_id, int src_lag, int tgt_lag) |
void | yac_cdef_couple (char const *src_comp_name, char const *src_grid_name, char const *src_field_name, char const *tgt_comp_name, char const *tgt_grid_name, char const *tgt_field_name, char const *coupling_timestep, int time_unit, int time_reduction, int interp_stack_config_id, int src_lag, int tgt_lag) |
void | yac_ccheck_field_dimensions (int field_id, int collection_size, int num_pointsets, int const *pointset_sizes) |
void | yac_cget_ (int const field_id, int const collection_size, double *recv_field, int *info, int *ierror) |
void | yac_cget (int const field_id, int const collection_size, double **recv_field, int *info, int *ierror) |
void | yac_cget_async_ (int const field_id, int const collection_size, double *recv_field, int *info, int *ierror) |
void | yac_cget_async (int const field_id, int const collection_size, double **recv_field, int *info, int *ierror) |
void | yac_cput_ (int const field_id, int const collection_size, double *send_field, int *info, int *ierror) |
void | yac_cput (int const field_id, int const collection_size, double ***const send_field, int *info, int *ierror) |
void | yac_cput_frac_ (int const field_id, int const collection_size, double *send_field, double *send_frac_mask, int *info, int *ierror) |
void | yac_cput_frac (int const field_id, int const collection_size, double ***const send_field, double ***const send_frac_mask, int *info, int *ierror) |
void | yac_cput_ptr_ (int const field_id, int const collection_size, double **send_field, int *info, int *ierror) |
void | yac_cput_frac_ptr_ (int const field_id, int const collection_size, double **send_field, double **send_frac_mask, int *info, int *ierror) |
void | yac_cexchange_ (int const send_field_id, int const recv_field_id, int const collection_size, double *send_field, double *recv_field, int *send_info, int *recv_info, int *ierror) |
void | yac_cexchange (int const send_field_id, int const recv_field_id, int const collection_size, double ***const send_field, double **recv_field, int *send_info, int *recv_info, int *ierror) |
void | yac_cexchange_frac_ (int const send_field_id, int const recv_field_id, int const collection_size, double *send_field, double *send_frac_mask, double *recv_field, int *send_info, int *recv_info, int *ierror) |
void | yac_cexchange_frac (int const send_field_id, int const recv_field_id, int const collection_size, double ***const send_field, double ***const send_frac_mask, double **recv_field, int *send_info, int *recv_info, int *ierror) |
void | yac_cexchange_ptr_ (int const send_field_id, int const recv_field_id, int const collection_size, double **send_field, double **recv_field, int *send_info, int *recv_info, int *ierror) |
void | yac_cexchange_frac_ptr_ (int const send_field_id, int const recv_field_id, int const collection_size, double **send_field, double **send_frac_mask, double **recv_field, int *send_info, int *recv_info, int *ierror) |
void | yac_ctest (int field_id, int *flag) |
void | yac_cwait (int field_id) |
void | yac_csync_def (void) |
void | yac_csync_def_instance (int yac_instance_id) |
void | yac_cenddef (void) |
void | yac_cenddef_instance (int yac_instance_id) |
void | yac_cenddef_and_emit_config (int emit_flags, char **config) |
void | yac_cenddef_and_emit_config_instance (int yac_instance_id, int emit_flags, char **config) |
char * | yac_cget_start_datetime (void) |
char * | yac_cget_start_datetime_instance (int yac_instance_id) |
char * | yac_cget_end_datetime (void) |
char * | yac_cget_end_datetime_instance (int yac_instance_id) |
char * | yac_cget_version (void) |
int | yac_cget_nbr_comps (void) |
int | yac_cget_nbr_comps_instance (int yac_instance_id) |
int | yac_cget_nbr_grids () |
int | yac_cget_nbr_grids_instance (int yac_instance_id) |
int | yac_cget_comp_nbr_grids (const char *comp_name) |
int | yac_cget_comp_nbr_grids_instance (int yac_instance_id, const char *comp_name) |
int | yac_cget_nbr_fields (const char *comp_name, const char *grid_name) |
int | yac_cget_nbr_fields_instance (int yac_instance_id, const char *comp_name, const char *grid_name) |
void | yac_cget_comp_names (int nbr_comps, const char **comp_names) |
void | yac_cget_comp_names_instance (int yac_instance_id, int nbr_comps, const char **comp_names) |
void | yac_cget_grid_names (int nbr_grids, const char **grid_names) |
void | yac_cget_grid_names_instance (int yac_instance_id, int nbr_grids, const char **grid_names) |
void | yac_cget_comp_grid_names (const char *comp_name, int nbr_grids, const char **grid_names) |
void | yac_cget_comp_grid_names_instance (int yac_instance_id, const char *comp_name, int nbr_grids, const char **grid_names) |
void | yac_cget_field_names (const char *comp_name, const char *grid_name, int nbr_fields, const char **field_names) |
void | yac_cget_field_names_instance (int yac_instance_id, const char *comp_name, const char *grid_name, int nbr_fields, const char **field_names) |
const char * | yac_cget_component_name_from_field_id (int field_id) |
const char * | yac_cget_grid_name_from_field_id (int field_id) |
const char * | yac_cget_field_name_from_field_id (int field_id) |
const char * | yac_cget_timestep_from_field_id (int field_id) |
int | yac_cget_collection_size_from_field_id (int field_id) |
int | yac_cget_role_from_field_id (int field_id) |
int | yac_cget_field_id (const char *comp_name, const char *grid_name, const char *field_name) |
int | yac_cget_field_id_instance (int yac_instance_id, const char *comp_name, const char *grid_name, const char *field_name) |
const char * | yac_cget_component_metadata (const char *comp_name) |
const char * | yac_cget_component_metadata_instance (int yac_instance_id, const char *comp_name) |
const char * | yac_cget_grid_metadata (const char *grid_name) |
const char * | yac_cget_grid_metadata_instance (int yac_instance_id, const char *grid_name) |
const char * | yac_cget_field_metadata (const char *comp_name, const char *grid_name, const char *field_name) |
const char * | yac_cget_field_metadata_instance (int yac_instance_id, const char *comp_name, const char *grid_name, const char *field_name) |
const char * | yac_cget_field_timestep (const char *comp_name, const char *grid_name, const char *field_name) |
const char * | yac_cget_field_timestep_instance (int yac_instance_id, const char *comp_name, const char *grid_name, const char *field_name) |
double | yac_cget_field_frac_mask_fallback_value (const char *comp_name, const char *grid_name, const char *field_name) |
int | yac_cget_field_collection_size (const char *comp_name, const char *grid_name, const char *field_name) |
double | yac_cget_field_frac_mask_fallback_value_instance (int yac_instance_id, const char *comp_name, const char *grid_name, const char *field_name) |
int | yac_cget_field_collection_size_instance (int yac_instance_id, const char *comp_name, const char *grid_name, const char *field_name) |
int | yac_cget_field_role (const char *comp_name, const char *grid_name, const char *field_name) |
int | yac_cget_field_role_instance (int yac_instance_id, const char *comp_name, const char *grid_name, const char *field_name) |
void | yac_abort (MPI_Comm comm, const char *msg, const char *source, int line) __attribute__((noreturn)) |
void | yac_abort_message (char const *msg, const char *source, int line) |
void | yac_restore_default_abort_handler (void) |
void | yac_set_abort_handler (yac_abort_func custom_abort) |
yac_abort_func | yac_get_abort_handler (void) |
yac_abort_func | yac_get_default_abort_handler (void) |
void | yac_set_default_comm (MPI_Comm comm) |
size_t | yac_cget_grid_size (int location, int grid_id) |
size_t | yac_cget_points_size (int points_id) |
void | yac_cget_interp_stack_config (int *interp_stack_config_id) |
void | yac_cfree_interp_stack_config (int interp_stack_config_id) |
void | yac_cadd_interp_stack_config_average (int interp_stack_config_id, int reduction_type, int partial_coverage) |
void | yac_cadd_interp_stack_config_ncc (int interp_stack_config_id, int weight_type, int partial_coverage) |
void | yac_cadd_interp_stack_config_nnn (int interp_stack_config_id, int type, size_t n, double scale) |
void | yac_cadd_interp_stack_config_conservative (int interp_stack_config_id, int order, int enforced_conserv, int partial_coverage, int normalisation) |
void | yac_cadd_interp_stack_config_spmap (int interp_stack_config_id, double spread_distance, double max_search_distance, int weight_type, int scale_type, double src_sphere_radius, double tgt_sphere_radius) |
void | yac_cadd_interp_stack_config_hcsbb (int interp_stack_config_id) |
void | yac_cadd_interp_stack_config_user_file (int interp_stack_config_id, char const *filename, char const *src_grid_name, char const *tgt_grid_name) |
void | yac_cadd_interp_stack_config_fixed (int interp_stack_config_id, double value) |
void | yac_cadd_interp_stack_config_check (int interp_stack_config_id, char const *constructor_key, char const *do_search_key) |
void | yac_cadd_interp_stack_config_creep (int interp_stack_config_id, int creep_distance) |
void | yac_cadd_interp_stack_config_user_callback (int interp_stack_config_id, char const *func_compute_weights_key) |
void | yac_cadd_compute_weights_callback (yac_func_compute_weights compute_weights_callback, void *user_data, char const *key) |
#define TYPEDEF_YAC_FUNC_COMPUTE_WEIGHTS |
method signature for weight computation function used by User callback interpolation
If the field value of a target point, whose weights have been computed by this routine, is to be computed on the source process at which this routine was called, YAC would use the weights as follows (it is assumed that all required source points are available at this process):
If one or more source points associated to the global ids return by this routine are not actually available at this process, YAC will ensure that the respective value will be available for the interpolation.
[in] | tgt_coords | 3D coordinates of the target point |
[in] | src_cell_id | global id of the source cell matching the target point |
[in] | src_cell_idx | (zero based) index of the source cell matching the target point |
[out] | global_results_points | global ids of source points to be used for the interpolation of the target point |
[out] | result_weights | weights to be used for the interpolation of the target point |
[out] | result_count | number of source points to be used for the interpolation of the target point per pointset |
[in] | user_data | user_data pointer provided to yac_cadd_compute_weights_callback |
typedef void(* yac_abort_func) (MPI_Comm comm, const char *msg, const char *source, int line) __attribute__((noreturn)) |
functions used as error handler must conform to this interface
typedef void(* yac_func_compute_weights) (double const tgt_coords[3], int src_cell_id, size_t src_cell_idx, int const **global_results_points, double **result_weights, size_t *result_count, void *user_data) |
void yac_abort | ( | MPI_Comm | comm, |
const char * | msg, | ||
const char * | source, | ||
int | line | ||
) |
Calls the currently set abort handler (yac_abort_default by default)
[in] | comm | MPI communicator used to call MPI_Abort |
[in] | msg | message text to print |
[in] | source | string describing source file name |
[in] | line | line number of caller |
void yac_abort_message | ( | char const * | msg, |
const char * | source, | ||
int | line | ||
) |
Call the yac_abort function (providing the default communicator for the comm argument).
msg | message text to print |
source | string describing source file name |
line | line number of caller |
void yac_cadd_compute_weights_callback | ( | yac_func_compute_weights | compute_weights_callback, |
void * | user_data, | ||
char const * | key | ||
) |
registers a callback routine for the computation of weights by the interpolation method user_callback
[in] | compute_weights_callback | pointer to a weight computation routine |
[in] | user_data | data pointer that will be passed to compute_weights_callback |
[in] | key | key for identifying the callback routine |
Definition at line 3555 of file yac.c.
void yac_cadd_interp_stack_config_average | ( | int | interp_stack_config_id, |
int | reduction_type, | ||
int | partial_coverage | ||
) |
adds average interpolation to the bottom of a interpolation stack
[in] | interp_stack_config_id | interpolation stack |
[in] | reduction_type | reduction type |
[in] | partial_coverage | allow partial coverage |
Definition at line 3382 of file yac.c.
void yac_cadd_interp_stack_config_check | ( | int | interp_stack_config_id, |
char const * | constructor_key, | ||
char const * | do_search_key | ||
) |
adds fixed interpolation to the bottom of a interpolation stack
[in] | interp_stack_config_id | interpolation stack |
[in] | constructor_key | key provided to yac_interp_method_check_add_constructor_callback for a constructor callback routine |
[in] | do_search_key | key provided to yac_interp_method_check_add_do_search_callback for a do_search callback routine |
Definition at line 3520 of file yac.c.
void yac_cadd_interp_stack_config_conservative | ( | int | interp_stack_config_id, |
int | order, | ||
int | enforced_conserv, | ||
int | partial_coverage, | ||
int | normalisation | ||
) |
adds conservative interpolation to the bottom of a interpolation stack
[in] | interp_stack_config_id | interpolation stack |
[in] | order | first or second order |
[in] | enforced_conserv | enforce local conservation |
[in] | partial_coverage | allow partial coverage |
[in] | normalisation | normalisation type |
Definition at line 3439 of file yac.c.
void yac_cadd_interp_stack_config_creep | ( | int | interp_stack_config_id, |
int | creep_distance | ||
) |
void yac_cadd_interp_stack_config_fixed | ( | int | interp_stack_config_id, |
double | value | ||
) |
void yac_cadd_interp_stack_config_hcsbb | ( | int | interp_stack_config_id | ) |
void yac_cadd_interp_stack_config_ncc | ( | int | interp_stack_config_id, |
int | weight_type, | ||
int | partial_coverage | ||
) |
adds nearest corner cells interpolation to the bottom of a interpolation stack
[in] | interp_stack_config_id | interpolation stack |
[in] | weight_type | reduction type |
[in] | partial_coverage | allow partial coverage |
Definition at line 3401 of file yac.c.
void yac_cadd_interp_stack_config_nnn | ( | int | interp_stack_config_id, |
int | type, | ||
size_t | n, | ||
double | scale | ||
) |
adds n-nearest-neighbour interpolation to the bottom of a interpolation stack
[in] | interp_stack_config_id | interpolation stack |
[in] | type | reduction type |
[in] | n | number of nearest neighbour points |
[in] | scale | scale parameter required by some reduction types |
Definition at line 3419 of file yac.c.
void yac_cadd_interp_stack_config_spmap | ( | int | interp_stack_config_id, |
double | spread_distance, | ||
double | max_search_distance, | ||
int | weight_type, | ||
int | scale_type, | ||
double | src_sphere_radius, | ||
double | tgt_sphere_radius | ||
) |
adds source point mapping interpolation to the bottom of a interpolation stack
[in] | interp_stack_config_id | interpolation stack |
[in] | spread_distance | spread distance (in rad) |
[in] | max_search_distance | maximum search distance (in rad) |
[in] | weight_type | reduction type |
[in] | scale_type | scaling type |
[in] | src_sphere_radius | sphere radius used for source cell area computation |
[in] | tgt_sphere_radius | sphere radius used for target cell area computation |
Definition at line 3458 of file yac.c.
void yac_cadd_interp_stack_config_user_callback | ( | int | interp_stack_config_id, |
char const * | func_compute_weights_key | ||
) |
adds user callback interpolation to the bottom of a interpolation stack
[in] | interp_stack_config_id | interpolation stack |
[in] | func_compute_weights_key | key provided to yac_cadd_compute_weights_callback for a compute_weights callback routine |
Definition at line 3542 of file yac.c.
void yac_cadd_interp_stack_config_user_file | ( | int | interp_stack_config_id, |
char const * | filename, | ||
char const * | src_grid_name, | ||
char const * | tgt_grid_name | ||
) |
adds user weight file interpolation to the bottom of a interpolation stack
[in] | interp_stack_config_id | interpolation stack |
[in] | filename | weight file name |
[in] | src_grid_name | name of source grid |
[in] | tgt_grid_name | name of target grid |
Definition at line 3497 of file yac.c.
void yac_ccheck_field_dimensions | ( | int | field_id, |
int | collection_size, | ||
int | num_pointsets, | ||
int const * | pointset_sizes | ||
) |
Checks whether the field dimensions match with field definition and aborts if there is a mismatch
[in] | field_id | |
[in] | collection_size | collection size |
[in] | num_pointsets | number of pointsets |
[in] | pointset_sizes | size of each pointset |
Definition at line 1550 of file yac.c.
void yac_ccleanup | ( | ) |
Clean-up YAC (same as yac_cfinalize but without MPI_Finalize; see Restarting YAC)
Definition at line 505 of file yac.c.
void yac_ccleanup_instance | ( | int | yac_instance_id | ) |
Clean-up YAC (same as yac_cfinalize_instance but without MPI_Finalize; see Restarting YAC)
[in] | yac_instance_id | id of the YAC instance to be cleaned up |
Definition at line 497 of file yac.c.
void yac_cdef_calendar | ( | int | calendar | ) |
Defines the calendar of the default instance
[in] | calendar | The calendar |
Definition at line 562 of file yac.c.
void yac_cdef_comp | ( | const char * | comp_name, |
int * | comp_id | ||
) |
Elementary definition of the component for the default YAC instance
[in] | comp_name | name of the component |
[out] | comp_id | component Id |
yac_cpredef_comp
. Definition at line 795 of file yac.c.
void yac_cdef_comp_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
int * | comp_id | ||
) |
Elementary definition of the component.
[in] | yac_instance_id | id of the YAC instance |
[in] | comp_name | name of the component |
[out] | comp_id | component Id |
yac_cpredef_comp_instance
. Definition at line 789 of file yac.c.
void yac_cdef_component_metadata | ( | const char * | comp_name, |
const char * | metadata | ||
) |
void yac_cdef_component_metadata_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
const char * | metadata | ||
) |
void yac_cdef_comps | ( | const char ** | comp_names, |
int | num_comps, | ||
int * | comp_ids | ||
) |
Elementary definition of the components for the default YAC instance
[in] | comp_names | names of the components |
[in] | num_comps | number of components |
[out] | comp_ids | component Id's |
Definition at line 781 of file yac.c.
void yac_cdef_comps_instance | ( | int | yac_instance_id, |
const char ** | comp_names, | ||
int | num_comps, | ||
int * | comp_ids | ||
) |
Elementary definition of the components.
[in] | yac_instance_id | id of the YAC instance |
[in] | comp_names | names of the components |
[in] | num_comps | number of components |
[out] | comp_ids | component Id's |
Definition at line 756 of file yac.c.
void yac_cdef_couple | ( | char const * | src_comp_name, |
char const * | src_grid_name, | ||
char const * | src_field_name, | ||
char const * | tgt_comp_name, | ||
char const * | tgt_grid_name, | ||
char const * | tgt_field_name, | ||
char const * | coupling_timestep, | ||
int | time_unit, | ||
int | time_reduction, | ||
int | interp_stack_config_id, | ||
int | src_lag, | ||
int | tgt_lag | ||
) |
Define couple in the default yac instance
[in] | src_comp_name | component name of the source component |
[in] | src_grid_name | grid name of the source grid |
[in] | src_field_name | field name of the source field |
[in] | tgt_comp_name | component name of the target component |
[in] | tgt_grid_name | grid name of the target grid |
[in] | tgt_field_name | field name of the target field |
[in] | coupling_timestep | time step for the coupling given in the defined timestep unit |
[in] | time_unit | unit of coupling_timestep argument |
[in] | time_reduction | type for reducing multiple timesteps |
[in] | interp_stack_config_id | id of the interpolation stack config to be used |
[in] | src_lag | lag for this couple on the source component |
[in] | tgt_lag | lag for this couple on the target component |
Definition at line 1476 of file yac.c.
void yac_cdef_couple_custom | ( | char const * | src_comp_name, |
char const * | src_grid_name, | ||
char const * | src_field_name, | ||
char const * | tgt_comp_name, | ||
char const * | tgt_grid_name, | ||
char const * | tgt_field_name, | ||
char const * | coupling_timestep, | ||
int | time_unit, | ||
int | time_reduction, | ||
int | interp_stack_config_id, | ||
int | src_lag, | ||
int | tgt_lag, | ||
int | ext_couple_config_id | ||
) |
Define couple in the default yac instance using an extended coupling configuration
[in] | src_comp_name | component name of the source component |
[in] | src_grid_name | grid name of the source grid |
[in] | src_field_name | field name of the source field |
[in] | tgt_comp_name | component name of the target component |
[in] | tgt_grid_name | grid name of the target grid |
[in] | tgt_field_name | field name of the target field |
[in] | coupling_timestep | time step for the coupling given in the defined timestep unit |
[in] | time_unit | unit of coupling_timestep argument |
[in] | time_reduction | type for reducing multiple timesteps |
[in] | interp_stack_config_id | id of the interpolation stack config to be used |
[in] | src_lag | lag for this couple on the source component |
[in] | tgt_lag | lag for this couple on the target component |
[in] | ext_couple_config_id | extended coupling configuration |
Definition at line 1444 of file yac.c.
void yac_cdef_couple_custom_instance | ( | int | yac_instance_id, |
char const * | src_comp_name, | ||
char const * | src_grid_name, | ||
char const * | src_field_name, | ||
char const * | tgt_comp_name, | ||
char const * | tgt_grid_name, | ||
char const * | tgt_field_name, | ||
char const * | coupling_timestep, | ||
int | time_unit, | ||
int | time_reduction, | ||
int | interp_stack_config_id, | ||
int | src_lag, | ||
int | tgt_lag, | ||
int | ext_couple_config_id | ||
) |
Define couple using an extended coupling configuration
[in] | yac_instance_id | id of the YAC instance for that the couple should be defined |
[in] | src_comp_name | component name of the source component |
[in] | src_grid_name | grid name of the source grid |
[in] | src_field_name | field name of the source field |
[in] | tgt_comp_name | component name of the target component |
[in] | tgt_grid_name | grid name of the target grid |
[in] | tgt_field_name | field name of the target field |
[in] | coupling_timestep | time step for the coupling |
[in] | time_unit | unit of coupling_timestep argument |
[in] | time_reduction | type for reducing multiple timesteps |
[in] | interp_stack_config_id | id of the interpolation stack config to be used |
[in] | src_lag | lag for this couple on the source component |
[in] | tgt_lag | lag for this couple on the target component |
[in] | ext_couple_config_id | extended coupling configuration |
Definition at line 1429 of file yac.c.
void yac_cdef_couple_instance | ( | int | yac_instance_id, |
char const * | src_comp_name, | ||
char const * | src_grid_name, | ||
char const * | src_field_name, | ||
char const * | tgt_comp_name, | ||
char const * | tgt_grid_name, | ||
char const * | tgt_field_name, | ||
char const * | coupling_timestep, | ||
int | time_unit, | ||
int | time_reduction, | ||
int | interp_stack_config_id, | ||
int | src_lag, | ||
int | tgt_lag | ||
) |
Define couple
[in] | yac_instance_id | id of the YAC instance for that the couple should be defined |
[in] | src_comp_name | component name of the source component |
[in] | src_grid_name | grid name of the source grid |
[in] | src_field_name | field name of the source field |
[in] | tgt_comp_name | component name of the target component |
[in] | tgt_grid_name | grid name of the target grid |
[in] | tgt_field_name | field name of the target field |
[in] | coupling_timestep | time step for the coupling |
[in] | time_unit | unit of coupling_timestep argument |
[in] | time_reduction | type for reducing multiple timesteps |
[in] | interp_stack_config_id | id of the interpolation stack config to be used |
[in] | src_lag | lag for this couple on the source component |
[in] | tgt_lag | lag for this couple on the target component |
Definition at line 1459 of file yac.c.
void yac_cdef_datetime | ( | const char * | start_datetime, |
const char * | end_datetime | ||
) |
void yac_cdef_datetime_instance | ( | int | yac_instance_id, |
const char * | start_datetime, | ||
const char * | end_datetime | ||
) |
Definition of job start and end datetime
[in] | yac_instance_id | id of the YAC instance |
[in] | start_datetime | calendar job start datetime |
[in] | end_datetime | calendar job end datetime |
Definition at line 545 of file yac.c.
void yac_cdef_field | ( | char const * | field_name, |
int const | component_id, | ||
int const * | point_ids, | ||
int const | num_pointsets, | ||
int | collection_size, | ||
const char * | timestep, | ||
int | time_unit, | ||
int * | field_id | ||
) |
Definition of the coupling field (using default mask, if defined)
[in] | field_name | character string providing the name of the coupling field |
[in] | component_id | component ID |
[in] | point_ids | point IDs |
[in] | num_pointsets | number of pointsets per grid |
[in] | collection_size | collection size |
[in] | timestep | timestep |
[in] | time_unit | time unit |
[out] | field_id | returned field_id which has to be used to identify coupling fields in yac_cput and yac_cget. |
Definition at line 1085 of file yac.c.
void yac_cdef_field_mask | ( | char const * | field_name, |
int const | component_id, | ||
int const * | point_ids, | ||
int const * | mask_ids, | ||
int const | num_pointsets, | ||
int | collection_size, | ||
const char * | timestep, | ||
int | time_unit, | ||
int * | field_id | ||
) |
Definition of the coupling field
[in] | field_name | character string providing the name of the coupling field |
[in] | component_id | component ID |
[in] | point_ids | point IDs |
[in] | mask_ids | mask IDs |
[in] | num_pointsets | number of pointsets per grid |
[in] | collection_size | collection size |
[in] | timestep | timestep |
[in] | time_unit | |
[out] | field_id | returned field_id which has to be used to identify coupling fields in yac_cput and yac_cget. |
Definition at line 1012 of file yac.c.
void yac_cdef_field_metadata | ( | const char * | comp_name, |
const char * | grid_name, | ||
const char * | field_name, | ||
const char * | metadata | ||
) |
void yac_cdef_field_metadata_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
const char * | grid_name, | ||
const char * | field_name, | ||
const char * | metadata | ||
) |
void yac_cdef_grid_curve2d | ( | const char * | grid_name, |
int | nbr_vertices[2], | ||
int | cyclic[2], | ||
double * | x_vertices, | ||
double * | y_vertices, | ||
int * | grid_id | ||
) |
Definition of a 2d curvilinear grid
[in] | grid_name | name of the grid |
[in] | nbr_vertices | 2d array containing the number of vertices in each dimension |
[in] | cyclic | 2d array containing information about cyclic behaviour in each dimension |
[in] | x_vertices | array of vertex longitudes, in radians |
[in] | y_vertices | array of vertex latitudes, in radians |
[out] | grid_id | id of generated grid |
Definition at line 3190 of file yac.c.
void yac_cdef_grid_metadata | ( | const char * | grid_name, |
const char * | metadata | ||
) |
void yac_cdef_grid_metadata_instance | ( | int | yac_instance_id, |
const char * | grid_name, | ||
const char * | metadata | ||
) |
void yac_cdef_grid_reg2d | ( | const char * | grid_name, |
int | nbr_vertices[2], | ||
int | cyclic[2], | ||
double * | x_vertices, | ||
double * | y_vertices, | ||
int * | grid_id | ||
) |
Definition of a 2d regular grid
[in] | grid_name | name of the grid |
[in] | nbr_vertices | 2d array containing the number of vertices in each dimension |
[in] | cyclic | 2d array containing information about cyclic behaviour in each dimension |
[in] | x_vertices | array of vertex longitudes, in radians |
[in] | y_vertices | array of vertex latitudes, in radians |
[out] | grid_id | id of generated grid |
Definition at line 3172 of file yac.c.
void yac_cdef_grid_unstruct | ( | const char * | grid_name, |
int | nbr_vertices, | ||
int | nbr_cells, | ||
int * | num_vertices_per_cell, | ||
double * | x_vertices, | ||
double * | y_vertices, | ||
int * | cell_to_vertex, | ||
int * | grid_id | ||
) |
Definition of an unstructured grid
[in] | grid_name | name of the grid |
[in] | nbr_vertices | number of vertices |
[in] | nbr_cells | number of cells |
[in] | num_vertices_per_cell | array containing the number of vertices for each cell |
[in] | x_vertices | array of vertex longitudes, in radians |
[in] | y_vertices | array of vertex latitudes, in radians |
[in] | cell_to_vertex | connectivity of vertices belonging to cells (the vertex indices per cell have to be in clockwise or counterclockwise ordering) |
[out] | grid_id | id of generated grid |
Definition at line 3208 of file yac.c.
void yac_cdef_grid_unstruct_ll | ( | const char * | grid_name, |
int | nbr_vertices, | ||
int | nbr_cells, | ||
int * | num_vertices_per_cell, | ||
double * | x_vertices, | ||
double * | y_vertices, | ||
int * | cell_to_vertex, | ||
int * | grid_id | ||
) |
Definition of an unstructured grid with lon-lat edges
[in] | grid_name | name of the grid |
[in] | nbr_vertices | number of vertices |
[in] | nbr_cells | number of cells |
[in] | num_vertices_per_cell | array containing the number of vertices for each cell |
[in] | x_vertices | array of vertex longitudes, in radians |
[in] | y_vertices | array of vertex latitudes, in radians |
[in] | cell_to_vertex | connectivity of vertices belonging to cells (the vertex indices per cell have to be in clockwise or counterclockwise ordering) |
[out] | grid_id | id of generated grid |
Definition at line 3226 of file yac.c.
void yac_cdef_mask | ( | int const | grid_id, |
int const | nbr_points, | ||
int const | location, | ||
int const * | is_valid, | ||
int * | mask_id | ||
) |
define a mask for a grid
[in] | grid_id | grid ID |
[in] | nbr_points | number of points |
[in] | location | cell/vertex/edge |
[in] | is_valid | 0 for points that are masked out, 1 for valid points |
[out] | mask_id | returned handle to the mask struct |
Definition at line 984 of file yac.c.
void yac_cdef_mask_named | ( | int const | grid_id, |
int const | nbr_points, | ||
int const | location, | ||
int const * | is_valid, | ||
char const * | name, | ||
int * | mask_id | ||
) |
define a named mask for a grid
[in] | grid_id | grid ID |
[in] | nbr_points | number of points |
[in] | location | cell/vertex/edge |
[in] | is_valid | 0 for points that are masked out, 1 for valid points |
[in] | name | name of the mask |
[out] | mask_id | returned handle to the mask struct |
Definition at line 965 of file yac.c.
void yac_cdef_points_curve2d | ( | int const | grid_id, |
int const * | nbr_points, | ||
int const | location, | ||
double const * | x_points, | ||
double const * | y_points, | ||
int * | point_id | ||
) |
Definition of a set of points for 2D curvilinear grids.
[in] | grid_id | handle to the grid struct |
[in] | nbr_points | number of points |
[in] | location | location of points |
[in] | x_points | array of point longitudes, in radians |
[in] | y_points | array of point latitudes, in radians |
[out] | point_id | returned handle to the points struct |
Definition at line 881 of file yac.c.
void yac_cdef_points_reg2d | ( | int const | grid_id, |
int const * | nbr_points, | ||
int const | location, | ||
double const * | x_points, | ||
double const * | y_points, | ||
int * | point_id | ||
) |
Definition of a set of points for 2D regular grids.
[in] | grid_id | handle to the grid struct |
[in] | nbr_points | number of points |
[in] | location | location of points |
[in] | x_points | array of point longitudes, in radians |
[in] | y_points | array of point latitudes, in radians |
[out] | point_id | returned handle to the points struct |
Definition at line 845 of file yac.c.
void yac_cdef_points_unstruct | ( | int const | grid_id, |
int const | nbr_points, | ||
int const | location, | ||
double const * | x_points, | ||
double const * | y_points, | ||
int * | point_id | ||
) |
Definition of a set of points for 2D unstructured grids.
[in] | grid_id | handle to the grid struct |
[in] | nbr_points | number of points |
[in] | location | location of points |
[in] | x_points | array of point longitudes, in radians |
[in] | y_points | array of point latitudes, in radians |
[out] | point_id | returned handle to the points struct |
Definition at line 919 of file yac.c.
void yac_cenable_field_frac_mask | ( | const char * | comp_name, |
const char * | grid_name, | ||
const char * | field_name, | ||
double | frac_mask_fallback_value | ||
) |
Enables fractional masking for a coupling field and sets the fallback value
[in] | comp_name | |
[in] | grid_name | |
[in] | field_name | |
[in] | frac_mask_fallback_value | fractional mask fallback value |
Definition at line 1128 of file yac.c.
void yac_cenable_field_frac_mask_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
const char * | grid_name, | ||
const char * | field_name, | ||
double | frac_mask_fallback_value | ||
) |
Enables fractional masking for a coupling field and sets the fallback value
[in] | yac_instance_id | |
[in] | comp_name | |
[in] | grid_name | |
[in] | field_name | |
[in] | frac_mask_fallback_value | fractional mask fallback value |
Definition at line 1116 of file yac.c.
void yac_cenddef | ( | void | ) |
void yac_cenddef_and_emit_config | ( | int | emit_flags, |
char ** | config | ||
) |
End of the definition phase for the default YAC instance, invocation of the search and setup of internal data structures for coupling (communication matrices and interpolation weights). In addition, the collected coupling configuration from all processes is emitted.
[in] | emit_flags | flags for configuring the generated coupling configuration output (YAC_YAML_EMITTER_DEFAULT or YAC_YAML_EMITTER_JSON) |
[out] | config | coupling configuration |
Definition at line 2855 of file yac.c.
void yac_cenddef_and_emit_config_instance | ( | int | yac_instance_id, |
int | emit_flags, | ||
char ** | config | ||
) |
End of the definition phase, invocation of the search and setup of internal data structures for coupling (communication matrices and interpolation weights). In addition, the collected coupling configuration from all processes is emitted.
[in] | yac_instance_id | id of the YAC instance |
[in] | emit_flags | flags for configuring the generated coupling configuration output (YAC_YAML_EMITTER_DEFAULT or YAC_YAML_EMITTER_JSON) |
[out] | config | coupling configuration |
Definition at line 2846 of file yac.c.
void yac_cenddef_instance | ( | int | yac_instance_id | ) |
End of the definition phase, invocation of the search and setup of internal data structures for coupling (communication matrices and interpolation weights)
[in] | yac_instance_id | id of the YAC instance |
Definition at line 2834 of file yac.c.
void yac_cexchange | ( | int const | send_field_id, |
int const | recv_field_id, | ||
int const | collection_size, | ||
double ***const | send_field, | ||
double ** | recv_field, | ||
int * | send_info, | ||
int * | recv_info, | ||
int * | ierror | ||
) |
Exchange of the coupling fields
[in] | send_field_id | - |
[in] | recv_field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer dimensions send_field[collection_size] [nbr_fields] [nbr_points] |
[in] | recv_field | - receive buffer dimensions: recv_field[collection_size][nbr_points] |
[out] | send_info | - returned send info |
[out] | recv_info | - returned recv info |
[out] | ierror | - returned error |
Definition at line 2804 of file yac.c.
void yac_cexchange_ | ( | int const | send_field_id, |
int const | recv_field_id, | ||
int const | collection_size, | ||
double * | send_field, | ||
double * | recv_field, | ||
int * | send_info, | ||
int * | recv_info, | ||
int * | ierror | ||
) |
Exchange of the coupling fields
[in] | send_field_id | - |
[in] | recv_field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer (all data is stored in one contiguous part of the memory) dimensions send_field[collection_size] [nbr_fields] [nbr_points] |
[in] | recv_field | - receive buffer (all data is stored in one contiguous part of the memory) dimensions: recv_field[collection_size][nbr_points] |
[out] | send_info | - returned send info |
[out] | recv_info | - returned recv info |
[out] | ierror | - returned error |
Definition at line 2528 of file yac.c.
void yac_cexchange_frac | ( | int const | send_field_id, |
int const | recv_field_id, | ||
int const | collection_size, | ||
double ***const | send_field, | ||
double ***const | send_frac_mask, | ||
double ** | recv_field, | ||
int * | send_info, | ||
int * | recv_info, | ||
int * | ierror | ||
) |
Exchange of the coupling fields
[in] | send_field_id | - |
[in] | recv_field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer dimensions send_field[collection_size] [nbr_fields] [nbr_points] |
[in] | send_frac_mask | - send fractional mask dimensions send_frac_mask[collection_size] [nbr_fields] [nbr_points] |
[in] | recv_field | - receive buffer dimensions: recv_field[collection_size][nbr_points] |
[out] | send_info | - returned send info |
[out] | recv_info | - returned recv info |
[out] | ierror | - returned error |
Definition at line 2669 of file yac.c.
void yac_cexchange_frac_ | ( | int const | send_field_id, |
int const | recv_field_id, | ||
int const | collection_size, | ||
double * | send_field, | ||
double * | send_frac_mask, | ||
double * | recv_field, | ||
int * | send_info, | ||
int * | recv_info, | ||
int * | ierror | ||
) |
Exchange of the coupling fields
[in] | send_field_id | - |
[in] | recv_field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer (all data is stored in one contiguous part of the memory) dimensions send_field[collection_size] [nbr_fields] [nbr_points] |
[in] | send_frac_mask | - send fractional mask (all data is stored in one contiguous part of the memory) dimensions send_frac_mask[collection_size] [nbr_fields] [nbr_points] |
[in] | recv_field | - receive buffer (all data is stored in one contiguous part of the memory) dimensions: recv_field[collection_size][nbr_points] |
[out] | send_info | - returned send info |
[out] | recv_info | - returned recv info |
[out] | ierror | - returned error |
Definition at line 2561 of file yac.c.
void yac_cexchange_frac_ptr_ | ( | int const | send_field_id, |
int const | recv_field_id, | ||
int const | collection_size, | ||
double ** | send_field, | ||
double ** | send_frac_mask, | ||
double ** | recv_field, | ||
int * | send_info, | ||
int * | recv_info, | ||
int * | ierror | ||
) |
Sending of the coupling fields
[in] | send_field_id | - |
[in] | recv_field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer dimensions send_field[collection_size * nbr_fields] [nbr_points] |
[in] | send_frac_mask | - send buffer dimensions send_frac_mask[collection_size * nbr_fields] [nbr_points] |
[in] | recv_field | - receive buffer dimensions: recv_field[collection_size][nbr_points] |
[out] | send_info | - returned send info |
[out] | recv_info | - returned recv info |
[out] | ierror | - returned error |
Definition at line 2633 of file yac.c.
void yac_cexchange_ptr_ | ( | int const | send_field_id, |
int const | recv_field_id, | ||
int const | collection_size, | ||
double ** | send_field, | ||
double ** | recv_field, | ||
int * | send_info, | ||
int * | recv_info, | ||
int * | ierror | ||
) |
Sending of the coupling fields
[in] | send_field_id | - |
[in] | recv_field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer dimensions send_field[collection_size * nbr_fields] [nbr_points] |
[in] | recv_field | - receive buffer dimensions: recv_field[collection_size][nbr_points] |
[out] | send_info | - returned send info |
[out] | recv_info | - returned recv info |
[out] | ierror | - returned error |
Definition at line 2603 of file yac.c.
void yac_cfinalize | ( | ) |
void yac_cfinalize_instance | ( | int | yac_instance_id | ) |
void yac_cfree_ext_couple_config | ( | int | ext_couple_config_id | ) |
void yac_cfree_interp_stack_config | ( | int | interp_stack_config_id | ) |
void yac_cget | ( | int const | field_id, |
int const | collection_size, | ||
double ** | recv_field, | ||
int * | info, | ||
int * | ierror | ||
) |
Receiving of the coupling fields
[in] | field_id | - |
[in] | collection_size | - |
[in] | recv_field | - receive buffer dimensions: recv_field[collection_size][nbr_points] |
[out] | info | - returned info argument indicating the action performed |
[out] | ierror | - returned error |
Definition at line 1850 of file yac.c.
void yac_cget_ | ( | int const | field_id, |
int const | collection_size, | ||
double * | recv_field, | ||
int * | info, | ||
int * | ierror | ||
) |
Receiving of the coupling fields
[in] | field_id | - |
[in] | collection_size | - |
[in] | recv_field | - receive buffer (all data is stored in one contiguous part of the memory) dimensions: recv_field[collection_size][nbr_points] |
[in] | info | - returned info argument indicating the action performed |
[out] | ierror | - returned error |
Definition at line 1832 of file yac.c.
void yac_cget_action | ( | int | field_id, |
int * | action | ||
) |
Returns the action a put/get would return for the current timestep
[in] | field_id | field id returned by yac_cdef_field |
[out] | action | action for the current timestep (YAC_ACTION_NONE, YAC_ACTION_REDUCTION, YAC_ACTION_COUPLING, YAC_ACTION_GET_FOR_RESTART, YAC_ACTION_PUT_FOR_RESTART, or YAC_ACTION_OUT_OF_BOUND) |
Definition at line 1611 of file yac.c.
void yac_cget_async | ( | int const | field_id, |
int const | collection_size, | ||
double ** | recv_field, | ||
int * | info, | ||
int * | ierror | ||
) |
Receiving of the coupling fields
[in] | field_id | - |
[in] | collection_size | - |
[in] | recv_field | - receive buffer dimensions: recv_field[collection_size][nbr_points] |
[out] | info | - returned info argument indicating the action performed |
[out] | ierror | - returned error |
Definition at line 1859 of file yac.c.
void yac_cget_async_ | ( | int const | field_id, |
int const | collection_size, | ||
double * | recv_field, | ||
int * | info, | ||
int * | ierror | ||
) |
Receiving of the coupling fields
[in] | field_id | - |
[in] | collection_size | - |
[in] | recv_field | - receive buffer (all data is stored in one contiguous part of the memory) dimensions: recv_field[collection_size][nbr_points] |
[in] | info | - returned info argument indicating the action performed |
[out] | ierror | - returned error |
Definition at line 1841 of file yac.c.
int yac_cget_collection_size_from_field_id | ( | int | field_id | ) |
void yac_cget_comp_comm | ( | int | comp_id, |
MPI_Comm * | comp_comm | ||
) |
void yac_cget_comp_grid_names | ( | const char * | comp_name, |
int | nbr_grids, | ||
const char ** | grid_names | ||
) |
query routine to get the list of grid names of a given component that are referenced by at least one defined field or have metadata assigned to it
[in] | comp_name | name of the component |
[in] | nbr_grids | number of grids |
[out] | grid_names | list of grid names |
Definition at line 3013 of file yac.c.
void yac_cget_comp_grid_names_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
int | nbr_grids, | ||
const char ** | grid_names | ||
) |
query routine to get the list of grid names of a given component that are referenced by at least one defined field or have metadata assigned to it
[in] | yac_instance_id | id of the YAC instance |
[in] | comp_name | name of the component |
[in] | nbr_grids | number of grids |
[out] | grid_names | list of grid names |
Definition at line 2994 of file yac.c.
void yac_cget_comp_names | ( | int | nbr_comps, |
const char ** | comp_names | ||
) |
void yac_cget_comp_names_instance | ( | int | yac_instance_id, |
int | nbr_comps, | ||
const char ** | comp_names | ||
) |
query routine to get the list of component names for defined
[in] | yac_instance_id | id of the YAC instance |
[in] | nbr_comps | number of components |
[out] | comp_names | list of component names |
Definition at line 2961 of file yac.c.
int yac_cget_comp_nbr_grids | ( | const char * | comp_name | ) |
int yac_cget_comp_nbr_grids_instance | ( | int | yac_instance_id, |
const char * | comp_name | ||
) |
query routine for number of grids defined for a given components that is referenced by at least one defined field.
[in] | yac_instance_id | id of the YAC instance |
[in] | comp_name |
Definition at line 2913 of file yac.c.
const char * yac_cget_component_metadata | ( | const char * | comp_name | ) |
const char * yac_cget_component_metadata_instance | ( | int | yac_instance_id, |
const char * | comp_name | ||
) |
const char * yac_cget_component_name_from_field_id | ( | int | field_id | ) |
void yac_cget_comps_comm | ( | const char ** | comp_names, |
int | num_comps, | ||
MPI_Comm * | comps_comm | ||
) |
Generates an MPI communicator that contains all processes of the provided components
[in] | comp_names | name of components |
[in] | num_comps | number of components |
[out] | comps_comm | generated communicator |
Definition at line 688 of file yac.c.
void yac_cget_comps_comm_instance | ( | int | yac_instance_id, |
const char ** | comp_names, | ||
int | num_comps, | ||
MPI_Comm * | comps_comm | ||
) |
Generates an MPI communicator that contains all processes of the provided components
[in] | yac_instance_id | id of the YAC instance |
[in] | comp_names | name of components |
[in] | num_comps | number of components |
[out] | comps_comm | generated communicator |
Definition at line 678 of file yac.c.
int yac_cget_default_instance_id | ( | ) |
Getter function for the default instance
Returns the instance id of the default instance.
Definition at line 359 of file yac.c.
char * yac_cget_end_datetime | ( | void | ) |
char * yac_cget_end_datetime_instance | ( | int | yac_instance_id | ) |
void yac_cget_ext_couple_config | ( | int * | ext_couple_config_id | ) |
void yac_cget_ext_couple_config_mapping_side | ( | int | ext_couple_config_id, |
int * | mapping_side | ||
) |
void yac_cget_ext_couple_config_mask_name | ( | int | ext_couple_config_id, |
char const ** | tgt_mask_name | ||
) |
void yac_cget_ext_couple_config_scale_factor | ( | int | ext_couple_config_id, |
double * | scale_factor | ||
) |
void yac_cget_ext_couple_config_scale_summand | ( | int | ext_couple_config_id, |
double * | scale_summand | ||
) |
void yac_cget_ext_couple_config_src_mask_names | ( | int | ext_couple_config_id, |
size_t * | num_src_mask_names, | ||
char const *const ** | src_mask_names | ||
) |
void yac_cget_ext_couple_config_weight_file | ( | int | ext_couple_config_id, |
char const ** | weight_file | ||
) |
int yac_cget_field_collection_size | ( | const char * | comp_name, |
const char * | grid_name, | ||
const char * | field_name | ||
) |
int yac_cget_field_collection_size_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
const char * | grid_name, | ||
const char * | field_name | ||
) |
const char * yac_cget_field_datetime | ( | int | field_id | ) |
double yac_cget_field_frac_mask_fallback_value | ( | const char * | comp_name, |
const char * | grid_name, | ||
const char * | field_name | ||
) |
query routine to get the fractional mask fallback value of a field
[in] | comp_name | |
[in] | grid_name | |
[in] | field_name |
Definition at line 3137 of file yac.c.
double yac_cget_field_frac_mask_fallback_value_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
const char * | grid_name, | ||
const char * | field_name | ||
) |
query routine to get the fractional mask fallback value of a field
[in] | yac_instance_id | |
[in] | comp_name | |
[in] | grid_name | |
[in] | field_name |
Definition at line 3116 of file yac.c.
int yac_cget_field_id | ( | const char * | comp_name, |
const char * | grid_name, | ||
const char * | field_name | ||
) |
int yac_cget_field_id_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
const char * | grid_name, | ||
const char * | field_name | ||
) |
query routine to get the field_id from component, grid and field name (if defined on this process)
[in] | yac_instance_id | |
[in] | comp_name | component name |
[in] | grid_name | grid name |
[in] | field_name | field name |
Definition at line 2866 of file yac.c.
const char * yac_cget_field_metadata | ( | const char * | comp_name, |
const char * | grid_name, | ||
const char * | field_name | ||
) |
const char * yac_cget_field_metadata_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
const char * | grid_name, | ||
const char * | field_name | ||
) |
const char * yac_cget_field_name_from_field_id | ( | int | field_id | ) |
void yac_cget_field_names | ( | const char * | comp_name, |
const char * | grid_name, | ||
int | nbr_fields, | ||
const char ** | field_names | ||
) |
query routine to get the list of field names defined on the given component and grid for the default YAC instance.
[in] | comp_name | component name |
[in] | grid_name | grid name |
[in] | nbr_fields | number of fields |
[out] | field_names | list of field names |
Definition at line 3045 of file yac.c.
void yac_cget_field_names_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
const char * | grid_name, | ||
int | nbr_fields, | ||
const char ** | field_names | ||
) |
query routine to get the list of field names on the given component and grid
[in] | yac_instance_id | id of the YAC instance |
[in] | comp_name | component name |
[in] | grid_name | grid name |
[in] | nbr_fields | number of fields |
[out] | field_names | list of grid names |
Definition at line 3019 of file yac.c.
int yac_cget_field_role | ( | const char * | comp_name, |
const char * | grid_name, | ||
const char * | field_name | ||
) |
query routine to get the role of a field for a given ID
[in] | comp_name | |
[in] | grid_name | |
[in] | field_name |
Definition at line 3163 of file yac.c.
int yac_cget_field_role_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
const char * | grid_name, | ||
const char * | field_name | ||
) |
query routine to get the role of a field for a given ID
[in] | yac_instance_id | |
[in] | comp_name | |
[in] | grid_name | |
[in] | field_name |
Definition at line 3152 of file yac.c.
const char * yac_cget_field_timestep | ( | const char * | comp_name, |
const char * | grid_name, | ||
const char * | field_name | ||
) |
const char * yac_cget_field_timestep_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
const char * | grid_name, | ||
const char * | field_name | ||
) |
query routine to get the timestep of a field
[in] | yac_instance_id | |
[in] | comp_name | |
[in] | grid_name | |
[in] | field_name |
Definition at line 3097 of file yac.c.
const char * yac_cget_grid_metadata | ( | const char * | grid_name | ) |
const char * yac_cget_grid_metadata_instance | ( | int | yac_instance_id, |
const char * | grid_name | ||
) |
const char * yac_cget_grid_name_from_field_id | ( | int | field_id | ) |
void yac_cget_grid_names | ( | int | nbr_grids, |
const char ** | grid_names | ||
) |
query routine to get the list of grid names of the default YAC instance that are referenced by at least one defined field or have metadata assigned to it
[in] | nbr_grids | number of grids |
[out] | grid_names | list of grid names |
Definition at line 2989 of file yac.c.
void yac_cget_grid_names_instance | ( | int | yac_instance_id, |
int | nbr_grids, | ||
const char ** | grid_names | ||
) |
query routine to get the list of grid names that are referenced by at least one defined field or have metadata assigned to it
[in] | yac_instance_id | id of the YAC instance |
[in] | nbr_grids | number of grids |
[out] | grid_names | list of grid names |
Definition at line 2978 of file yac.c.
size_t yac_cget_grid_size | ( | int | location, |
int | grid_id | ||
) |
void yac_cget_groupcomm | ( | MPI_Comm * | group_comm | ) |
Providing a group communicator for the default YAC instance
[out] | group_comm | communicator containing all processes that passed the same group name to the init-routine or MPI_COMM_NULL if not group name was provided. |
void yac_cget_groupcomm_instance | ( | int | yac_instance_id, |
MPI_Comm * | group_comm | ||
) |
Providing a group communicator
[in] | yac_instance_id | id of the YAC instance |
[out] | group_comm | communicator containing all processes that passed the same group name to the init-routine or MPI_COMM_NULL if not group name was provided. |
void yac_cget_interp_stack_config | ( | int * | interp_stack_config_id | ) |
int yac_cget_nbr_comps | ( | void | ) |
int yac_cget_nbr_comps_instance | ( | int | yac_instance_id | ) |
int yac_cget_nbr_fields | ( | const char * | comp_name, |
const char * | grid_name | ||
) |
query routine for number of coupling fields defined in the given component and grids of the default YAC instance
[in] | comp_name | name of the component |
[in] | grid_name | name of the grid |
Definition at line 2956 of file yac.c.
int yac_cget_nbr_fields_instance | ( | int | yac_instance_id, |
const char * | comp_name, | ||
const char * | grid_name | ||
) |
query routine for number of coupling fields defined in the given component and grids
[in] | yac_instance_id | id of the YAC instance |
[in] | comp_name | name of the component |
[in] | grid_name | name of the grid |
Definition at line 2936 of file yac.c.
int yac_cget_nbr_grids | ( | ) |
int yac_cget_nbr_grids_instance | ( | int | yac_instance_id | ) |
query routine for number of grids that are referenced by at least one defined field or have metadata assigned to it
[in] | yac_instance_id | id of the YAC instance |
Definition at line 2900 of file yac.c.
size_t yac_cget_points_size | ( | int | points_id | ) |
int yac_cget_role_from_field_id | ( | int | field_id | ) |
query routine to get the role of a field for a given ID
[in] | field_id | ID as provided by yac_cdef_field |
Definition at line 3088 of file yac.c.
char * yac_cget_start_datetime | ( | void | ) |
char * yac_cget_start_datetime_instance | ( | int | yac_instance_id | ) |
const char * yac_cget_timestep_from_field_id | ( | int | field_id | ) |
query routine to get the timestep of a field for a given ID
[in] | field_id | ID as provided by yac_cdef_field |
Definition at line 3074 of file yac.c.
char * yac_cget_version | ( | void | ) |
void yac_cinit | ( | void | ) |
Elementary initialisation of the whole system
Definition at line 402 of file yac.c.
void yac_cinit_comm | ( | MPI_Comm | comm | ) |
Elementary initialisation of the whole system using a user-provided MPI communicator
[in] | comm | MPI communicator |
Definition at line 376 of file yac.c.
void yac_cinit_comm_dummy | ( | MPI_Comm | comm | ) |
Dummy initialisation of the whole system using a user-provided MPI world communicator
[in] | comm | MPI communicator |
Definition at line 412 of file yac.c.
void yac_cinit_comm_instance | ( | MPI_Comm | comm, |
int * | yac_instance_id | ||
) |
Elementary initialisation of the whole system using a user-provided MPI communicator
[in] | comm | MPI communicator |
[out] | yac_instance_id | id of the YAC instance initialised by this call |
Definition at line 364 of file yac.c.
void yac_cinit_dummy | ( | void | ) |
Dummy for initialisation of the whole system
Definition at line 428 of file yac.c.
void yac_cinit_instance | ( | int * | yac_instance_id | ) |
Elementary initialisation of the whole system
[out] | yac_instance_id | id of the YAC instance initialised by this call |
Definition at line 390 of file yac.c.
void yac_cmpi_handshake | ( | MPI_Comm | comm, |
size_t | n, | ||
char const ** | group_names, | ||
MPI_Comm * | group_comms | ||
) |
MPI Handshake (MPI handshake algorithm)
Splits the provided communicator into group communicators. Each group communicator contains all processes of the provided communicator that provided the same group name. The order of the group names can be arbitrary on each process. A process can be part of multiple groups.
[in] | comm | MPI communicator |
[in] | n | number of group communicators to be generated |
[in] | group_names | group names |
[out] | group_comms | group communicators |
Definition at line 327 of file yac.c.
void yac_cpredef_comp | ( | char const * | comp_name, |
int * | comp_id | ||
) |
Non-blocking pre-definition of a component for the default YAC instance.
[in] | comp_name | name of the component |
[out] | comp_id | component Id |
Definition at line 751 of file yac.c.
void yac_cpredef_comp_instance | ( | int | yac_instance_id, |
char const * | comp_name, | ||
int * | comp_id | ||
) |
Non-blocking pre-definition of a component.
[in] | yac_instance_id | id of the YAC instance |
[in] | comp_name | name of the component |
[out] | comp_id | component Id |
Definition at line 718 of file yac.c.
void yac_cput | ( | int const | field_id, |
int const | collection_size, | ||
double ***const | send_field, | ||
int * | info, | ||
int * | ierror | ||
) |
Sending of the coupling fields
[in] | field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer dimensions send_field[collection_size] [nbr_fields] [nbr_points] |
[out] | info | - returned info |
[out] | ierror | - returned error |
Definition at line 2514 of file yac.c.
void yac_cput_ | ( | int const | field_id, |
int const | collection_size, | ||
double * | send_field, | ||
int * | info, | ||
int * | ierror | ||
) |
Sending of the coupling fields
[in] | field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer (all data is stored in one contiguous part of the memory) dimensions send_field[collection_size] [nbr_fields] [nbr_points] |
[out] | info | - returned info |
[out] | ierror | - returned error |
Definition at line 1917 of file yac.c.
void yac_cput_frac | ( | int const | field_id, |
int const | collection_size, | ||
double ***const | send_field, | ||
double ***const | send_frac_mask, | ||
int * | info, | ||
int * | ierror | ||
) |
Sending of the coupling fields
[in] | field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer dimensions send_field[collection_size] [nbr_fields] [nbr_points] |
[in] | send_frac_mask | - send fractional mask dimensions send_frac_mask[collection_size] [nbr_fields] [nbr_points] |
[out] | info | - returned info |
[out] | ierror | - returned error |
Definition at line 2425 of file yac.c.
void yac_cput_frac_ | ( | int const | field_id, |
int const | collection_size, | ||
double * | send_field, | ||
double * | send_frac_mask, | ||
int * | info, | ||
int * | ierror | ||
) |
Sending of the coupling fields
[in] | field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer (all data is stored in one contiguous part of the memory) dimensions send_field[collection_size] [nbr_fields] [nbr_points] |
[in] | send_frac_mask | - send fractional mask (all data is stored in one contiguous part of the memory) dimensions send_frac_mask[collection_size] [nbr_fields] [nbr_points] |
[out] | info | - returned info |
[out] | ierror | - returned error |
Definition at line 1938 of file yac.c.
void yac_cput_frac_ptr_ | ( | int const | field_id, |
int const | collection_size, | ||
double ** | send_field, | ||
double ** | send_frac_mask, | ||
int * | info, | ||
int * | ierror | ||
) |
Sending of the coupling fields
[in] | field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer dimensions send_field[collection_size * nbr_fields] [nbr_points] |
[in] | send_frac_mask | - send fractional mask dimensions send_frac_mask[collection_size * nbr_fields] [nbr_points] |
[out] | info | - returned info |
[out] | ierror | - returned error |
Definition at line 2035 of file yac.c.
void yac_cput_ptr_ | ( | int const | field_id, |
int const | collection_size, | ||
double ** | send_field, | ||
int * | info, | ||
int * | ierror | ||
) |
Sending of the coupling fields
[in] | field_id | - |
[in] | collection_size | - |
[in] | send_field | - send buffer dimensions send_field[collection_size * nbr_fields] [nbr_points] |
[out] | info | - returned info |
[out] | ierror | - returned error |
Definition at line 2015 of file yac.c.
void yac_cread_config_json | ( | const char * | json_file | ) |
void yac_cread_config_json_instance | ( | int | yac_instance_id, |
const char * | json_file | ||
) |
void yac_cread_config_yaml | ( | const char * | yaml_file | ) |
void yac_cread_config_yaml_instance | ( | int | yac_instance_id, |
const char * | yaml_file | ||
) |
void yac_cset_core_mask | ( | int const * | is_core, |
int | location, | ||
int | grid_id | ||
) |
Set core mask for a grid
[in] | is_core | 0 for cells/vertices/edges that are halos, 1 for cells/vertices/edges that are core |
[in] | location | cell/vertex/edge |
[in] | grid_id | grid id |
Definition at line 3285 of file yac.c.
void yac_cset_ext_couple_config_mapping_side | ( | int | ext_couple_config_id, |
int | mapping_side | ||
) |
void yac_cset_ext_couple_config_scale_factor | ( | int | ext_couple_config_id, |
double | scale_factor | ||
) |
void yac_cset_ext_couple_config_scale_summand | ( | int | ext_couple_config_id, |
double | scale_summand | ||
) |
void yac_cset_ext_couple_config_src_mask_names | ( | int | ext_couple_config_id, |
size_t | num_src_mask_names, | ||
char const *const * | src_mask_names | ||
) |
Sets source mask names
[in] | ext_couple_config_id | extended coupling configuration |
[in] | num_src_mask_names | number of source mask names |
[in] | src_mask_names | source mask names |
Definition at line 1362 of file yac.c.
void yac_cset_ext_couple_config_tgt_mask_name | ( | int | ext_couple_config_id, |
char const * | tgt_mask_name | ||
) |
void yac_cset_ext_couple_config_weight_file | ( | int | ext_couple_config_id, |
char const * | weight_file | ||
) |
Sets the weight file name
[in] | ext_couple_config_id | extended coupling configuration |
[in] | weight_file | name of a weight file |
Definition at line 1260 of file yac.c.
void yac_cset_global_index | ( | int const * | global_index, |
int | location, | ||
int | grid_id | ||
) |
Set global ids for a grid
[in] | global_index | array of global indices |
[in] | location | cell/vertex/edge |
[in] | grid_id | grid id |
Definition at line 3244 of file yac.c.
void yac_cset_mask | ( | int const * | is_valid, |
int | points_id | ||
) |
void yac_csync_def | ( | void | ) |
void yac_csync_def_instance | ( | int | yac_instance_id | ) |
void yac_ctest | ( | int | field_id, |
int * | flag | ||
) |
Determines whether there is an asynchronous communication associated with a field, which is not yet completed (for example by a previous put)
[in] | field_id | |
[out] | flag | "0" if there is an uncompleted asynchronous communication associated with the field, "1" otherwise |
Definition at line 2066 of file yac.c.
void yac_cupdate | ( | int | field_id | ) |
If the action for the current timestep is YAC_ACTION_NONE, this routine will advance the internal clock to next timestep.
[in] | field_id | field id returned by yac_cdef_field |
Definition at line 1674 of file yac.c.
void yac_cwait | ( | int | field_id | ) |
yac_abort_func yac_get_abort_handler | ( | void | ) |
yac_abort_func yac_get_default_abort_handler | ( | void | ) |
void yac_restore_default_abort_handler | ( | void | ) |
Restores default abort handler
void yac_set_abort_handler | ( | yac_abort_func | custom_abort | ) |
Sets custom abort handler
[in] | custom_abort | custom abort handler |
void yac_set_default_comm | ( | MPI_Comm | comm | ) |
Sets default MPI communicator (MPI_COMM_WORLD by default)
[in] | comm | default MPI communicator |
|
extern |
emit to YAML format
Definition at line 46 of file config_yaml.c.
|
extern |
emit to JSON format
Definition at line 47 of file config_yaml.c.