UploadModelId

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску

Запрос управляющей системе на загрузку модели со стороны веб-сервера (пользователя).

Входные параметры запроса[1][2]


Имя поля Размер, байт Смысл
Имя модели
model_name_size 4 Размер имени модели в байтах
model_name model_name_size Имя модели в UTF-8.


Запакованные параметры пространства.
metric_id 4 Беззнаковое целое, задающее единицу измерения длины. Может принимать одно из следующих значений.
Символическое имя Целочисленное значение Единица измерения
CHU_MILLIMETERS 0 Миллиметры. Не поддерживается.
CHU_METERS 1 Метры. Единственная поддерживаемая единица.
CHU_KILOMETERS 2 Километры. Не поддерживается.
CHU_INVALID_METRIC 3 Служебный идентификатор для обозначения минимальной границы неверных идентификаторов метрик. Не поддерживается.
Запакованный размер.
dimensions 4 Беззнаковое целое, которое задает число измерений, в которых определен размер.
размеры 8 dimensions Последовательно заданные размеры во всех dimensions измерениях. Размеры в измерениях dimensions полагаются бесконечными.
Серия параметров предметной области пространства[3].
domain_size 4 Беззнаковое целое, задающее количество экземпляров подсистемы предметной области, для которых заданы данные.
domain_name_size 4 Беззнаковое целое, задающее байтовую длину идентификатора экземпляра подсистемы предметной области, для которой заданы данные.
domain_name domain_name_size Строковой идентификатор экземпляра подсистемы предметной области.
domain_data_size 4 Байтовый размер данных предметной области для экземпляра domain_name подсистемы предметной области.
domain_params domain_data_size Параметры предметной области для экземпляра domain_name подсистемы предметной области. Отсутствуют при domain_name_size = domain_data_size = 0.
...
Элементы геометрической модели
object_count 4 Число всех объектов модели
Последовательность object_count запакованных объектов, каждый из которых, представлен ниже
Общие параметры для всех классов объектов
object_name_size 4 Беззнаковое целое число байт в имени объекта модели. [4]
object_name object_name_size UTF-8 строка с именем объекта модели. [4]
Серия параметров предметной области объекта[5].
domain_size 4 Беззнаковое целое, задающее количество экземпляров подсистемы предметной области, для которых заданы данные.
domain_name_size 4 Беззнаковое целое, задающее байтовую длину идентификатора экземпляра подсистемы предметной области, для которой заданы данные.
domain_name domain_name_size Строковой идентификатор экземпляра подсистемы предметной области.
domain_data_size 4 Байтовый размер данных предметной области для экземпляра domain_name подсистемы предметной области.
domain_params domain_data_size Параметры предметной области для экземпляра domain_name подсистемы предметной области. Отсутствуют при domain_name_size = domain_data_size = 0.
...
typeid 4 Беззнаковый целочисленный идентификатор класса создаваемого объекта.
Символическое имя Значение Описание
ObjectPoly 0 Идентификатор полигонального объекта.
ObjectSource 1 Идентификатор источника.
ObjectPlain 2 Идентификатор плоскости вывода результатов.


Для полигонального объекта
faces_count 4 Число полигонов, составляющих создаваемый объект.
Полигон 1
vertex_count 4 Беззнаковое целое число вершин, составляющих полигон.
Вершина 1
dimensions 4 Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки.
координаты 8 dimensions Последовательно заданные координаты точки.
...
Вершина vertex_count.
dimensions 4 Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки.
координаты 8 dimensions Последовательно заданные координаты точки.
Серия параметров предметной области полигона[6]
domain_size 4 Беззнаковое целое, задающее количество экземпляров подсистемы предметной области, для которых заданы данные.
domain_name_size 4 Беззнаковое целое, задающее байтовую длину идентификатора экземпляра подсистемы предметной области, для которой заданы данные.
domain_name domain_name_size Строковой идентификатор экземпляра подсистемы предметной области.
domain_data_size 4 Байтовый размер данных предметной области для экземпляра domain_name подсистемы предметной области.
domain_params domain_data_size Параметры предметной области для экземпляра domain_name подсистемы предметной области. Отсутствуют при domain_name_size = domain_data_size = 0.
...
...
Полигон faces_count
vertex_count 4 Беззнаковое целое число вершин, составляющих полигон.
Вершина 1
dimensions 4 Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки.
координаты 8 dimensions Последовательно заданные координаты точки.
...
Вершина vertex_count.
dimensions 4 Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки.
координаты 8 dimensions Последовательно заданные координаты точки.
Серия параметров предметной области полигона[6]
domain_size 4 Беззнаковое целое, задающее количество экземпляров подсистемы предметной области, для которых заданы данные.
domain_name_size 4 Беззнаковое целое, задающее байтовую длину идентификатора экземпляра подсистемы предметной области, для которой заданы данные.
domain_name domain_name_size Строковой идентификатор экземпляра подсистемы предметной области.
domain_data_size 4 Байтовый размер данных предметной области для экземпляра domain_name подсистемы предметной области.
domain_params domain_data_size Параметры предметной области для экземпляра domain_name подсистемы предметной области. Отсутствуют при domain_name_size = domain_data_size = 0.
...
Для объекта-источника
Позиция источника поля
dimensions 4 Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки.
координаты 8 dimensions Последовательно заданные координаты точки.
Ненулевые некомпланарные вектора направлений для каждого из измерений
число_векторов 4 Количество векторов, значение должно быть не меньше количества измерений, в которых определены вектора источника, минус один.
Вектора направлений источника поля
dimensions 4 Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки.
координаты 8 dimensions Последовательно заданные координаты точки.
...
Для секущей плоскости вывода результатов
Позиция точки на плоскости
dimensions 4 Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки.
координаты 8 dimensions Последовательно заданные координаты точки.
Направляющие вектора плоскости
число_векторов 4 Число векторов, задающих положение плоскости.
dimensions 4 Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки.
координаты 8 dimensions Последовательно заданные координаты точки.
...

Выходные параметры запроса[7]

В случае успешного вызова функции ControlSystemEntryPoint ответом является имя загруженной модели на сервере.

Другие запросы


Символическое имя Целочисленное значение Действие
CreateModelId 0 создание новой модели
CreateObjectId 1 создание нового элемента модели
UploadModelId 2 загрузка модели со стороны пользователя.
StartSimulationId 3 запуск физического моделирования в предметной области
GetProcessStatusId 4 получение сведений о состоянии процесса моделирования
GetSimulationResultsId 5 получение результатов моделирования
StopSimulationId 6 досрочная остановка процесса моделирования (не реализовано)
CloseSimulationId 7 закрытие моделирования и освобождение соответствующих ресурсов на сервере; если запущен процесс моделирования, то его остановка.

Примечения

  1. Содержимое буфера pPackedInputParams при вызове функции ControlSystemEntryPoint.
  2. Имена модели и ее элементов опциональны. В случае их отутствия, когда соответствующий байтовый размер равен нулю, назначается имя по умолчанию - сгенерированный UUID в строковом представлении.
  3. В предметной области "Архитектурная акустика" параметры доменной области пространства - число с плавающей точкой двойной точности (8 байт), задающее коэффициент линейного затухания звукового сигнала. Поэтому для архитектурной акустики domain_size должен быть равен 8, а domain_params должен содержать бинарного представления коэффициента затухания. В предметной области "Интеграл" параметры доменной области - пара пределов интегрирования (сначала - меньший, затем - больший), каждый из которых является 8-байтовым числом с плавающей точкой.
  4. 4,0 4,1 При создании модели имя объекта не должно задаваться пользователем, т.е. object_name_size должно быть равно 0, а данные поля object_name не должны включаться в параметры запроса на создание объекта.
  5. Запакованные параметры предметной области объектов-элементов модели среды моделируемого физического поля.
    Для предметной области "Архитектурная акустика".
    • Для полигонального объекта общие предметные параметры полигонального объекта не задаются. Вместо этого задаются параметры каждой отдельной поверхности (полигона), составляющей полигональный объект. Данные представлены в описании класса CFace.
    • Для источника поля общие параметры предметной области, связанные с объектом, представлены в описании класса CPrimarySource.
    • Для плоскости вывода результатов параметры предметной области не задаются.
    Для предметной области "Интеграл".
    • Параметры предметной области, связанные с объектом любого класса, а также параметры, связанные с поверхностями полигонального объекта, не задаются.
  6. 6,0 6,1 Запакованные параметры предметной области объектов-элементов модели среды моделируемого физического поля.
    Для предметной области "Архитектурная акустика".
    • Для полигонального объекта общие предметные параметры полигонального объекта не задаются. Вместо этого задаются параметры каждой отдельной поверхности (полигона), составляющей полигональный объект. Данные представлены в описании класса CFace.
    • Для источника поля общие параметры предметной области, связанные с объектом, представлены в описании класса CPrimarySource.
    • Для плоскости вывода результатов параметры предметной области не задаются.
    Для предметной области "Интеграл".
    • Параметры предметной области, связанные с объектом любого класса, а также параметры, связанные с поверхностями полигонального объекта, не задаются.
  7. Содержимое буфера pPackedOutputParams, возвращаемого управляющей подсистемой.