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


7.9 Информационные функции

В MathGL есть ряд функций для получения свойств массива данных. В MGL скриптах большинство из них реализовано в виде "суффиксов". Суффиксы дают числовое значение некоторой характеристики массива данных. Например, его размер, минимальное и максимальное значение, сумму элементов и т.д. Суффиксы начинаются с точки ‘.’ сразу после массива (без пробелов). Например, a.nx даст размер массива a вдоль x, b(1).max даст максимальное значение второй колонки массива b, (c(:,0)^2).sum даст сумму квадратов в первой строке массива c и т.д.

Команда MGL: info dat
Метод класса mglDataA: const char * PrintInfo () const
Метод класса mglDataA: void PrintInfo (FILE *fp) const
Функция С: const char * mgl_data_info (HCDT dat)
Fortran процедура: mgl_data_info (long dat, char *out, int len)

Возвращает строку с информацией о данных (размеры, моменты и пр.) или пишет её в файл. В MGL скрипте печатает её как сообщение.

Команда MGL: info 'txt'

Печатает строку txt как сообщение.

Команда MGL: info val

Печатает значение числа val как сообщение.

Команда MGL: print dat
Команда MGL: print 'txt'
Команда MGL: print val

Аналогично info, но сразу выводит в stdout.

Команда MGL: echo dat

Печатает все значения массива dat как сообщение.

MGL suffix: (dat) .nx
MGL suffix: (dat) .ny
MGL suffix: (dat) .nz
Метод класса mglDataA: long GetNx ()
Метод класса mglDataA: long GetNy ()
Метод класса mglDataA: long GetNz ()
Функция С: long mgl_data_get_nx (HCDT dat)
Функция С: long mgl_data_get_ny (HCDT dat)
Функция С: long mgl_data_get_nz (HCDT dat)

Возвращает размер данных в направлении x, y и z соответственно.

MGL suffix: (dat) .max
Метод класса mglDataA: mreal Maximal () const
Функция С: mreal mgl_data_max (HCDT dat)

Возвращает максимальное значение массива данных.

MGL suffix: (dat) .min
Метод класса mglDataA: mreal Minimal () const
Функция С: mreal mgl_data_min (HMDT dat) const

Возвращает минимальное значение массива данных.

Метод класса mglDataA: mreal Minimal (int &i, int &j, int &k) const
Функция С: mreal mgl_data_min_int (HCDT dat, int *i, int *j, int *k)

Возвращает максимальное значение массива данных и сохраняет его положение в переменные i, j, k.

Метод класса mglDataA: mreal Maximal (int &i, int &j, int &k) const
Функция С: mreal mgl_data_max_int (HCDT dat, int *i, int *j, int *k)

Возвращает минимальное значение массива данных и сохраняет его положение в переменные i, j, k.

Метод класса mglDataA: mreal Minimal (mreal &x, mreal &y, mreal &z) const
Функция С: mreal mgl_data_min_real (HCDT dat, mreal *x, mreal *y, mreal *z)

Возвращает максимальное значение массива данных и его приближенное (интерполированное) положение в переменные x, y, z.

MGL suffix: (dat) .mx
MGL suffix: (dat) .my
MGL suffix: (dat) .mz
Метод класса mglDataA: mreal Maximal (mreal &x, mreal &y, mreal &z) const
Функция С: mreal mgl_data_max_real (HCDT dat, mreal *x, mreal *y, mreal *z)

Возвращает минимальное значение массива данных и его приближенное (интерполированное) положение в переменные x, y, z.

MGL suffix: (dat) .mxf
MGL suffix: (dat) .myf
MGL suffix: (dat) .mzf
MGL suffix: (dat) .mxl
MGL suffix: (dat) .myl
MGL suffix: (dat) .mzl
Метод класса mglDataA: long Maximal (char dir, long from) const
Метод класса mglDataA: long Maximal (char dir, long from, long &p1, long &p2) const
Функция С: mreal mgl_data_max_firstl (HCDT dat, char dir, long from, long *p1, long *p2)

Возвращает положение первого (последнего при from<0) максимума в направлении dir, начиная с позиции from. Положение остальных координат для максимума сохраняется в p1, p2.

MGL suffix: (dat) .sum
MGL suffix: (dat) .ax
MGL suffix: (dat) .ay
MGL suffix: (dat) .az
MGL suffix: (dat) .aa
MGL suffix: (dat) .wx
MGL suffix: (dat) .wy
MGL suffix: (dat) .wz
MGL suffix: (dat) .wa
MGL suffix: (dat) .sx
MGL suffix: (dat) .sy
MGL suffix: (dat) .sz
MGL suffix: (dat) .sa
MGL suffix: (dat) .kx
MGL suffix: (dat) .ky
MGL suffix: (dat) .kz
MGL suffix: (dat) .ka
Метод класса mglDataA: mreal Momentum (char dir, mreal &a, mreal &w) const
Метод класса mglDataA: mreal Momentum (char dir, mreal &m, mreal &w, mreal &s, mreal &k) const
Функция С: mreal mgl_data_momentum_val (HCDT dat, char dir, mreal *a, mreal *w, mreal *s, mreal *k)

Возвращает нулевой момент (энергию, I=\sum a_i) и записывает первый (среднее, m = \sum \xi_i a_i/I), второй (ширину, w^2 = \sum (\xi_i-m)^2 a_i/I), третий (асимметрия, s = \sum (\xi_i-m)^3 a_i/ I w^3) и четвёртый моменты (эксцесс, k = \sum (\xi_i-m)^4 a_i / 3 I w^4)). Здесь \xi – соответствующая координата если dir равно ‘'x'’, ‘'y'’, ‘'z'’. В противном случае среднее, ширина, асимметрия, эксцесс равны m = \sum a_i/N, w^2 = \sum (a_i-m)^2/N и т.д.

MGL suffix: (dat) .fst
Метод класса mglDataA: mreal Find (const char *cond, int &i, int &j, int &k) const
Функция С: mreal mgl_data_first (HCDT dat, const char *cond, int *i, int *j, int *k)

Находит положение (после заданного в i, j, k) первого не нулевого значения формулы cond. Функция возвращает найденное значение и записывает его положение в i, j, k.

MGL suffix: (dat) .lst
Метод класса mglDataA: mreal Last (const char *cond, int &i, int &j, int &k) const
Функция С: mreal mgl_data_last (HCDT dat, const char *cond, int *i, int *j, int *k)

Находит положение (перед заданного в i, j, k) последнего не нулевого значения формулы cond. Функция возвращает найденное значение и записывает его положение в i, j, k.

Метод класса mglDataA: int Find (const char *cond, char dir, int i=0, int j=0, int k=0) const
Функция С: mreal mgl_data_find (HCDT dat, const char *cond, int i, int j, int k)

Возвращает положение первого в направлении dir не нулевого значения формулы cond. Поиск начинается с точки {i,j,k}.

Метод класса mglDataA: bool FindAny (const char *cond) const
Функция С: mreal mgl_data_find_any (HCDT dat, const char *cond)

Определяет есть ли хоть одно значение массива, удовлетворяющее условию cond.

MGL suffix: (dat) .a

Возвращает первое число массива (для .a это dat->a[0]).





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