Введение в ActiveField
Обзор объектов
Диаграмма иерархии
С чего начать
Работа с задачами
Работа с моделью
Работа с данными
Анализ результатов

GetValuesArray Method

Краткое описание

Возвращает двумерный массив полевых характеристик вдоль контура. Каждая строка массива соответсвует пересечению контура с конечным элементом, а количество и состав столбцов задается свойством ColumnsArray.

Синтаксис

Contour.GetValuesArray (
   colums As Unknown
) As Unknown

Параметры

colums
[in, optional] Unknown

Замечания

Задачей метода GetValuesArray является проход по всему контуру с запоминанием значений поля во всех точках пересечения контура с конечными элементами. Поскольку количество полевых величин в точке относительно велико, при вызове метода ему передается параметр - массив, содержащий список координатных и полевых величин, вычисляемых в каждой точке.

Другая особенность состоит в том, что контур может иметь разрывы, проходя через области, в которых расчет поля не производится. Чтобы пользователь метода смог отличить разрывы, на каждом пересечении контура с треугольным конечным элементом формируется отрезок (пара точек - начальная и конечная). Поэтому, когда контур пересекает сплошной массив треугольников, почти каждая точка возвращается дважды: один раз в качестве начальной, другой раз - в качестве конечной.

Метод GetValuesArray имеет входной параметр columns, представляющий собой массив констант из перечисления QfQuantity. Количество и состав элементов массива columns определяют состав столбцов таблицы, которую вернет метод GetValuesArray по завершению работы. В качестве элементов входного массива разрешается использовать константы, соответствующие локальным значениям поля, разрешенным для данного типа задач.

Возвращаемое значение представляет собой трехмерный массив чисел типа: Result [i] [j] [k] as Double

При этом первый индекс i обозначает номер отрезка и пробегает все значения от 1 до полного количества треугольников, пересеченных контуром;
Второй индекс j обозначает порядковый номер полевой характеристики в соответствии со входным массивом columns. Он пробегает значения от 1 до числа элементов в массиве columns;
Третий индекс принимает значения 1 или 2 в зависимости от того, относится он к начальной (1) или конечной (2) точке отрезка.