I3S

From Tygron Preview Support Wiki
Jump to navigation Jump to search
This article is a stub.

Template:Learned

What is SLPK?

A Scene Layer Package (SLPK) file is an openly published file format for 3D geospatial data, designed as a package for storage or exchange that captures all resources for a "scene layer" structured according to the Indexed 3D Scene Layer (I3S) specification. The I3S/SLPK specification originates from Esri. A scene layer displays one of four data types: points, point cloud, 3D objects, or an integrated mesh.

How to create a SLPK?

In this documentation we will look on how to export a SLPK with ArcGIS Pro. To learn more about ArcGIS Pro visit ESRI's ArcGis Pro Documentation. In order to export a 3d model as a SLPK it first must be imported into ArcGIS Pro and Georeferenced if it has no world coördinates. ArcGIS Pro allows for the following file formats to be imported:

  • DWG (Drawing) Used in CAD packages. Can be exported from most 3d animation packages.
  • OBJ (Wavefront object) Used in most 3d animation packages like Autodesk 3dsmax and Maya.
  • DAE (Collada) Used in most 3d animation packages like Autodesk 3dsmax and Maya.
  • 3DS (3d studio) Used as an exported file from Autodesk 3dsmax.
  • FLT (OpenFlight) Used in MultiGen Creator.
  • WRL (Virtual Reality Modeling Language File)A VRML file format for representing 3D vector graphics.

There are differences in how a DWG file is added to your project from other 3d file formats. We will explain both methods below.

Creating a new ArcGis 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).

Adding a DWG file to ArcGIS Pro

If you are working with CAD data follow this procedure to import a DWG file:

How to import a DWG file into ArcGis:
  1. In ArcGis go to the "Map" tab and select "Add Data"
  2. Choose the DWG file
  3. Select Multipatch

Importing other 3d files to ArcGis Pro

To import other 3d files like OBJ, DAE, 3DS, FLT or WRL follow this procedure:

How to import 3d files:
  1. In ArcGis go to the "Analysis" Tab and select "Tools".
  2. On the right pane select the "Import 3D Files" tool or type it in the search bar to find it.
  3. In the "Input files" field click on the folder icon next to the field and browse to the 3d file you want to import
  4. A name will be automatically generated in the "Output Multipatch Feature Class" field.
  5. Select a Coordinate system from the dropdown menu or select an other system by clicking on the grid sphere icon next to the field.
  6. Select "Y is Up" only if your 3d model was exported from a package wich uses Z is up.
  7. Click on "Run" at the lower right of the pane.
  8. 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.

Georeferencing your imported model in ArcGis

Imported models, if they are created in a package wich does not have global coordinates, are imported without a global reference for the location on the map. To move your imported model to the right location on the map follow this procedure:

How to Georeference 3d models:
  1. In ArcGis, select your 3d object from the Contents pane or the Viewport.
  2. Go to the "Edit" tab. The tools section will appear
  3. Select the "Move" tool and drag the 3d model along one of the axes to translate it on the map to the desired location.
  4. If desired, the object can be rotated and/or scaled with the "Rotate" and "Scale" tools
  5. Make sure that the object is at the proper height relative to the ground

Exporting 3d files to SLPK in ArcGis

After importing and Georeferencing your model(s) you can export them to a SLPK file by following this procedure:

How to Export to SLPK:
  1. In ArcGis 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 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
  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.
  6. This will save the Multipatch to the database.
  7. Click on "Run" at the bottom right of the pane.
  8. Go to the "Analysis" Tab and select "Tools" again.
  9. On the right pane navigate to the "Layer 3D to Feature Class" tool or type it in the search bar to find it.
  10. In the "Input Feature Layer" field select the multipatch feature like before.
  11. 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.
  12. Check "Disable Color and Texture" only if you do not want these features to be converted.
  13. Click on "Run" at the bottom right of the pane.
  14. Finally go to the "Analysis" Tab and select "Tools" again.
  15. On the right pane navigate to the "Create 3D Object Scene Layer Package" tool or type it in the search bar to find it.
  16. In the "Imput Dataset" field select the created Layer3d file form the previous steps.
  17. 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.
  18. 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.
  19. Optimize the textures for various platform by choosing an option from the "Texture Optimization" dropdown field or leave at the default setting.
  20. Click on "Run" at the bottom right of the pane.

Importing a SLPK into the Tygron Platform

After creating a SLPK file in ArcGis Pro (see section on Creating a SLPK) it can be imported into the Tygron Engine. Make sure that your project includes the geographic location of the SLPK file. To import a SLPK to the Tygron Platform follow this procedure:

How to import a SLPK into the Tygron Platform.:
  1. Create a new project or open an existing one
  2. Drag the SLPK file into the viewport or go to the "Current Situation" tab, go to buildings and select "Import Geo Data" from the dropdown menu
  3. This will start the Geo Data Wizard. Click on "Next".
  4. Select "Import an I3S SLPK file
  5. Select the file to be imported. The Wizard will validate the file. Click on "Next".
  6. Step 2 shows the features wich will be imported. Click on "Next".
  7. Select Which filter you want to use. Click on "Next".
  8. Choose if you want to Update or Replace the shapes already existing. Click on "Next".
  9. Click on "Finish" to finalize.
  10. Your SLPK file has been imported.