3D ファイルのインポート(Import 3D Files) (3D Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

1 つ以上の 3D モデルをマルチパッチ フィーチャクラスにインポートします。

使用法

構文

Import3DFiles_3d (in_files, out_featureClass, {root_per_feature}, {spatial_reference}, {y_is_up}, file_suffix, {in_featureClass}, {symbol_field})
パラメータ説明データ タイプ
in_files

サポートされている形式のファイルを含む 1 つ以上の 3D モデルまたはフォルダ。サポートされている形式は、3D Studio Max(*.3ds)、SketchUp(*.skp)、VRML および GeoVRML(*.wrl)、OpenFlight(*.flt)、COLLADA(*.dae)です。

File; Folder
out_featureClass

入力ファイルから作成されるマルチパッチ。

Feature Class
root_per_feature
(オプション)

ファイルごとに 1 つのフィーチャを作成するのか、ファイル内のルート ノードごとに 1 つのフィーチャを作成するのかを示します。このオプションの適用対象は VRML モデルだけです。

  • ONE_ROOT_ONE_FEATURE生成された出力には、ファイル内のルート ノードごとに 1 つのフィーチャが含まれます。
  • ONE_FILE_ONE_FEATURE生成された出力には、各フィーチャに 1 つのファイルが含まれます。これはデフォルト設定です。
Boolean
spatial_reference
(オプション)

入力データの座標系です。大部分の形式で、これは不明になります。GeoVRML 形式のみがその座標系を格納します。そのデフォルトは(空間参照がここで指定されていなければ)、リストの 1 つ目のファイルから取得されます。

Spatial Reference
y_is_up
(オプション)

入力ファイルの縦方向を定義する軸を識別します。

  • Z_IS_UPZ が上であることを示しています。これはデフォルト設定です。
  • Y_IS_UPY が上であることを示しています。
Boolean
file_suffix

入力フォルダからインポートするファイルのファイル拡張子。少なくとも 1 つのフォルダが入力として指定されている場合は、このパラメータが必要です。

  • *サポートされているすべてのファイル。これはデフォルト設定です。
  • 3DS3D Studio Max
  • WRLVRML または GeoVRML
  • SKPSketchUp 6.0
  • FLTOpenFlight
  • DAECollada
String
in_featureClass
(オプション)

座標が入力ファイルの実世界の位置を定義するポイント フィーチャ。各入力ファイルが [シンボル フィールド] に格納されているファイル名に基づいて対応するポイントに対応付けられます。ポイントの空間参照を対応付けるには、[座標系] パラメータを定義する必要があります。

Feature Class
symbol_field
(オプション)

各ポイントに関連付けられている 3D ファイルの名前を含んでいるポイント フィーチャのフィールド。

Field

コードのサンプル

Import3DFiles(3D ファイルのインポート)の例 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(3D ファイルのインポート)の例 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 for Desktop Basic: 次のものが必要 3D Analyst
ArcGIS for Desktop Standard: 次のものが必要 3D Analyst
ArcGIS for Desktop Advanced: 次のものが必要 3D Analyst
7/28/2014