I3S: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
 
(60 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{being_updated}}
[[File:San_francisco.png|thumb|300px|right|Custom geometries of San Francisco from an I3S Service, visualized in the {{software}}]]
{{learned|what a SLPK is|how to create a SLPK file|how to upload a SLPK file to the {{software}}}}
Indexed 3D Scene Layer Specification (I3S){{ref|i3s}} is a format for large 3D Geo datasets. The specification was mainly designed for streaming large 3D visualization data over the web. The specification was originally designed by Esri and was adopted as a Community Standard by the OGC (Open Geospatial Consortium) in 2017. In ArcGIS software, an I3S dataset can be visualized using a Scene Layer.


==What is SLPK?==
In the {{software}} it is possible to add your own 3D models as [[Custom Geometries]]. A format for these models which the {{software}} supports is I3S, along with the other format [[CityGML]].
The I3S (Indexed 3D Scene Layer Specification) originates from Esri. The specification was adopted as a Community Standard by the OGC (Open Geospatial Consortium) in 2017. The I3S specification is for streaming and packaging large heterogenous 3D Geo data. An I3S dataset is also called a Scene Layer. With a Scene Layer Package (SLPK) file, one I3S layer, containing all the data can be exchanged.


==How to create a SLPK?==
Different other formats, such as BIM data or a SketchUp model, can be converted to the I3S format with a SLPK file. Read on to learn more about this.
In this documentation we will look on how to export a SLPK file with ArcGIS Pro. 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. ArcGIS Pro allows for the following file formats to be imported:


*DWG (Drawing) Used in CAD software. Can be exported from most 3D animation packages.
{{clear}}
*OBJ (Wavefront object) Used in most 3D animation packages like Autodesk 3dsmax and Maya.
==I3S and SLPK ==
*DAE (Collada) Used in most 3D animation packages like Autodesk 3dsmax and Maya.
A Scene Layer Package (SLPK) is a file format for the storage/exchange of one or more I3S layers. SLPK's can be used to import both  into your [[project]] once it has been created.
*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 ArcGIS Pro project from other 3D file formats. Both will be explained below.
=== 2D versus 3D ===
Generally, I3S Services and SLPK files are used to import [[Custom Geometries]], that provide an alternative 3D visualization, for existing or new [[Building]]s.
I3S services and SLPK files can also be used to import 2D spatial data for items such as [[Area]]s and [[Terrain]]s. However, the support for additional attributes is currently limited.


===1. Creating a new ArcGIS Pro project===
{{article end
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).
|howtos=
* [[How to import i3s scene layer in new project]]
* [[How to create an SLPK file]]
* [[How to import an SLPK file]]
* [[How to import an SLPK file for 2D Spatial data]]
* [[How to import 3D Models from ArcGIS Online]]
* [[How to convert a Revit model to a SLPK file using ArcGIS Pro]]
|seealso=
* [[Custom Geometries]]
|references=
<references>
{{ref|i3s
  |name=Indexed 3D Scene Layers (I3S)
  |author=
  |page=
  |source=Open Geospatial Consortium
  |link=https://www.ogc.org/standard/i3s/
  |lastvisit=5-10-2023
}}
</references>
}}


===2.a Adding a DWG file===
{{GeoDataOverview}}
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|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">
File:Analysis_tools.jpg|Step 1
File:Import_3d_files.jpg|Step 2
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>
 
 
{{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.}}
 
===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.
Therefore, the model has to be moved to the right location on the map. 
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===
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 the in order.
 
{{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 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 multipatch feature like before.|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.}}
 
{{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.}}
 
==Importing a SLPK into the Tygron Platform==
 
After creating a SLPK file, the data can be imported into the {{software}} by making use of the [[Geo_Data_Wizard|Geo data wizard]].
Read [[Geo_Data_Wizard#Steps_in_the_Geo_Data_Wizard|here]] for the steps on how to use the wizard.

Latest revision as of 12:43, 22 December 2023

Custom geometries of San Francisco from an I3S Service, visualized in the Tygron Platform

Indexed 3D Scene Layer Specification (I3S)[1] is a format for large 3D Geo datasets. The specification was mainly designed for streaming large 3D visualization data over the web. The specification was originally designed by Esri and was adopted as a Community Standard by the OGC (Open Geospatial Consortium) in 2017. In ArcGIS software, an I3S dataset can be visualized using a Scene Layer.

In the Tygron Platform it is possible to add your own 3D models as Custom Geometries. A format for these models which the Tygron Platform supports is I3S, along with the other format CityGML.

Different other formats, such as BIM data or a SketchUp model, can be converted to the I3S format with a SLPK file. Read on to learn more about this.

I3S and SLPK

A Scene Layer Package (SLPK) is a file format for the storage/exchange of one or more I3S layers. SLPK's can be used to import both into your project once it has been created.

2D versus 3D

Generally, I3S Services and SLPK files are used to import Custom Geometries, that provide an alternative 3D visualization, for existing or new Buildings. I3S services and SLPK files can also be used to import 2D spatial data for items such as Areas and Terrains. However, the support for additional attributes is currently limited.