wbox.h

#include <complex.h> // todo: create gcc g++ compatibility. See wdata, winterp, wderiv for template
#include <stdio.h>
#include <stdlib.h>

typedef struct
{
    int ix;
    int iy;
    int iz;
} wbox_insert_t;

typedef struct
{
    int nx;
    int ny;
    int nz;

    int dim;

    void *data;
} wbox_md_t;

// SUCCESS
#define WBOX_SUCCESS_INIT EXIT_SUCCESS

#define WBOX_SUCCESS_INSERT EXIT_SUCCESS
#define WBOX_SUCCESS_INSERT_CHECK EXIT_SUCCESS

#define WBOX_SUCCESS_MERGE EXIT_SUCCESS

#define WBOX_SUCCESS_ROTATE EXIT_SUCCESS

// ERRORS
#define WBOX_ERR_INIT_DIM 0001
#define WBOX_ERR_INIT_DATATYPE_NOT_IMPLEMENTED 0002

#define WBOX_ERR_INSERT 1000

#define WBOX_ERR_MERGE 2000

#define WBOX_ERR_ROTATE 3000

/**
 * @brief Function to initialize latice
 *
 * @param wbmd [out] - pointer to WBox metadata structure. Each WBox structure is responsible for only one variable, like rho_a
 * @param nx [in] - number of lattice points in OX direction {int}
 * @param ny [in] - number of lattice points in OY direction
 * @param nz [in] - number of lattice points in OZ direction
 * @param datatype [in] - character describing type of data. Can be 'i'nteger, 'r'eal (double), 'c'omplex (double complex)
 * @param data [in] - pointer to a data of `datatype` type
 * @return `WBOX_SUCCESS_INIT` or `WBOX_ERR_INIT` with help description
 */
int wbox_init(wbox_md_t *wbmd, const int nx, const int ny, const int nz, const char datatype, const void *data);

/**
 * @brief Function that inserts data from smaller 1D box (`wmbd`) into the 1D bigger box(`wmbd_big`) that is anchored in `wbox_insert`.
 * Function checks the anchor placements.
 *
 * @param wbmd [in] - `wbox_md_t` type that stores the information about data from small box
 * @param wbox_insert [in] - `wbox_insert_t` type that stores the information about the anchor point
 * @param wbmd_big [out] - `wbox_md_t` type that stores the information about data from big box
 * @return `WBOX_SUCCESS_INSERT` or `WBOX_ERR_INSERT` with help description
 */
int wbox_insert_1d(const wbox_md_t *wbmd, const wbox_insert_t wbox_insert, wbox_md_t *wbmd_big);

/**
 * @brief Function that inserts data from smaller 2D box (`wmbd`) into the 2D bigger box(`wmbd_big`) that is anchored in `wbox_insert`.
 * Function checks the anchor placements.
 *
 * @param wbmd [in] - `wbox_md_t` type that stores the information about data from small box
 * @param wbox_insert [in] - `wbox_insert_t` type that stores the information about the anchor point
 * @param wbmd_big [out] - `wbox_md_t` type that stores the information about data from big box
 * @return `WBOX_SUCCESS_INSERT` or `WBOX_ERR_INSERT` with help description
 */
int wbox_insert_2d(const wbox_md_t *wbmd, const wbox_insert_t wbox_insert, wbox_md_t *wbmd_big);

/**
 * @brief Function that inserts data from smaller 3D box (`wmbd`) into the 3D bigger box(`wmbd_big`) that is anchored in `wbox_insert`.
 * Function checks the anchor placements.
 *
 * @param wbmd [in] - `wbox_md_t` type that stores the information about data from small box
 * @param wbox_insert [in] - `wbox_insert_t` type that stores the information about the anchor point
 * @param wbmd_big [out] - `wbox_md_t` type that stores the information about data from big box
 * @return `WBOX_SUCCESS_INSERT` or `WBOX_ERR_INSERT` with help description
 */
int wbox_insert_3d(const wbox_md_t *wbmd, const wbox_insert_t wbox_insert, wbox_md_t *wbmd_big);

/**
 * @brief Master function that inserts data from smaller box (`wmbd`) into the bigger box(`wmbd_big`) that is anchored in `wbox_insert`.
 * Function checks the anchor placements. First checks the dimension of box and places calls adequate insert function
 *
 * @param wbmd [in] - `wbox_md_t` type that stores the information about data from small box
 * @param wbox_insert [in] - `wbox_insert_t` type that stores the information about the anchor point
 * @param wbmd_big [out] - `wbox_md_t` type that stores the information about data from big box
 * @return `WBOX_SUCCESS_INSERT` or `WBOX_ERR_INSERT` with help description
 */
int wbox_insert(const wbox_md_t *wbmd, const wbox_insert_t wbox_insert, wbox_md_t *wbmd_big);

/**
 * @brief Function that checks the possible errors for inserting a data from small box into big box.
 *
 * @param wbmd [in] - `wbox_md_t` type that stores the information about data from small box
 * @param wbox_insert [in] - `wbox_insert_t` type that stores the information about the anchor point
 * @param wbmd_big [out] - `wbox_md_t` type that stores the information about data from big box
 * @return `WBOX_SUCCESS_INSERT_CHECK` or `WBOX_ERR_INSERT_CHECK` with help description
 */
int wbox_insert_check(const wbox_md_t *wbmd, const wbox_insert_t wbox_insert, wbox_md_t *wbmd_big);

int wbox_merge1d(const wbox_md_t *wbmd_one, const wbox_md_t *wbmd_two, wbox_md_t *wbmd_result);
int wbox_merge2d(const wbox_md_t *wbmd_one, const wbox_md_t *wbmd_two, wbox_md_t *wbmd_result);
int wbox_merge3d(const wbox_md_t *wbmd_one, const wbox_md_t *wbmd_two, wbox_md_t *wbmd_result);
int wbox_merge(const wbox_md_t *wbmd_one, const wbox_md_t *wbmd_two, wbox_md_t *wbmd_result);

int wbox_rotate2d(wbox_md_t *wbmd);
int wbox_rotate3d(wbox_md_t *wbmd);
int wbox_rotate(wbox_md_t *wbmd);