RES dat xx [yy=all zz=all] ¶mglData: mglData(mreal xx, mreal yy=-1, mreal zz=-1) const ¶mglDataC: mglData(mreal xx, mreal yy=-1, mreal zz=-1) const ¶HMDT(HCDT dat, mreal xx, mreal yy, mreal zz) ¶Возвращает в res подмассив массива данных dat с фиксированными значениями индексов с положительными значениями. Например, SubData(-1,2) выделяет третью строку (индексы начинаются с нуля), SubData(4,-1) выделяет 5-ую колонку, SubData(-1,-1,3) выделяет 4-ый срез и т.д. В MGL скриптах обычно используется упрощенная версия dat(xx,yy,zz). Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES dat xdat [ydat zdat] ¶mglData: mglData(const mglDataA &xx, const mglDataA &yy, const mglDataA &zz) const ¶mglDataC: mglData(const mglDataA &xx, const mglDataA &yy, const mglDataA &zz) const ¶HMDT(HCDT dat, HCDT xx, HCDT yy, HCDT zz) ¶Возвращает в res подмассив массива данных dat с индексами, заданными в массивах xx, yy, zz (косвенная адресация). Результат будет иметь размерность массивов с индексами. Размеры массивов xx, yy, zz с индексами должна быть одинакова, либо должны быть "скаляром" (т.е. 1*1*1). В MGL скриптах обычно используется упрощенная версия dat(xx,yy,zz). Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES dat 'eq' ¶mglData: mglData(const char *eq) const ¶mglDataC: mglData(const char *eq) const ¶HMDT(HCDT dat, const char *eq) ¶Возвращает массив данных заполненный по формуле eq, вычисленной для именованных колонок (или срезов). Например, Column("n*w^2/exp(t)");. Имена колонок должны быть предварительно заданы функцией idset или при чтении файлов данных. В MGL скриптах обычно используется упрощенная версия dat('eq'). Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES dat mx [my=1 mz=1] ¶mglData: mglData(int mx, int my=0, int mz=0, mreal x1=0, mreal x2=1, mreal y1=0, mreal y2=1, mreal z1=0, mreal z2=1) const ¶mglDataC: mglData(int mx, int my=0, int mz=0, mreal x1=0, mreal x2=1, mreal y1=0, mreal y2=1, mreal z1=0, mreal z2=1) const ¶HMDT(HCDT dat, int mx, int my, int mz) ¶HMDT(HCDT dat, int mx, int my, int mz, mreal x1, mreal x2, mreal y1, mreal y2, mreal z1, mreal z2) ¶Возвращает массив данных размером mx, my, mz со значениями полученными интерполяцией значений из части [x1,x2] x [y1,y2] x [z1,z2] исходного массива. Величины x,y,z полагаются нормированными в диапазоне [0,1]. Если значение mx, my или mz равно 0, то исходный размер используется. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES dat idat [norm=on] ¶RES dat idat jdat [norm=on] ¶RES dat idat jdat kdat [norm=on] ¶mglData: mglData(const mglDataA &idat, bool norm=true) const ¶mglData: mglData(const mglDataA &idat, const mglDataA &jdat, bool norm=true) const ¶mglData: mglData(const mglDataA &idat, const mglDataA &jdat, const mglDataA &kdat, bool norm=true) const ¶mglDataC: mglData(const mglDataA &idat, bool norm=true) const ¶mglDataC: mglData(const mglDataA &idat, const mglDataA &jdat, bool norm=true) const ¶mglDataC: mglData(const mglDataA &idat, const mglDataA &jdat, const mglDataA &kdat, bool norm=true) const ¶HMDT(HCDT dat, HCDT idat, HCDT jdat, HCDT kdat, int norm) ¶Возвращает массив данных, полученный в результате интерполяции исходного массива в точках других массивов (например, res[i,j]=dat[idat[i,j],jdat[i,j]]). Размеры массивов idat, jdat, kdat должны совпадать. Координаты в idat, jdat, kdat полагаются нормированными в диапазон [0,1] (при norm=true) или в диапазоны [0,nx], [0,ny], [0,nz] соответственно. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES dat ids ['dir'='y' val=nan] ¶RES dat id ['dir'='y' val=nan] ¶mglData: mglData(const mglDataA &ids, const char *dir='y', mreal val=NAN) const ¶mglData: mglData(long id, const char *dir='y', mreal val=NAN) const ¶mglDataC: mglData(const mglDataA &ids, const char *dir='y', mreal val=NAN) const ¶mglDataC: mglData(long id, const char *dir='y', mreal val=NAN) const ¶HMDT(HCDT dat, HCDT ids, const char *dir, mreal val) ¶HMDT(HCDT dat, long id, const char *dir, mreal val) ¶HADT(HCDT dat, HCDT ids, const char *dir, mreal val) ¶HADT(HCDT dat, long id, const char *dir, mreal val) ¶Возвращает массив данных, являющийся id-ой секцией (диапазоном срезов, разделенных значениями val) исходного массива dat. Для id<0 используется обратный порядок (т.e. -1 даст последнюю секцию). Если указано несколько ids, то выходной массив будет результатом последовательного объединения секций.
RES dat val 'dir' [norm=on] ¶RES dat val 'dir' idat [norm=on] ¶mglData: mglData(mreal val, char dir, bool norm=true) const ¶mglData: mglData(mreal val, char dir, const mglDataA &idat, bool norm=true) const ¶HMDT(HCDT dat, mreal val, char dir, HCDT idat, int norm) ¶Возвращает массив индексов (корней) вдоль выбранного направления dir в которых значения массива dat равны val. Выходной массив будет иметь размеры массива dat в направлениях поперечных dir. Если предоставлен массив idat, то его значения используются как стартовые при поиске. Это позволяет найти несколько веток с помощью последовательного вызова функции. Индексы полагаются нормированными в диапазон [0,1] (при norm=true) или в диапазоны [0,nx], [0,ny], [0,nz] соответственно. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов. См. раздел Solve sample, для примеров кода и графика.
RES 'func' ini ['var'='x'] ¶RES 'func' ini ['var'='x'] ¶mglData: mglData(const char *func, char var) const ¶HMDT(const char *func, HCDT ini, char var) ¶mreal(const char *func, mreal ini, char var) ¶Возвращает массив корней уравнения ’func’=0 для переменной var с начальными положениями ini. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES 'funcs' 'vars' ini ¶mglData: mglData(const char *funcs, const char *vars) const ¶mglDataC: mglDataC(const char *funcs, const char *vars) const ¶HMDT(const char *func, const char *vars, HCDT ini) ¶HADT(const char *func, const char *vars, HCDT ini) ¶Возвращает массив корней системы уравнений ’funcs’=0 для переменных vars с начальными значениями ini. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES dat lvl dj [di=0 minlen=0] ¶mglData: mglData(mreal lvl, mreal dj, mreal di=0, mreal minlen=0) const ¶HMDT(HCDT dat, mreal lvl, mreal dj, mreal di, mreal minlen) ¶Возвращает массив кривых {x,y}, разделенных NAN значениями, для локальных максимумов массива dat как функцию координаты x. Шумы амплитудой меньше lvl игнорируются. Параметр dj (в диапазоне [0,ny]) задает область "притяжения" точек в y-направлении к кривой. Аналогично, di продолжает кривые в x-направлении через разрывы длиной менее di точек. Кривые с минимальной длинной менее minlen игнорируются. См. раздел Sample ‘detect’, для примеров кода и графика.
RES dat n v1 v2 [nsub=0] ¶RES dat wdat n v1 v2 [nsub=0] ¶mglData: mglData(int n, mreal v1=0, mreal v2=1, int nsub=0) const ¶mglData: mglData(const mglDataA &w, int n, mreal v1=0, mreal v2=1, int nsub=0) const ¶mglDataC: mglData(int n, mreal v1=0, mreal v2=1, int nsub=0) const ¶mglDataC: mglData(const mglDataA &w, int n, mreal v1=0, mreal v2=1, int nsub=0) const ¶HMDT(HCDT dat, int n, mreal v1, mreal v2, int nsub) ¶HMDT(HCDT dat, HCDT w, int n, mreal v1, mreal v2, int nsub) ¶Возвращает распределение (гистограмму) из n точек от значений массива в диапазоне [v1, v2]. Массив w задает веса элементов (по умолчанию все веса равны 1). Параметр nsub задает число дополнительных точек интерполяции (для сглаживания получившейся гистограммы). Если nsub<0, то используется линейная интерполяция вместо сплайнов. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов. См. также histl, Распределение данных. См. раздел Sample ‘hist’, для примеров кода и графика.
RES dat n v1 v2 ¶RES dat wdat n v1 v2 ¶mglData: mglData(int n, mreal v1=0, mreal v2=1) const ¶mglData: mglData(const mglDataA &w, int n, mreal v1=0, mreal v2=1) const ¶mglDataC: mglData(int n, mreal v1=0, mreal v2=1) const ¶mglDataC: mglData(const mglDataA &w, int n, mreal v1=0, mreal v2=1) const ¶HMDT(HCDT dat, HCDT w, int n, mreal v1, mreal v2) ¶Возвращает распределение (гистограмму) из n точек от значений массива в диапазоне [v1, v2] используя линейную интерполяцию между точками. Массив w задает веса элементов (по умолчанию все веса равны 1). Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов. См. также hist, Распределение данных. См. раздел Sample ‘histl’, для примеров кода и графика.
RES dat 'how' ['dir'='z'] ¶mglData: mglData(char dir, const char *how) const ¶mglDataC: mglData(char dir, const char *how) const ¶HMDT(HCDT dat, char dir, const char *how) ¶Возвращает момент (1d массив) данных вдоль направления dir. Строка how определяет тип момента. Момент определяется как res_k = \sum_ij how(x_i,y_j,z_k) a_ij/ \sum_ij a_ij если dir=‘z’ и т.д. Координаты ‘x’, ‘y’, ‘z’ – индексы массива в диапазоне [0,1]. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES dat 'dir' ¶mglData: mglData(const char *dir) const ¶mglDataC: mglData(const char *dir) const ¶HMDT(HCDT dat, const char *dir) ¶Возвращает результат суммирования данных вдоль направления(ий) dir. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES dat 'dir' ¶mglData: mglData(const char *dir) const ¶mglDataC: mglData(const char *dir) const ¶HMDT(HCDT dat, const char *dir) ¶Возвращает максимальное значение данных вдоль направления(ий) dir. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES dat 'dir' ¶mglData: mglData(const char *dir) const ¶mglDataC: mglData(const char *dir) const ¶HMDT(HCDT dat, const char *dir) ¶Возвращает минимальное значение данных вдоль направления(ий) dir. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES dat ¶mglData: mglData() const ¶HMDT(HCDT dat) ¶Возвращает положение локальных минимумов и максимумов. Функция возвращает NULL или пустой массив если минимумов и максимумов нет.
RES val dat ¶mglData: mglData(mreal val) const ¶HMDT(mreal val, HCDT dat) ¶Возвращает координаты линий уровня для dat[i,j]=val. Кривые разделяются NAN. Функция возвращает NULL или пустой массив если линий уровня нет.
RES adat bdat ¶mglData: mglData(const mglDataA &a) const ¶mglDataC: mglData(const mglDataA &a) const ¶HMDT(HCDT dat, HCDT a) ¶Возвращает прямое произведение массивов (наподобие, res[i,j] = adat[i]*bdat[j] и т.д.). Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES dat ¶mglData: mglData() const ¶mglDataC: mglData() const ¶HMDT(HCDT dat) ¶Возвращает массив диагональных элементов a[i,i] (для 2D данных) или a[i,i,i] (для 3D данных) где i=0...nx-1. В 1D случае возвращается сам массив данных. Размеры массива данных должен быть ny,nz >= nx или ny,nz = 1. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
RES adat bdat 'dir' ¶mglData: mglData(const mglDataA &b, const char *dir) const ¶mglData: mglData(const char *dir) const ¶mglDataC: mglDataC(const mglDataA &b, const char *dir) const ¶mglDataC: mglDataC(const char *dir) const ¶HMDT(HCDT a, HCDT b, const char *dir) ¶HADT(HCDT a, HCDT b, const char *dir) ¶Возвращает корреляцию массивов a (или this в C++) и b вдоль направлений dir. При вычислении используется преобразование Фурье. Поэтому может потребоваться вызов функций swap и/или norm перед построением. Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов.
mglDataC: mglData() const ¶HMDT(HCDT dat) ¶Возвращает массив действительных частей массива данных.
mglDataC: mglData() const ¶HMDT(HCDT dat) ¶Возвращает массив мнимых частей массива данных.
mglDataC: mglData() const ¶HMDT(HCDT dat) ¶Возвращает массив абсолютных значений массива данных.
mglDataC: mglData() const ¶HMDT(HCDT dat) ¶Возвращает массив аргументов массива данных.
RES dat 'dir' ¶mglData: mglData(const char *dir) const ¶HMDT(HCDT dat, const char *dir) ¶Находит параметры импульса вдоль направления dir: максимальное значение (в колонке 0), его положение (в колонке 1), ширина по параболлической аппроксимации (в колонке 3) и по полувысоте (в колонке 2), энергию около максимума (в колонке 4). NAN значения используются для ширин если максимум расположен вблизи границ массива. Отмечу, что для комплексных массивов есть неопределенность определения параметров. Обычно следует использовать квадрат абсолютного значения амплитуды (т.е. |dat[i]|^2). Поэтому MathGL не включает эту функцию в mglDataC, хотя формально C функция будет работать и для них, но будет использовать абсолютное значение амплитуды (т.е. |dat[i]|). Функция возвращает NULL или пустой массив если данные не могут быть созданы при данных значениях аргументов. См. также max, min, momentum, sum. См. раздел Pulse properties, для примеров кода и графика.
RES dat 'dir' val ¶mglData: mglData(const char *dir, mreal val) const ¶mglDataC: mglData(const char *dir, mreal val) const ¶HMDT(HCDT dat, const char *dir, mreal val) ¶Возвращает массив положений ячеек со значениями впервые превысившими val. Для комплексных данных используется абсолютное значение. См. также last.
RES dat 'dir' val ¶mglData: mglData(const char *dir, mreal val) const ¶mglDataC: mglData(const char *dir, mreal val) const ¶HMDT(HCDT dat, const char *dir, mreal val) ¶Возвращает массив положений ячеек со значениями последний раз превысившими val. Для комплексных данных используется абсолютное значение. См. также first.
HMDT(const char *str, long n, ...) ¶HADT(const char *str, long n, ...) ¶Вычисляет формулу str для заданного списка из n массивов данных типа HCDT. Имена переменных соответствуют именам массивов. Возвращенный массив должен быть удален пользователем по окончании использования. См. также fill.