Next: , Previous: , Up: Data processing   [Contents][Index]


7.3 Data resizing

MGL command: new DAT [nx=1 ny=1 nz=1]
Method on mglData: void Create (int mx, int my=1, int mz=1)
Method on mglDataC: void Create (int mx, int my=1, int mz=1)
C function: void mgl_data_create (HMDT dat, int mx, int my, int mz)
C function: void mgl_datac_create (HADT dat, int mx, int my, int mz)

Creates or recreates the array with specified size and fills it by zero. This function does nothing if one of parameters mx, my, mz is zero or negative.

MGL command: rearrange dat mx [my=0 mz=0]
Method on mglData: void Rearrange (int mx, int my=0, int mz=0)
Method on mglDataC: void Rearrange (int mx, int my=0, int mz=0)
C function: void mgl_data_rearrange (HMDT dat, int mx, int my, int mz)
C function: void mgl_datac_rearrange (HADT dat, int mx, int my, int mz)

Rearrange dimensions without changing data array so that resulting sizes should be mx*my*mz < nx*ny*nz. If some of parameter my or mz are zero then it will be selected to optimal fill of data array. For example, if my=0 then it will be change to my=nx*ny*nz/mx and mz=1.

MGL command: transpose dat ['dim'='yxz']
Method on mglData: void Transpose (const char *dim="yx")
Method on mglDataC: void Transpose (const char *dim="yx")
C function: void mgl_data_transpose (HMDT dat, const char *dim)
C function: void mgl_datac_transpose (HADT dat, const char *dim)

Transposes (shift order of) dimensions of the data. New order of dimensions is specified in string dim. This function can be useful also after reading of one-dimensional data.

MGL command: extend dat n1 [n2=0]
Method on mglData: void Extend (int n1, int n2=0)
Method on mglDataC: void Extend (int n1, int n2=0)
C function: void mgl_data_extend (HMDT dat, int n1, int n2)
C function: void mgl_datac_extend (HADT dat, int n1, int n2)

Increase the dimensions of the data by inserting new (|n1|+1)-th slices after (for n1>0) or before (for n1<0) of existed one. It is possible to insert 2 dimensions simultaneously for 1d data by using parameter n2. Data to new slices is copy from existed one. For example, for n1>0 new array will be a_ij^new = a_i^old where j=0...n1. Correspondingly, for n1<0 new array will be a_ij^new = a_j^old where i=0...|n1|.

MGL command: squeeze dat rx [ry=1 rz=1 sm=off]
Method on mglData: void Squeeze (int rx, int ry=1, int rz=1, bool smooth=false)
Method on mglDataC: void Squeeze (int rx, int ry=1, int rz=1, bool smooth=false)
C function: void mgl_data_squeeze (HMDT dat, int rx, int ry, int rz, int smooth)
C function: void mgl_datac_squeeze (HADT dat, int rx, int ry, int rz, int smooth)

Reduces the data size by excluding data elements which indexes are not divisible by rx, ry, rz correspondingly. Parameter smooth set to use smoothing (i.e. out[i]=\sum_{j=i,i+r} a[j]/r) or not (i.e. out[i]=a[j*r]).

MGL command: crop dat n1 n2 'dir'
Method on mglData: void Crop (int n1, int n2, char dir='x')
Method on mglDataC: void Crop (int n1, int n2, char dir='x')
C function: void mgl_data_crop (HMDT dat, int n1, int n2, char dir)
C function: void mgl_datac_crop (HADT dat, int n1, int n2, char dir)

Cuts off edges of the data i<n1 and i>n2 if n2>0 or i>n[xyz]-n2 if n2<=0 along direction dir.

MGL command: crop dat 'how'
Method on mglData: void Crop (const char *how="235x")
Method on mglDataC: void Crop (const char *how="235x")
C function: void mgl_data_crop_opt (HMDT dat, const char *how)
C function: void mgl_datac_crop_opt (HADT dat, const char *how)

Cuts off far edge of the data to be more optimal for fast Fourier transform. The resulting size will be the closest value of 2^n*3^m*5^l to the original one. The string how may contain: ‘x’, ‘y’, ‘z’ for directions, and ‘2’, ‘3’, ‘5’ for using corresponding bases.

MGL command: insert dat 'dir' [pos=off num=0]
Method on mglData: void Insert (char dir, int pos=0, int num=1)
Method on mglDataC: void Insert (char dir, int pos=0, int num=1)
C function: void mgl_data_insert (HMDT dat, char dir, int pos, char num)
C function: void mgl_datac_insert (HADT dat, char dir, int pos, char num)

Insert num slices along dir-direction at position pos and fill it by zeros.

MGL command: delete dat 'dir' [pos=off num=0]
Method on mglData: void Delete (char dir, int pos=0, int num=1)
Method on mglDataC: void Delete (char dir, int pos=0, int num=1)
C function: void mgl_data_delete (HMDT dat, char dir, int pos, char num)
C function: void mgl_datac_delete (HADT dat, char dir, int pos, char num)

Delete num slices along dir-direction at position pos.

MGL command: delete dat
MGL command: delete 'name'

Deletes the whole data array.

MGL command: sort dat idx [idy=-1]
Method on mglData: void Sort (lond idx, long idy=-1)
C function: void mgl_data_sort (HMDT dat, lond idx, long idy)

Sort data rows (or slices in 3D case) by values of specified column idx (or cell {idx,idy} for 3D case). Note, this function is not thread safe!

MGL command: clean dat idx
Method on mglData: void Clean (lond idx)
C function: void mgl_data_clean (HMDT dat, lond idx)

Delete rows which values are equal to next row for given column idx.

MGL command: join dat vdat [v2dat ...]
Method on mglData: void Join (const mglDataA &vdat)
Method on mglDataC: void Join (const mglDataA &vdat)
C function: void mgl_data_join (HMDT dat, HCDT vdat)
C function: void mgl_datac_join (HADT dat, HCDT vdat)

Join data cells from vdat to dat. At this, function increase dat sizes according following: z-size for data arrays arrays with equal x-,y-sizes; or y-size for data arrays with equal x-sizes; or x-size otherwise.


Next: , Previous: , Up: Data processing   [Contents][Index]