Adding Data Sources

You can add multiple data source types to the Spatial Explorer map. Each data source you add to Spatial Explorer includes all the data layers available from that source. If the data source requires a user name and password, you are prompted to enter these credentials the first time you connect to the data source. For each data layer you add to the map, you must provide an identifying name for the layer. Spatial Explorer uses this identifying name in the Data Source and Layers lists.

Data Source Method for Adding

For map services, WMS data sources, portals, and feature services, you need to provide a valid URL. For an SDE database, you need to provide a file path and database name.

Browse to and locate the shape file, raster file, or geodatabase folder.

Project data

Select the following project data directly in Spatial Explorer (deviation surveys are included with well selections):

  • (Kingdom only) Wells (all wells, visible wells, and well subsets)
  • (Harmony only) Wells (all wells and custom groups)
  • (Kingdom only) Well Plans
  • (Kingdom only) 2D surveys (All surveys, visible surveys, and survey subsets)

(Kingdom only) Drag and drop

Drag and drop from Project Explorer onto the Spatial Explorer Data Source panel:

  • 3D surveys
  • Contours
  • Culture groups
  • Fault segments and fault surfaces
  • Grids
  • Horizons
  • Polygons

Text Layers

Text layers are native to Spatial Explorer and do not need to be imported or added from the Kingdom or Harmony project.

Polygon Layers

Polygon layers are native to Spatial Explorer and do not need to be imported or added from the Kingdom or Harmony project.

How to add a data source

The steps below provide general guidance for adding any data source other than a Portal for ArcGIS to Spatial Explorer. Refer to the separate instructions for Adding a Portal for ArcGIS data source.

The remaining sections following the steps below provide supplemental information that is unique to particular data types. For example, after adding either a Adding a geodatabase or an Adding an SDE database to Spatial Explorer, you have the option to update the X and Y coordinates of these data sources to ensure they are included in spatial queries.

  1. Click Add new data source.
  2. Select the data source type you want to use.
  3. If you want to add a shape file, raster file, or geodatabase, browse to and select the file or the geodatabase folder, and then click Open.
  4. If you want to add a feature service, map service, or WMS service, provide the URL for the service as well as a display name, and then click Connect. You are prompted for a user name and password if these are required to access the service.
  5. If you want to add an SDE database:
    1. Select whether you are connecting to an Oracle or SQL Server database server.
    2. Provide a valid SDE database server name and a display name (the display name is the name you want to display in the Data Source list for this data source).
    3. Enter a valid username and password, and then click Log on.
    4. Select the database(s) you want to connect to.
    5. Click Done. The SDE database appears in the Data Source list with the display name you provided in step 5b.

After you add a data source, that data source and any layers it includes appear in the Data Source list. Data sources are grouped by type.

When you first add a data source, the data source and any data layers they include may appear outlined in red. This indicates that the data source contains no valid data or the data it includes lies outside the project bounds.

Relinking data sources

Existing data sources may also appear in red when starting Spatial Explorer. This means that Spatial Explorer can no longer access that particular data source. This can occur if the data source is no longer available (such as a missing shape file) or if you need to provide the credentials for the data source again (such as a map service, WMS service, or portal).

  1. Click Refresh icon on the data source highlighted in red.
  2. If the data source is a map service, WMS service, or feature service, you may prompted to provide the user name and password if credentials are required.
  3. If the data source is a shape file, remove it from the Data Source list and add it again from its new location.

Adding Feature Services

You add Feature Services to Spatial Explorer Click Add new data source. as most other data sources. However, unlike a typical Feature Service, Feature Services in Spatial Explorer are read-only.

Adding a Portal for ArcGIS data source

Spatial Explorer supports Portal for ArcGIS version 10.7.

To add a Portal for ArcGIS as a data source in Spatial Explorer, the portal administrator must first grant Kingdom access to the portal and provide you with the location of the portal access file, which contains the Kingdom authentication key. You must then configure Spatial Explorer to use the authentication key by clicking Portal Settings on the Settings menu and then browsing to and selecting the authentication key file.

  1. Click Add new data source.
  2. Select Portal for ArcGIS.
  3. From the list, select the address for the portal server you want to use, and then click Connect.
  4. You may be prompted to provide a user name and password, depending on the data source. If the data source is configured to use your Windows credentials, these are obtained automatically.
  5. Select one or more data sources you want to add, and then click Done.

The portal access file

The portal access file contains an authentication key that allows Spatial Explorer to access the ArcGIS portal. This access file is created when the portal administrator grants Kingdom access to the portal. This authentication key must be placed in a .csv file with the following structure: PortalURL, key. The portal administrator needs to place this access file on a shared network location where Kingdom users can access it.

Configuring a Portal for ArcGIS

To add a Portal for ArcGIS as a data source in Spatial Explorer, the portal administrator must first grant Kingdom or Harmony access to the portal and provide you with the location of the portal access file, which contains the Kingdom or Harmony authentication key. You must then configure Spatial Explorer to use the authentication key by clicking Portal Settings on the Settings menu and then browsing to and selecting the authentication key file.

In some cases, you may need to configure the ArcGIS portal for Kingdom or Harmony access and create your own authentication key file. The following steps describe how to do this. Note that these steps may vary slightly due to changes in the ArcGIS portal software.

  1. Using an internet browser, connect to an ArcGIS portal you want to access in Spatial Explorer. You may need to provide credentials to log on.
  2. Click Content, thenMy Content.
  3. Click Add Item and then click An applcation.
  4. Select Application from the list of available types.
  5. In the Title field, type a name for the Kingdom application (for example, Kingdom).
  6. If you want to use them, add one or more tags to help identify the Kingdom application during searches in the Tags field.
  7. Click Add Item.
  8. Click the Settings tab.
  9. Click Registered Info. A list of registration information displays.
  10. Copy the App ID number and paste the number into a text file.
  11. Repeat Steps 1 - 8 for any other ArcGIS portal you want to access. For Step 8, use the same text file for pasting each App ID.
  12. Using the text file where you copied the AppIDs, precede each AppID with the URL of the ArcGIS portal where you obtained the AppID and separate the two items with a comma. For example:
    https://companyserver.internal.corp/arcgis/sharing/rest,AVU2YjGW0asySWvt
    https://companyserver2.internal.corp/arcgis/sharing/rest,iGoqq6uHwJHwCe2E
    https://www.arcgis.com,UUXoNZ9B99OnV27y
  13. Save this file with the extension .csv and place it in a shared network location where other Spatial Explorer users can access it.
  14. From the Spatial Explorer Settings menu, click Portal Settings.
  15. Browse to and select the .csv portal access file, then click OK.

To add access to more ArcGIS portals in the future, follow these steps to update the existing portal access file.

Adding an SDE database

After you add an SDE database as a data source to Spatial Explorer (see How to add a data source), you have the option to update the X and Y boundaries used for spatial queries to ensure any data added from the geodatabase is included in these queries.

  1. Click on the SDE Database data source in the Data Source list.
  2. In the Update Query Bounds for Data window, either type in the new X and Y coordinates you want to use or click Use map current view.
  3. Click OK.

Adding a geodatabase

After you add a geodatabase file as a data source to Spatial Explorer, you have the option to update the X and Y boundaries used for spatial queries to ensure any data added from the geodatabase is included in these queries.

  1. Click on the Geodatabase File or SDE Database data source in the Data Source list.
  2. In the Update Query Bounds for Data window, either type in the new X and Y coordinates you want to use or click Use map current view.
  3. Click OK.

As implemented in Spatial Explorer 2018, you cannot write data to a geodatabase file. They are read-only data sources.

Adding shape files

When you add shape files to Spatial Explorer, you link to them from their original location using the steps provided Click Add new data source..

By default, Spatial Explorer links to shape files without copying them. You can change the default behavior so Spatial Explorer places a copy of any shape files you add in a location you specify.

  1. In the Data Source list, click next to the Shape Files data source.
  2. If you want to change the default path where Spatial Explorer copies shape files, click and then browse to the new location where you want to copy shape files (by default, Spatial Explorer copies them to the project directory).

Now whenever you add shape files to Spatial Explorer, a copy of the shape file is placed in the specified directory. To turn this option off, simply click again.

To remove any shape files you added to Spatial Explorer, click Remove All. If you selected the option to copy shape files to a directory when adding them to your project, removing shape files from the project does not delete the copied files.

Adding an image file (Raster file, .TIF file, .png, .jpg, etc.)

When you add a .TIF file to Spatial Explorer, the application needs to know where to locate the file on the map. To accomplish this, when you add the .TIF file Spatial Explorer opens the Geo Image Navigation window, where you can provide the X and Y coordinates and degree of rotation for the image you are adding. You can type in the coordinates for the four corners of the image, or you can digitize a location on the map (in effect, you are converting the .TIF image into a GEOTIFF file). You also have the option to maintain the aspect ratio of any image you add so it does not become stretched horizontally or vertically. If you need to make adjustments to the size, position, or rotation of a .TIF image after you have added it, click the Display Settings icon for the .TIF layer.

  1. In the Data Source list, select Add new data source.
  2. Select Raster File.
  3. Browse to the image you want to upload. Note that the default setting is .TIF, so you may have to select All Files from the drop-down list.
  4. In the Raster File Coordinates dialog box, either type your X and Y coordinates, or draw a box on the map where you want the image to go. If you draw a box, your X and Y coordinates are automatically populated in the dialog box. Click OK when done.

You can rotate the image by a specified number of degrees to properly align the image. You also have the option to preserve the aspect ratio of the image when you add it to the map to prevent any distortion of the image along the X or Y axes.

Related Topics

Overview

Connecting to IHS Energy Map Services

Selecting and Displaying Layers

Setting Layer Display Properties

Data Layer Icons