Landsat 8 Image Service

Add-In for ArcGIS

Usage Documentation

19th January 2017

1
 Table of Contents
Feedback Notice .......................................................................................................................................... 3
Overview ....................................................................................................................................................... 3
Installation ..................................................................................................................................................... 4
Add-In Components ...................................................................................................................................... 5
Customization ............................................................................................................................................... 8
Changes and Enhancements ....................................................................................................................... 9
Appendix A .................................................................................................................................................. 10

2
Feedback Notice
This Add-In is intended primarily to work with Esri’s Landsat 8 image services. The Add-In also allows the
user to load other image services, but note that the advanced tools (Supervised Classification, Temporal
Selection, Temporal Profile etc.) will work only with Landsat 8.

Please send feedback to ImageManagementWorkflows@esri.com.

Overview
The Add-In consists of a mixture of buttons and tools grouped together in a toolbar for loading and
manipulating Landsat 8 services from ArcGIS online. Input for this control comes from an XML
configuration file embedded in the add-in. Landsat 8 services are federated and accessing them and the
tools provided by the Add-in requires an ArcGIS online account. Some of the plugin tools can be used
with other services like World Elevation and the non-federated Landsat GLS services.

Raster
Add Layer
Temporal Spectral Supervised
Selection Profile Classification

3
Installation

• Double-click the provided Landsat8Addin_Setup.exe. The setup will run and install the addin.
• To see the installed Add-In details, go to Customize -> Add-In Manager and select Landsat 8
Tools.

• To add the toolbar to ArcMap, go to Customize -> Customize Mode. In the Toolbars tab, select
Image Service Toolbar.

4
Add-In Components

Add Layer

Type: Button

Description: Reads the XML configuration file for a list of available layers and presents a list of Image
Services to add to the active map. Selected layers are added with the properties specified in the
config file.

UI: On clicking the Add Layer button, the following dialog appears.

5
Usage: Multiple layers can be selected from the list and added to ArcMap. The description box shows
the name and description of the last selected layer in the list. If Raster functions are available, they can
be applied after setting appropriate arguments. If any of the selected layers is federated, an ArcGIS
Signon dialog appears to authorize access to those image services.

Temporal Selection

Type: Tool

Description: Lets you make a point or box selection on the active image service layer and lists the
rasters in that selection with corresponding key metadata. You can select images to lock or add as
group layer. Layer name is based on Acquisition Date property.

UI: After making a selection using the tool, the following dialog appears-

Usage: Using the tool make point or drag selections on the active layer. The rasters that fall in that
selection will appear in the above dialog. These features are sorted so that the latest rasters are listed
at the top. Only primary features will be listed. On clicking any item in the list, the corresponding
metadata gets populated in the Raster Dataset Property fields. Double-click to select a feature. The
selected features can be locked or added separately as a new group layer. The Reset button removes
any selections made, reverts the active layer to default mosaic properties and closes the dialog. If
selections still exist and the corresponding dialog was closed, it can be brought back with Ctrl + Click.

6
Spectral Profile

Type: Tool

Description: Displays a graph showing the Spectral/ NDVI/ SAVI/ NDMI properties of the image(s) in
the Active layer, using the pixel values at the current point. The wavelength information for Spectral
Profile is collected from the image service.

UI: On activating the tool, the following dialog pops up to set the Profile type. Temporal feature is
optional for Spectral profile, while NDVI, SAVI and NDMI profiles are always temporal. For SAVI
Profile, L Value parameter can be set.

Usage: Once the Profile mode is set, the user can click anywhere on the Image service to obtain the
profile graph. The clicked point is highlighted with a colored dot, and its corresponding graph is
plotted with the same color for easy identification. The identified pixel values are obtained at the
Pixel Size specified for the service and are then normalized based on the Min-Max values of the
service. They are plotted as ‘Data Value’ on the Y axis for all Profile types. For Spectral Profiles, the X
axis is labelled with the band names, while for all other profiles, it is labelled with the Acquisition
Date. Multiple point information can be plotted on the same graph window for all Profiles except
Temporal Spectral Profile. This enables better visual comparison of properties over different areas.
For Temporal Spectral Profile, the graph window is refreshed for each new point selection, as it plots
graphs for all available rasters at the same point, sorted by the Acquisition date.

Supervised Classification

Type: Button

Description: Enables server-based Maximum Likelihood supervised classification. Takes as input a

shape file to define training areas, transmits it to the server and obtains back a server-generated
supervised classification. (Note this currently works only on the Landsat 8 services)

7
 UI: This tool is only active if the Landsat8 services are selected as an active layer. On activation, the
tool requests user name and password, and requests credentials for your ArcGIS Online account.
(This is a known limitation and related to the requirement to use REST to perform supervised
classification.). It then prompts for the shape file with training areas as well as the Bands to be used
for to compute the classification. This shape file should be created using the draw option on the
Image Classification toolbar that enables the definition of the training areas, class name, value and
color. Once defined, save it as a shape file using the ‘Save training samples’ button from the ‘Training
Sample Manager’ tool. (Note the use of the Classification toolbar requires the Spatial Analyst
Extension). Try and limit the number of vertices being used in the definition of the training areas. I.E.
do not use circles etc. Define the bands to be used for the classification. On pressing OK, the training
samples will be transmitted to the server, which will compute the signatures and then a new layer
will be created with the classification results. These will be applied on the fly as you pan and zoom.
Typically this function is used only with selected rasters. See the Temporal Selection tool.

Raster to Vector
Type : Button

Description : Using this you can export the raster as an vector.

UI: This tool is only active if a layer with the results of Supervised classification is active. It prompts
for the PixelSize, Output Directory Path, and Feature Class name to create. The pixel size is that to be
used for the request to the server. Typically for Landsat8 this is set at 30m.

On pressing OK, the tool will extract from the server a supervised classification result for the current
display extent and convert the raster to polygons and then add the feature class. The resulting
polygon can then be used in other analysis and reports. Note that there is a limit of 4000x4000 pixels
in the size of the extent to be processed. If this limit is exceeded then it is necessary to zoom in and
on a smaller area, or else use a larger pixel size.

Customization

The list of layers displayed when the Add Layer button is used can be customized by overriding the default
list of services. Follow the steps below to create and deploy a customized list of services to display.

Adding Layers to a list:

• From Appendix A at the end of this document copy and paste the sample into a text file called
LSTools_config.xml
• Save the text file and open in a text editor. Preferably an XML Editor.
• Edit the various nodes appropriately.
• Each Layer is defined between <Layer> </Layer> nodes.

Overriding default layer list:

8
 • After creating a new list copy it to Document\ArcGIS folder: C:\Users\<CurrentUser>\My
Documents\ArcGIS\LSTools_Config.xml
• Start ArcGIS and Click on Add Layer.
• You should see the updated list.

NOTE: Open the list in an xml editor first to verify that all nodes are properly closed. If an the
configuration file is not a properly formatted XML file it will not be loaded by the program.

Changes and Enhancements

20th April 2015:

1. Single version for desktop version 10.2.1, 10.2.2, 10.3 and 10.3.1
2. Corrected the scaled values for NDVI SAVI and NDMI profiles.
3. Updated the config file with links to Landsat AWS services.
4. Updated the profile tool to recognize Landsat AWS services.

10th September 2015

1. Removed links to AWS services.

2. Landsat 8 services no longer requires a login.

Know Issues:

1. For Naip services, a login screen pops up when using the supervised classification tool. If the user
clicks cancel it may crash ArcGIS.
2. Bad token or could not generate token error occurs when trying to use the sign in dialog brought
up supervised classification tool.

9
Appendix A

Sample Config file.

<?xml version="1.0" encoding="utf-8"?>

<Layers>
<Layer>
<Name>Landsat8 - SAVI</Name>
<Description>The Soil-Adjusted Vegetation Index (SAVI) is a vegetation index that attempts to
minimize soil brightness influences using a soil-brightness correction factor. This is often used in arid regions
where vegetative cover is low. Values scaled to 200.Return data as LZW compressed so will take longer to return
than
rendered views.</Description>
<URL>http://landsat.arcgis.com/arcgis/services/Landsat8_Views/ImageServer</URL>
<ServerFunction>None</ServerFunction>
<CompatibleRasterFunctions>SAVI</CompatibleRasterFunctions>
<ResamplingMethod>Bilinear Interpolation</ResamplingMethod>
<TransmissionCompression>LZ77</TransmissionCompression>
<TransmissionQuality>95</TransmissionQuality>
<Federated>true</Federated>
<DefaultBandIDs>1</DefaultBandIDs>
</Layer>
<Layer>
<Name>NAIP - Natural Color</Name>
<Description>Natural Color Naip Imagery</Description>
<URL>http://naip.arcgis.com/arcgis/rest/services/NAIP/ImageServer</URL>
<ServerFunction>NaturalColor</ServerFunction>
<CompatibleRasterFunctions></CompatibleRasterFunctions>
<ResamplingMethod>Bilinear Interpolation</ResamplingMethod>
<TransmissionCompression>JPEG</TransmissionCompression>
<TransmissionQuality>85</TransmissionQuality>
<Federated>true</Federated>
<DefaultBandIDs>4,3,2</DefaultBandIDs>
</Layer>
<Functions>
<SAVI>{"rasterFunction" : "BandArithmetic","rasterFunctionArguments" : {"Method" : 0, "BandIndexes" :
"(100.0 *
((B5 - B4)/(B5 + B4 + L))*(1 + L) + 100.0 + 0.5)"}}</SAVI>
<NDVI>{"rasterFunction" : "NDVI", "rasterFunctionArguments" : {"VisibleBandID" : 4, "InfraredBandID" :
5}}</NDVI> <Band_Arithmetic>{"rasterFunction" : "BandArithmetic", "rasterFunctionArguments" : {"Method" : 5,
"BandIndexes" : "5 4"},"outputPixelType" : 9}</Band_Arithmetic>
</Functions>
</Layers>

10
11