6.5 File I/O

Method on mglData (C++, Python): void Read (const char *fname)

C function: void mgl_data_read (HMDT dat, const char *fname)

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

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

C function: void mgl_data_read_dim (HMDT dat, const char *fname, int mx, int my, int mz)

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 (C++, Python): void ReadMat (const char *fname, int dim=2)

C function: void mgl_data_read_mat (HMDT dat, const char *fname, int dim)

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 (C++, Python): 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 (C++, Python): 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 (C++, Python): void Save (const char *fname, int ns=-1) const

C function: void mgl_data_save (const HMDT dat, const char *fname, int ns)

Saves the whole data array (for ns=-1) or only ns-th slice to text file.

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

Reads data array named dname from HDF5 or HDF4 file. This function does nothing if NO_HDF5|NO_HDF4 was defined during library compilation.

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

Saves data array named dname from HDF5 or HDF4 file. This function does nothing if NO_HDF5|NO_HDF4 was defined during library compilation.

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

C function: void mgl_data_import (HMDT dat, const char *fname, const char *scheme, float v1, float v2)

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 (C++, Python): void Export (const char *fname, const char *scheme, float v1=0, float v2=0, int ns=-1) const

C function: void mgl_data_export (HMDT dat, const char *fname, const char *scheme, float v1, float v2, int ns) 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.