Seismic Server walk through (Gullfaks) - geocapas/documentation GitHub Wiki

About this document

This document is a practical guide to the installation of Geocap Seismic Server and web client. It will also guide you through getting subsurface data published and displayed. The data used will be from the Gullfaks Petrel project which contains seismics, wells and surfaces.

Prerequisites

To follow this manual the reader should have access to ArcGIS Desktop (ArcMap or ArcGIS Pro), ArcGIS Server and Portal. The reader should to be familiar with the publishing of maps and using Web App Builder.

Publishing rights to an ArcGIS Server is required, including permissions to install Server Object extensions.

To follow this manual you will also need the following software and data at hand (the "bundle"):

  1. The Geocap Seismic Server SOE
  2. The Geocap web client
  3. The Gullfaks sample data

Please contact [email protected] for information on how to access this.

Installing the web client

The web client has two parts : The Web App Builder widget, and the Geocap Javascript client. The widgets plugs into the web app builder application and hosts the Geocap Javascript client, which manages the visualization.

  1. From the bundle, locate the folder GeocapViewer. This is the widget to be used by the WAB.
  2. Follow Esri's instructions for registering the custom widget : https://enterprise.arcgis.com/en/web-appbuilder/latest/create-apps/add-custom-widgets.htm

That's it ! Now lets build a Web App builder application in order to test the client.

  1. Login to your ArcGIS Portal and go to Contents.
  2. Click Create -> Web App and create a 2D web app.
  3. In the web app interface select the Dashboard theme.
  4. Click Modify Layout and remove all but one widget. Arrange it so that you have the widget to the left and the map to the right.
  5. Goto the Web App builder Widgets section and click the empty widget slot at the top. A dialog will appear that show a selection of built-in widgets.
  6. Select the Custom pane and click the Geocap widget, named S3 (The name S3 originates from the widgets early days as a Seismic 3D viewer).
  7. In the field containing the URL to the Geocap JS library, enter : https://geocap.geodata.no/api/2.2/geocap.2.2.89.js
  8. Click OK.
  9. Save the app and click Launch. The app will launch in a new tab.

You just made your first Geocap App ! Let's add some some data.

  1. In the toolbar click the '+' button.
  2. In the dialog that opens enter the following URL : https://geocap.geodata.no/arcgis/sharing/servers/4a8bb17c1e9e49918be96061e35c5bf5/rest/services/seismicportal/MapServer/6
  3. Click OK.
  4. When the data is loaded, expand the top-level item in the table-of-contents. The element denoting the Peon 3D volume will show.
  5. After the seismic 3D volume appears click on the Peon text itself. A dialog with inline, crossline and timeslice sliders will appear. Use these to navigate in the cube.
  6. Click Peon -> "..." -> Settings . Experiment with the various display options.

Installing the seismic server.

You will now install the Seismic Server on your ArcGIS Server, which allows you to host your own seismic data.

To install seismic server:

  1. Locate the SOE file in the Software -> Seismic Server folder in the bundle. This is the software that you will install on the server.
  2. There are two SOE files. For ArcMap, choose SeismicServer.soe. For ArcGIS Pro, choose SeismicServer_ent.soe.
  3. Open the Manager page for your ArcGIS Server. Click Site -> Extensions.
  4. Click the Add Extension button and add the SOE file.
  5. The Seismic Server is not installed.

Whenever you publish seismic navigation as a map service, make sure to enable the Seismic Server extension for that map service. You can do this either when publishing or later by accessing the Capabilities page for your Map Service.

Publishing Seismic Data

Now that we have both the client and server installed it's time to publish some seismic data. Publishing seismic data consists of these steps:

  1. Copy the actual seismic data (ZGY or raster files) to the server, or to a location the server can access.
  2. Using ArcGIS Desktop, create a map with the corresponding outline or navigation.
  3. In the URL column of each feature class, update the URL to match the location of the data files in 1)
  4. Publish the features as a regular map service.

Let's go through each of these in turn.

  1. In the bundle. locate the ZGY file in the zgy folder.Copy the file to a location that is accessible to the ArcGIS server and make a note of the path. This location could be on the same machine that is running the ArcGIS server or a remote file share.
  2. Open ArcGIS Pro or ArcMap. The rest of this documentation assumes Pro.
  3. Locate the Gullfaks GDB in the bundle (Gullfaks is the name of an oil field in the North Sea).
  4. Create a new map
  5. Add the feature class called SeismicCubes. This contains the outlines for the seismic 3D volumes (only one in this case).
  6. Open the attribute table. In the URL field enter the url corresponding to the ZGY file copied to the server. Note that in practice this will be filename-like url's. As an example, if the ZGY file myvolume.zgy was placed in a folder called c:/mydata the URL will be file://c:/mydata/myvolume.zgy. Remember to save your edits by clicking Save in the Edit toolbar. If your files reside in shared storage please see the section on shared storage URL syntax at the end of this document.
  7. We will now repeat this procedure with the 2D seismics. In the ArcGIS Pro catalog, locate the raster tif files in the GullfaksExport/seismic folder. Right-click to calculate statistics and create pyramids.
  8. Copy the raster files to a server or server-accessible location like you did with the ZGY file. Make a note of the path.
  9. Add the feature class called SeismicLines. This contains the navigation for the 2D lines (only one in this case).
  10. Edit the URL in the same way as the ZGY file. Remember to save your edits.
  11. Login to the ArcGIS Server from Pro.
  12. Click Share -> Web Layer -> Publish Web Layer.
  13. In the publishing configuration panel enter parameters as you would usually do. Ensure that Seismic Server is checked in the Configuration tab.
  14. Complete the publishing process.
  15. Once complete access the map service and locate the URL's to the 2D and 3D seismic layers.
  16. In the web client installed earlier, click the "+" button in the toolbar and add the URLs.
  17. Verify that the data is displayed as expected.

Making a map

The hard part is done. You can now create a map with your newly published seismic data and add to your app.

  1. In ArcGIS portal, create a map containing the seismic data.
  2. In Web App Builder, make this the main map.
  3. Save and click Launch.
  4. In the map, click on the seismics in the map. A popup meny will appear
  5. Click the three dots "..." at the bottom of the popup menu and click Display in 3D. The data will appear in the 3D viewer.

Wells and logs

The Petrel plugin exports wellheaders, boreholes, logs and welltops into feature classes. This data from the Gullfaks dataset is included in the bundle. This data is published just like any other feature classes. They do not require the seismic server to be displayed, but you will need the Geocap web client to unpack and display the well data correctly.

It is up to you if you want to include the well-related layers in the same map as the seismics or start with an empty map.

To publish Petrel wells and logs:

  1. From the bundle, add all the well-related feature classes and tables to the map. They are named Boreholes, DictionaryColorTables, Wellheads, WellLogs, WellTops.
  2. In the Pro table-of-contents, check the WellHeads layer, but keep the others unchecked.
  3. Publish the map as a web layer.
  4. To display the wells, either
    • Click a well header in the map
    • or
    • add the URL of the WellHeads layer to the viewer using the '+' button in the toolbar.

Surfaces

Surface-like datasets are export to single-band geotiff files by the plugin. Examples of surfaces are horizons and seafloors.

To make surfaces part of your visualization model:

  1. Calculate statistics and pyramids on the rasters
  2. Publish them as Image Services. The web client has built in support for reading image services.
  3. To view the rasters click the + button in the toolbar and add the Image Service URL to the scene.
  4. If the rasters have been added to the map they can be added by clicked the + button and click Add data from Map -> Rasters

Saving scenes

Once you have added data to the Geocap viewer you can save the scene so as to make it easy to retrieve later.

To save and restore a scene proceed as follows:

  1. Build the scene using any of the methods mentioned earlier in this post. Data can be added using either the + button in the toolbar or by clicking on the data in the map. Note that for protected data we recommend that the data is either added to the map beforehand or to the Contents section in the Portal, possibly with the option of saving the user credentials. The new URL's produced by the portal can then be added to the viewer.
  2. In the Geocap toolbar click the Bookmark button to save scenes. They will appear as thumbnails along the lower half of the viewer. Click a thumbnail to jump to that view directly
  3. When you are done building the scene click the Download Scene button in the toolbar to download the scene file.
  4. In the Web App Builder edit the Geocap Viewer widget.
  5. In the section called Startup Scene upload the scene file.
  6. Save and re-launch the app. The app will now show the scene automatically at startup.

A note on shared file access

The URL field in the seismic feature classes supports shared files. If your file has the path

\\myfolder\data.zgy

the corresponding URL should be one of

//myfolder/data.zgy

or

file:////myfolder/data.zgy