How to create an SLPK file: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
 
(41 intermediate revisions by 4 users not shown)
Line 1: Line 1:
This page provides information on how to export a [[SLPK]] file with ArcGIS Pro. The ArcGIS PRo version used in this documentation is 2.4.0. To learn more about ArcGIS Pro visit ESRI's [https://pro.arcgis.com/en/pro-app/help/main/welcome-to-the-arcgis-pro-app-help.htm ArcGis Pro Documentation].
__NOTOC__
In order to export a 3D model as a SLPK, it has to be imported into ArcGIS Pro and Georeferenced to place the model on the right location. ArcGIS Pro allows for the following file formats to be imported:
This page provides information on how to export a [[SLPK]] file with ArcGIS Pro. The ArcGIS PRo version used in this documentation is 2.4.0. <br>
To learn more about ArcGIS Pro visit ESRI's [https://pro.arcgis.com/en/pro-app/help/main/welcome-to-the-arcgis-pro-app-help.htm ArcGis Pro Documentation].
In order to export a 3D model as a SLPK, it has to be imported into ArcGIS Pro and Georeferenced to place the model on the right location.<br> ArcGIS Pro allows different file formats to be imported.<br>


*DWG (Drawing) Used in CAD software. Can be exported from most 3D animation packages.
=Requirements on 3D model data=
*OBJ (Wavefront object) Used in most 3D animation packages like Autodesk 3dsmax and Maya.
Below some notes to take into account when importing a 3D model into the {{software}}<br>
*DAE (Collada) Used in most 3D animation packages like Autodesk 3dsmax and Maya.
* If the 3D model is of a 3D plan with multiple [[Function]]s, take note of the following. For each [[Function]] in the 3D plan, a separate SLPK file should be created, since it is not possible to do a function mapping when importing. Therefore, you could also consider to only transform the 3D buildings into a SLPK file to import these models as one function into the {{software}}. If there are multiple types of buildings in the plan, then create multiple SLPK files or after importing, change the type of buildings manually in the Platform. The other elements in the plan, such as roads, squares and green spaces can be transformed to a (2D) [[GeoJSON]] file. For a GeoJSON it is possible to do a function mapping when importing, only then the generic Tygron models are used for the elements in the plan.
*3DS (3D studio) Used as an exported file from Autodesk 3dsmax.
* The 3D plan should only contain the new functions (the new adjustments to the current situation) and no existing functions such as the surroundings.  
*FLT (OpenFlight) Used in MultiGen Creator.
* If possible, try to draw the model directly on the right location or after finishing the model, move it to the right location. This saves a few steps in preparing the data before importing in the {{software}}.
*WRL (Virtual Reality Modeling Language File) A VRML file format for representing 3D vector graphics.
* When drawing the 3D plan, work with different layers for the different [[Function]]s in the design. For example, all office buildings are in a layer called offices, parks are in the layer green spaces etc. Try to be clear with the naming of the layers.  
 
* Be aware of the fact that [[Function]]s in the {{software}} can't overlap. For example a building polygon may not be on top of a green space polygon. In the {{software}} this would translate to either the building which is imported or the green space, since it is not possible to stack functions on top of each other. In this case, the green space should be drawn surrounding the building polygon. 
There are differences in how a DWG file is added to your ArcGIS Pro project from other 3D file formats. Both will be explained below.
* Try to make the model as neat as possible to ensure a valid data file. For example, no lines or polygons on top of each other (duplicates), loose line segments or surfaces that do not belong to the plan, polygons that are not closed etc.


===1. Creating a new ArcGIS Pro project===
===1. Creating a new ArcGIS Pro project===
To add a 3D model like CAD or OBJ you should first create a new project in ArcGIS Pro. When starting a new project make sure that you select a local Scene from the Blank Templates section. You can convert a local scene to a global scene after you have imported your model(s).
First create a new project in ArcGIS Pro. When starting a new project make sure that you select a local Scene from the Blank Templates section. You can convert a local scene to a global scene after you have imported your model(s).
 
===2.a Adding a DWG file===
If you are working with CAD data follow this procedure to import a DWG file:
 
[[File:Add_data.jpg|450px]]
 
{{editor steps|title=import a DWG file into ArcGis|In ArcGis go to the "Map" tab  and select "Add Data"|Choose the DWG file. If the file is not visible in the add Data panel, click on the refresh button (top right corner)|Select Multipatch}}
 
===2.b Importing other 3D file formats===
To import other 3D files like OBJ, DAE, 3DS, FLT or WRL follow this procedure:


<gallery mode="nolines">
===2. Adding 3D data files===
File:Analysis_tools.jpg|Step 1
====Adding a DWG file====
File:Import_3d_files.jpg|Step 2
If you are working with CAD data, see the steps on [[How_to_import_a_DWG_file_in_ArcGIS_Pro|How to import a DWG file]].
File:Input_files.jpg|Step 3a
File:Import_dialog.jpg|Step 3b
File:Output_name.jpg|Step 4
File:Coordinates.jpg|Step 5
File:Y_up.jpg|Step 6
</gallery>


====Import a SketchUp model====
To import a SketchUp model, see the [[How_to_import_a_SketchUp_model_in_ArcGIS_Pro|How to import a SketchUp model in ArcGIS Pro]].


{{editor steps|title=import 3d files|In ArcGis go to the "Analysis" Tab and select "Tools".|On the right pane select the "Import 3D Files" tool or type it in the search bar to find it.|In the "Input files" field click on the folder icon next to the field and browse to the 3D file you want to import|A name will be automatically generated in the "Output Multipatch Feature Class" field.|Select a Coordinate system from the dropdown menu or select an other system by clicking on the grid sphere icon next to the field.|Select "Y is Up" only if your 3d model was exported from a package wich uses Z is up.|Click on "Run" at the lower right of the pane.|After it is finished ArcGis will have created a Multipatch feature which can be located on the Contents Pane on the left. Note that your original 3D imported file is also present, but we will be using the multipatch for further conversion to SLPK.}}
====Import BIM data====
To import BIM data in ArcGIS Pro, there are multiple options. Here we describe one of them by making use of ArcMap. See for the steps [[How_to_prepare_BIM_data_to_import_in_ArcGIS_Pro|How to prepare BIM data to import in ArcGIS Pro]].


===2.c Importing and assigning texture maps on an imported model===
====Importing other 3D file formats====
If your model has a texture map and it is not loaded onto the model after importing you can import it manually in ArcGis Pro. To import and assign a texture follow this procedure:
To import other 3D files like OBJ, DAE, 3DS, FLT or WRL, see the [[How_to_import_a_3D_model_in_ArcGIS_Pro|How to import a 3D file]].


{{editor steps|title=import texture map and assign to model|In ArcGis select the imported multipatch model from the contents pane.|Got to "Edit" and select the "Modify" button from the "Features" Section of the tab. The "modify features" pane appears on the right side.|Expand "Reshape" and click Multipatch texture.|In the pane, click Active Select and select the multipatch feature.|The selected feature appears in a list, and the editing toolbar appears at the bottom of the scene.|Click Load Texture. A file browser appears|Click Apply.}}
===2.b Importing and assigning texture maps on an imported model===
 
If your model has a texture map and it is not loaded onto the model after importing you can import it manually in ArcGis Pro. To import and assign a texture follow the steps in the [[How_to_import_and_assign_a_texture_in_ArcGIS_Pro|How to import and assign textures]].
To learn more about applying textures to a multipatch feature in ArcGis Pro go to [https://pro.arcgis.com/en/pro-app/help/editing/apply-textures-to-a-multipatch-feature.htm Applying textures to Multipatch feature]
 
<gallery mode="nolines">
File:Modify.jpg|Modify
File:Active_select.jpg|Active Select
File:Load_texture.jpg|Load texture
</gallery>


===3.Georeference your imported model===
===3.Georeference your imported model===
Imported models, if they are created in a software program without a CRS (Coordinate Reference System), are imported and probably not placed on the right location.
If the 3D model is not yet on the right location on the map, follow the steps in the How to to georeference the model:  
Therefore, the model has to be moved to the right location on the map. 
[[How to Georeference a 3D model]].
Note that imported DWG 3d models are georeferenced in a different way than other 3d formats like obj or other 3d formats. Therefore there are 2 ways to georeference your models depending on if they are a DWG or another file format.
See the steps below appropriate to your workflow.
 
<gallery mode="nolines">
File:Selection_context_menu.jpg|Select Building
File:CAD_Layer_tab.jpg|CAD Layer tab
File:Define_projection.jpg|Choose coordinate system
File:Translate_tools.jpg|Positioning tools.
</gallery>
 
{{editor steps|title=Georeference DWG models|In ArcGIS Pro, select your 3D object (Multipatch version) from the Contents pane by right-clicking on the imported multipatch feature, choosing "selection" and clicking on "select all". (If model is not visisble in the viewport choose "zoom to selection" from the same selection menu)|Go to the "CAD Layer" Manage tab. (This tab will only appear if the imported model is a DWG file) The DWG management tools section will appear.|Click on the "Define Projection" tool and select a coordinate system from the library (click on the globe next to the field)or choose the default one. (This can be done from the right tools pane)|Click on "Run" in the lower right of the pane.|Select the "Georeference" tool.|Choose the "move", "scale" or "rotate" tool and drag, rotate and scale the 3D model along one or all of the axes to move it on the map to the desired location.|Use the "Elevate To Ground" tool so that the model snaps to the ground (Provided that the pivot point or center of the model is at the desired groundlevel base of the model.|Finally click on "Save To Workspace" (Next to the move, scale and rotate tools) so that the location is saved.|Close the Georeference toolset, your model is georeferenced for use in your project and ready for export to SLPK.}}
 
<gallery mode="nolines">
File:Select building.jpg|Select Multipatch
File:Georeference_model.jpg|Georeference 3d model
</gallery>
 
{{editor steps|title=Georeference 3D models|In ArcGIS Pro, select your 3D object from the Contents pane or the Viewport.|Go to the "Edit" tab. The tools section will appear|Select the "Move" tool and drag the 3D model along one of the axes to move it on the map to the desired location.|If desired, the model can be rotated and/or scaled with the "Rotate" and "Scale" tools|Make sure that the model is at the proper height relative to the ground|}}


===4. Export the model as a SLPK file===
===4. Export the model as a SLPK file===
After importing and Georeferencing your model(s) you can export them to a SLPK file by following the steps below, which are divided into three sections. Please follow them in order.  
After importing and if needed Georeferencing your model you can export the model to a [[SLPK]] file by following the steps below, which are divided into three sections. Please follow them in order.  


<gallery mode="nolines">
<gallery mode="nolines">
Line 82: Line 46:
</gallery>
</gallery>


{{editor steps|title=create a Feature Class|In ArcGIS Pro go to the "Analysis" Tab and select "Tools".|On the right pane navigate to the "Feature Class to Feature Class" tool or type it in the search bar to find it.|In the "Input Features" field select the Multipatch feature of the imported object by clicking on the dropdown in the field to select it. Make sure it is the Multipatch version and not the original object|The Output location will be a .gdb (database file) with the project as a name. Leave the default name as is or rename it if you prefer.|In the "Output Feature Class" field type in a name.|This will save the Multipatch to the database.|Click on "Run" at the bottom right of the pane.}}
{{editor steps|title=create a Feature Class
 
|In ArcGIS Pro go to the "Analysis" Tab and select "Tools".|On the right pane navigate to the "Feature Class to Feature Class" tool or type it in the search bar to find it.
{{editor steps|title=create a Layer 3D|Go to the "Analysis" Tab and select "Tools" again.|On the right pane navigate to the "Layer 3D to Feature Class" tool or type it in the search bar to find it.|In the "Input Feature Layer" field select the newly created feature class not the original multipatch.|An automatic name will be generated in the "Output Feature Class" field. Usually it will append a "_Layer3DToF1" tag after the Multipatch name. Leave as default or rename it if you want. Make sure that you can identify the name because we will be needing it in the final step.|Check "Disable Color and Texture" only if you do not want these features to be converted.|Click on "Run" at the bottom right of the pane.}}
|In the "Input Features" field select the Multipatch feature(s) of the imported object by clicking on the dropdown in the field to select the layers.
|The Output location will be a .gdb (database file) with the project as a name. Leave the default name as is or rename it if you prefer.
|In the "Output Feature Class" field type in a name.This will save the Multipatch layer(s) to the database.
|Click on the Environments tab and choose the CRS for your data.
|Click on "Run" at the bottom right of the pane.
}}


{{editor steps|title=Export to SLPK|Finally go to the "Analysis" Tab and select "Tools" again.|On the right pane navigate to the "Create 3D Object Scene Layer Package" tool or type it in the search bar to find it.|In the "Input Dataset" field select the created Layer3d file from the previous steps.|In the "Output Scene Layer Package" field type in the name for the SLPK file wich will be created and choose the location for the file to be saved.|In the "Output Coordinate System" dropdown field select this projects system or select a new one by clicking on the grid sphere icon on the right of the field.|Optimize the textures for various platform by choosing an option from the "Texture Optimization" dropdown field or leave at the default setting.|Click on "Run" at the bottom right of the pane.|Now a SLPK file will be created.}}
Note: these steps can be skipped when converting from a DWG file. Continue directly to the steps for exporting an SLPK instead.


==Importing a SLPK into the Tygron Platform==
{{editor steps|title=create a Layer 3D
|Go to the "Analysis" Tab and select "Tools" again.
|On the right pane navigate to the "Layer 3D to Feature Class" tool or type it in the search bar to find it.
|In the "Input Feature Layer" field select the newly created feature class not the original multipatch layer(s).
|An automatic name will be generated in the "Output Feature Class" field. Usually it will append a "_Layer3DToF1" tag after the Multipatch name. Leave as default or rename it if you want. Make sure that you can identify the name because we will be needing it in the final step.
|Check "Disable Color and Texture" only if you do not want these features to be converted.
|Click on "Run" at the bottom right of the pane.}}


After creating a SLPK file, the data can be imported into the {{software}} by making use of the [[Geo_Data_Wizard|Geo data wizard]].
{{editor steps|title=Export to SLPK
Read [[Geo_Data_Wizard#Steps_in_the_Geo_Data_Wizard|here]] for the steps on how to use the wizard.
|Finally go to the "Analysis" Tab and select "Tools" again.
|On the right pane navigate to the "Create 3D Object Scene Layer Package" tool or type it in the search bar to find it.
|In the "Input Dataset" field select the created Layer3d file from the previous steps.
|In the "Output Scene Layer Package" field type in the name for the SLPK file wich will be created and choose the location for the file to be saved.
|Optimize the textures for various platform by choosing an option from the "Texture Optimization" dropdown field or leave at the default setting.|Click on "Run" at the bottom right of the pane.
|Now a SLPK file will be created.}}


{{Template:GeoDataOverview}}
{{article end
|howtos=*[[How to import an SLPK file]]
|seealso=*[[SLPK]]
}}
{{GeoDataOverview}}
[[Category:How-to's]]

Latest revision as of 14:00, 30 January 2024

This page provides information on how to export a SLPK file with ArcGIS Pro. The ArcGIS PRo version used in this documentation is 2.4.0.
To learn more about ArcGIS Pro visit ESRI's ArcGis Pro Documentation. In order to export a 3D model as a SLPK, it has to be imported into ArcGIS Pro and Georeferenced to place the model on the right location.
ArcGIS Pro allows different file formats to be imported.

Requirements on 3D model data

Below some notes to take into account when importing a 3D model into the Tygron Platform

  • If the 3D model is of a 3D plan with multiple Functions, take note of the following. For each Function in the 3D plan, a separate SLPK file should be created, since it is not possible to do a function mapping when importing. Therefore, you could also consider to only transform the 3D buildings into a SLPK file to import these models as one function into the Tygron Platform. If there are multiple types of buildings in the plan, then create multiple SLPK files or after importing, change the type of buildings manually in the Platform. The other elements in the plan, such as roads, squares and green spaces can be transformed to a (2D) GeoJSON file. For a GeoJSON it is possible to do a function mapping when importing, only then the generic Tygron models are used for the elements in the plan.
  • The 3D plan should only contain the new functions (the new adjustments to the current situation) and no existing functions such as the surroundings.
  • If possible, try to draw the model directly on the right location or after finishing the model, move it to the right location. This saves a few steps in preparing the data before importing in the Tygron Platform.
  • When drawing the 3D plan, work with different layers for the different Functions in the design. For example, all office buildings are in a layer called offices, parks are in the layer green spaces etc. Try to be clear with the naming of the layers.
  • Be aware of the fact that Functions in the Tygron Platform can't overlap. For example a building polygon may not be on top of a green space polygon. In the Tygron Platform this would translate to either the building which is imported or the green space, since it is not possible to stack functions on top of each other. In this case, the green space should be drawn surrounding the building polygon.
  • Try to make the model as neat as possible to ensure a valid data file. For example, no lines or polygons on top of each other (duplicates), loose line segments or surfaces that do not belong to the plan, polygons that are not closed etc.

1. Creating a new ArcGIS Pro project

First create a new project in ArcGIS Pro. When starting a new project make sure that you select a local Scene from the Blank Templates section. You can convert a local scene to a global scene after you have imported your model(s).

2. Adding 3D data files

Adding a DWG file

If you are working with CAD data, see the steps on How to import a DWG file.

Import a SketchUp model

To import a SketchUp model, see the How to import a SketchUp model in ArcGIS Pro.

Import BIM data

To import BIM data in ArcGIS Pro, there are multiple options. Here we describe one of them by making use of ArcMap. See for the steps How to prepare BIM data to import in ArcGIS Pro.

Importing other 3D file formats

To import other 3D files like OBJ, DAE, 3DS, FLT or WRL, see the How to import a 3D file.

2.b Importing and assigning texture maps on an imported model

If your model has a texture map and it is not loaded onto the model after importing you can import it manually in ArcGis Pro. To import and assign a texture follow the steps in the How to import and assign textures.

3.Georeference your imported model

If the 3D model is not yet on the right location on the map, follow the steps in the How to to georeference the model: How to Georeference a 3D model.

4. Export the model as a SLPK file

After importing and if needed Georeferencing your model you can export the model to a SLPK file by following the steps below, which are divided into three sections. Please follow them in order.

How to create a Feature Class:
  1. In ArcGIS Pro go to the "Analysis" Tab and select "Tools".
  2. On the right pane navigate to the "Feature Class to Feature Class" tool or type it in the search bar to find it.
  3. In the "Input Features" field select the Multipatch feature(s) of the imported object by clicking on the dropdown in the field to select the layers.
  4. The Output location will be a .gdb (database file) with the project as a name. Leave the default name as is or rename it if you prefer.
  5. In the "Output Feature Class" field type in a name.This will save the Multipatch layer(s) to the database.
  6. Click on the Environments tab and choose the CRS for your data.
  7. Click on "Run" at the bottom right of the pane.

Note: these steps can be skipped when converting from a DWG file. Continue directly to the steps for exporting an SLPK instead.

How to create a Layer 3D:
  1. Go to the "Analysis" Tab and select "Tools" again.
  2. On the right pane navigate to the "Layer 3D to Feature Class" tool or type it in the search bar to find it.
  3. In the "Input Feature Layer" field select the newly created feature class not the original multipatch layer(s).
  4. An automatic name will be generated in the "Output Feature Class" field. Usually it will append a "_Layer3DToF1" tag after the Multipatch name. Leave as default or rename it if you want. Make sure that you can identify the name because we will be needing it in the final step.
  5. Check "Disable Color and Texture" only if you do not want these features to be converted.
  6. Click on "Run" at the bottom right of the pane.
How to Export to SLPK:
  1. Finally go to the "Analysis" Tab and select "Tools" again.
  2. On the right pane navigate to the "Create 3D Object Scene Layer Package" tool or type it in the search bar to find it.
  3. In the "Input Dataset" field select the created Layer3d file from the previous steps.
  4. In the "Output Scene Layer Package" field type in the name for the SLPK file wich will be created and choose the location for the file to be saved.
  5. Optimize the textures for various platform by choosing an option from the "Texture Optimization" dropdown field or leave at the default setting.
  6. Click on "Run" at the bottom right of the pane.
  7. Now a SLPK file will be created.

How-to's

See also