8.20 Data filling (Pure C)

C function: void mgl_data_fill (HMDT dat, float x1, float x2, char dir)

Equidistantly fills the data values to range [x1, x2] in direction dir={‘x’,‘y’,‘z’}.

C function: void mgl_data_fill (HMGL gr, HMDT dat, const char *eq, const HMDT *vdat, const HMDT *wdat)

Fills the value of array according to the formula in string eq. Formula is an arbitrary expression depending on variables ‘x’, ‘y’, ‘z’, ‘u’, ‘v’, ‘w’. Coordinates ‘x’, ‘y’, ‘z’ are supposed to be normalized in bounding box of gr (in difference from Modify functions). Variable ‘u’ is the original value of the array. Variables ‘v’ and ‘w’ are values of vdat, wdat which can be NULL (i.e. can be omitted).

C function: void mgl_data_modify (HMDT dat, const char *eq, int dim)

Function fills the value of array according to the formula in string eq. Formula is an arbitrary expression depending on variables ‘x’, ‘y’, ‘z’, ‘u’. Coordinates ‘x’, ‘y’, ‘z’ are data indexes normalized in interval [0,1]. Variable ‘u’ is the original value of the array. Modification will be fulfilled only for slices >=dim.

C function: void mgl_data_modify_vw (HMDT dat, const char *eq, const HMDT v, const HMDT w)

Function fills the value of array according to the formula in string eq. Formula is an arbitrary expression depending on variables ‘x’, ‘y’, ‘z’, ‘u’, ‘v’, ‘w’. Coordinates ‘x’, ‘y’, ‘z’ are data indexes normalized in interval [0,1]. Variable ‘u’ is the original value of the array. Variables ‘v’ and ‘w’ are values of vdat, wdat which can be NULL (i.e. can be ommited).

mglData: void mgl_data_put_val (HMDT a, float val, int i, int j, int k)

Function sets value(s) of array a[i, j, k] = val. Negative indexes i, j, k=-1 set the value val to whole range in corresponding direction(s). For example, mgl_data_put_val(a,val,-1,0,-1); sets a[i,0,j]=val for i=0...(a.nx-1), j=0...(a.nz-1).

mglData: void mgl_data_put_dat (HMDT a, const HMDT v, int i, int j, int k)

Function copies value(s) from array v to the range of array a. Negative indexes i, j, k=-1 set the range in corresponding direction(s). At this minor dimensions of array v should be large than corresponding dimensions of array a. For example, mgl_data_put_dat(a,v,-1,0,-1); sets a[i,0,j]=v.ny>nz ? v[i,j] : v[i], where i=0...(a.nx-1), j=0...(a.nz-1) and condition v.nx>=a.nx is true.

C function: void mgl_data_set_value (HMDT dat, float v, int i, int j, int k)

Sets the value in specified cell of the data with border checking.

C function: float mgl_data_get_value (HMDT dat, int i, int j, int k)

Gets the value in specified cell of the data with border checking.

C function: float mgl_data_get_nx (HMDT dat)

Gets the x-size of the data.

C function: float mgl_data_get_ny (HMDT dat)

Gets the y-size of the data.

C function: float mgl_data_get_nz (HMDT dat)

Gets the z-size of the data.