Создать ресурсы слоя сцены интегрированной модели 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 могут не поддерживаться на всех платформах. Просмотрщик сцены поддерживает максимальный размер текстуры 8192.
Файлы формата OSGB создаются Drone2Map и сторонними поставщиками. Полный список этих поставщиков см. в разделе Слой сцены интегрированной модели Mesh.
Используйте параметр Целевое облачное подключение, чтобы выходной ресурс слоя сцены был в хранилище объектов, расположенном в облаке, например, в Amazon S3, Azure Blob storage, 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 and DXT, для использования в клиентах ArcGIS Pro в 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 and DXT, для использования в клиентах ArcGIS Pro в 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')

Параметры среды

Текущая рабочая область, Временная рабочая область

Информация о лицензировании

Basic: Да
Standard: Да
Advanced: Да