Yet Another eXchange Tool 0.11.2
|
opaque configuration object for settings where the default needs to be overridden More...
#include <xt/xt_xmap_dist_dir_bucket_gen.h>
Go to the source code of this file.
Typedefs | |
typedef struct Xt_config_ * | Xt_config |
Enumerations | |
enum | Xt_exchangers { xt_exchanger_irecv_send , xt_exchanger_irecv_isend , xt_exchanger_irecv_isend_packed , xt_exchanger_mix_isend_irecv , xt_exchanger_neigh_alltoall , xt_exchanger_irecv_isend_ddt_packed } |
enum | Xt_mthread_mode { XT_MT_NONE = 0 , XT_MT_OPENMP = 1 } |
enum | Xt_sort_algorithm { XT_QUICKSORT , XT_MERGESORT } |
opaque configuration object for settings where the default needs to be overridden
Definition in file xt_config.h.
typedef struct Xt_config_* Xt_config |
Definition at line 58 of file xt_config.h.
enum Xt_exchangers |
Enumerator | |
---|---|
xt_exchanger_irecv_send | |
xt_exchanger_irecv_isend | |
xt_exchanger_irecv_isend_packed | |
xt_exchanger_mix_isend_irecv | |
xt_exchanger_neigh_alltoall | |
xt_exchanger_irecv_isend_ddt_packed |
Definition at line 75 of file xt_config.h.
enum Xt_mthread_mode |
Enumerator | |
---|---|
XT_MT_NONE | |
XT_MT_OPENMP |
Definition at line 138 of file xt_config.h.
enum Xt_sort_algorithm |
Enumerator | |
---|---|
XT_QUICKSORT | use default, in-place algorithm |
XT_MERGESORT | use merge sort with allocation to trade space for better worst-case behaviour |
Definition at line 163 of file xt_config.h.
void xt_config_delete | ( | Xt_config | config | ) |
destructor of configuration objects
[in,out] | config | configuration object to destroy |
Definition at line 85 of file xt_config.c.
int xt_config_get_exchange_method | ( | Xt_config | config | ) |
get exchanger used when the config object is passed to constructors
[in] | config | configuration object to query |
Definition at line 144 of file xt_config.c.
int xt_config_get_idxvec_autoconvert_size | ( | Xt_config | config | ) |
query size above which index lists of vector type will be converted
For many operations it makes sense to first compress large index vectors to stripes before continuing further computations.
[in] | config | configuration object to query |
Definition at line 327 of file xt_config.c.
int xt_config_get_mem_saving | ( | Xt_config | config | ) |
Get memory conservation parameter.
[in] | config | configuration object to query |
Definition at line 269 of file xt_config.c.
int xt_config_get_redist_mthread_mode | ( | Xt_config | config | ) |
query multi-thread mode of message passing
[in] | config | configuration object to query |
Definition at line 340 of file xt_config.c.
int xt_config_get_sort_algorithm_id | ( | Xt_config | config | ) |
query sorting algorithm suite
[in] | config | configuration object to query |
Definition at line 232 of file xt_config.c.
int xt_config_get_xmap_stripe_align | ( | Xt_config | config | ) |
Get xmap stripe alignment parameter.
[in] | config | configuration object to query |
Definition at line 399 of file xt_config.c.
Xt_xmdd_bucket_gen xt_config_get_xmdd_bucket_gen | ( | Xt_config | config | ) |
Query configured bucket generator
Definition at line 276 of file xt_config.c.
Xt_config xt_config_new | ( | void | ) |
constructor for configuration object
Definition at line 78 of file xt_config.c.
void xt_config_set_exchange_method | ( | Xt_config | config, |
int | method ) |
set exchanger to use when the config object is passed to constructors
[in,out] | config | configuration object to modify |
method | an entry from enum Xt_exchangers to signify the desired exchanger for data transfers |
Definition at line 297 of file xt_config.c.
void xt_config_set_idxvec_autoconvert_size | ( | Xt_config | config, |
int | cnvsize ) |
set size above which index lists of vector type will be converted
For many operations it makes sense to first compress large index vectors to stripes before continuing further computations. This function sets the size of vectors at which this conversion happens for operations that are called with the configuration object as parameter.
[in,out] | config | configuration object to modify |
[in] | cnvsize | size of vectors at which conversion happens |
Definition at line 333 of file xt_config.c.
void xt_config_set_mem_saving | ( | Xt_config | config, |
int | memconserve ) |
Set memory conservation parameter.
[in,out] | config | configuration object to modify |
memconserve | switch on methods of memory saving currently supported values: 0 and 1 |
When set to 1, operations parameterized by config will aggressively try to trade memory savings for higher computational cost.
Currently, by not sorting index lists used in xmap construction.
When set to 0, use default trade-offs for space vs. time complexity.
Definition at line 263 of file xt_config.c.
void xt_config_set_redist_mthread_mode | ( | Xt_config | config, |
int | mode ) |
set multi-thread mode of message passing
[in,out] | config | configuration object to modify |
[in] | mode | one of the enum Xt_mthread_mode members above |
Definition at line 347 of file xt_config.c.
void xt_config_set_sort_algorithm_by_id | ( | Xt_config | config, |
int | algo ) |
set sorting algorithm suite
[in,out] | config | configuration object to modify |
[in] | algo | one of the enum Xt_sort_algorithm members above |
Definition at line 245 of file xt_config.c.
void xt_config_set_xmap_stripe_align | ( | Xt_config | config, |
int | use_stripe_align ) |
Set xmap stripe alignment parameter.
[in,out] | config | configuration object to modify |
use_stripe_align | 0: detect element positions one by one, 1: align full stripes to form position extents 2: automatically choose element of stripe alignment |
When set to 1, the computations in the xmap constructor can be much more expensive if stripes are very short. When set to 0, use very simple algorithm that positions each element individually but will use memory proportional to the local index list sizes.
By default the xmap constructor switches automatically to stripe alignment if it appears profitable, which might be untrue if the number of resulting stripes/extents is rather high.
Definition at line 389 of file xt_config.c.
void xt_config_set_xmdd_bucket_gen | ( | Xt_config | config, |
Xt_xmdd_bucket_gen | bucket_gen_iface ) |
Change generator for buckets in distributed directory The default is a generator that tiles the range of indices of all index lists involved in xmap creation in 1D fashion with stripes.
Definition at line 282 of file xt_config.c.
int xt_exchanger_id_by_name | ( | const char * | name | ) |
map exchanger name string to method id from Xt_exchangers
[in] | name | string that is supposed to match the part of the corresponding enum after xt_exchanger_ |
Definition at line 126 of file xt_config.c.