Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction


This section describes how to setup set up your own seismic portal using the Seismic Server web client as well as basic usage. An example of what your seismic portal could look like like can be found by visiting the official Geocap Seismic Portal.  

...

This section is for anyone involved in setting up GIS web applications and who wishes to add seismic data to the map. Basic familiarity with creating a web page or using ArcGIS web maps is assumed. This section does not cover how to read seismics load seismic into ArcGIS and publish the data.

...

The widget comes with the following features:

  1. A 3D window for showing seismicsseismic, features and rasters in 3D. This data is accessed from ArcGIS services,  including the Geocap Seismic Server.
  2. A 2D crossection cross-section window for showing seismic cross-sections along with intersections between the seismics seismic and other data.
  3. The ability to measure 2D and 3D distance along with any object in the scene
  4. Interact with the standard ArcGIS web map including copying data from the map to the Geocap 3D display
  5. Change visualization properties 
  6. Supported datatypes data types are :
    1. 2D + 3D
    seismics
    1. seismic
    2. Features
    3. Rasters, including mosaics, server from an ArcGIS Image Server.


A PC is the recommended device on which to interact with the client. Mobile devices will work but some gestures like 3D seismic section movement will require a notebook-size sized screen to be useful.

Prerequisites

...

  1. Once you have access to the Geocap Viewer widget follow the ArcGIS Portal documentation on how to add custom widgets.
  2. From the portal create a webb web app using the web app builder
  3. When adding widgets from within the web app builder click the Custom tab in the widget dialog. The Geocap Viewer widget should be listed. Just clicking the defaults should be ok.
    Image Added
  4. The next step is to configure the Geocap Viewer. In the startup scene input, you can optionally choose the JSON file with your previously saved bookmarks in Geocap Viewer by clicking the Browse button. The required input is the Location of Geocap JS which is supposed to be used to link to the geocap.js file.


A note on themes.

All web app builder themes are supported. However, some themes place the widgets in a fixed narrow location on either sides side in a way that does not work well with the requirements the Geocap viewer has for screen space. Also, the creation of two instances of the Geocap viewer in the same app is not supported.

...

This section describes the basics on of how to use the Geocap web client. Some details differ depending on whether you have decided to embed it as a WAB widget or as a standalone component in your web page.

Adding Data

Anchor#addwebclientdata#addwebclientdataTo add data directly from an ArcGIS service:

  • Click the + icon  icon on the toolbar and click Add Data from Web.
  • Enter the url URL of the service that you wish to add and click OK. You may need to check the Perform Login button to access restricted services. Here are some example links that you may try:

If you're using an ArcGIS web app created using the Web App Builder you can add data from the map in two different ways, as follows:

  1. In the Geocap viewer interface. Click the +

...

  1.  icon on the toolbar and click Add Data from Map:
    1. All to add all layers

...

    1. from the map to the Geocap viewer table of contents

...

    1. , or
    2. Rasters to add all rasters from the map to the Geocap viewer table of contents
  1. From the map. Select a feature on the map and click the 

...

  1. ... icon on the

...

  1. bottom of the pop-up window and choose:
    1. Display in 3D. It will add a single clicked feature to the Geocap viewer table of contents, or
    2. Add layer to 3D viewer. It will add an entire layer that includes the selected feature.
      Image Added

Manipulate view and windows

The Geocap viewer contains three types of windows: 3D, 2D, and Log viewer. They can be manipulated in the same way as in most graphical operating systems, like Microsoft Windows.

Possible operations:

  • moving each window independently by dragging the name bar of a specific window
  • resizing windows
  • minimizing, maximalizing, and closing
  • snapping windows by dragging or resizing the window in the way one of the edges is close to an edge of another window until the edge changes color to blue; to unsnap just resize one of snapped windows from the corner of the snapped (blue) edge or drag on of snapped windows 
  • double-clicking on the name bar of a window to maximize or restore the previous window's size

Predefined windows positions (tile, side by side) are available in the toolbar's View pulldown menu.

The Geocap viewer has also useful visual functionalities available in the View pulldown menu:

  • Scenic Effects visualizes seawater level and the sky
  • Color Legend describes colors displayed in 3D view by numbers
  • Axis visually grids the spatial data

Saving Scenes and bookmarks

...

  • Load and visualize the data that you wish to save
  • Click the bookmark Save Bookmark icon on the toolbar to save the current view. You may save any number of views. To restore a particular view just click on the thumbnailone of the thumbnails (View Bookmarks icon).
  • To save the whole scene to a file click the download button Download Scene icon on the toolbar. The scene will be saved to a JSON file on your PC (default download location of your web browser).


To restore a scene interactively:

...

  • Configure the Geocap Viewer widget from within the web app builder. In the section Startup Scene upload the scene JSON file.


 

Viewing Seismics

To view seismic data:

  1. Publish the data to the server and add the url URL for the seismic layer as desribed described in the section on adding data.
  2. Ensure that both the layer item and child feature items are checked in the table of contents.
  3. To view seismics seismic in 3D click the 3D button in the toolbar to ensure that the 3D view is visible.
  4. To view seismic in a 2D cross-section click the "..." pulldown menu in the table of contents for the seismic item and click View in 2D.  Make sure the 2D window is opened, if not then click the 2D button in the toolbar.
    Image Added
  5. If necessary click the "..." button for the seismic item and click zoom to. The seismic should appear.
  6. When using 3D seismics  seismic you can move the section by moving the section sliders. The section sliders will appear if you:
    1. Click on the text for the seismic item in the table of contents
    2. -or
    3. Click the "..." pulldown menu for the item and click View Slices.


Viewing Rasters

The web client supports visualization of both ArcGIS Image Services, Raster Layers, and Map Services. Rasters can be displayed using various modes:

...

  1. View the service as a single raster that is the combination of all the layers in the service. This corresponds to the conventional 2D view of the map.
  2. View the layers in the map service individually. 

When adding map services these display options are set by checking either the Add Map as Rastermap raster option or the Add Individual Map Service Layersindividual map service layers options in the Add Data dialog ('+' button → Add Data from Web).

If viewed in elevation mode band 0 of the raster is assumed to contain elevation values representing z values.

By default rasters with 3 or 4 bands (typically RGB) will be displayed in flat mode, while rasters with one band will be assumbed assumed to be  be elevation rasters.

One raster may be draped on top of another. Typically an RGB satellite image will be layered on top of an elevation surface.

...

  • Measuring method: Choose whether the distance between the selected data points is calculated using planar or geodesic geodetic calculation.
  • Horisontal Horizontal unit: The unit used for horizontal distances
  • Horisontal Horizontal path distance: The total horisontal horizontal distance of all line segments. No depth distance is included.
  • Horisontal Horizontal net distance: The horisontal horizontal distance between the first and last measuring points. No depth distance is included.
  • Vertical net distance: The pure vertical distance between the first and last measuring points. No horisontal horizontal distance is included.



When the scene is set in either in either WGS-84 (wkid: 4326) or Web Mercator Auxiliary Sphere (wkid: 3857) it is recommended that you use the geodesic method of calculation. For projected coordinate systems planar is  is often an acceptable alternative. 

To change the spatial reference of the scene:

  • Click the toolbar cog wheel cogwheel to open the settings dialog to set the spatial reference 
    • -or
  • Click the pulldown menu for the TOC item that you wish to adjust to. Click Use this spatial reference to set the scene to use the spatial reference asssociated associated with the selected item.


Note that geodesic measurements on scenes set to a projected coordinate system may sometimes fail due to restrictions in the underlying projection software used.

A note on vertical units in the measurement

For non-seismic data Geocap generally does not know the z domain (time or depth) or vertical units for a dataset. Geocap performs the vertical measurement based on the z values as-is. When performing measurements on a single dataset or a group of datasets with the same vertical unit this is typically not an issue. However, if a single measurement is performed across several datasets with mixed vertical units the reported value will generally be incorrect. The user is advised to be mindful of this when performing depth - measurements.