6.5 File I/O

Method on mglData: void Read (const char *fname)

Reads data from tab-separated text file with auto determining sizes of the data.

Method on mglData: void Read (const char *fname, int mx, int my=1, int mz=1)

Reads data from text file with specified data sizes. This function does nothing if one of parameters mx, my or mz is zero or negative.

Method on mglData: void ReadMat (const char *fname, int dim=2)

Read data from text file with size specified at beginning of the file by first dim numbers. At this, variable dim set data dimensions.

Method on mglData: void ReadRange (const char *templ, float from, float to, float step=1.f, bool as_slice=false)

Join data arrays from several text files. The file names are determined by function call sprintf(fname,templ,val);, where val changes from from to to with step step. The data load one-by-one in the same slice if as_slice=false or as slice-by-slice if as_slice=true.

Method on mglData: void ReadAll (const char *templ, bool as_slice=false)

Join data arrays from several text files which filenames satisfied the template templ (for example, templ="t_*.dat"). The data load one-by-one in the same slice if as_slice=false or as slice-by-slice if as_slice=true.

Method on mglData: void Save (const char *fname, int ns=-1) const

Saves the whole data array (for ns=-1) or only ns-th slice to text file. If ns>0 then only ns-th slice (or column for 2D array) will be saved.

Method on mglData: void ReadHDF (const char *fname, const char *dname)

Reads data array named dname from HDF file. This function does nothing if NO_HDF5 was defined during library compilation.

Method on mglData: void SaveHDF (const char *fname, const char *dname, bool rewrite=false) const

Saves data array named dname from HDF file. This function does nothing if NO_HDF5 was defined during library compilation.

Method on mglData: void Import (const char *fname, const char *scheme, float v1=0, float v2=1)

Reads data from bitmap file (now support only PNG format). The RGB values of bitmap pixels are transformed to float values in range [v1, v2] using color scheme scheme (see section Color scheme).

Method on mglData: void Export (const char *fname, const char *scheme, float v1=0, float v2=0, int ns=-1) const

Saves data matrix (or ns-th slice for 3d data) to bitmap file (now support only PNG format). The data values are transformed from range [v1, v2] to RGB pixels of bitmap using color scheme scheme (see section Color scheme). If v1>=v2 then the values of v1, v2 are automatically determined as minimal and maximal value of the data array.