Краткая информация
Импортирует одну или несколько 3D-моделей в класс пространственных объектов-мультипатчей.
Использование
Сохраните текстуру 3D моделей, сохранив выходной мультипатч в базе геоданных. Шейп-файлы не поддерживают сохранение текстур.
Если верхняя сторона итоговых объектов-мультипатчей повернута вбок, попробуйте еще раз настроить ориентацию с помощью этого инструмента, включив параметр Y_Is_Up (Ось Y направлена вверх).
GeoVRML является единственным форматом с определенной системой координат. Многие 3D-модели создаются с помощью локальной системы координат с центром координат в точке 0, 0, 0. Для таких объектов можно выполнить геопривязку к реальным координатам одним из приведенных ниже способов:
- Если 3D модели необходимо повернуть и сдвинуть, рассмотрите возможность использования одного из методов векторной трансформации, чтобы правильно расположить объекты. Более подробно о векторной трансформации
- Если 3D модели ориентированы в данной системе координат правильно, и их необходимо только сдвинуть, рассмотрите возможность настройки свойств Системы координат, чтобы получить необходимый сдвиг. Если есть точечные объекты, которые задают положение центроида каждой модели в координатах реального мира, используйте эти точки в качестве входных данных инструмента для геопривязки моделей.
Элементы точечной и линейной геометрии, которые могут существовать в файле 3D, не сохраняются в выходном классе пространственных объектов мультипатчей (мультипатчи не поддерживают такие элементы).
Синтаксис
Import3DFiles_3d (in_files, out_featureClass, {root_per_feature}, {spatial_reference}, {y_is_up}, file_suffix, {in_featureClass}, {symbol_field})
Параметр | Объяснение | Тип данных |
in_files [in_files,...] | Одна или несколько моделей 3D или папок, содержащих такие файлы в поддерживаемых форматах, включая 3D Studio Max (*.3ds), SketchUp (*.skp), VRML и GeoVRML (*.wrl), OpenFlight (*.flt) и COLLADA (*.dae). | File; Folder |
out_featureClass | Мультипатч, который будет создан на основе входных файлов. | Feature Class |
root_per_feature (Дополнительный) | Определяет, требуется ли создавать один объект для каждого файла, либо один объект для каждого корневого узла в файле. Данная опция применяется только к моделям VRML.
| Boolean |
spatial_reference (Дополнительный) | Система координат входных данных. Для большинства форматов это неизвестная система координат. Только формат GeoVRML хранит свою систему координат, по умолчанию она будет получена из первого файла в списке, если не указана пространственная привязка. | Spatial Reference |
y_is_up (Дополнительный) | Определяет ось, которая задает вертикальную ориентацию входных файлов.
| Boolean |
file_suffix | Разрешение файлов, импортируемых из входной папки. Этот параметр также необходим, если хотя бы одна папка указана в качестве входных данных.
| String |
in_featureClass (Дополнительный) | Точечные объекты, чьи координаты определяют реальное положение входных файлов. Каждый входной файл будет соответствовать своей точке на основании имен файлов, хранящихся в Поле символов. Параметр Система координат должен быть задан, чтобы совпадать с пространственной привязкой точек. | Feature Layer |
symbol_field (Дополнительный) | Поле в точечных объектах, содержащее имя файла 3D, связанного с каждой точкой. | Field |
Пример кода
Import3DFiles, пример 1 (окно Python)
В следующем примере показано использование этого инструмента в окне Python.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.Import3DFiles_3d("AddisSheraton.skp", "Test.gdb/AddisSheraton", False, "", False)
Import3DFiles, пример 2 (автономный скрипт)
В следующем примере показано использование этого инструмента в автономном скрипте Python.
'''*********************************************************************
Name: Model Shadows For GeoVRML Models
Description: Creates a model of the shadows cast by GeoVRML models
imported to a multipatch feature class for a range of dates
and times. A range of times from the start time and end
time can also be specified by setting the EnforceTimes
Boolean to True. This sample is designed to be used in a
script tool.
*********************************************************************'''
# Import system modules
import arcpy
from datetime import datetime, time, timedelta
#************************* Script Variables **************************
inFiles = arcpy.GetParameterAsText(0) # list of input features
spatialRef = arcpy.GetParameterAsText(1) # list of GeoVRML files
outFC = arcpy.GetParameterAsText(2) # multipatch from 3D files
inTimeZone = arcpy.GetParameterAsText(3) # time zone
startDate = arcpy.GetParameter(4) # starting date as datetime
endDate = arcpy.GetParameter(5) # ending date as datetime
dayInterval = arcpy.GetParameter(6) # day interval as long (0-365)
minInterval = arcpy.GetParameter(7) # minute interval as long (0-60)
enforceTime = arcpy.GetParameter(8) # minute interval as Boolean
outShadows = arcpy.GetParameterAsText(9) # output shadow models
outIntersection = arcpy.GetParameterAsText(10) # shadow & bldg intersection
# Function to find all possible date/time intervals for shadow modelling
def time_list():
dt_result = [startDate]
if dayInterval:
if endDate: #Defines behavior when end date is supplied
while startDate < endDate:
startDate += timedelta(days=dayInterval)
dt_result.append(startDate)
dt_result.append(endDate)
else: # Behavior when end date is not given
daymonthyear = datetime.date(startDate)
while startDate <= datetime(daymonthyear.year, 12, 31, 23, 59):
startDate += timedelta(days=dayInterval)
dt_result.append(startDate)
return dt_result
try:
arcpy.CheckOutExtension('3D')
importFC = arcpy.CreateUniqueName('geovrml_import', 'in_memory')
# Import GeoVRML files to in-memory feature
arcpy.ddd.Import3DFiles(inFiles, importFC, 'ONE_FILE_ONE_FEATURE',
spatialRef, 'Z_IS_UP', 'wrl')
# Ensure that building models are closed
arcpy.ddd.EncloseMultiPatch(importFC, outFC, 0.05)
# Discard in-memory feature
arcpy.management.Delete(importFC)
dt_result = time_list()
for dt in dt_result:
if dt == dt_result[0]:
shadows = outShadows
else:
shadows = arcpy.CreateUniqueName('shadow', 'in_memory')
arcpy.ddd.SunShadowVolume(outFC, dt, shadows, 'ADJUST_FOR_DST',
inTimeZone, '', minInterval, 'MINUTES')
if dt is not dt_result[0]:
arcpy.management.Append(shadows, outShadows)
arcpy.management.Delete(shadows)
arcpy.ddd.Intersect3D(outFC, outIntersection, outShadows, 'SOLID')
arcpy.CheckInExtension('3D')
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = "PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}"\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = "ArcPy ERRORS:\n {0}\n".format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Требует 3D Analyst
- ArcGIS Desktop Standard: Требует 3D Analyst
- ArcGIS Desktop Advanced: Требует 3D Analyst