ERDAS APOLLO Tutorial: ERDAS IMAGINE Geoprocessing inside ERDAS APOLLO

ii   

 

      iii

ERDAS APOLLO Tutorial: ERDAS IMAGINE Geoprocessing inside ERDAS APOLLO © 2015 Intergraph® Corporation and/or its affiliates. All Rights Reserved. Printed in the United States of America.

The information contained in this document (the “Work”) is the exclusive property of Intergraph Corporation (“Intergraph”). The Work is protected under United States copyright law and other international copyright treaties and conventions, to include the Berne and Geneva Phonograms Conventions, the WIPO Copyright Treaty, and the World Trade Organization.

No part of the Work may be reproduced, stored, or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, or by any information storage or retrieval system, except as expressly permitted in writing by Intergraph. All such requests should be sent to the attention of Manager of Customer Education of the Hexagon Geospatial Division of Intergraph (“Hexagon Geospatial”) at the following address:

Hexagon Geospatial 5051 Peachtree Corners Circle Norcross, Georgia 30092-2500 USA

Phone: 770 / 776-3651 Fax: 770 / 776-3694

Support Services: 800 / 953-6643 Customer Education: 800 / 373-2713 Web: www.hexagongeospatial.com

Warning

The Work, and the software that is the subject of the Work, including icons, graphical symbols, file formats, and audio-visual displays, may be used only as permitted under license from Intergraph; contain confidential and proprietary information of Intergraph and/or third parties which is protected by patent, trademark, copyright and/or trade secret law; and may not be provided or otherwise made available without proper authorization. The Work may not be reproduced in any manner, including for resale or redistribution, without the prior written permission of Intergraph. Use of the software during the training course shall be in accordance with the End User License Agreement ("EULA") delivered with the software. Neither the software nor the software documentation may be reproduced in any manner, without the prior written permission of Intergraph.

About This Manual

The Work is an instructional document designed to be an integral part of the training course offered by Hexagon Geospatial. Hexagon Geospatial believes the information in the Work is accurate as of its publication date. Any specifications cited in the Work are subject to change without notice. The information and the software discussed in the Work are subject to change without notice. Intergraph is not responsible for any errors that may appear in the Work.

Intergraph, the Intergraph logo, ERDAS, ERDAS IMAGINE, IMAGINE Essentials, IMAGINE Advantage, IMAGINE Professional, IMAGINE VirtualGIS, GeoMedia, ImageStation, Video Analyst, Stereo Analyst, TopoMouse, Hexagon Smart M.App, and Power Portfolio are trademarks of Intergraph Corporation. Hexagon and the Hexagon logo are registered trademarks of Hexagon AB or its subsidiaries. Other brands and product names are trademarks of their respective owners.

Acknowledgments

Landsat imagery acquired from the United States Geological Survey (USGS) and distributed by the Land Processes Distributed Active Archive Center (LP DAAC), located at USGS/EROS, Sioux Falls, SD. http://lpdaac.usgs.gov. Questions concerning the use or redistribution of LP DAAC data should be directed to:

LP DAAC User Services USGS Earth Resources Observation and Science (EROS) Center Mundt Federal Building Sioux Falls, SD 57198 Toll Free: 866-573-3222 Telephone: 605-594-6116 Facsimile: 605-594-6963 Email: lpdaac@eos.nasa.gov

   

iv   

 

   

      v

Table of Contents 

Table of Contents ............................................................................................................ v 

This Tutorial ................................................................................................................... vii 

 Publish a Spatial Model to ERDAS APOLLO ................................................... 1 

 Configure and Upload a Spatial Model to an ERDAS APOLLO Instance ....... 3 

 Review and Run a Spatial Model in ERDAS APOLLO .................................. 12 

vi   

      vii

This Tutorial 

Tutorial Objective To instruct ERDAS APOLLO Data Managers / Users on how to publish ERDAS IMAGINE Spatial Models to the ERDAS APOLLO system for general or secured use.

This tutorial is mainly for Data Managers or Administrators who manage an organizations data holdings, however the publishing of models from ERDAS IMAGINE to ERDAS APOLLO can be done by any user who has been given permission to do so.

 Tutorial Data Set The tutorial data size is ~10Mb in size and provided in a ZIP format.

The

 Tutorial Text Conventions There are several conventions used throughout the tutorial:

Menu items are shown as: In the Aaa tab, in the Bbb group, click Ccc.

Dialog box names, field names, and button names are depicted using Bolded Text.

Information to be entered, either by selecting from a list or by typing, is depicted using Italicized Text.

 Tutorial Prerequisites For this tutorial, the user must already be familiar with how to build and structure ERDAS IMAGINE spatial models. Please visit the Hexagon Geospatial eTraining site to view Spatial Modeler eTraining videos. The data provided in this tutorial should be loaded into the ERDAS APOLLO system by a system Data Manager or Administrator. Information concerning the data (metadata, keywords, etc.) to be used by the publication process are included in this tutorial.

viii   

 

Publish a Spatial Model to ERDAS APOLLO 

Section Objective To learn how to use the publish capabilities of the ERDAS IMAGINE Spatial Modeler to upload a model into the ERDAS APOLLO system for use.

 Tools Used  Spatial Modeler  The ERDAS IMAGINE Spatial Modeler allows for the building of a

spatial flow chart that contains operators strung together logically to produce output results. Real-time previews and visual indicators allow you to inspect the model as it runs, easily find and correct errors, and see the results before running the model.  

GeoServices Explorer     The GeoServices Explorer workstation allows for the browsing and discovery of Geospatial entities from a variety of services including Open Geospatial Consortium (OGC), Oracle GeoRaster and ERDAS APOLLO services.

 Data Manager  A light-weight program used to interface with the ERDAS APOLLO

catalog or multiple ERDAS APOLLO catalogs. The management and security of data and spatial models published to the ERDAS APOLLO system is managed with this application.

Geospatial Portal  A HTML JavaScript Web Application which is the Hexagon Geospatial

default Web based portal for spatial data services. The portal enables users to find, view, query, analyze and consume geospatial data and standard ISO/OGC compliant web services.

Text Editor  This can be an editor of choice. The editor is used to create or modify

GIM files that are associated with a dataset. Recommended editor is Notepad++ (https://notepad-plus-plus.org/) which is a free editor which support multiple languages (e.g. XML).

.

2   

 

      3

Configure and Upload a Spatial Model to an ERDAS APOLLO Instance 

Objective:   This exercise will go over how open and configure a spatial model in ERDAS IMAGINE for use in ERDAS APOLLO. Once configured the steps to connect and upload the model to an ERDAS APOLLO instance and cataloged will be explained.

Task 1: Configure Spatial Model for ERDAS APOLLO 

Spatial models created in ERDAS IMAGINE may have to be slightly modified before they can be published and used in ERDAS APOLLO. The inputs used must be parameterize so that the input and output file paths are not embedded in the model components. Operators in the Spatial Modeler are used to chain workflows together for processing inputs to generate outputs. The Raster Input and Raster Output operators used in the model have to have their Port Input operators parameterized. Typically in the desktop workflow environment, the Raster Input and Raster Output Operators specify local paths to input and output files directly. If published to the ERDAS APOLLO server, these models will not be able to be executed for data other than the file paths these were published with.

1. With ERDAS IMAGINE open, select the Toolbox tab and then select the Spatial Model Editor.

2. Close the 2D View (if present) and right-click in the Spatial Model Editor window and select Open.

3. Navigate to the tutorial data and select the res-merge.gmdx file and open it.

4   

NOTE: To learn how to create this model review the eTraining video “Create a Spatial Model in ERDAS IMAGINE”. This eTraining video and others covering the Hexagon Geospatial product line can be found in the Hexagon Geospatial Community web site at: http://community.hexagongeospatial.com/ Look for the eTraining section. The course named above will be under the Spatial Modeler eTraining section. 

4. As can be seen in the model, the Raster Input 1 & 2 as well as the Raster Output have defined image files/names to be used. Double click on Raster Input (1) to open its properties.

5. For the file to be used in the model, click on the File open icon and navigate to the tutorial data and select the vegas-ls8-pan.ecw image

a) This must be done to associate the model with the new location of the data as it differs from the original location when this model was first constructed.

6. Leave the remaining option as they are and click the OK button.

7. Repeat this process for Raster Input 2 (vegas-ls8-msi.ecw) and the Raster Output (vegas-resmerge.img) making sure the output image will be written to an output directory.

8. Once the inputs paths and the output directory has been defined, click the Preview button in the Spatial Modeler tab to run the model and view the data.

      5

Now that the model has been tested and confirmed to produce an output image, it now needs to be modified so that it will work with data inside of the ERDAS APOLLO Catalog once published.

9. In the Spatial Model Editor, select from the Operators section Input Port Port Input. Drag and drop the port next to Raster Input operator. Replicate this process and place a second port next to Raster Input 2 operator.

10. Connect the Port Input 1 operator to the Raster Input operator, replacing the vegas-ls8-msi.ecw file input.

11. Connect the Port Input 2 operator to the Raster Input 2 operator, replacing the vegas-ls8-pan.ecw file input.

12. Double click the Port Input 1 operator; change the name from Port Input 1 to High Res Image. Type in a description that explains what type of image should be selected by the user (optional) then type in one or more keywords (optional). The use of Keywords will allow the model once published in ERDAS APOLLO to search the its catalog for these keywords, pulling back only those datasets that are suited for this particular model.

13. In the Supported Data Types leave the default IMAGINE.File and click the OK button to close the dialog box.

14. Double click the Port Input 2 operator; change the name from Port Input 2 to Low Res Multispec. Type in a description that explains what type of image should be selected by the user (optional) then type in one or more keywords (optional). In the Supported Data Types leave the default IMAGINE.File and click the OK button to close the dialog box.

15. Back in the Operator section of the Spatial Modeler Editor, select Input Port Port Input and drag-n-drop it next to the Raster Output operator.

16. Connect the Port Input 3 operator to the Output Raster filename, replacing vegas-resmerg.img.

17. Double Click on the Port Input 3 operator and change the name to Output and click the OK button

6   

18. Double click the Raster Input operator and in the File Name section, click the X to remove the file name from the Raster Input Properties and click the OK button. Do this also for the Raster Input 2 and Raster Output operators; note that the Raster Output operator has Clear instead of X.

19. Go to the ERDAS IMAGINE File tab, Select the Save As option and then select the Spatial Model As.. Give the model the new name res-merge-apollo.gmdx. Save the file in the tutorial data folder. The model should have all the same components as seen below.

20. Select the Spatial Modeler tab and in the Model section of the tab, click on the Processing Properties.

21. Select the Operator Info tab in the Processing Properties dialog.

22. Leave the Namespace section blank.

23. In the Name section, give the model a unique name, in this instance EAResMerge will be used.

24. In the Display Name section, give the model a ‘user friendly’ name which will make it easy for a user to find and understand. In this instance Resolution Merge will be used.

25. In the Display Category, create a new category for this model to be placed under. In this instance the category Image Enhancement will be used.

26. Leave the Icon (*.ico) section with its default block.ico or blank.

      7

27. The Description section should contain an explanation of what the model is doing as well as any constraints or information the user may need to know prior to selecting data and running the model.

28. Once the information has been added, click the OK to close the Processing Properties dialog box.

29. Click the Save icon in the ERDAS IMAGINE Toolbar or click Ctr+S to save the model.

Task 2: Connect and Upload Model to an ERDAS APOLLO Instance 

Once a model has been modified to work inside an ERDAS APOLLO instance, it must be uploaded from the Spatial Modeler. An existing connection to the instance is needed.

1. Select the Home tab from the ERDAS IMAGINE ribbon bar and click Add Views. Select Create New 2D View; a new 2D viewer will open alongside the Spatial Model Editor window.

2. With the 2D view window activated (click inside the viewer to activate it), go to the File tab in the ERDAS IMAGINE ribbon.

3. Select Open and then select the Web Service.. option. The GeoServices Explorer window will display.

4. Right mouse click on the Catalog Services and select the Add Service… option.

5. In the GeoService Connection Setup, choose ERDAS APOLLO Catalog from the GeoService Type pull down.

8   

6. In the Host Name section, input the URL to the ERDAS APOLLO server the model will be uploaded to.

a) Also include the Username and Password if required. The user logging in must have the correct permission in ERDAS APOLLO in order to publish model. See the ERDAS APOLLO Administration User Guide for more information. b) The default port for ERDAS APOLLO should be 80 or 443 if the instance has an SSL certificate setup.

7. Click on the Test button to confirm that ERDAS IMAGINE can connect to the ERDAS APOLLO instance. If successful a message will display confirming connection capability.

a) Click OK to close the test message window.

8. Click on the OK button in the GeoService Connection Setup to connect to the instance and to close the dialog box. The ERDAS APOLLO server should now be added to the GeoServices Explorer dialog.

9. Close the GeoServices Explorer window, and close the 2D View in ERDAS IMAGINE.

      9

10. In the Spatial Modeler tab, click the Publish to ERDAS APOLLO button.

11. The instance that was set up in the GeoServices Explorer window should be displayed In the Select ERDAS APOLLO Server for Publishing dialog box or available under the pull down menu.

12. Once the server to publish to has been selected, click the OK button to publish the model.

13. Save the Spatial Model and close ERDAS IMAGINE.

10   

Add a Spatial Extent option to the Spatial Model 

By default the model used in Task 1, required that the model execute on the entire dataset. A change to the model can be made so that the user will need to define a rectangular geospatial extent in ERDAS APOLLO for the model to run. The Challenge will go through the steps to add a geospatial extent requirement to the model which will then be used once published to ERDAS APOLLO. 

Task 1: Add Spatial Extent Option 

1. Open ERDAS IMAGINE and open the res-merge-apollo.gmdx model inside the Spatial Modeler Editor.

2. Once opened, go to the File tab then the Save As option. Select the Spatial Model As and input the name res-merge-apollo-extents.gmdx and click the OK button.

a) The Spatial Model Editor window should now display the current working model as res-merge-apollo-extents.gmdx.

3. Select the Raster Input operator for the High Res Image section of the model.

4. Select the Properties option in the View section of the Spatial Modeler tab; if not already selected.

5. In the Properties section, place a check mark in the Show column for the MapBoundary property.

      11

6. In the Operators section, go to Input Port Port Input and drag-n-drop the Port Input operator next to the Raster Input.

7. Connect the Port Input to the MapBoundary port of the Raster Input.

8. Double click on the Port Input; in the Port properties dialog box, type in Model Extent as the name. Ensure that under the Supported Data Types that IMAGINE.Boundary is selected.

9. Click the OK button to close the Port properties.

10. Click on the Processing Properties in the Model section of the Spatial Modeler tab.

11. In the Operator Info tab, change the Name to EAResMergeExtent.

12. Change the Display Name to Res Merge w/Extent.

13. Leave everything else as is and click the OK button to save the changes and close the properties dialog box.

14. Click on the Save icon or do Ctl +S to save the model.

15. Click on the Publish to ERDAS APOLLO in the Model section of the Spatial Modeler.

16. Select the ERDAS APOLLO server instance to publish the model to and click the OK button; the new model with spatial extent requirement is now published to ERDAS APOLLO.

12   

Review and Run a Spatial Model in ERDAS APOLLO 

Once a model has be uploaded the ERDAS APOLLO Administrator or Data Manager(s) can then review the model and set security of the model for use within an organization. The model also needs to be tested inside of the ERDAS APOLLO Geospatial Portal to make sure that it runs and produces output.

Task 1: Review Uploaded Spatial Model in the ERDAS APOLLO Data Manager 

1. Open the ERDAS APOLLO Data Manager and log into the EA instance the model was uploaded to.

2. In the Data Manager Explorer tab, select and open the Processes section.

3. Locate the Image_Enhancement processes and the EAResMerge model should be seen.

4. Select the IMAGINE SMS:IMAGINE.EAResMerge model from the Processes section and examine the information about the model in the Properties tab.

      13

5. Notice that only the Description and Title of the model are the only properties which can be modified. All other information is locked and is populated with the information from the model properties itself when published from ERDAS IMAGINE. To change information in these locked fields, the model properties must be edited in ERDAS IMAGINE, saved and republished to ERDAS APOLLO.

6. Back in the Explorer tab, right-click on the EAResMerge model. Two choices are presented; Delete and Security. Select the Security option.

7. The Security option will open the Process Security dialog box. From here the ERDAS APOLLO Administrator or Data Manager can set the security and assign Users and/or Roles that will allow for the model to run from the ERDAS APOLLO Geospatial Portal. General users only need the Read and Execute permissions set to run models.

8. Click the Cancel button.

14   

Task 2: Select and Run Model in ERDAS APOLLO Geospatial Portal 

Once the models have been uploaded and verified in ERDAS APOLLO, it is time to run them and review the results generated from the ERDAS APOLLO Geospatial Portal.

1. Choose and open an Internet browser (FireFox, Chrome, Internet Explorer, etc.) and open the ERDAS APOLLO Geospatial Portal (http://<server>/apollo-portal).

a) For this example http://demo-apollo.hexagongeospatial.com/apollo-portal will be used.

2. If required, click on the Authentication tab and log into the portal.

a) To follow along this task using this demo server, the login is demo2 with a password of demo456

Two image datasets (vegas-ls8-pan.ecw and vegas-ls8-msi.ecw) are available for this tutorial and can be downloaded from the Hexagon Geospatial Community site where this tutorial is located.  Add these datasets to the ERDAS APOLLO Catalog and add the Keywords LandSat8 to each data set and PAN to the panchromatic dataset and MSI to the multispectral one.  To add the datasets to ERDAS APOLLO, review the ERDAS APOLLO Tutorial: Cataloging Data & Metadata or review the eTraining video Ingesting Data into the ERDAS APOLLO Catalog the Hexagon Geospatial Community web site at: http://community.hexagongeospatial.com/

      15

3. Select the Geoprocessing panel on the left side of the portal, the Image_Enhancement Processes folder created when the model were published should be present along with the model(s).

4. Select the Res_Merge_w/Extent model and click the Select link.

a) If you did not complete the Challenge 1 exercise, select the Resolution_Merge and ignore the steps below pertaining to selecting an area.

5. Once selected a new tab opens in the Geoprocessing panel called Selected; it will display the model name as well as description along with any fields that need to be populated for the model to run.

16   

In this example, the model will require a High Res Image, a Low Res Multispec image as well as a geographic Model Extent defined.

6. The Results panel in the portal will also display two tabs; the tabs represent the required Inputs to run the model.

a) These tabs may or may not be populated with data returns based off the requirements built into the model published such as Keywords which would then search the catalog for specific datasets with the keywords defined in the model properties.

7. In the Input: High Res Image tab, select the record for the PAN image (vegas-ls8-pan.ecw), then using the Add as input… pull down menu, select the High Res Image option.

8. In the Input: Low Res Multispec tab, select the record for the multrispectral image (vegas-ls8-msi.ecw) as the Low Res Multispec image as the input into the model.

9. With one of the inputs selected, click the Add to map option in the Results panel.

10. Next click on the Extents link to zoom to the area of interest where the imagery displays in the portal.

Besides using the information located in the Input tabs, the user can use the Browse ERDAS APOLLO Catalog panel to navigate to datasets, select and use that selection as the input(s) for the model.

      17

11. In the Geoprocessing panel, click the Draw option (if present) to select an area of interest to run the model on.

a) Left click the mouse in the Map window to select an area and then double-click the mouse to end.

12. Once complete the coordinates are placed in the Model Extent section of the models Input Data window.

13. After all the input fields have been populated, click on the Execute option.

14. Click the My Processes tab; this will give the user a status and progress meter showing the progression of the model as it runs. It will also show any errors if there is a problem with the model or inputs.

18   

15. When the model has finished running successfully, the record will turn green. Select the record and click the Show result option.

16. The output image will display in the Results panel under the Output tab. The image is given a generic name and can be added to the Map view or selected and downloaded to the users local machine.

      19

This concludes the ERDAS IMAGINE Geoprocessing in ERDAS APOLLO tutorial. For more information concerning ERDAS APOLLO functionality, please review other course offerings, tutorials, eTraining videos or contact your local Hexagon Geospatial representative.

For general information concerning ERDAS APOLLO or other Hexagon Geospatial products, please email at geospatial@hexagongeospatial.com or visit our website at www.hexagongeospatial.com.