Создать ресурсы слоя сцены интегрированной модели mesh (Управление данными)

Краткая информация

Создает ресурсы слоя сцены (.slpk или .i3sREST) по бинарным данным OpenSceneGraph (OSGB).

Использование

  • Так же как и с другими графическими 3D форматами, данные OSGB исходно не поддерживает задание или захват системы координат модели. Обычно файлы формата OSGB используют декартову систему координат, которая размещает данные в фиксированных координатах. Координаты X, Y и Z модели не являются географическими точками. Они представляют собой положения относительно произвольной геометрической начальной точки (0,0,0). Одна из типичных систем координат, используемых в таких моделях - это Easting-Northing-UP (ENU), где ось x может рассматриваться как направление на восток, ось y - на север, а ось z - вверх. Для правильной пространственной привязки модели требуются дополнительные метаданные .xml, .3mx или файл привязки (.wld3), которые могут быть размещены рядом с папкой, содержащей файлы OSGB, или заданы через параметр Точка якоря.

  • Если не существует файла привязки модели, можно создать файл .wld3 для указания исходной привязки. Этот разделенный пробелами или запятыми файл может быть отформатирован в десятичных градусах как <From x,y,z> <space> <To x,y,z>.

    Пример файла привязки для пространственной привязки модели. Только одна координатная пара должна содержать координаты точки якоря.

    0, 0, 0 -117.17222, 34.0392512, 0
  • Если файлы формата OSGB были созданы с известной системой координат, файл проекции (.prj) должен быть помещен рядом с папкой, содержащей файлы формата OSGB, чтобы правильно привязать модель. Например, если путь к входному файлу C:\temp\data и файлы формата OSGB находятся во вложенных папках C:\temp\data\Tile_001 и C:\temp\data\Tile_002, файл проекции или файл метаданных должны быть помещены в папку C:\temp\data.

  • В следующей таблице перечислены файлы пространственной привязки, используемые для каждой входной системы координат модели OSGB:

    Входная система координатФайл пространственной привязки

    Местная система координат (ENU)

    .xml, .wld3, или файл .3mx, или класс точечных объектов

    Система координат проекции

    Файл проекции (.prj)

    Географическая система координат

    Файл проекции (.prj)

  • Используйте параметр Максимальный размер текстуры для установления размера текстур на узел в выходном пакете слоев сцены. Размеры текстур свыше 4096 могут не поддерживаться на всех платформах. Scene Viewer поддерживает максимальный размер текстур 8192.

  • Файлы формата OSGB создаются Drone2Map и сторонними поставщиками. Полный список этих поставщиков см. в разделе Слой сцены интегрированной модели Mesh.

  • Используйте параметр Целевое облачное подключение, чтобы выходной ресурс слоя сцены был в хранилище объектов, расположенном в облаке, например, в Amazon S3, хранилище BLOB-объектов Azure, Alibaba OSS или Google Cloud. Этот ресурс можно опубликовать как сервис сцены, а выбранное вами местоположение должно быть зарегистрировано как управляемое пользователем хранилище данных в ArcGIS Enterprise.

  • Вы можете создать файл подключения (.acs), используя инструмент Создать файл подключения к облачному хранилищу.

Параметры

ПодписьОписаниеТип данных
Входной набор данных

Файлы формата OSGB или папки, содержащие файлы формата OSGB, которые будут импортированы в пакет слоя сцены интегрированной mesh. Этот параметр позволяет выбрать несколько файлов формата OSGB или несколько папок, содержащих файлы формата OSGB.

File; Folder
Выходной пакет слоя сцены
(Дополнительный)

Создаваемый пакет слоя сцены интегрированной mesh. Этот параметр необходим, если не задано значение параметра Целевое облачное подключение.

File
Точка якоря
(Дополнительный)

Точечный объект или .3mx, .xml, или файл .wld3, который будет использоваться как положение центра модели OSGB. Если в классе объектов есть несколько точек, только первая из них будет использоваться для геопривязки данных.

Feature Layer; File
Суффикс файла
(Дополнительный)

Задает обрабатываемые файлы входного набора данных.

  • Все поддерживаемые файлыВсе бинарные файлы, независимо от расширения, будут проверяться на соответствие формату OSGB.
  • Файлы с расширением *.osgbОбрабатываются только файлы с расширением .osgb.
String
Выходная система координат
(Дополнительный)

Система координат выходного пакета слоя сцены. Это может быть любая пользовательская или система координат проекции. Поддерживаются географические системы координат WGS84 и China Geodetic Coordinate System 2000. WGS 1984 и EGM96 Geoid являются горизонтальной и вертикальной системами координат по умолчанию соответственно. Систему координат можно задать следующими способами:

  • Укажите путь к файлу .prj.
  • Установите привязку набора данных к корректной системой координат.
  • Используйте объект arcpy.SpatialReference.

Spatial Reference
Максимальный размер текстур
(Дополнительный)

Максимальный размер текстуры в пикселах для каждого узла слоя сцены.

Long
Оптимизация текстуры
(Дополнительный)

Указывает текстуры, которые оптимизируются в соответствии с целевой платформой, где используется пакет слоев сцены.

Внимание:

Оптимизации, включающие KTX2, могут занимать много времени. Для более быстрого получения результатов используйте опции Desktop или Нет.

  • ВсеВсе форматы текстур будут оптимизированы, включая JPEG, DXT и KTX2, для использования на настольных, веб-и мобильных платформах.
  • Настольные компьютерыТекстуры, поддерживаемые Windows, Linux и Mac, будут оптимизированы, включая JPEG и DXT для использования в клиентах ArcGIS AllSource на Windows и в настольных клиентах ArcGIS Maps SDKs на Windows, Linux и Mac. Это значение по умолчанию
  • МобильныеТекстуры, поддерживаемые Android и iOS, будут оптимизированы, включая JPEG и KTX2, для использования в мобильных приложениях Maps SDKs.
  • НетТекстуры JPEG будут оптимизированы для использования в настольных и веб-платформах.
String
Целевое облачное подключение
(Дополнительный)

Целевой файл облачного подключения (.acs), куда сохраняются ресурсы слоя сцены (.i3sREST).

Folder
Выходное имя
(Дополнительный)

Выходное имя ресурса слоя сцена при выгрузке в облачное хранилище. Этот параметр доступен только в случаях, если задано значение параметра Целевое облачное подключение.

String

arcpy.management.CreateIntegratedMeshSceneLayerPackage(in_dataset, {out_slpk}, {anchor_point}, {file_suffix}, {out_coor_system}, {max_texture_size}, {texture_optimization}, {target_cloud_connection}, {out_name})
ИмяОписаниеТип данных
in_dataset
[in_dataset,...]

Файлы формата OSGB или папки, содержащие файлы формата OSGB, которые будут импортированы в пакет слоя сцены интегрированной mesh. Этот параметр позволяет выбрать несколько файлов формата OSGB или несколько папок, содержащих файлы формата OSGB.

File; Folder
out_slpk
(Дополнительный)

Создаваемый пакет слоя сцены интегрированной mesh. Этот параметр необходим, если не задано значение параметра Целевое облачное подключение.

File
anchor_point
(Дополнительный)

Точечный объект или .3mx, .xml, или файл .wld3, который будет использоваться как положение центра модели OSGB. Если в классе объектов есть несколько точек, только первая из них будет использоваться для геопривязки данных.

Feature Layer; File
file_suffix
(Дополнительный)

Задает обрабатываемые файлы входного набора данных.

  • *Все бинарные файлы, независимо от расширения, будут проверяться на соответствие формату OSGB.
  • osgbОбрабатываются только файлы с расширением .osgb.
String
out_coor_system
(Дополнительный)

Система координат выходного пакета слоя сцены. Это может быть любая пользовательская или система координат проекции. Поддерживаются географические системы координат WGS84 и China Geodetic Coordinate System 2000. WGS 1984 и EGM96 Geoid являются горизонтальной и вертикальной системами координат по умолчанию соответственно. Систему координат можно задать следующими способами:

  • Укажите путь к файлу .prj.
  • Установите привязку набора данных к корректной системой координат.
  • Используйте объект arcpy.SpatialReference.

Spatial Reference
max_texture_size
(Дополнительный)

Максимальный размер текстуры в пикселах для каждого узла слоя сцены.

Long
texture_optimization
(Дополнительный)

Указывает текстуры, которые оптимизируются в соответствии с целевой платформой, где используется пакет слоев сцены.

Внимание:

Оптимизации, включающие KTX2, могут занимать много времени. Для более быстрого получения результатов используйте опции Desktop или None.

  • AllВсе форматы текстур будут оптимизированы, включая JPEG, DXT и KTX2, для использования на настольных, веб-и мобильных платформах.
  • DesktopТекстуры, поддерживаемые Windows, Linux и Mac, будут оптимизированы, включая JPEG и DXT для использования в клиентах ArcGIS AllSource на Windows и в настольных клиентах ArcGIS Maps SDKs на Windows, Linux и Mac. Это значение по умолчанию
  • MobileТекстуры, поддерживаемые Android и iOS, будут оптимизированы, включая JPEG и KTX2, для использования в мобильных приложениях Maps SDKs.
  • NoneТекстуры JPEG будут оптимизированы для использования в настольных и веб-платформах.
String
target_cloud_connection
(Дополнительный)

Целевой файл облачного подключения (.acs), куда сохраняются ресурсы слоя сцены (.i3sREST).

Folder
out_name
(Дополнительный)

Выходное имя ресурса слоя сцена при выгрузке в облачное хранилище. Этот параметр доступен только в том случае, если задано значение параметра target_cloud_connection.

String

Пример кода

CreateIntegratedMeshSceneLayerPackage, пример 1 (окно Python)

В следующем примере показано использование этого инструмента в окне Python.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.managementCreateIntegratedMeshSceneLayerPackage(
    "terrain_osgb", "mesh.slpk", "anchor.wld3", "OSGB", arcpy.SpatialReference(4326))
CreateIntegratedMeshSceneLayerPackage, пример 2(окно Python)

В следующем примере показано использование этого инструмента в окне Python с входными данными из нескольких папок.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.managementCreateIntegratedMeshSceneLayerPackage(
    ["Tile_+001_+001", "Tile_+001_+002", "Tile_+002_+001"], "mesh.slpk", 
    "anchor.shp", "OSGB", arcpy.SpatialReference(4326), 2048, "DESKTOP")
CreateIntegratedMeshSceneLayerPackage, пример 3 (окно Python)

В следующем примере показано использование этого инструмента в окне Python с выходными данными в облачном хранилище.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.managementCreateIntegratedMeshSceneLayerPackage(
    ["Tile_+001_+001", "Tile_+001_+002", "Tile_+002_+001"], "mesh.slpk", 
    "anchor.shp", "OSGB", arcpy.SpatialReference(4326), 2048, "DESKTOP",
    'AWS.acs', 'mySceneLayer.i3srest')