19
ERDAS APOLLO Tutorial: Cataloging Business Data
ERDAS APOLLO Tutorial: Cataloging Business Data
ii
iii
ERDAS APOLLO Tutorial: Cataloging Business Data
© 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
Some of the data provided in the Work were procured from the Clark County Nevada GIS Department (http://www.clarkcountynv.gov/depts/ccgis) and Cherokee County, Georgia GIS Department and is provided without warranty or any kind, expressed or implied. Imagery provided courtesy of DigitalGlobe, Longmont CO USA.
iv
v
Table of Contents
Table of Contents ............................................................................................................ v
This Tutorial ................................................................................................................... vii
Catalog Business Data ................................................................................... 1
Cataloging Business Data ............................................................................. 3
vi
vii
This Tutorial
Tutorial Objective To instruct ERDAS APOLLO Data Managers / Users on how to catalog traditionally non-geospatial data such as MS Word documents, MS PowerPoints, Adobe PDF, non-geospatial imagery (JPG, GIF, etc) and enable geospatial capabilities which will allow them to be located during a spatial search of the ERDAS APOLLO Catalog.
This tutorial is mainly for Data Manager or Administrators who manage an organizations data holdings, however the Generic Item Metadata (GIM) file portion of the tutorial can be used by any user in the organization to prepare business data for cataloging in ERDAS APOLLO.
Tutorial Data Set The tutorial data size is ~10Mb in size and provided in a ZIP format.
The Esri FGDB file was provided by the Cherokee Co. Georgia GIS Department for use in demos and training. This data is for instructional use only and neither the Cherokee Co. GIS Department nor Hexagon Geospatial and is provided without warranty or any kind, expressed or implied and should not be used for real analysis or mapping. It is for display only and attribute information has been modified and changed. Other business documents were freely downloaded from Internet sources and are copyrighted by those organization. Other brands and product names are trademarks of their respective owners.
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 the crawling and cataloging of business data, the user must have access to an ERDAS APOLLO server as well as ERDAS APOLLO Data Manager with administrator or data manager privileges. For GIM file creation or modification only access to a text editor is required.
viii
Catalog Business Data
Section Objective To learn how to use the Data Manager to catalog business data than may accompany other geodata types or catalog business data and add geo information to it. This allows business data to be spatially searched with the tools inside the ERDAS APOLLO Portal or other geospatial portals.
Tools Used Data Manager A light-weight program used to interface with the ERDAS APOLLO
catalog or multiple ERDAS APOLLO catalogs.
Data Crawler Allows the organization to schedule or run immediately job process of
adding raster, vector, point cloud or business data to the ERDAS APOLLO catalog.
GIM Files Generic Item Metadata (GIM) files contain geospatial metadata;
projection info, coordinates, etc. These files can be associated with business data to give them more metadata as well as geospatial information which allows for spatial indexing and search capabilities within the ERDAS APOLLO Catalog.
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
Cataloging Business Data
Objective: Even though data placed into the ERDAS APOLLO catalog contains metadata, the information in that metadata can be limited. Additional information can accompany or be added to geodata to enhance the information about a particular feature or layer. For example, working with a fire hydrant layer, additional documentation such as engineering schematics, part lists and photo inspection reports, considered ‘Business Data’ can be placed into the ERDAS APOLLO catalog like other geospatial data, searched and downloaded/viewed.
This exercise will go over how to ingest business data into the catalog keywords and modifying the projection and BBOX information associated with the business data.
Task 1: Adding Business Data to the Catalog
Adding business data to the catalog is the same process as adding images, point clouds and vector data. The organizations data manager conducts a crawling session to ingest the data.
1. Expand the Catalog and select the ROOT folder select Craw File System the Crawler Schedule Wizard dialog will open asking for a directory to crawl.
2. From the EATutorial directory, select the BusinessData folder.
3. Go through the crawling wizard and accept all defaults.
4. Click Finish to start the crawling process.
The BusinessData folder contains an Esri File Geodatabase (Cherokee_Hydrants.gdb) of fire hydrants of Cherokee County Georgia as well as a folder (HydrantDoc) containing PDF documents of fire hydrant schematics and other information and a zip file (HydrantPhotos.zip) containing JPG files as well as Generic Item Metadata (.gim) files associated with the JPG files.
5. Review the data crawled by selecting the Cherokee_Hydrant folder in the Data Explorer tab and selecting the Dataset tab and adding the Fire_Hydrants layer to the map.
6. Select the HydrantDoc aggregate in the Explorer tab and review the data contained within; 6 PDF documents. Notice the default EPSG of 4326.
4
7. Using a ZIP utility, un-zip the HydrantPhoto.zip directory located in the BusinessData folder. The BusinessData folder should now contain a HydrantPhoto folder.
8. Review the contents of the folder and open up one of the GIM files in a text editor.
a) Notice the information contained in the various tags such as name, description, tags, footprint, resource-url and icon-url
9. As in the previous steps, use the Crawling Wizard to catalog the contents of the HydrantPhoto directory.
10. Once crawled review the HydrantPhoto aggregate in the Explorer tab and review the data contained within; 5 JPG documents. Notice the default EPSG of 2240 which was set by the footprint srs in the GIM file.
11. Open an Internet browser and navigate to the ERDAS APOLLO Portal page: http://<serverURL>/apollo-portal. Log into the portal page with the admin/apollo123 credentials.
12. Select “Browse ERDAS APOLLO Catalog” from the side panel and expand the ROOT directory and navigate to the BusinessData HydrantPhotos aggregate.
5
a) Selecting the aggregate will show the aggregate information and what data is in the aggregate in the Results Panel.
13. In the Results Panel, click the Extent values for the HydrantPhotos aggregate which will zoom the Map View to the extent of the data contain within.
a) The individual data entries are represented by a gold star in the Map View.
14. Right mouse click on one of the stars and the Preview pop-up menu will display, click on the hydrant Name/ID and a window will open showing the JPG image of the fire hydrant.
15. Select the to the BusinessData HydrantDocs aggregate; the Results Panel will show the PDF files that were cataloged.
6
16. Select one of the PDF files by clicking on the record in the Results Panel, the left edge of the record will display a red bar.
a) Notice that there are no icons, such as the stars seen with the photos in the Map. The extents of the record is large as well. This is because the PDF has no geospatial information and the extents were inherited from the ROOT folder SRS of EPSG:4326
b) The file thumbnail is also represented by a ‘generic’ data icon that is the default for business data of all types in ERDAS APOLLO.
17. Click on the Download button on the Results Panel bar and the PDF will open.
For this exercise, the data is located in C:\Training\
Adobe Acrobat Reader or other PDF reader / browser plug‐in must be installed on the machine to open the downloaded PDF file used in this exercise.
7
18. Once finished, close all browsers and PDF documents and in Data Manager, select the HydrantDoc aggregate in the Explorer tab; Right click on it and select Delete Aggregate.
19. In a Windows Explorer window, navigate to the \BusinessData\HydrantDocs directory.
20. In this directory there are a number of PDF files and a number of GEM files. Change the extension of the GEM files from gem to gim.
21. Notice that the name of the GIM file is the same as the associated file, including the file extension. The GIM must be named this way for the information inside to be associated with the file in ERDAS APOLLO
a) Example: 10643.pdf and 10643.pdf.gim
22. Open up one of the gim files in a text editor.
23. Review the GIM file. Reopen one of the GIM file for the JPG photos and look at the differences.
The GIM file also contains fields where information such as the Name, Title, Description and Tags or ‘Keywords’ can be added. When ERDAS APOLLO crawls data that contains a GIM file, it uses the information in these fields to populate the catalog. The data can then be searched based on name, or keywords.
Projection information can also be set such as EPSG as well as POINT, LINE or POLY coordinates. This information allows the data to be returned during a spatial search in the ERDAS APOLLO Portal or other applications.
24. Find the icon-url section of the GIM file. In this line you can associate an icon, in this case an Adobe icon, with a file type. In this tutorial, example icons have been provided and are located in the Business-Graphics folder.
a) Change the path presented from <YOUR COMPUTER> to the location on your system where the BusinessData folder is. For example, if your BusinessData tutorial data is on your C: drive the line would be:
8
<icon-url mimeType=”image/png”>C:\BusinessData\Business-Graphics\ADOBE-PDF-icon.png</icon-url>
b) Notice the mimeType is an IMAGE in a PNG format which is the same format the icon is in. If the icon was a JPG, the mimeType would also need to be JPG.
25. The <resource-url> section identifies the application type as well as the file. This allows, in this example, for the 10642.pdf file to be opened by the default application on the users system that reads PDF files. Usually Adobe Reader.
a) If the document was a MS Word file (10642.docx) then the application associated would be “application/doc”.
26. Take time to create a GIM from ‘scratch’ using one of the files provided as a template for one or more of the other documents that do not already have a GIM file associated with them.
a) Leave at least one business document with no GIM file associated for the next task.
Task 2: Using Data Manager to Geo‐Enable Business Data
GIM files are not required to geo-enable business data in ERDAS APOLLO. The ERDAS APOLLO Data Manager can also work with business data to give the data metadata information as well as a geospatial footprint.
1. Recrawl the HydrantDocs folder with the GIM files. There should be at least one document in the folder that does not have a GIM file associated with it.
2. Once the data is added to the catalog, select the HydrantDocs folder in the Explorer tab and review the entries in the Datasets tab.
3. Select one of the entries with the EPSG:2240 SRS and review its information in the Properties tab.
a) Notice that the information (Name, Description, etc.) in the GIM file associated with the document transferred to the catalog.
9
4. Select one of the documents in the Datasets tab that did not have a GIM file associated with it. Notice the EPSG is 4326 and that in the Properties tab, there is limited information associated with the dataset.
5. Just like any dataset inside of Data Manager, information such as an Abstract, Keywords or Title can be entered manually by selecting the appropriate field in inputting the information.
a) The Batch Update option under the Aggregate can also be used to update all the documents in the aggregate in one job, however that process will also modify or remove any information in that was cataloged via a GIM file.
6. In the Properties tab, select the Spatial Extent field in the Statio- Temporal Domain section. An icon with 3 dots will appear on the right side of the record. Click on the icon.
7. The Select Polygon dialog box will appear with a map. Use the Zoom options at the top to navigate to the geographic area of interest to associate with this file. In this case, Cherokee Co. Georgia, around the city of Canton.
8. Since this document applies to many fire hydrants in and around the city of Canton, the Draw tool is selected and a rectangle is placed around the city and outlying area.
10
9. Once complete, the coordinates will show in the bottom portion of the Select Polygon dialog box. Click the OK button to close the dialog box and add the coordinates to the Spatial Extent field.
10. Click the Save icon in the Data Manager toolbar or click off the Properties tab and when prompted, save the changes made.
11. Open up the ERDAS APOLLO Portal and review the HydrantDocs with the new information and associated icons. Select a record and click the Download option to open or download the selected file.
11
This concludes the ERDAS APOLLO Cataloging Business Data 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 [email protected] or visit our website at www.hexagongeospatial.com.
