Contents
Overview of ERDAS APOLLO ...... 5 About Us ...... 13
Catalog Web Interface ...... 15 Logging In ...... 15 Browsing and Searching Content ...... 18 Advanced Search ...... 20 Managing Catalog Records ...... 22 ERDAS APOLLO Catalog REST Interfaces ...... 23 Publishing External Content ...... 33 Testing the CSW Endpoint ...... 34 Administration Options ...... 35
Delivering Data ...... 37 Delivering Map Images with a Web Map Service (WMS) ...... 38 Web Map Service Requests ...... 38 GetLegendGraphic Request ...... 39 WMS HTTP POST Requests ...... 39 WSDL and WMS HTTP SOAP Requests ...... 40 Delivering Image Data with a Web Coverage Service (WCS) ...... 40 Web Coverage Service Requests ...... 41 Requesting a Reference to a Coverage ...... 42 Georeferenced Coverages ...... 43 WSDL and WCS HTTP SOAP Requests ...... 46 Delivering Image and Point Cloud Data with Streaming Services ...... 46 Delivering Vectors/Features with a Web Feature Service (WFS) ...... 48 Web Feature Service Requests ...... 48 WSDL and WFS SOAP Requests ...... 50 OGC Compliant HTTP Request Samples ...... 50
Portraying and Styling Data ...... 53 Style Templates ...... 54 Creating Styles ...... 55 Creating Styles with Properties ...... 56 Creating Styles with SLD ...... 56 Deploying Styles ...... 64 Displaying Statistics in a Map ...... 65 Producing KML...... 67 Limitations ...... 70 Coverage Portrayal Service (CPS) ...... 70 Operational Concept ...... 71 Styled Layer Descriptor (SLD) ...... 72 ERDAS APOLLO Style Editor ...... 85 Starting the ERDAS APOLLO Style Editor ...... 86 Main Window ...... 87
1
Contents
Preferences ...... 89 Managing Projects ...... 90 Data Sources ...... 92 Layers ...... 106 Map Navigation ...... 111 Views ...... 117 Styling Data ...... 120 Managing Styles ...... 121 Scale Range Management ...... 125 Style Rules ...... 126
Business Data in the Catalog ...... 186
Coordinate Reference Systems ...... 191 Coordinate Reference System Engines ...... 191 Passing CRS Parameters in Web Requests ...... 192 Adding a Custom CRS ...... 192 Adding a Custom ERDAS APOLLO Coordinate Reference System ...... 193 Adding a Custom ERDAS IMAGINE Coordinate Reference System ...... 200 Adding a Custom Geospatial SDI Coordinate Reference System ...... 201
Troubleshooting ...... 211 Checking for Unsupported EPSG Code Failures during a WMS Request ...... 211 Checking for Unsupported EPSG Code Failures When Crawling Vector Data ...... 212
Appendix A: Coordinate Reference Systems ...... 215 ERDAS APOLLO CRS Definition ...... 215 CRS Configuration Tags...... 215 CRS Definition Tags ...... 218 ERDAS IMAGINE Projection System ...... 228
Appendix B: Schema and Database Mapping for WFS ...... 239 GML Application Schema and Mapping to Databases ...... 239 Key Concepts ...... 241 GML Application Schema ...... 241 Feature and Feature Type ...... 242 Mapping ...... 242 Feature Schema Configuration ...... 243 Feature Mapping ...... 245 Explicit Mapping Definition Steps ...... 249 SQL Mapping Definition Steps ...... 250 Automatic Mapping Definition Steps ...... 252 Relational (Explicit) Mapping Definition Steps ...... 253 Mapping of Enumerations ...... 267 Control Mapping Correctness ...... 271 Moving to GML3 ...... 271 Set Up an ERDAS APOLLO WFS Serving GML-SF (Simple Feature) ...... 274
2
Contents
Feature Mapping Tags ...... 275 Map Generation Transformer ...... 299 Using MapGen ...... 300 MapGen Tags and Attributes ...... 302 MapGen Tag ...... 302 Feature Properties (Re)definition ...... 302 scaleMin and scaleMax ...... 304 Filter - The "Where" Tag ...... 304 The "Last" Tag ...... 306 Warning: MapGen and Portrayal Rules ...... 307 Scale Dependent Table ...... 307 Protecting Data ...... 308 Disabling Interfaces ...... 308 Hiding Columns ...... 309 Disabling Output Formats ...... 310 Adding a Copyright or a Watermark ...... 310 Schema Generator ...... 311 From-SQL Generator ...... 313 WFS Loader ...... 315
Appendix C: Shapefile RTree Builder ...... 321
Technical Support and Information ...... 323
Index ...... 325
3
Contents
4
S E C T I O N 1 Overview of ERDAS APOLLO
About ERDAS APOLLO ERDAS APOLLO is an enterprise-class, comprehensive data management, analysis, and delivery system enabling an organization to catalog, search, discover, process, and securely disseminate massive volumes of both file-based and web-enabled data. This solution consistently delivers virtually any digital object faster and with less hardware than competing server-based products. An interoperable OGC/ISO-based application that implements an out-of-the-box service-oriented architecture (SOA), ERDAS APOLLO is the solution for data management in the overall Hexagon Geospatial server story. Available in three product tiers, ERDAS APOLLO suits a spectrum of organizations – integrating easily with other geospatial software and offering unparalleled performance even when handling massive data archives and many users. ERDAS APOLLO Essentials is the fastest geospatial image and LIDAR server in the world. A single server with standard hardware can serve terabytes of data to thousands of concurrent users. ERDAS APOLLO Essentials works with your GIS to provide geospatial data as quickly as possible. Examples of ERDAS APOLLO Essentials in action can be seen at http://demo-apollo.hexagongeospatial.com/erdas-apollo/. ERDAS APOLLO Advantage is a comprehensive data management and delivery solution providing remarkable business value. This OGC/ISO standards-based solution can organize, securely manage and disseminate data within databases and also massive volumes of dynamic and static images, point cloud data, terrain, vector data, third party web services, and any digital resource in the enterprise. ERDAS APOLLO Advantage is scalable through clustering to meet an organization’s specific needs, ensuring unprecedented performance even when handling the largest data archives.
ERDAS APOLLO Professional is the most advanced product tier of ERDAS APOLLO. It offers on-the-fly geoprocessing through a powerful implementation of the OGC Web Processing Service (WPS) specification. Users can run an entire model, such as change detection, site analysis, or elevation change, completely contained within a single web processing service (WPS). ERDAS APOLLO Professional is unrivaled in the complexity of algorithms stored under the hood.
5
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Documentation for ERDAS APOLLO The following documents are installed (or are available for installation) with the product, or they are provided on the delivery media:
Document Description
ERDAS APOLLO Installation and This document contains instructions and descriptions for Configuration Guide installing and initially configuring ERDAS APOLLO. This includes pre-installation, system configuration, installation and configuration of applications via Setup Manager, and some manual post installation configuration. Post installation configuration content is limited to configuration activities that only need to be done once or very rarely. All other configuration and administration related content is described in the ERDAS APOLLO Administrator Guide.
ERDAS APOLLO Administrator Guide This document contains instructions and descriptions for configuring and maintaining an ERDAS APOLLO system after the initial installation and configuration. The primary focus of this document is administration of an ERDAS APOLLO server/system. Content related to how to use ERDAS APOLLO to manage data or services is described in either the ERDAS APOLLO Server User Guide or the ERDAS APOLLO Data Manager User Guide.
ERDAS APOLLO Server User Guide This document contains instructions and descriptions for using ERDAS APOLLO tools, utilities and applications to manage data and services. This document covers all aspects of using ERDAS APOLLO except for ERDAS APOLLO Data Manager which has its own dedicated User Guide. The ERDAS APOLLO Server User Guide includes documentation for foundational concepts such as web services, OGC services, data formats and coordinate references systems. It also as includes documentation for using the ERDAS APOLLO Catalog Web Interface, the ERDAS APOLLO Streaming Test Page and the ERDAS APOLLO Style Editor.
ERDAS APOLLO Data Manager User This document contains instructions and descriptions for Guide using ERDAS APOLLO Data Manager. ERDAS APOLLO Data Manager is designed to be the primary day to day user interface for managing data and services in ERDAS APOLLO.
6
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
ERDAS APOLLO Supported A PDF file that lists the supported software configurations Environments (required and optional) for the product.
ERDAS APOLLO Release Notes A PDF file that lists the enhancements for the current release.
ERDAS APOLLO Issues Resolved A PDF file that lists the product defects that have been fixed for the current release.
The current versions of the Supported Environments, Release Notes, and Issues Resolved documents are available on the Contact Support https://sgisupport.intergraph.com/infocenter/index?page=contact_support page. They can also be accessed via links on the Intergraph Setup Manager dialog.
ERDAS APOLLO Welcome Page After installing and configuring ERDAS APOLLO open the ERDAS APOLLO Welcome Page in a web browser. The default URL of the ERDAS APOLLO welcome page is: http://
7
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
See the ERDAS APOLLO Advantage/Professional Installation and Configuration Guide for complete instructions on installing and configuring ERDAS APOLLO.
From this web page, you can access many ERDAS APOLLO tools and documents. In addition, links to certain tools and documents for ERDAS APOLLO Essentials and Geospatial Portal are also included.
8
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
See the Geospatial Portal User Guide or the Geospatial Portal Administrator Guide for detailed information using Geospatial Portal.
9
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Copyright © 2007 - 2014 Intergraph® Corporation and/or its affiliates. All Rights Reserved. Warning: This computer program, including software, icons, graphical symbols, file formats, and audio-visual displays; may be used only as permitted under the applicable software license agreement; contains 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. Restricted Rights Legend Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c) (1) and (2) of Commercial Computer Software -- Restricted Rights at 48 CFR 52.227-19, as applicable. Unpublished - rights reserved under the copyright laws of the United States. Intergraph Corporation P.O. Box 240000 Huntsville, AL 35813 Terms of Use Use of this software product is subject to the End User License Agreement ("EULA") delivered with this software product unless the licensee has a valid signed license for this software product with Intergraph Corporation. If the licensee has a valid signed license for this software product with Intergraph Corporation, the valid signed license shall take precedence and govern the use of this software product. Subject to the terms contained within the applicable license agreement, Intergraph Corporation gives licensee permission to print a reasonable number of copies of the documentation as defined in the applicable license agreement and delivered with the software product for licensee's internal, non-commercial use. The documentation may not be printed for resale or redistribution. Warranties and Disclaimers All warranties given by Intergraph Corporation about software are set forth in the EULA provided with the software or with the applicable license for the software product signed by Intergraph Corporation, and nothing stated in, or implied by, this document or its contents shall be considered or deemed a modification or amendment of such warranties. Intergraph and its suppliers believe the information in this publication is accurate as of its publication date. The information and the software discussed in this document are subject to change without notice and are subject to applicable technical product descriptions. Intergraph Corporation and its suppliers are not responsible for any error that may appear in this document. Trademarks Intergraph, the Intergraph logo, and GeoMedia are registered trademarks of Intergraph Corporation. Hexagon and the Hexagon logo are registered trademarks of Hexagon AB or it subsidiaries. Microsoft and Windows are registered trademarks of Microsoft Corporation. Bing is a trademark of Microsoft Corporation. Google Maps is a trademark of Google Incorporated. Pictometry Intelligent Images is a registered trademark of Pictometry International Corporation. ERDAS, ERDAS IMAGINE, Stereo Analyst, IMAGINE Essentials, IMAGINE Advantage, IMAGINE Professional, IMAGINE VirtualGIS, Mapcomposer, Viewfinder, Imagizer, LPS, and ERDAS APOLLO are registered trademarks and exclusive property of Intergraph Corporation. Other brands and product names are trademarks of their respective owners. Government Reserved Rights. MrSID technology incorporated in the Software was developed in part through a project at the Los Alamos National Laboratory, funded by the U.S. Government, managed under contract by the University of California (University), and is under exclusive commercial license to LizardTech, Inc. It is used under license from LizardTech. MrSID is protected by U.S. Patent No. 5,710,835. Foreign patents pending. The U.S. Government and the University have reserved rights in MrSID technology, including without limitation: (a) The U.S. Government has a non-exclusive, nontransferable, irrevocable, paid-up license to practice or have practiced throughout the world, for or on behalf of the United States, inventions covered by U.S. Patent No. 5,710,835 and has other rights under 35 U.S.C. § 200-212 and applicable implementing regulations; (b) If LizardTech's rights in the MrSID Technology terminate during the term of this Agreement, you may continue to use the Software. Any provisions of this license which could reasonably be deemed to do so would then protect the University and/or the U.S. Government; and (c) The University has no
10
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
obligation to furnish any know-how, technical assistance, or technical data to users of MrSID software and makes no warranty or representation as to the validity of U.S. Patent 5,710,835 nor that the MrSID Software will not infringe any patent or other proprietary right. For further information about these provisions, contact LizardTech, 1008 Western Ave., Suite 200, Seattle, WA 98104. Portions of the user interface copyright 2013 Telerik AD.
11
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
12
About Us Hexagon Geospatial helps you make sense of the dynamically changing world. Hexagon Geospatial provides the software products and platforms to a large variety of customers through direct sales, channel partners, and Hexagon businesses, including the underlying geospatial technology to drive Intergraph Security, Government & Infrastructure (SG&I) industry solutions. Hexagon Geospatial is a division of Intergraph Corporation. CUSTOMERS. Globally, a wide variety of organizations rely on our products daily including local, state and national mapping agencies, transportation departments, defense organizations, engineering and utility companies and businesses serving agriculture and natural resource needs. Our portfolio enables these organizations to holistically understand change and use information to make mission and business-critical decisions. TECHNOLOGY. Our priority is to deliver products and solutions that make our customers successful. Hexagon Geospatial is focused on developing leading-edge technology that is easily configurable. Through extensible, scalable and collaborative products, we enable you to transform multi-source content into dynamic and actionable information. We are constantly re-conceptualizing and improving our products. PARTNERS. As an organization, we are partner-focused, working alongside our channel to ensure we succeed together. We provide the right tools, products and support to our business partners so that they may successfully deliver sophisticated solutions for their customers. We recognize that we greatly extend our reach and influence by cultivating channel partner relationships both inside and outside of Hexagon. TEAM. As an employer, we recognize that the success of our business is the result of our highly motivated and collaborative staff. At Hexagon Geospatial, we celebrate a diverse set of people and talents; and we respect people for who they are and the wealth of knowledge they bring to the table. We retain talent by fostering individual development and ensuring frequent opportunities to learn and grow. HEXAGON. Hexagon Geospatial plays a key role in Hexagon’s multi-industry focus, leveraging the entire portfolio for a wide variety of geospatial needs. Hexagon is a leading global provider of design, measurement and visualization technologies. Synergistic thinking is encouraged across all levels and functions at Hexagon companies, so that we all respond better and faster to our shared customer’s needs. For more information, visit www.hexagongeospatial.com (http://www.hexagongeospatial.com) and www.hexagon.com (http://www.hexagon.com).
13
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
14
S E C T I O N 2 Catalog Web Interface The Catalog Web Interface is a web application that allows you to search, browse and publish the data in your catalog. It also offers administration tools for the catalog service. For authenticated users, the Catalog Web Interface includes a page to aid in creating and submitting Catalog Service Web (CSW) requests. This page uses ERDAS APOLLO's implementation of the CSW-ebRIM profile for searching your ERDAS APOLLO catalog and delivering metadata describing catalog holdings. Finally, the ERDAS APOLLO catalog exposes its object model as a RESTful set of resources, with each resource type having its own dedicated URL endpoint. You can initiate the Catalog Web Interface by typing the following address in any web browser: http://
In This Section Logging In ...... 15 Browsing and Searching Content...... 18 Publishing External Content ...... 33 Testing the CSW Endpoint ...... 34 Administration Options ...... 35
Logging In You can search for and browse the public data in the ERDAS APOLLO catalog without logging in. In order to view private data, publish data, or use the administration tools you must log in with a user name and password. To do so, select the Login button in the upper right corner of the page.
15
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Logging in as the default data manager, dm, (or as any user that has been granted the data manager role), will enable the Publish link and allow you to Publish content.
16
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Logging in as the default administrator, admin, (or as any user that has been granted the admin role), will enable the Publish, CSW, JSON and Admin links.
17
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Browsing and Searching Content Select the Browse link to browse the contents of your ERDAS APOLLO Catalog.
Filter By Data Type The drop-down data type filter allows you to filter your search based on specific data types. The data types filters are:
Aggregates - Return only aggregates of datasets
Documents - Return only business documents
Image Datasets - Return only image datasets
Point Cloud Datasets - Return only point cloud datasets
Vector Datasets - Return only vector of datasets
18
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Datasets - Return only datasets (image, point cloud, vector or documents)
Processes - Return only Web Processing Services (WPS)
Services - Return only data services (WCS, WFS or WMS)
Coverage Services - Return only Web Coverage Services (WCS)
Coverage Layers - Return only layers contained in Web Coverage Services (WCS layers)
Vector Services - Return only Web Feature Services (WFS)
Vector Layers - Return only layers contained in Web Feature Services (WFS layers)
Map Services - Return only Web Map Services (WMS)
Map Layers - Return only layers contained in Web Map Services (WMS layers)
To remove the data type filter from your search, select the data type filter drop-down and use the up arrow on your keyboard until the field displays -CHOOSE DATA TYPE-.
Filter By Keyword The keyword filter allows you to filter your search based on keywords and keyword patterns. The keyword patterns are compared against the names, descriptions and tags associated with the holdings in your catalog. Keyword searches can be combined using the following operators:
Operator Description Example
AND Logical AND between two keywords. road AND Atlanta
OR Logical OR between two keywords. road OR Atlanta
() Logical Group surrounding keywords. (road OR Atlanta) AND city
The logical AND and OR operators must be entered in upper case.
Topics Advanced Search ...... 20 Managing Catalog Records ...... 22 ERDAS APOLLO Catalog REST Interfaces ...... 23
19
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Advanced Search The Advanced Search panel can be opened by clicking on the arrow on the left edge of the Browse panel. This panel offers sorting options and a tree view of the object types available in the ERDAS APOLLO Catalog.
Single-clicking on an object type will search for records of that type.
Category objects can be multi-selected by pressing the CTRL key and then selecting one or more category objects.
20
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Double-clicking on an object type will display the definition of the object type.
21
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Managing Catalog Records If you are logged in as an authorized user, additional catalog record management links may be displayed for each object in the search result panel. An authorized user is either the user that originally published the object or any user that has been granted the admin role.
22
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Delete The Delete link will delete the object from your ERDAS APOLLO catalog.
Reharvest The Reharvest link will update the catalog metadata of a service object as well as the metadata of the layers associated to the service. Only service objects (Web Coverage Service, Web Feature Service and Web Map Service) support the Reharvest command. Reharvest makes it easy to update the ERDAS APOLLO catalog when layers are added to or deleted from a service or if the metadata associated with the service or one of its layers has changed.
View Default The View Default link will display the default document associated with the object. The data returned by this command depends upon the type of the object. For example, service objects (WCS, WFS and WMS) will return a GetCapabilities document. Dataset and layer objects will return a default metadata document. Process objects will return a process description document. Business objects will generally return the document itself.
ERDAS APOLLO Catalog REST Interfaces The ERDAS APOLLO Catalog exposes its object model as a RESTful set of resources, such that each resource type has a dedicated URL endpoint. REST is subject to an ongoing debate to define exactly what it is or isn't, and many REST-related concepts and questions are still looking for a clear answer. The following sections are not intended to define REST, but rather describe the REST architecture as it is pertains to ERDAS APOLLO.
Topics REST Background ...... 23 ERDAS APOLLO REST Endpoints ...... 25
REST Background REST, meaning "REpresentational State Transfer", is a style of software architecture for distributed hypermedia systems such as the World Wide Web. REST strictly refers to a collection of network architecture principles which outline how resources are defined and addressed. Systems which follow REST principles are often referred to as "RESTful".
See Chapter 5 of Roy Fielding's 2000 doctoral dissertation from the University of California, Irvine, "Representational State Transfer (REST)": http://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm The following terms are used in the description of the ERDAS Apollo architecture and its implementation of REST:
23
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Resource Oriented Architecture (ROA): A software service architecture type that is resource-centric, as opposed to Remote Procedure Call (RPC) architecture that is process-centric.
REST: REpresentational State Transfer, as defined in Fielding's dissertation. We consider REST as being an instance of ROA relying on the HTTP protocol; this is important as the term REST as it is used here will always refer to the HTTP implementation of an ROA.
Uniform Resource Identifiers (URI): Resources in an ROA must be identifiable by unique and static IDs. In REST these IDs are URIs that can be used to directly access the resource or to link to it in another resource representation.
Representation: Resources are decoupled from their representations. A URI uniquely identifies a resource on the server, but the client interacts with the server using representations of resources. In a REST architecture, the representations are described by mime types.
Hyperlinking: Representations of resources must express links between resources using hypermedia links. In a REST architecture, the URIs of resources are used as hyperlinks.
RESTful systems have these characteristics:
Each resource is published as a static URI, with an ID
CRUD operations (Create, Read, Update, Delete) on resources are supported using the standard HTTP commands (GET, POST, PUT, DELETE)
Multiple representations (or encodings) of resources are supported, often by using a URI extension pattern
Resources are linked using their URIs
HTTP headers are used to perform content type negotiation
In the scope of the ERDAS APOLLO catalog, a REST interface has been developed using the restlet framework (restlet.org). This REST approach enables the catalog to be easily accessible from web-based clients such as browsers.
REST Examples for APOLLO The following examples illustrate how these REST concepts apply to ERDAS APOLLO:
Issuing a GET request on items will return a list of all the items in the catalog:
http://
Issuing a GET request on services will return a list of all the services in the catalog:
24
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
http://
A single item with id 'abc' can be accessed directly at its URL:
http://
Alternate encodings can be obtained by appending the desired extension. For example, a GET request of services.json will return a JSON encoded list of all the services in the catalog:
http://
REST URLs can be augmented with filtering parameters. The following request filters the result based on keyword and bounding box and also limits the number of returned results:
http://
A new service can be published by issuing a POST request of its URL to:
http://
ERDAS APOLLO REST Endpoints The REST interface base URL of the ERDAS APOLLO Catalog is: http://
Endpoint Description
/items Query all catalog items
/aggregates Query only aggregates of datasets
/datasets Query only datasets (image, point cloud, vector or document)
/datasets/generic Query only business documents
/datasets/images Query only image datasets
/datasets/pointclouds Query only point cloud datasets
/datasets/vectors Query only vector datasets
25
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Endpoint Description
/services Query only data services (WCS, WFS or WMS)
/services/wcs Query only Web Coverage Services (WCS)
/services/wcs/resources Query only layers contained in Web Coverage Services (WCS)
/services/wfs Query only Web Feature Services (WFS)
/services/wfs/resources Query only layers contained in Web Feature Services (WFS)
/services/wms Query only Web Map Services (WMS)
/services/wms/resources Query only layers contained in Web Map Services (WMS)
/processes Query only Web Processing Services (WPS)
Issuing a HTTP GET request to any of those URLs will return a list of corresponding objects, with no filtering applied, with default paging settings, and where the encoding is chosen as explained in the Result Encodings (see "Result Representations/Encodings" on page 30) section below. It must be noted that the first endpoint (/items) is the main endpoint to retrieve any catalog object. Other endpoints are convenient ways to subset the result set by object types. Also, some specific operations described further are available only on specific endpoints. For example, publishing a service can only be done by POSTing to a /service endpoint.
Topics Querying and Filtering ...... 26 Result Representations/Encodings ...... 30 JSON Model...... 31
Querying and Filtering
Accessing a Single Object Any of the ERDAS APOLLO REST endpoints can be appended with the id of an object, thereby providing a way to obtain a single object. For example a specific service can be accessed by referencing: http://
26
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
http://
http://
http://
REST Query Parameters In addition to querying for specific IDs, the ERDAS APOLLO REST endpoints support various other querying parameters. These parameters allow for filtering, ordering and paging of results. Some parameters are only available for specific object types.
Parameter Name Value Type Supported By Description keywords space separated set of All object types Performs a search in the catalog and tries to match string keywords the given keywords against the name, title or tags of the catalog items. defaults to none orderby name of an object All object types Return the results ordered according to the given attribute attribute name. The attribute must be a valid attribute for the object type being queried. defaults to none Use asc for ascending and desc for descending. start integer All object types Paging parameter - specifies the start index for the objects to return. defaults to 0 maxresults integer All object types Paging parameter - specifies the maximum number of results to return. defaults to 10 intersect a WKT-encoded FeatureType, Performs filtering using a spatial intersection. geometry MapLayer,
OgcCoverage defaults to none inurl part of a domain name OGCWebService, Performs filtering on the content of the online WebCoverageService resource URL, if any. , WebFeatureService, WebMapServeric,
27
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Parameter Name Value Type Supported By Description FeatureType, MapLayer, OgcCoverage
Examples:
http://
http://
http://
Use an ampersand, &, to separate multiple query parameters.
http://
http://
Advanced Querying in JSON Complex queries can be submitted to the service on a dedicated search.json endpoint. Those queries are expressed in JSON, and must be sent using HTTP POST on the /content/catalog/search.json endpoint.
28
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Examples of such queries can be found on the JSON Test page.
OpenSearch The OpenSearch specification defines a description language to describe web search engines. The OpenSearch Geo extension defines an extra set of spatial filtering parameters. Offering an OpenSearch description identifies a web service as being a web search engine; OpenSearch clients such as today's browsers recognize it and can add that service in their list of search engines. The ERDAS Apollo Catalog offers such an OpenSearch Geo description. It is published in the head section of any HTML page of the catalog.
29
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Result Representations/Encodings Representation formats are identified with mime types. When querying, the format of a resource is determined using HTTP content negotiation represented by the HTTP Accept header. Any HTTP client can use that header to specify a set of accepted mime types. The server will then choose the best available mime type, produce that representation and set the Content-Type response header to specify what mime type was chosen for the representation. For instance, a typical web browser may issue GET requests like this: GET http://example.com/rest/items/1234 HTTP/1.1 Accept: text/html,application/xml Such a request means that the client prefers text/html, but can also accept application/xml. The content negotiation can be overridden by appending a format extension to the URI. For example, the following resource: http://
Encoding URL Extension Description
HTML .html Using this encoding, results are encoded using an HTML template defined on the server, ready to be displayed in a standard HTML browser. It must be noted that the ERDAS APOLLO Catalog Web client is actually the HTML encoding of the REST interface.
Plain Text .txt This encoding is more of a debugging feature, to get a quick and simple display of the results. In particular, this encoding can be useful to output the URLs of the service currently stored in the catalog, for a quick backup or transfer, using a URL like: http://
JSON .json This encoding returns the set of results encoded in JSON, and ready to be interpreted in a JavaScript environment. This is especially useful to build lightweight JavaScript applications that can run in a browser and can access the catalog data without the need for a server-side middle-tier. JSON types are named after their Java counterparts, using qualified
30
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Encoding URL Extension Description class names such as com.erdas.rsp.babel.model.CatalogItem. See JSON Model (on page 31) for more details.
GeoRSS .atom Using this encoding, the results will be returned as a RSS feed, following the GeoRSS specification that defines ways to add location tags to RSS entries. This can be useful to be notified of the latest services harvested, by subscribing to the following feed: http://
KML .kml The KML encoding returns the set results encoded using OGC KML encoding, following the ML 2.2 specification. Results are encoded using their spatial extent when available; furthermore, if results are MapLayers, the KML document will contain special overlays that allow you to display the original data from the service directly in a KML browser (like Google Earth).
Any REST query can be retrieved in any of the encodings. The encoding is specified by adding the corresponding extension to the URL, before the query parameters. For example, the following is a request for all services containing the keyword hydro, returned in a JSON representation:
http://
JSON Model The JSON model is exposed as a set of resources, under the REST path /content/catalog/mappings, using this URL pattern: http://
31
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The entire model can be browsed either by browsing through the HTML representation, or by double clicking a subnode of the "Catalog Objects" tree in the Advanced Search (on page 20) panel.
JSON Reflection The JSON object model is also available, encoded in JSON, by appending the .json extension, thereby allowing reflection. For example, you can display the full JSON encoding for OgcWebService with the following URL: http://
Profiles Profiles allow you to request views that contain only a subset of the data. Using profiles is a means of optimization and performance tuning. You can select a profile by including the profile specification at the end of your JSON request: http://
32
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Publishing External Content Select the the Publish link on the Catalog Web Interface to register external service providers and geospatial processes in the ERDAS APOLLO Catalog.
To publish an external service in the ERDAS APOLLO Catalog: 1. Select a resource type in the Select Resource Type drop-down box. The options are:
W*S
WFS
WMS
WCS
WPS
If you know the type of service that you want to publish, select it as the resource type. If you are not sure of the service type, select W*S and ERDAS APOLLO will try to determine the service type by issuing a GetCapabilities request to the URL. 2. Key in the URL of the service that you want to publish. 3. Click the Publish button (to the right of the URL field). The current user is considered the owner of data published this way. This means that only this user or users granted the admin role will be allowed to delete or reharvest the service.
33
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Testing the CSW Endpoint Select the CSW link on the Catalog Web Interface to submit Catalog Service Web (CSW) requests.
This page uses ERDAS APOLLO's implementation of the CSW-ebRIM profile for searching your ERDAS APOLLO catalog and delivering metadata describing catalog holdings. The left panel contains the CSW-ebRIM request and the right panel contains the response to the posted request.
34
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Select one of the Sample CSW requests to populate the request in the left panel. You can submit the sample request as it is written or you can modify it in the left panel. Select Post request. The request will be sent to the server, and the response from the server will be displayed in the right panel. In the upper right of the page, a panel indicates the status of the CSW endpoint. The panel also contains buttons that allow you to Restart the CSW service, issue a GetCapabilities request or Refresh the service by flushing its cache. Note that the CSW endpoint will start automatically on demand; this status and button are for debug purposes only, to force a restart and a cache flush of the CSW stack. You may need to refresh the entire page to force the CSW Status field to update from Not Started to Running.
Administration Options Select the Admin link on the Catalog Web Interface to access database administration utilities for the ERDAS APOLLO catalog.
The Welcome panel at the top of the page identifies your login as well as all of the roles your login has been granted.
Re-index keywords: This command regenerates the keyword index of the Apache Lucene™ Core used by the ERDAS APOLLO catalog. You may need to do this if you move your ERDAS APOLLO catalog database to a new server.
Apache Lucene is an open source library that provides high performance full-featured text search.
35
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Flush 2nd level cache: ERDAS APOLLO uses Hibernate to facilitate persisting data to the ERDAS APOLLO catalog. The Hibernate 2nd level cache improves data access performance by caching data so that repeated requests for the same data do not necessitate repeated database accesses. This command allows you to flush this cache. Using this command is only necessary in the rare instance when a process other than the ERDAS APOLLO server modifies the contents of the ERDAS APOLLO catalog database.
Visit http:\hibernate.org to learn more about Hibernate ORM. Manage DB schemas: This command opens a page that lists the currently installed database schema(s) and their version(s). If the current database schema is not in sync with the ERDAS APOLLO software version, this page allows you to run the upgrade process.
36
S E C T I O N 3 Delivering Data ERDAS APOLLO facilitates delivering your data to web clients in multiple ways.
Image Delivery via OGC Compliant Services Web Map Service (WMS) – Deliver portrayed GIS-ready and web-client-consumable styled map data to any OGC WMS client application such as ERDAS IMAGINE, GeoMedia, Geospatial Portal, AutoCAD, ArcGIS, Google Earth, or other custom applications.
Web Map Tile Service (WMTS) – Deliver portrayed GIS-ready and web-client-consumable tiles to any OGC WMTS client application; easily create mashups with OpenLayers and Google Maps.
Web Coverage Service (WCS) – Deliver raw pixel data of any supported imagery format and type to OGC imagery exploitation clients as an interoperable coverage.
Image Delivery via Streaming Protocols ECWP – Deliver ECW and JP2 wavelet-compressed imagery through ECWP protocol (ecwp://) to ECWP clients such as Geospatial Portal, ERDAS IMAGINE, AutoCAD or ArcGIS.
JPIP – Deliver JP2 wavelet-compressed imagery through the JPIP protocol (jpip://) to JPIP-compliant clients.
Vector/Feature Delivery via OGC Compliant Services Web Feature Service (WFS/WFS-T) – Deliver portrayed GIS-ready and web-client-consumable vectors/features to any OGC WFS client application. Publish, insert, delete and update vector data geometry and attributes using a Transactional Web Feature Service (WFS-T).
The following sections describe how you can publish and deliver your catalog holdings.
In This Section Delivering Map Images with a Web Map Service (WMS) ...... 38 Delivering Image Data with a Web Coverage Service (WCS) ...... 40 Delivering Image and Point Cloud Data with Streaming Services. 46 Delivering Vectors/Features with a Web Feature Service (WFS) . 48 OGC Compliant HTTP Request Samples ...... 50
37
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Delivering Map Images with a Web Map Service (WMS) The Web Map Service (WMS) is an interface standard defined by the Open Geospatial Consortium (OGC). The OGC defines it this way: The OpenGIS® Web Map Service Interface Standard (WMS) provides a simple HTTP interface for requesting geo-registered map images from one or more distributed geospatial databases. A WMS request defines the geographic layer(s) and area of interest to be processed. The response to the request is one or more geo-registered map images (returned as JPEG, PNG, etc) that can be displayed in a browser application. The interface also supports the ability to specify whether the returned images should be transparent so that layers from multiple servers can be combined or not. Visit http://www.opengeospatial.org/ to learn more about the OGC. Visit http://www.opengeospatial.org/standards/wms to learn more about the WMS standard. ERDAS APOLLO supports two versions of the OGC-WMS standard: WMS 1.1.1, and WMS 1.3.0 (also approved as ISO 19128). Each has a different syntax. Complete documentation for both standards can be found on the OGC website: Web Map Service Implementation Specification, Version 1.1.1 Open GIS Web Map Server Implementation Specification, Version 1.3.0
Topics Web Map Service Requests ...... 38 GetLegendGraphic Request ...... 39 WMS HTTP POST Requests ...... 39 WSDL and WMS HTTP SOAP Requests ...... 40
Web Map Service Requests Both supported versions of the WMS standard (1.1.1 and 1.3.0) define the same three operations (or requests): GetCapabilities, GetMap and GetFeatureInfo. The following descriptions for each of these operations are taken from the 1.3.0 version of the Open GIS Web Map Server Implementation Specification. Detailed documentation of these operations is beyond the scope of this document. The most accurate and up-to-date documentation for using OGC services can always be found on the OGC website and in the standard documents referenced above.
38
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
GetCapabilities The purpose of the mandatory GetCapabilities operation is to obtain service metadata, which is a machine readable (and human-readable) description of the server’s information content and acceptable request parameter values. See sections 7.1 Web Map Service Implementation Specification, Version 1.1.1 or section 7.2 Open GIS Web Map Server Implementation Specification, Version 1.3.0 for details on calling GetCapabilities.
GetMap The GetMap operation returns a map. See sections 7.2 Web Map Service Implementation Specification, Version 1.1.1 or section 7.3 Open GIS Web Map Server Implementation Specification, Version 1.3.0 for details on calling GetMap.
GetFeatureInfo The GetFeatureInfo operation provides clients of a WMS with more information about features in the pictures of maps that were returned by previous Map requests. See sections 7.3 Web Map Service Implementation Specification, Version 1.1.1 or section 7.4Open GIS Web Map Server Implementation Specification, Version 1.3.0 for details on calling GetFeatureInfo.
GetLegendGraphic Request The GetLegendGraphic request is described as part of the OGC-SLD 1.1 standard (05-078r3 - SLD Profile of WMS).
Styled Layer Descriptor profile of the Web Map Service Implementation Specification The following description is from the document: GetLegendGraphic: The GetLegendGraphic operation itself is optional for an SLD-enabled WMS. It provides a general mechanism for acquiring legend symbols, beyond the LegendURL reference of WMS Capabilities. See sections 10.2 in the Styled Layer Descriptor profile of the Web Map Service Implementation Specification for details on calling GetLegendGraphic.
WMS HTTP POST Requests The ERDAS APOLLO WMS services support HTTP requests using HTTP-GET and HTTP-POST. An OGC project document (Ref: 02-017r1 - Web Map Service Implementation Specification - Part 2: XML for Requests Using HTTP POST) describes the structure and encoding for WMS POST requests.
39
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Web Map Service Implementation Specification -- Part 2: XML for Requests using HTTP POST The greatest benefit of HTTP-POST versus HTTP GET is realized in the GetMap operation, where the comma-separated list of layer names in HTTP GET can be replaced by a sequence of XML elements, each of which is either a named layer or a user-defined layer, and directly associates style and filter information within each layer. The GetFeatureInfo operation, which includes most of a GetMap request, benefits the user in a similar way. The OGC document presents the XML schema for the GetCapabilities, GetMap and GetFeatureInfo requests. The OGC proposal references an optional
WSDL and WMS HTTP SOAP Requests A Web Service Description Language (WSDL) document provides a formalized description of the services and facilitates recording of the service(s) in a UDDI registry, such as a Systinet Registry. Once registered, the service can be invoked using the Simple Object Access Protocol (SOAP). ERDAS APOLLO supports one of the OGC candidate WSDL solutions, by using a request=getWSDL request type. The syntax is similar to a classical HTTP-GET GetCapabilities request, except that the request name is "getWSDL" and an optional "SoapOnly" parameter is allowed. Note that the "Service" parameter will determine the nature of the output WSDL, as each service type (WMS, WFS, WCS) has a different WSDL description. The following is an example of a GetWSDL request: http://localhost:80/erdas-apollo/coverage/ATLANTA_MOSAIC?version=1.1 .1&service=WMS&request=getWSDL&SoapOnly=true
Delivering Image Data with a Web Coverage Service (WCS) The Web Coverage Service (WCS) is an interface standard defined by the Open Geospatial Consortium (OGC). The OGC defines it this way: The Web Coverage Service (WCS) supports electronic interchange of geospatial data as "coverages" – that is, digital geospatial information representing space-varying phenomena. Examples of coverages are satellite imagery, digital elevation models, and triangulated integrated networks (TINs). A WCS provides access to potentially detailed and rich sets of geospatial information, in forms that are useful for client-side rendering, multi-valued coverages, and input into scientific models and other clients. Visit http://www.opengeospatial.org/ to learn more about the OGC.
40
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Visit http://www.opengeospatial.org/standards/wcs to learn more about the WCS standard. ERDAS APOLLO supports version 1.0.0 of the OGC-WCS standard. Complete documentation can be found on the OGC website:
Web Coverage Service (WCS), Version 1.0.0 (Corrigendum)
Topics Web Coverage Service Requests ...... 41 Requesting a Reference to a Coverage ...... 42 Georeferenced Coverages ...... 43 WSDL and WCS HTTP SOAP Requests ...... 46
Web Coverage Service Requests The WCS standard defines three operations (or requests): GetCapabilities, DescribeCoverage and GetCoverage. The following descriptions for each of these operations are taken from Web Coverage Service (WCS), Version 1.0.0 (Corrigendum). Detailed documentation of these operations is beyond the scope of this document. The most accurate and up-to-date documentation for using OGC services can always be found on the OGC website and in the standard documents referenced above. Each of these request types can be formulated using HTTP-GET and HTTP-POST messaging. SOAP messaging is also supported.
GetCapabilities Each Web Coverage Server must describe its capabilities. This clause defines an XML document structure intended to convey general information about the service itself, and summary information about the available data collections from which coverages may be requested. See section 7.2.1 Web Coverage Service (WCS), Version 1.0.0 (Corrigendum) for more details on calling GetCapabilities.
DescribeCoverage A request to obtain a full description of one or more coverages available. The server responds to such a request with an XML document describing one or more coverages served by the WCS. See section 8.2.2 in Web Coverage Service (WCS), Version 1.0.0 (Corrigendum) for more details on calling DescribeCoverage.
GetCoverage The GetCoverage operation allows retrieval of coverages from a coverage offering. A GetCoverage request may be encoded as key-value pairs, or as an XML document.
41
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
See section 9.2.2 in Web Coverage Service (WCS), Version 1.0.0 (Corrigendum) for more details on calling GetCoverage.
Requesting a Reference to a Coverage Typically, a GetCoverage operation returns a coverage (values or properties of a set of geographic locations) bundled in a well-known coverage format. In other words, the GetCoverage operation returns data, not images. (Refer to Coverage Portrayal Service (see "Coverage Portrayal Service (CPS)" on page 70) for details on how to obtain an image from a coverage using a CPS.) You can also choose to store the coverage data on the server and request a reference to the coverage by using the STORE=TRUE option in the request. When the STORE=TRUE option is used, the output is an XML document referencing the coverage in a
42
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Georeferenced Coverages Coverage files are usually georeferenced and provide the bounds and a spatial reference system identifier for the coverage files. For example, a GeoTIFF file has a binary header which describes the data bounding box and reference system. This information is available in the DescribeCoverage documents. DescribeCoverage Document Subsets
43
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
defines the reference system identifiers that can be used in a GetCoverage request (CRS parameter) and the ones in which the result can be reprojected (RESPONSE_CRS). Only a few request/response reference systems are described in the DescribeCoverage documents, but ERDAS APOLLO WCS can provide coordinate transforms from and to each reference system of its database. The following vendor-specific element in the GetCapabilities document expresses this Coordinate Transform/Reprojection ability: GetCapabilities Document Subset
Logical Space Grid Coverage data can be queried in its logical space. A description of that logical space is provided in the following DescribeCoverage document: DescribeCoverage Document Subsets, Georeferenced Grid
44
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
45
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
WSDL and WCS HTTP SOAP Requests A Web Service Description Language (WSDL) document provides a formalized description of the services and facilitates recording of the service(s) in a UDDI registry, such as a Systinet Registry. Once registered, the service can be invoked using the Simple Object Access Protocol (SOAP). ERDAS APOLLO supports one of the OGC candidate WSDL solutions, by using a request=getWSDL request type. The syntax is similar to a classical HTTP-GET GetCapabilities request, except that the request name is "getWSDL" and an optional "SoapOnly" parameter is allowed. Note that the "Service" parameter will determine the nature of the output WSDL, as each service type (WMS, WFS, WCS) has a different WSDL description. The following is an example of a GetWSDL request: http://localhost:80/erdas-apollo/vector/ATLANTA_VECTOR?version=1.0.0 &service=WCS&request=getWSDL&SoapOnly=true
Delivering Image and Point Cloud Data with Streaming Services ERDAS APOLLO is able to stream some image and point cloud data using wavelet-based image compression. Enhanced Wavelet Compressed (ECW) files can be streamed using the Enhanced Wavelet Compression Protocol (ECWP) and JPEG 2000 files can be streamed using the JPEG 2000 Interactive Protocol (JPIP). ERDAS APOLLO provides the following web page that you can use to test streaming of image data: http://[server_name]/erdas-iws/samples/SimpleExampleNative.htm The page allows you to test streaming of both ECW and JPEG 2000 imagery. The ECW JPEG 2000 Plugin for internet browsers must be installed on your client machine to enable ECWP or JPIP streaming. To install the plug-ins: 1. Go the server home page: http://[server name]/erdas-apollo 2. Click the link inside the ECWP Plugin box on the top right of the page. 3. The File Download dialog box opens. Click Run to install the plugins. 4. Go to the Streaming Test Page: http://[server name]/erdas-iws/samples/SimpleExampleNative.htm Consult the ERDAS APOLLO Essentials User Guide for more details on streaming ECW and JPEG 2000 imagery with ERDAS APOLLO.
46
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
ECWP Streaming Any ECW image in the ERDAS APOLLO catalog can be streamed. The ECWP stream of the ECW dataset can be accessed as follows: ecwp://[server name]/APOLLO-Catalog/[aggregate name]/[child aggregate name]/[dataset name].ecw For example, if your ERDAS APOLLO Server is apollo.mycompany.com and you have added an ECW image named world.ecw to an aggregate named MyImages, you would access it on the Streaming Test Page by entering the following in the field next to the Open File button: ecwp://apollo.mycompany.com/APOLLO-Catalog/MyImages/world.ecw
JPIP Streaming Similar to ECW, any JPEG 2000 image in the ERDAS APOLLO catalog can be streamed. The JPIP stream of the JPEG 2000 dataset can be accessed as follows: jpip://[server name]/APOLLO-Catalog/[aggregate name]/[child aggregate name]/[dataset name].jp2 For example, if your ERDAS APOLLO Server is apollo.mycompany.com and you have added a JPEG 2000 image named world.jp2 to an aggregate named MyImages, you would access it on the Streaming Test Page by entering the following in the field next to the Open File button: jpip://apollo.mycompany.com/APOLLO-Catalog/MyImages/world.jp2
Accessing Secure Resources You can stream secure resources that require a user name and password by appending the user name and password of the account to the URL. Use the pipe character ( | ) as a delimiter as follows: ecwp://[server name]/APOLLO-Catalog/[aggregate name]/[child aggregate name]/[dataset name].ecw|[user name]|[password] or jpip://[server name]/APOLLO-Catalog/[aggregate name]/[child aggregate name]/[dataset name].jp2|[user name]|[password] For example, you would use the following URL to access the image world.jp2 with the user name ‘manager’ and the password ‘JFKE8uek3’ on the apollo.mycompany.com server: jpip://apollo.mycompany.com/APOLLO-Catalog/MyImages/world.jp2|manage r|JFKE8uek3
47
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Delivering Vectors/Features with a Web Feature Service (WFS) The Web Feature Service (WFS) is an interface standard defined by the Open Geospatial Consortium (OGC). The OGC defines it this way: The OGC Web Feature Service (WFS) allows a client to retrieve and update geospatial data encoded in Geography Markup Language (GML) from multiple Web Feature Services. The WFS operations support INSERT, UPDATE, DELETE, LOCK, QUERY and DISCOVERY operations on geographic features using HTTP as the distributed computing platform. Visit http://www.opengeospatial.org/ to learn more about the OGC. Visit http://www.opengeospatial.org/standards/wfs to learn more about the WFS standard. ERDAS APOLLO supports version 1.1.0 of the OGC-WFS standard:
Web Feature Service Implementation Specification
Topics Web Feature Service Requests ...... 48 WSDL and WFS SOAP Requests...... 50
Web Feature Service Requests ERDAS APOLLO implements these five operations (or requests) of the WFS standard: GetCapabilities, DescribeFeatureType, GetFeature, Transaction, and LockFeature. The following descriptions for each of these operations are taken from Web Feature Service Implementation Specification. Detailed documentation of these operations is beyond the scope of this document. The most accurate and up-to-date documentation for using OGC services can always be found on the OGC website and in the standard document referenced above. Each of these request types can be formulated using HTTP-GET and HTTP-POST messaging. SOAP messaging is also supported.
GetCapabilities The GetCapabilities operation returns an XML document that describes the service and its capabilities. Specifically, it must indicate which feature types it can service and what operations are supported on each feature type.
48
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
See section 13 in Web Feature Service Implementation Specification and section 7 in OWS Common Implementation Specification for more details on calling GetCapabilities.
The ERDAS APOLLO WFS service endpoint is configured to be exclusively for WFS requests, therefore the Service parameter is optional and will always default to "WFS".
Although the AcceptFormats parameter is acceptable as part of the GetCapabilities request, ERDAS APOLLO WFS only outputs its capabilities in XML.
DescribeFeatureType The DescribeFeatureType operation describes the structure and schema of any feature type serviced by the WFS. See section 8 in Web Feature Service Implementation Specification for more details on calling DescribeFeatureType.
GetFeature The GetFeature operation provides the ability to retrieve feature instances. In addition, it provides the ability to specify which feature properties to fetch and how to constrain the query spatially and non-spatially. See section 9 in Web Feature Service Implementation Specification for more details on calling GetFeature.
Transaction The Transaction operation is used to describe data transformation operations (insert, update and delete) that are to be applied to web accessible feature instances. When the transaction has been completed, a web feature service will generate an XML response document indicating the completion status of the transaction. If the ERDAS APOLLO WFS is configured to support editing and modification, it is considered to be transactional (WFS-T). It will support "Transaction" operations such as Insert, Update, Delete and possibly LockFeature. Even though the WFS-T request supports three operations (Insert, Update, Delete), it only allows the Delete operation for HTTP-GET. Transactional Insert and Update operations, in practice, would be very lengthy expressions and therefore not suitable for an HTTP-GET request. See section 12 in Web Feature Service Implementation Specification for more details on calling Transaction.
49
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
LockFeature The LockFeature operation allows the service to process a lock request on one or more instances of a feature type for the duration of a transaction. This ensures that serializable transactions are supported. See section 11 in Web Feature Service Implementation Specification for more details on calling LockFeature.
Other WFS Request Types The WFS GetGmlObject and GetFeatureWithLock operations are defined in the WFS specification but are not supported by the ERDAS APOLLO WFS service implementation.
WSDL and WFS SOAP Requests A Web Service Description Language (WSDL) document provides a formalized description of the services and facilitates recording of the service(s) in a UDDI registry, such as a Systinet Registry. Once registered, the service can be invoked using the Simple Object Access Protocol (SOAP). ERDAS APOLLO supports one of the OGC candidate WSDL solutions, by using a request=getWSDL request type. The syntax is similar to a classical HTTP-GET GetCapabilities request, except that the request name is "getWSDL" and an optional "SoapOnly" parameter is allowed. Note that the "Service" parameter will determine the nature of the output WSDL, as each service type (WMS, WFS, WCS) has a different WSDL description. The following is an example of a GetWSDL request: http://localhost:80/erdas-apollo/vector/ATLANTA_VECTOR?version=1.1.0 &service=WFS&request=getWSDL&SoapOnly=true
OGC Compliant HTTP Request Samples ERDAS APOLLO includes a set of sample data and sample OGC services. You can access these sample OGC services by visiting the OGC Compliant HTTP Request Samples page: http://
50
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
51
S E C T I O N 4 Portraying and Styling Data Portrayal is the use of rules to display and convert data such as GML, coverages, JDBC result sets or COM objects into an image or formatted text document. For Web Application developers using OGC interfaces, data is accessed through a WFS or WCS. The ERDAS APOLLO Portrayal Engine transforms a collection of features or coverages into the required output format. Output formats can be vector format (SVG), image formats (GIF, JPEG, PNG, WBMP and, GeoTIFF) or even textual formats (text, HTML, XML and, PDF). The ERDAS APOLLO Portrayal Engine uses server-side rules to portray information. These rules can be expressed in several languages: Property, SLD and Java. ERDAS APOLLO includes the ERDAS APOLLO Style Editor (on page 85) which provides the ability to style data using ERDAS APOLLO predefined rules. The ERDAS APOLLO Style Editor can be used to portray data using these predefined styles and rules or using custom designed ones. Custom rules can be written using the Portrayal API. Portrayal rules and styles are two distinct concepts. Each entity provides a different level of service but both are needed to portray data. Rules are pieces of program code that provide a specific way to portray data using a classification scheme, such as classes representing a numeric attribute. Styles are text files that contain parameters defining how to portray a dataset. For example, a Style may define which field the ERDAS APOLLO Portrayal Engine will classify and what fill color and stroke width to use.
Rules - Portrayal Logic Rules define the behavior to be used when portraying any kind of compatible feature or coverage collection. They are written once and used as many times as requested on as many different data sets as required. A rule resides in a Java class written using the ERDAS APOLLO API and is dedicated to render a defined kind of data, feature and coverage collections. A rule may also use a property or SLD file which is called a style. The Java code may be either generic to allow the rule to be used with as many feature or coverage types as possible or written to portray a specific feature or coverage collection in a more efficient way. ERDAS APOLLO provides a set of generic rules to be used with any kind of feature. Developing new portrayal rules requires advanced Java knowledge. The ERDAS APOLLO predefined rules have been extensively tested and optimized to provide open and powerful portraying of any feature collection. Rules also support advanced logic such as generalization, classification, and new feature creation to render an updated feature collection.
Styles - Look and Feel Styles are collections of parameters that are used by a rule to render a specific set of data in a predefined way. They are different for each set of data and are only used by the specified data set. A style defines a set of parameters to portray data using a selected rule and the properties for use in labeling and classifying and in determining the geometry to render, the colors for fill, the
53
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
stroke to use and/or the image band to display. Styles are tied to the data being styled as well as to the rule it uses. Styles do not include any kind of logic and do not affect performance. These issues are addressed during the rules development process. The styling process only focuses on portraying the data. The ERDAS APOLLO Style Editor (on page 85) simplifies the process of building styles. It allows you to define, preview and deploy styles.
In This Section Style Templates ...... 54 Creating Styles ...... 55 Deploying Styles ...... 64 Displaying Statistics in a Map ...... 65 Producing KML ...... 67 Limitations ...... 70 Coverage Portrayal Service (CPS) ...... 70 ERDAS APOLLO Style Editor...... 85
Style Templates The ERDAS APOLLO Style Editor is a Java-based GUI tool that can be used to create, edit, preview and deploy styles. It contains a range of styling functionality that allows the user to style data quickly and easily. The ERDAS APOLLO Style Editor is tightly bound to the prebuilt style templates.
Style Templates Description To facilitate the styling of data, ERDAS APOLLO includes a set of prebuilt rules referred to as Style Templates. The style templates provided with the ERDAS APOLLO Style Editor may fulfill most rendering requirements, including classification and generalization. The style templates available in ERDAS APOLLO include the following:
Uniform: This template applies a simple style to every feature. The stroke, fill and symbol can be configured for the entire feature collection and any property of the feature can be used for labeling.
Known Symbol: This template applies a fast-to-render marker from a fixed, predefined set to the centroid of each feature. A property of the feature can be used for labeling.
Uniform Roads: This is a style template dedicated to the display and portrayal of various types of roads. The ERDAS APOLLO Style Editor allows custom configuration of the outline, fill color, and center line to line or polyline geometry. Roads can be labeled with any property of the feature.
Range Classification: This style is used to classify numeric data, ranked data (to show a progression of values), or to represent percentages.
54
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Discrete Classification: This style template should be used to symbolize categorical data. Data values where the symbol for one value is no more or less prominent than the symbols for another value. It also handles lines and polygons stroke and fill color variations as well as line/outline width.
Range Road Classification: A style is attached to a range of values of a property for the classification of nondiscrete data. Values must be numeric.
Discrete Road Classification: This style template is used to render roads with a discrete classification that affects outline and centerline colors.
HTML Report Fragment: This style template allows the rendering of a feature collection into an HTML fragment. A subtitle can be added that will appear in the output for this feature type.
Variable Markers: This style template marks features with scaled and optionally rotated symbols. The size and orientation are determined using one of the properties of the feature.
Patterner: This styling rule fills polygons with patterned backgrounds.
Feature Numberer: This styling rule marks the features that are the nearest from the map center with sequential numbers.
Symbol Roller: This styling rule renders linear geometries by stamping a list of symbols along the curve in a cyclic manner.
Coverage Style: This is the only template applying to coverages. It permits choosing the channels, the colormap and the contrast operation.
Creating Styles Two styling languages are available in ERDAS APOLLO, Property and OGC Styled Layer Descriptor (SLD). ERDAS APOLLO Solution Toolkit allows users to plug custom styling rules into the ERDAS APOLLO Portrayal Engine and/or create their own styling mechanisms.
Topics Creating Styles with Properties ...... 56 Creating Styles with SLD ...... 56
55
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Creating Styles with Properties The "Property" language is a simple, key/value-based styling language that defines both the rule to load in the ERDAS APOLLO Portrayal Engine and the parameters to apply during the portrayal of the feature collection. Styles based on the Property language are typically created and modified using ERDAS APOLLO Style Editor. Since the set of available properties depends on the rule chosen, ERDAS APOLLO Style Editor offers a user-friendly, self-documenting way of setting the corresponding values. This language cannot be used to create styles that apply to coverages. That is handled by the SLD language.
Creating Styles with SLD The OGC Styled Layer Descriptor (SLD) is a powerful XML-based styling language. While the complete SLD mechanism is intended for WMS requests, the ERDAS APOLLO Portrayal Engine contained in this product is able to style specific feature types and coverages using a subset of the SLD tags. Visit http://www.opengeospatial.org/standards/sld to learn more about Styled Layer Descriptors.
Supported SLD Tags The following list is a reference for style developers. Depending on whether the SLD document is provided in a GetMap request to a vector data server (ERDAS APOLLO vector servlet), an SLD Portray provider addressing a WFS, an SLD Portray provider addressing a WCS (also named a Coverage Portrayal service), or a Coverage Server, this list of supported SLD tags varies. Notation
VP: Tags supported in the vector providers
PP: Tags supported in the SLD Portray provider on top of a WFS
CP: Tags supported by the SLD Portray provider on top of a WCS or in a Web Coverage Server
ignored: The element does not produce an error and thus, has no apparent behavior.
SLD Tag Name Parent Element Supporting version/provider
NamedLayer StyledLayerDescriptor VP
56
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
SLD Tag Name Parent Element Supporting version/provider
UserLayer StyledLayerDescriptor PP
Name, Title, Abstract StyledLayerDescriptor ignored
@version StyledLayerDescriptor defaults to "1.0.0"
Name NamedLayer VP
LayerFeatureConstraints NamedLayer ignored
NamedStyle NamedLayer VP
UserStyle NamedLayer VP
Name NamedStyle VP,PP
Name UserLayer PP,CP
RemoteOWS UserLayer PP,CP
LayerFeatureConstraints UserLayer PP
LayerCoverageConstraints UserLayer CP
UserStyle UserLayer PP,CP
Service RemoteOWS "WFS" or "WCS"
OnlineResource RemoteOWS PP - "&" must be written "&" (i.e. xml encoding)
FeatureTypeConstraint LayerFeatureConstraints PP
CoverageConstraint LayerCoverageConstraints CP
FeatureTypeName FeatureTypeConstraint PP
Filter FeatureTypeConstraint PP
Extent FeatureTypeConstraint ignored
CoverageName CoverageConstraint CP
57
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
SLD Tag Name Parent Element Supporting version/provider
Extent CoverageConstraint CP (to be deprecated. Use CoverageExtent instead)
CoverageExtent CoverageConstraint CP
TimePeriod Extent/CoverageExtent CP
RangeAxis Extent/CoverageExtent CP
Name UserStyle ignored: mapped with the STYLES parameter of the GetMap request
Title, Abstract, IsDefault UserStyle ignored
FeatureTypeStyle UserStyle Rendered sequentially (last on top)
CoverageStyle UserStyle CP
Name, Title, Abstract FeatureTypeStyle ignored
FeatureTypeName FeatureTypeStyle Useless if the UserLayer has 1! feature type
SemanticTypeIdentifier FeatureTypeStyle ignored
Rule FeatureTypeStyle Rendered sequentially (last on top)
Rule CoverageStyle CP
Name Rule VP
Title, Abstract Rule ignored
LegendGraphic Rule ignored
Filter Rule 1.0: parameters are supported and can be expressions
ElseFilter Rule VP,PP
MinScaleDenominator, Rule 1.0 MaxScaleDenominator
58
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
SLD Tag Name Parent Element Supporting version/provider
RasterSymbolizer Rule CP
*Symbolizer (except Raster) Rule VP,PP
Geometry *Symbolizer VP,PP - can be omitted if only one in the feature type.
Stroke LineSymbolizer VP,PP
PropertyName Geometry VP,PP
CssParameter Stroke VP,PP
ParameterValueType CssParameter VP,PP expression ParameterValueType VP,PP
Graphic GraphicFill 1.0
Fill PolygonSymbolizer VP,PP
Stroke PolygonSymbolizer VP,PP
GraphicFill Fill 1.0
CssParameter Fill VP,PP
Graphic PointSymbolizer VP,PP
ExternalGraphic Graphic 1.0
Mark Graphic VP,PP
Opacity Graphic CP
Size Graphic 1.0
Rotation Graphic 1.0
OnlineResource ExternalGraphic 1.0
Format ExternalGraphic 1.0
59
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
SLD Tag Name Parent Element Supporting version/provider
WellKnownName Mark VP,PP
Fill Mark VP,PP
Stroke Mark VP,PP
Label TextSymbolizer VP,PP
Font TextSymbolizer VP,PP
LabelPlacement TextSymbolizer VP,PP
Halo TextSymbolizer ignored
Fill TextSymbolizer VP,PP
CssParameter Font VP,PP
PointPlacement LabelPlacement at the centroid of the geometry
LinePlacement LabelPlacement ignored
AnchorPoint PointPlacement ignored
Displacement PointPlacement VP,PP
Rotation PointPlacement VP,PP
DisplacementX, Displacement VP,PP DisplacementY
ChannelSelection RasterSymbolizer CP
ContrastEnhancement RasterSymbolizer CP
ColorMap RasterSymbolizer CP
ShadedRelief RasterSymbolizer CP
ReliefFactor ShadedRelief CP
60
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
SLD Tag Name Parent Element Supporting version/provider
RedChannel, Green, Blue, ChannelSelection CP Gray
SourceChannelName RedChannel, Green, Blue, CP Gray
Normalize ContrastEnhancement CP
Histogram ContrastEnhancement CP
ColorMapEntry ColorMap CP
@color ColorMapEntry CP
@quantity ColorMapEntry CP
Notes
The NamedStyle is processed as a style name.
The Filter in a Rule element is ignored if it applies to a feature property that does not exist. It is important to ensure the proper handling of syntax errors in property names.
Globally, the Title and Abstract tags have no effect, as they only make sense when SLD content is published by a server.
Default SLD version is "1.0.0".
The LAYERS parameter must be mentioned in the GetMap request to an ERDAS WMS even when the SLD tag is used. Among the layers found in the SLD, only those found in the LAYERS parameter are rendered. This restriction does not apply to the Portray Provider or to the CPS.
Unknown CssParameters do not produce an error message. A CssParameter can be specified multiple times overriding the values previously set.
In Text Symbolizers, text anti-aliasing is enabled by default.
Parsing The SLD parsing is lenient. If the file is not a valid XML document, the parser will detect an error. If it does not conform to the SLD DTD, the parser will try to extract the most valuable information and continue processing. Sample SLD Style
61
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
62
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
63
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Deploying Styles The ERDAS APOLLO Portrayal Engine locates the styles to use for portraying features or coverages in a directory hierarchy whose root is defined by the STYLE DIR keyword in the CONFIGURATION section of the providers.fac file:
For ease of manipulation, the contents of that folder hierarchy can be packaged in a Grid Archive (GAR). The styles generated by the ERDAS APOLLO Style Editor tool are packaged in archives that should be copied to the STYLE DIR. The default installation folder for vector and coverage styling is:
Provider-Specific Styles If WFS/WMS provider-specific styles are defined, an additional level of subfolders with names based on the provider name can be created under the root of the hierarchy. For example, styles specific to a provider named ATLANTA_VECTOR can be copied to the following subfolder:
Deployment Structure Styles In each style folder, styles are searched in a path structure composed by appending the lower case collection keyword, the feature type or coverage offering name and then the style name. The style filenames are composed based on the target format (SVG for SVG and raster
64
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
formats or HTML for HTML) and the extension is based on the language (.prop for property styles or .sld for SLD fragments.) For example, consider a WMS request for the portrayal of the Buildings feature type/layer with the outline style in PNG format. If the style is defined using properties the style path and filename should be: collection\buildings\outline\SVG.prop If the style is defined using SLD if will be: collection\buildings\outline\SVG.sld A "default" style is used if no style is mentioned in the request. The directory name for that style must be named "defaultstyle" if it applies to features but not for coverages. For example, the "default" style for rendering the "Buildings" layer in PNG is: collection\buildings\defaultstyle\SVG.prop Symbols When a style contains a reference to a symbol, the path searched is composed by appending the symbol keyword, the symbol library name and the symbol filename. The ERDAS APOLLO Portrayal Engine libraries can contain symbols in a variety of raster formats such GIF, PNG, SVG and TrueType. An example of a Property style referencing a TrueType font used as a symbol is included in the distribution and can be invoked through the ATLANTA_VECTOR WFS provider using the place_names layer with the "truetype" style. The font set is: symbol/lib/hanshand.ttf.
Displaying Statistics in a Map Displaying statistics in a map provides the ability to determine exactly what types of geometry and how much geometry is portrayed in the style/rule issued to the ERDAS APOLLO Portrayal Engine. Display statistics can be used to analyze the service performance. Issue this request to the portrayal engine to return statistical information on the amount and complexity of the geometry and shapes requested. Geometry is defined in the feature type and includes point, line, polygon, ring, multipoint, multiline, or multipolygon.
OGC Simple Feature Access - Part 1: Common Architecture A shape is a geometric property defined by the Java AWT interface. A shape is described by a PathIterator object which can express the outline of the shape as well as a rule for determining how the outline divides the two-dimensional plane into interior and exterior points. Each shape object provides callbacks to do the following:
Get the bounding box of the geometry
65
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Determine whether points or rectangles lie partly or entirely within the interior of the shape
Retrieve a PathIterator object that describes the trajectory path of the shape outline
The ERDAS APOLLO Portrayal Engine uses the SVG concept of a group to apply the same set of common property values to a set of geometries. To display statistics use the WMS GetMap request and append the "NEEDSTAT=TRUE" option. Statistics are only obtained when requesting a raster format. SVG and GML2 output do not contain portrayal statistics. The statistics are returned as left-aligned text in the image returned by the GetMap request. Example Response to NEEDSTAT=TRUE Total Geometry:n Total Group:n Total Shape:n Geometry Types: Type Unknown(0) : n Type Point(1) : n Type Line(2) : n Type Ring(3) : n Type Polygon(4) : n Type MultiPoint(5) : n Type MultiLine(6) : n Type MultiPolygon(7) : n Total Point:n Max Point:n Mean Point:n Total Color:n World Size:f x f Pixel Size:n x n StandardScale:f
Line Description
Total Geometry The number of graphic geometries that are portrayed
Total Group Number of SVG groups returned.
Total Shape The total number of Java AWT shapes that are rendered
Geometry Types Total amounts are shown for different geometry
66
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Line Description types, numbered 0 to 7
Total Point: The total number of points - including points in geometry types other than point (line, polygons, etc)
Max Point The maximum number of points in a geometry
Mean Point The mean number of points for the geometries returned
Total Color The total number of colors requested in the map (based on an RGBA scale)
World Size The width and height of the map returned. Units are expressed in a specified unit of measure based on the coordinate transform system.
Pixel Size Size in pixels of the output image (width and height).
StandardScale StandardScale is an SLD property, giving the denominator of the map scale. Refer to the SLD 1.0 specification for additional information on standardscale.
Producing KML KML is a file format used to display geographic data in an Earth browser, such as Google Earth or Google Maps. You can output KML with ERDAS APOLLO in various ways for different types of KML contents. Without changing anything in your portrayal configuration, you can request maps (with the GetMap request) in KML out of a vector service (WFS), by providing the proper FORMAT parameter value: FORMAT=application/vnd.google-earth.kml+xml Replace the "+" sign with "%2B" when entering as a URL You also need to be sure that the SRS used is EPSG:4326. Here is an example of a request:
67
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
http://localhost:80/erdas-apollo/vector/ATLANTA_VECTOR?VERSION=1.1.1 & REQUEST=GetMap& SRS=EPSG%3A4326& BBOX=-71.07503,42.264893,-71.06302,42.273808& WIDTH=500& HEIGHT=500& LAYERS=protectedareas,hydro,roads,highways,place_names& STYLES=,,,,& FORMAT=application/vnd.google-earth.kml%2Bxml& BGCOLOR=0xffffff&TRANSPARENT=FALSE& EXCEPTIONS=application/vnd.ogc.se_xml
The ERDAS APOLLO Portrayal Engine, after building the graphic objects that need to be rendered, produces a KML (XML) output instead of an SVG-like structure. This stage of the process has no more information about what entities (features) are to be rendered, so the produced KML is semantically poor and only holds graphic information. This is a basic KML output that can be produced with minimal configuration efforts and that can fulfill a set of use cases. Some limitations:
Only the basic styling information is found in the KML document: predefined point icon, line stroke, polygon stroke and fill, polygon opacity.
Some of the portrayal rules do not produce any output in KML: Predefined Symbols for lines and polygons.
Some rules produce reduced output: Entity Numbering rules for lines and polygons only produce placemarks.
The GetFeatureInfo request type, with INFO_FORMAT=application/vnd.google-earth.kml+xml, will also produce a KML document that can be opened in your KML Browser. It will only contain the objects that are found by the request.
For smarter map production in KML, you need to write a specific Java rule that receives as input the feature set to render and the set of portrayal parameters. You can use the ERDAS KML Helper API to easily generate the KML elements that fit your needs.
For KML output out of the raster and coverage servlets, you will only get images. They can be referenced either as a GetMap URL in the KML document, or embedded as a raster image in a KMZ archive. For raster images in a KMZ archive, the format to use in the request is application/vnd.google-earth.kmz. When the output is KML from GetMap, ERDAS APOLLO leverages the Google Super-overlays technology so that further GetMap requests are executed with small tiles.
68
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The ERDAS APOLLO Catalog is also able to output KML. It outputs the various selected catalog objects, with their title, abstract, description, object sub-tree if any, and footprint if any. If the object is a KML-enabled vector layer, it will contain a network link to a GetMap request to that service. If the object is a KML-enabled image layer, the output is a network link to a GetMap request producing Google Super-overlays (a technology allowing tiling).
69
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Limitations
Fast 2D Rendering The default behavior of the portrayal engine is to build an SVG-like tree of graphical elements before converting them into an image or a real SVG file. ERDAS APOLLO also includes an alternative portrayal method, which uses the Sun Java2D library. This method uses low-level functions to draw points, lines, polygons and several other shapes. It is several times faster than the normal portrayal method but it does not apply in all cases. Some of the situations where it does not provide a proper result are:
If coordinate transform is needed
When using area patterns, line dashes and SVG symbols
When requesting SVG as output format
Coverage Portrayal Styling capabilities are limited for coverages. The following limitations apply:
No provider-specific style is interpreted by the portrayal engine.
The ERDAS APOLLO Style Editor does not produce the GAR to allow deployment on the server. The hierarchy must be built manually.
Only SLD styles are supported. Property styles are not read.
Coverage Portrayal Service (CPS) The Coverage Portrayal Service (CPS) is an interface standard defined by the Open Geospatial Consortium (OGC). The OGC defines it this way: The CPS is an OGC Processing Service that adds value to the products of a Web Coverage Service. The CPS links together WMS clients and WCS services, using SLD as a service language. The CPS interfaces are slight extensions or restrictions of the corresponding WMS interfaces. The purpose of the CPS is to provide a standard interface for producing visual pictures from coverage data. Visit http://www.opengeospatial.org/ to learn more about the OGC. OWS1 Coverage Portrayal Service (WCS)
70
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Topics Operational Concept ...... 71 Styled Layer Descriptor (SLD) ...... 72
Operational Concept The OWS1 Coverage Portrayal Service (WCS) describes the operational concept of WCS in this way:
71
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The CPS integrates into the OGC architecture by implementing two standard OGC interfaces, the WMS interface and the WCS interface. [The figure] shows how a thin WMS map viewer client, which has been generated on the fly by a server-side client generator, can use the services of a WCS by connecting through a CPS.
Styled Layer Descriptor (SLD) The Styled Layer Descriptor (SLD) is an implementation specification defined by the Open Geospatial Consortium (OGC). The OGC defines it this way:
72
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The OpenGIS® Styled Layer Descriptor (SLD) Profile of the OpenGIS® Web Map Service (WMS) Encoding Standard defines an encoding that extends the WMS standard to allow user-defined symbolization and coloring of geographic feature and coverage data. Visit http://www.opengeospatial.org/standards/sld to learn more about Styled Layer Descriptors. Styled Layer Descriptor profile of the Web Map Service Implementation Specification The Coverage Portrayal Service uses SLD as a language to apply a specific portrayal. In addition to request parameters, which serve to qualify the request action, additional information has to be provided to the CPS for it to work. This additional information can tell the CPS:
where to obtain the coverage of interest for the client,
what part or parts of the coverage data with which to work, and
how the client wants the CPS to portray the data.
SLD is used to express this additional information and to provide a user-defined styling of the coverage data. There is a parallel between the way that a client can direct a CPS to use data from a WCS and the way that a client can direct a WMS to use data from a WFS. Using SLD for both CPS requests and WMS requests exploits this parallel. The parts of the SLD that affect how the client wants the CPS to portray the data are contained in the SLD RasterSymbolizer element. The following subsections discuss some relevant aspects of this element.
See Creating Styles with SLD (on page 56) for a description of the complete list of SLD tags supported by ERDAS APOLLO.
Data selection with SLD RangeAxis Tag The SLD RangeAxis tag enables range axis subsetting. The following example shows the selection of different channels of a MODIS coverage offering and their mapping on the RGB channels of the resulting image. In this example the first three bands of the MODIS coverage, sur_refl_b01_1,sur_refl_b02_1,sur_refl_b03_1, are mapped to the red, green and blue bands of the portrayed image.
73
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
In this example the next three bands of the MODIS coverage, sur_refl_b04_1,sur_refl_b05_1,sur_refl_b06_1, are mapped to the red, green and blue bands of the portrayed image.
TimePeriod Tag The SLD TimePeriod tag enables temporal subsetting. The following example shows the selection of different datasets of a MODIS coverage layer, using different temporal intervals.
74
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Data Styling with SLD ContrastEnhancement Tag The SLD ContrastEnhancement tag can be used to reveal values that occupy a very small part of the data range.
"Normalize" means to stretch the contrast so that the dimmest color is stretched to black and the brightest color is stretched to white, with all colors in between stretched out uniformly.
"Histogram" means to stretch the contrast based on a histogram of how many colors are at each brightness level on input, with the goal of producing equal number of pixels in the image at each brightness level on output. This has the effect of revealing many subtle ground features.
75
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
ContrastEnhancement can also be used to define contrast enhancements for a channel of a false-color image or for a color image. In the case of a color image, the relative intensity (brightness) of the pixel color is used. First we show a single band (sur_refl_b04_1) of the MODIS image with no contrast enhancement. GrayChannel Without Contrast Enhancement
Here we show the same band being portrayed with the Normalize ContrastEnhancemant. GrayChannel with Contrast Enhancement
76
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Here we show how Normalize and Histogram act differently on the same image. Gray Channel with "Normalize" Contrast Enhancement
77
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Gray Channel with "Histogram" Contrast Enhancement
78
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
ColorMap Tag The ColorMap SLD tag can be used to classify the values of the coverage data. One color is chosen for each data range. In the example below, the color #4327ED (hexadecimal encoding of the color RGB[4,50,126]) will be applied on all "pixels" that have a value smaller than -1.0. Note that in the example below the data is encoded in short values: this means that the data values are integers between -32767 and 32768. GrayChannel with Color Map
79
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
ShadedRelief Tag The ShadedRelief SLD tag can be used to apply the hill shading algorithm on elevation data. Hill Shading on Short Elevation Data
80
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Use Case for Portraying Coverages This use case presents the steps that might take place during a typical CPS session. In this use case there are three components: the WCS that provides a Spot View coverage, the CPS that styles the Spot View coverage, and a client application that knows how to define an SLD for a coverage, performs the WMS-SLD GetMap requests, and then displays the GetMap response. The result is a visual representation of the Spot View coverage that can be overlaid with additional WMS map layers. The figure below is an example of a georectified Spot View coverage that has been overlaid with an additional map layer showing watercourses. This map layer has been requested from another WMS.
81
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Layering of Watercourses Over a Portrayed Coverage
Below are the different steps: 1. A Web Coverage Service (WCS) publishes a layer containing a multiband grid of data located in a region. The WCS URL: http://apollo.erdas.com/erdas-apollo/coverage/SPOT5J 2. The user finds that the published layer overlaps with his current region of interest and wishes to view this data in order to determine if it requires further analysis or further processing. This can be done by executing a GetCapabilities request followed by a DescribeCoverage for a given coverage or directly by executing a global DescribeCoverage. This action will provide information about all the coverages available on the service. http://apollo.erdas.com/erdas-apollo/coverage/SPOT5J? REQUEST=GetCapabilities&VERSION=1.0.0&SERVICE=WCS http://apollo.erdas.com/erdas-apollo/coverage/SPOT5J? REQUEST=DescribeCoverage&VERSION=1.0.0&SERVICE=WCS
82
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
3. The client application knows of a CPS and requests it to provide a view of the data that can be overlaid with familiar map features. http://apollo.erdas.com/erdas-apollo/map/PORTRAY 4. The client builds a Styled Layer Descriptor (SLD) document, which acts as a raster descriptor, to assign red to band 1 of the grid data, green to band 2, and blue to band 3 of the WCS.
83
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
84
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
BBOX=539629.504688809,4176155.456291143,576617.010472623,4194649.209 18305& TIME=2002-08-09T16:45:00Z/2002-08-09T20:05:00Z& WIDTH=500& HEIGHT=250& FORMAT=GeoTIFF 8. The WCS returns the requested coverage data to the CPS. If necessary, the CPS redraws the data in the requested BBOX and SRS, applies the SLD to produce an image of the requested format with the requested WIDTH and HEIGHT, and returns the image to the client.
ERDAS APOLLO Style Editor The ERDAS APOLLO Style Editor is a Java Swing client you can use to explore and style geographical data. The ERDAS APOLLO Style Editor can access OGC services such as Web Map Servers, Web Feature Servers, and Web Coverage Servers. The ERDAS APOLLO Style Editor also helps in the creation of styles which are used to render maps by the Portrayal Service. Use the ERDAS APOLLO Style Editor to create rendering rules to style vector data that is published through ERDAS APOLLO services. When a WFS is set up using ERDAS APOLLO, you can use the Style Editor to generate point, line, and polygon styling rules allowing ERDAS APOLLO to publish the styled vector data through a WMS interface. \ Imagery, terrain, and point cloud styling can be done in the ERDAS APOLLO Data Manager. Cataloged vector datasets may also be styled in the ERDAS APOLLO Data Manager in order to render a desired thumbnail or to set the style used for the dataset when rendered through the ApolloCatalogWMS* services. See the ERDAS APOLLO Data Manager User Guide for more details.
85
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Topics Starting the ERDAS APOLLO Style Editor ...... 86 Main Window ...... 87 Preferences...... 89 Managing Projects ...... 90 Data Sources ...... 92 Layers 106 Map Navigation ...... 111 Views 117 Styling Data...... 120 Managing Styles ...... 121 Scale Range Management ...... 125 Style Rules ...... 126
Starting the ERDAS APOLLO Style Editor ERDAS APOLLO Style Editor is installed as part of ERDAS APOLLO. You can start ERDAS APOLLO Style Editor in the following way:
Double-click the Style Editor icon located under the ERDAS APOLLO 2015 folder in the Windows Start menu.
Run
After the splash screen, the ERDAS APOLLO Style Editor main window opens.
86
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Main Window ERDAS APOLLO Style Editor Main Window
Styles Panel: The Styles panel presents the current project structure as a tree. This panel shows all the data sources, map sources, and coverage sources that have been added to the project. Refer to Data Sources (on page 92) for more information.
Map Panel: The Map Panel displays the contents of the Styles Panel and Layers Panel in a geographic view. Unless you specified a particular device screen (see Views (on page 117) for more information about device screens), the map panel will be resized when the main window is resized.
87
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Layers Panel: The Layers Panel shows the list of layers that have been added to the preview. The Layers Panel includes buttons to reorder the list and remove layers from the preview. Please refer to Layers (on page 106) for more information.
ERDAS APOLLO Style Editor Toolbar: This toolbar contains commands whose functions are described in Map Navigation (on page 111).
Overview Panel: The Overview Panel is a collapsible area that shows a map of the whole world superimposed by either a yellow shaded rectangle area or red crosshairs representing the area or location being displayed in the Map Pane. Refer to the Map Overview section in Map Navigation (on page 111) for more information.
Status Bar: A status bar with information such as cursor coordinates or measured lengths and areas. It contains a split pane which displays the Scale Range Manager described in Scale Range Management (on page 125).
Map Panel Tabs: The Map Panel tabs allow you to switch to different views of the project as described in Views (on page 117).
Processing Indicator: The Processing Indicator is an ERDAS APOLLO Server logo which animates when the ERDAS APOLLO Style Editor is performing an operation. The current
operation can be canceled at any time by pressing the Stop button.
Status History: The Status History button in the in the lower left corner opens the Status History dialog which displays a log of all the previously performed tasks.
88
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Preferences This section explains how to personalize some of the options ERDAS APOLLO Style Editor uses to determine its behavior. The options are placed in the Style Editor Preferences window, accessible in the tools menu. Preferences item in the Tools menu
Style Editor Preferences Dialog
Setting the HTTP Connection Time-out This option determines the maximum time ERDAS APOLLO Style Editor waits for a server response. Selecting a time limit is useful to prevent situations where ERDAS APOLLO Style Editor could be kept waiting for a non-responsive server. The initial value of 15000 milliseconds is set to produce reasonable behavior for most situations. 1. Select the Preferences option from the Tools menu. 2. In the HTTP group, use the checkbox to activate or deactivate the Connection Time-out. 3. Set the text field with the desired value in milliseconds.
89
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Setting the Logging Path ERDAS APOLLO Style Editor automatically creates log files you can consult (for instance, to view the generated map requests). By default, the files have a prefix log, and are placed in the preferences folder. 1. Select the Preferences item from the Tools menu. 2. In the Prefix text field, set the path and prefix for the log files.
Managing Projects ERDAS APOLLO Style Editor stores its configuration in a centralized file called a project file. The project file contains information such as:
a list of different views, each representing a map
a list of data sources
a list of layers
style configuration
miscellaneous settings
Project files are associated with the .gar extension.
90
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Project management commands such as New Project and Open are located under the File menu.
Creating a New Project To create a new project, select New Project in the File menu. A new, empty, project will be created in a new window. When you start ERDAS APOLLO Style Editor (except for the very first time), a new blank project is opened for you to work with. To use your new project, you may want to start adding data sources. Read the next sections of this guide to learn how to add data sources.
Opening an Existing Project To open an existing project, select Open... from the File menu. When asked to choose a file, select a project file with an extension of .gar or .styler. Typically, the projects are stored in the "projects" subfolder of your ERDAS APOLLO Style Editor installation. You can also open a project using the Open Recent menu item. Open Recent allows direct access to the 10 most recently opened projects.
91
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Data Sources A data source is an OGC/ISO compliant service or a GIS resource such as a local Shapefiles directory. Data sources are used by the ERDAS APOLLO Style Editor to render maps. A data source may also be queried on its capabilities, its list of layers (if it's a WMS), its feature descriptions (if it's a WFS), and so forth. The current version of ERDAS APOLLO Style Editor supports the following data sources:
Remote WFS through the HTTP protocol
Local Feature Server, from a .fac file
Local Shapefiles directory
Remote WMS through HTTP
Local georeferenced image
Remote WCS with remote CPS
OGC WMS Contexts
Adding a Data Source Adding a data source, whatever its type, is accomplished by using the Data menu shown below:
The next sections present the detailed procedure for each data source type.
Topics Adding Features Resources ...... 93 Adding Raster Resources ...... 97 Adding Coverage Resources ...... 99 Authenticated Connections ...... 101 Managing Data Sources ...... 103
92
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Adding Features Resources This section explains how to add remote OGC/ISO Web Feature Servers and Shapefiles directories to the project. 1. Select Data/Add Data Source... in the menu or right click on the Project in the Styles panel and select Add Data Source. 2. On the Attach a New Feature Server dialog choose either to add a Web Feature Server (WFS), a Local Feature Server or a collection of Shapefiles located in a given directory.
Adding a Web Feature Server To add a reference to a remote Web Feature Server, select Web Feature Server (HTTP) on the initial Attach a New Feature Server dialog and then select Next.
93
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
In the next dialog choose a previously entered URL from the list or enter a New service URL and click the Add button. Note that all valid URLs are automatically collected for future use.
Select Next
Provide both a Name and a Title for the service. Name is used in styles in order to achieve the mapping between a service and a rule bundle while Title is the human-readable title that will be displayed in the Project Structure panel.
94
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The Name must be in lowercase and must correspond to the name of the provider specified in the configuration of the WFS. Please refer to Servlet-Specific Configuration Parameters (providers.fac) section in the Administrator Guide.
If the WFS service requires authentication, select Next. (See Authenticated Connections (on page 101) for more detail).
Select Finish
You should now see the data source in the Styles panel.
Adding a Local Feature Server To add a reference to a local Web Feature Server, select Local Feature Server (From '.fac' file) on the initial Attach a New Feature Server dialog and select Next.
You may either
Key in the full File path and name of the .fac file or,
Select the " ... " button to browse for a .fac file or,
Select from the preexisting Entries list.
Select Finish
You should now see the data source in the Styles panel.
95
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Adding a Collection of Shapefiles To add a collection of Shapefiles, select Shapefile Directory on the initial Attach a New Feature Server dialog.
First choose a Directory that contains Shapefiles (common extensions are .shp, .shx, .dbf ).
Since Shapefiles do not export any SRS information, you have to manually specify the native SRS in which your data is expressed.
The drop-down list of SRS is a history of your previous selections, not a list of suggested SRS for the given Shapefiles directory.
Select Next
On the next panel, enter a Name and Title for your data source.
The Name must be in lowercase and must correspond to the name of the provider that will be used when configuring your Portrayal Service. Select Finish
You should now see the data source in the Styles panel.
96
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Adding Raster Resources This section explains how to add remote OGC/ISO Web Map Servers and local georeferenced images to the project. 1. Select Data/Add Data Source... in the menu or right click on the Project in the Styles panel and select Add Map Source. 2. On the Attach a New Map Server dialog choose either to add a Web Map Server (HTTP) or a Local Georeferenced Image.
Adding a Web Map Server To add a reference to a Web Map Server, select Web Map Server (HTTP) on the initial Attach a New Map Server dialog and then select Next.
97
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
In the next dialog choose a previously entered URL from the list or enter a New service URL and click the Add button. Note that all valid URLs are automatically collected for future use.
If the WMS service requires authentication, select Next. (See Authenticated Connections (on page 101) for more detail).
Select Finish
You should now see the data source in the Styles panel.
Adding a Local Georeferenced Image Georeferenced images are not saved in the project file. They must be manually added each time ERDAS APOLLO Style Editor is run.
To add a reference to a local georeferenced image, select Local Georeferenced Image on the initial Attach a New Map Server dialog and select Next.
In the next dialog choose an image File:
Key in the full File path and name or,
Select the " ... " button to browse for an image file or,
Select an image file from the File drop-down list
98
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Specify the native SRS of the image, even if your georeferenced image already defines an SRS.
The drop-down Image SRS list is a history of your previous selections, not a list of suggested SRS for the given georeferenced image. Select a provider mode. Please refer the ERDAS APOLLO Server Administrator's Guide for more details on provider modes.
Select Finish
You should now see the data source in the Styles panel.
Adding Coverage Resources This section explains how to add remote OGC/ISO Web Coverage Servers and their associated Coverage Portrayal Services to the project. 1. Select Data/Add Coverage Source... in the menu or right click on the Project in the Styles panel and select Add Coverage Source. 2. In the Attach a New Coverage Server dialog, choose a previously entered WCS URL from the list or enter a New WCS service URL and click the Add button. Note that all valid URLs are automatically collected for future use.
99
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The coverage service doesn't support on-the-fly coordinate transform. For example, to use the ATLANTA_SINGLE coverage service, you will first need to change the coordinate system to EPSG:2240, which is the SRS supported by ATLANTA_SINGLE.
3. Select Next
100
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
4. In the next dialog choose a previously entered CPS URL from the list or enter a New CPS service URL and click the Add button. Note that all valid URLs are automatically collected for future use.
5. Enter a unique Name and a Title for the coverage. The name must be in lowercase and should preferably correspond with the WCS provider. 6. If the WCS service requires authentication, select Next. (See Authenticated Connections (on page 101) for more detail). 7. Select Finish. You should now see the data source in the Styles panel.
Authenticated Connections Some data services (WFS, WMS or WCS) may require authentication in order to establish connection. The authentication is done through a login and password which can be defined when adding the data source. 1. Follow the normal Add Data Source procedure for the specific type you wish to add. In the final step of the procedure, select Next (instead of Finish). 2. Enter the server's Login and Password.
101
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
3. If you want ERDAS APOLLO Style Editor to memorize the login and password for future utilization, even if the service URL is used as another type of data source select the Try remember checkbox.
102
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Managing Data Sources
Browsing a Data Source The Styles panel displays all the data sources that have been added to the project in a tree structure.
To browse a specific data source, double-click the data source name or click its expand icon. Each data source expands to show its containing elements. The list of elements is specific to each data source. For instance, a WFS will list feature types while a WMS will list layers. Right click on the data source to display a context menu containing a list of commands for operating on the data source:
Remove Data Source
Create Report
Global Style Properties
Dressing Style Properties
Reporting Style Properties
Properties
103
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Data Source Properties The Properties command allows you to view (and in some cases edit) the properties you specified when you initially added the data source.
The Forgiving Checkbox If you try to add a WFS style based on a nonconforming geometry to the Map panel, an error will be displayed alerting you that the actual geometry does not match the type defined in the feature schema. This is a sign that the server is improperly configured and should be fixed in order be compliant with the WFS specification. In some circumstances, you may want to allow the introduction of nonconforming geometry layers in your project despite that mismatch. To do so, select the Forgiving checkbox to make ERDAS APOLLO Style Editor behave less restrictively and accept the layer. The Forgiving checkbox only appears on WFS Data Source Properties dialog boxes.
Removing Data Sources To remove a data source, right click on the data source in the Style panel and select Remove Data Source. A confirmation dialog will be displayed so that you can confirm the remove command. This action is irreversible. It will remove all the styles created from the selected source, even if they are currently being used.
Data Source History List Each time you add a valid web service URL it is stored in the data source's history. This history is conveniently shown to you when trying to add data sources, so you don't need to remember or retype the same URL multiple times.
104
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The data source's history list can be modified by right clicking on any entry in the list. You can organize the list of URLs by moving entries up or down or removing those that are no longer needed.
Adding Resources from a Web Map Context You can add a data source by importing an OGC Web Map Context.
See OGC Web Map Contexts Documents for more details. To import a local context into ERDAS APOLLO Style Editor, select the Import Context... from the File menu, select the OGC context XML file you want to import, as shown by the following.
105
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Layers When rendering a map, the ERDAS APOLLO Style Editor will overlay different layers to form a single image. The list of layers that the ERDAS APOLLO Style Editor considers when composing its map are taken from the layers panel.
Adding a Layer to the Map To add a layer to the map, right-click on one of the sub-elements of a data source in the data source panel and select Add To Preview. The selected layer will then appear in the layers panel and the Map panel will automatically be refreshed.
Renaming a Layer The layers you add to the map are created with the same name as its corresponding data source sub-element, allowing you to quickly start using the layer. ERDAS APOLLO Style Editor gives you the ability to rename each layer, allowing you to choose the best suited name in the context of your own project. To rename a layer: 1. Right right-click on the layer in the Layers panel and select Layer Properties 2. Edit the Title field with the new label title and select OK.
Removing a Layer from the Map To remove a layer from Layers panel and Map panel, right-click on a layer in the Layers panel and select the Remove Layer from Preview menu entry. The Map will refresh itself and the layer will be removed from the Layers panel.
Toggle Visibility for a Layer To keep a layer in the Layers Panel but force it not to be rendered in the Map panel, right-click on the layer in the Layers panel and select the Toggle Layer Visibility menu entry. The layer will no longer display in the Map panel and will appear grayed out in the Layers panel. Select Toggle Layer Visibility again to turn visibility back on for the layer.
106
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Ordering Layers The order in which layers compose on the Map can be changed. To make a layer appear above another layer, click the layer in the Layers Panel and select the Up button. The map will automatically reload to reflect this change. Similarly use the Down button to move a layer down in the display order.
Limiting WFS Features This Max Count setting allows you to limit the number of results obtained. This is useful in limiting data transfer delays when a request retrieves more data than anticipated. As an example, consider a server with detailed information on all of the streets in the United States. You may only be interested in streets in a local region, but if you start with the entire United States in your Map panel, you will generate a request for all the streets in the U.S. The Max Count setting limits the data returned so that you can navigate to the region of interest or analyze the retrieved data in order to understand which data should be filtered out. The Max Count setting only applies to WFS servers. Other services, such as WMS or WCS, have other data limiting filters. To set Max Count on a WFS: 1. Right-click on a feature layer in the Layers panel and select Layer Properties 2. In the Layer Properties window: Toggle the Max Count checkbox to activate or deactivate it.
107
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Edit the Max Count text field to specify the retrieved feature limit.
3. Select OK.
Spatial Filtering Spatial filtering is used to limit the retrieved information to the area being currently displayed on your screen. This may be used both with WFS and WMS servers. To enable Spatial Filtering 1. Right-click on a feature layer or map layer in the Layers panel and select Layer Properties For feature layers, toggle the Spatial Filtering checkbox.
108
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
For map layers, toggle the Use Box checkbox.
2. Select OK on the Layers Properties dialog.
Additional Service Parameters Some servers accept proprietary parameters in their requests such as ServiceName or Quality. ERDAS APOLLO Style Editor allows you to specify these additional parameters for the service requests of each layer. 1. Right-click on a map layer in the Layers panel and select Layer Properties 2. Select New in the Layer Properties window.
109
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
3. In the New Entry window, insert the server specific Key and Value.
4. Select OK. 5. Repeat steps 2-4 for all additional service parameters. 6. Select OK on the Layer Properties dialog.
Layer Statistics The statistics option allows you to obtain detailed information on the elements contained in WMS layer built over a WFS. This information includes the number of retrieved geometries and the type of geometries. This is a feature only available with ERDAS APOLLO servers. Follow this procedure to activate layer statistics. 1. Right-click on a map layer in the Layers panel and select Layer Properties 2. Toggle the Statistics checkbox to activate/deactivate this option.
110
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
3. Select OK on the Layers Properties dialog.
Map Navigation This section presents the ERDAS APOLLO Style Editor navigation tools that allow you to change the current view of the map by zooming, panning or quickly jumping to specific locations.
Pan Tools
The Pan tool allows you to re-center the view on a point indicated by a single click on the map.
111
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Zoom Tools
The Zoom In tool allows you to zoom in (by a factor of 2) by clicking on a single point or to zoom in to a specific area by clicking down and dragging a box around the desired area. The Zoom Out tool allows you to zoom out (by a factor of 2) by clicking on a single point.
Changing Scale
The Scale tool in the Scale panel also allows you to zoom in the Map panel. Scale can be modified quickly by using the slider or precisely by entering an exact value in the Scale text field. If Scale panel expander arrow is pointing to the left, click it to expand the Scale panel and view the Scale tool.
Fit View to Layer Use the Fit View to Layer command to set the view extents of the Map panel the envelope of a specified layer. This is the quickest way to view the content of an entire layer. To fit the Map panel to a specific layer:
Right-click on a feature layer in the Layers panel and select Fit View to Layer
Switching Map Extents
You can quickly navigate to previous views of the Map by using the Back and Forward icons in the toolbar. For example, clicking the Back icon will take you back to the previous map extent.
112
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Setting the Map Panel Extents and Spatial Reference System Use the Envelope Panel to precisely control the extents of the Map panel, as well as its Spatial Reference System.
If the Envelope panel's expander arrow is pointing to the left, click it to expand the Envelope panel and view the Envelope parameters. The Envelope Panel also offers additional features in the Envelope menu. To start using these features, click the menu icon (to the right of the SRS field) and select the appropriate menu entry.
Switch SRS... displays a dialog that allows you to change the spatial reference system of the Map panel.
Copy Envelope copies the SRS and envelope parameters (formatted as a BBOX) to the clipboard. Example:
&SRS=EPSG%3A4326&BBOX=-84.7522,33.4264,-84.0077,34.2135
Paste Envelope pastes a similarly formatted string into the fields of the Envelope panel.
Go To... displays the Go To Point dialog which allows you to enter a specific point and SRS to center the Map panel on.
Parse... displays the "Magic Envelope" dialog which allows you enter a WMS GetMap request URL and extract the SRS and bounding box parameters.
Map Overview The Overview panel gives an indication of where the current Map view is situated within a broader context, such as the world.
113
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The box of the active map will be represented on the overview map as either a red cross or a yellow rectangle area, depending on whether the box of the active map can be drawn meaningfully as a rectangle area on the overview map.
Measuring Distances and Areas
The Measure tool will let you draw polygons while displaying, in the status bar, the distance and area of the currently drawn geometry. After selecting the Measure tool, simply click in the Map panel to define lines or areas. The Measure tool will automatically report the length and the area of the defined geometry in the status bar at the bottom of the ERDAS APOLLO Style Editor window.
114
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Left click with your mouse to add new points and right click with your mouse on an existing point to delete it.
View Feature Properties
115
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The Feature Info tool allows you to view information about selected features. The kind of information you will obtain is dependent on the type of the feature. To use this function, click the Feature Info icon and then either click a point in the Map panel or drag a rectangle in the Map panel. The Feature Info dialog will display.
The Feature Info dialog allows you to view feature information for all of the features in the selected area. The Features drop-down allows you to select the feature you want to review. (You can also use the next and previous arrow buttons to the right of the Features drop-down to browse through the features one at a time). All properties of the selected feature are listed in the table. Note that, in the example above, the selected feature is of Type roads with ID of roads.26989.
116
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Views The ERDAS APOLLO Style Editor allows you to create multiple views of your data in the Map panel. A View is an interactive map that lets you display, explore, query, analyze and style geographic data in the ERDAS APOLLO Style Editor. Views are saved as part of the ERDAS APOLLO Style Editor project. A view defines the geographic data that will be used and how it will be displayed, but it does not contain the geographic data sources or map servers themselves. Instead, a view references these data sources. This means that a view is dynamic, because it reflects the current status of the data source. If the data source changes, a view that uses its data will automatically reflect the change the next time the view is drawn. This also means that the same data can be displayed on more than one view. Another powerful feature of the ERDAS APOLLO Style Editor is that it allows you to share styles between different views. Each style created in the scope of a project can be used to render data in any view of that project.
117
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
This feature allows you to easily compare multiple maps in single instance of ERDAS APOLLO Style Editor. You will be able to preview your maps at different scales and see how your maps look like on a specific device. Additionally, you will be able to export your view as an OGC Web Map Context.
Creating a View A default view, called View 1, will be created when you initiate a new project. If you want to create a new view in your project, you can do it in two ways:
In the View Menu, select Create New. A new view will be displayed.
Or you can right click on a existing view and select New.
118
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
View Properties The View Properties dialog allows you to change the name of the view as well as set some OGC Web Map Context attributes such as the Context Title, Abstract and Keywords. To display the View Properties dialog, right click on the view tab and select Properties from the context menu.
Enabling Map Dressing Enabling map dressing gives you the option to add a legend, a scale bar, or a grid to the Map. To enable or disable Map Dressing, select or un-select Map Dressing in the View menu. If map dressing hasn't been configured for your data source you will not see any results when you enable Map Dressing on the View. Map dressing configuration requires you to select what kinds of dressing elements you want to add to your map, such as a legend, a grid, a scale bar, etc. To configure map dressing, right-click on the data source and select the Dressing Style Properties.
Show Transparent Areas Enabling Show Transparent Areas will result in transparent areas being rendered with a checker board pattern. To enable or disable Show Transparent Areas select it or deselect it in the View menu.
119
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Configuring a Device Use the Device Screen sub-menu to define or select "Devices" for previewing styles in the Map panel. A "Device" is simply a named set of parameters that define specific dimensions and color depth. You can define new "Devices" to represent actual hardware tools such as smart phones, tablets or other hand held devices. Select View->Device Screen->Manage to define new devices or edit the properties of existing devices. To preview how your styles will look on the device simply select the device from the View->Device Screen menu. Select View->Device Screen->
Saving a View as an OGC Web Map Context The current view can be saved as an OGC Web Map Context. Saving the context will serialize the current view and its associated data sources to an XML file on your hard disk. To save the current view as a context, select the Export Context... from the File menu. A standard Save As dialog will display so that you can save the context as an XML file. The XML context file can be later re-used by importing it into ERDAS APOLLO Style Editor. Local Shapefiles cannot be exported in a context file. If you have local Shapefile layers you will receive a warning and be given the opportunity to save the context without Shapefile layers.
Styling Data Styling is the process of creating stylesheets, which are sets of parameters to be applied when portraying a particular feature type. Refer to Portraying and Styling Data (on page 53) for more details.
Styling Architecture The ERDAS APOLLO Style Editor tool gives you the ability to preview style changes before publishing them. To accomplish this, the tool embeds the following components:
A "client" version of ERDAS APOLLO's versatile portrayal engine, with support for plug-in styling rules.
The same bundle of styling rules that is available on the server side, with additional configuration/user interface descriptors.
The rules are used in three distinct ways by the ERDAS APOLLO Style Editor:
To create and present a user-friendly interface that allows intuitive parameter editing/selection.
120
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
To generate preview renderings of the style against sample feature sets extracted from your real-world data.
To create style packages that will later be published on the server. The published styles will then be available via the WMS interface of the service.
The diagram below shows how the rule bundle is always available on both the client and server, while the style packages produced by the ERDAS APOLLO Style Editor tool are published on the server.
Managing Styles You can create new styles for any feature in the Styles pane using the Add Style wizard. To create a new style:
121
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
1. Right-click on any feature in the Styles panel and select Create Style... from the context menu. This will initiate the Add Style wizard.
2. Select the geometry type you want to use, then click Next. This step will only appear for sources with more than one geometry type defined. 3. Choose if you prefer to create a new style or use one of the predefined styles, then click Next. 4. Select the styling rule your style will be based on from the drop-down menu (a small description of the rule behavior will appear under the drop-down control when available), then click Next. 5. Enter the name that will be used to reference the style once it is deployed on the server, then click Finish or Properties... to create the style and insert it in the database. Since style names have to conform to the WMS naming conventions, the Finish and Properties... are enabled only when the name is valid. While the name is invalid, a descriptive tip explaining the cause should appear under the control. The Properties... button performs the same action as Finish, and then invokes the inspector for you to edit the style parameters.
Deleting Styles You can delete an existing style by right clicking on the style in the Styles panel and selecting Delete from the context menu. If you confirm the deletion, the style is removed from the database and every preview layer that depends on it is also deleted.
122
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Modifying Styles You can edit properties of a style using the Style Properties dialog. To open the Style Properties dialog, either double click the style in the Styles panel or right click on the style in the Style panel and select Properties.
Style Rule: The rule the current style is based on. If you select another rule, the ERDAS APOLLO Style Editor tool will try to migrate your current style settings to the new rule (when applicable).
Style Inspector: The tabs in the central part of the dialog embed an inspector for the currently selected styling rule. You will find the description of these inspectors in Style Rules (on page 126).
OK: Applies the current settings to the style, commits them to the style database, and closes the dialog.
123
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Apply: Temporarily applies the current settings to the underlying style, and causes the views that depend on it to refresh themselves. The Apply button does not close the dialog, and can be clicked more than once.
Cancel: Undoes any temporary changes made to the underlying style and then closes the editing dialog.
Style Rules Summary The styling rules provided with the ERDAS APOLLO Style Editor are:
Uniform - Uniformly applies a simple style to every feature. The stroke, fill, and symbol to use can be configured for the whole feature collection, and a property of the feature can be used for labeling.
Discrete Classification - This style rule should be used for displaying categorical data (data values such that the symbol for one value is no more or less prominent than the symbols for any other value). It also handles lines' and polygons' stroke and fill color variations as well as line/outline width.
Range Classification - This style is used to classify raw data (such as population counts), ranked data (to show a progression of values such as best to worst scholastic scores in a given region), or to represent percentages (such as percentage of given area that are affected by pollution).
Known Symbol - Applies a fast-to-render marker (from a fixed, predefined set) at the centroid of each feature. A property of the feature can be used for labeling.
Uniform Roads - This is a style type dedicated to the display and portrayal of various types of roads. It allows you to configure an outline, fill color, and center line to line or polyline geometry; it can also label the road with a property of the feature.
Discrete Road Classification - This style type is used to render roads with a discrete classification that affects outline and center line colors.
Range Road Classification - This style type is used to render roads with a range classification that affects outline and center line colors
Variable Markers - This styling rule marks features with scaled and (optionally) rotated symbols. The size and orientation are determined from one of the properties of the feature.
Patterner - This styling rule fills polygons with patterned backgrounds.
Feature Numberer - This styling rule marks the features that are the nearest from the map center with sequential numbers.
Symbol Roller - This styling rule renders linear geometries by stamping a list of symbols along the curve in a cyclic manner.
124
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Styling Various Types of Geometries Styling is specific to geometry contained by the selected layer. Graphic Options According to Geometries
Points You can select the specific marker desired and set display properties, such as color, size and labels.
Lines You can set a color, width, and dash type for lines as well as determine linear capping and join parameters.
Polygons You have the same styling options as available for Lines, as well as the ability to add a fill color.
Deploying Styles The easiest (and recommended) way to deploy styles is to package them in a GAR archive which will be subsequently dropped in the rendering directory of the portrayal service. Refer to Deploying Styles (on page 64) for more information about the rendering directory organization. If you are saving your styling project in a GAR package (which is the default format in this version of the ERDAS APOLLO Style Editor tool), no additional steps are necessary: you can just drop your project file as-is in the rendering directory. If you are using an old-style .styler archive, you can generate a GAR archive using the File/Styles/Create Bundle... command. This command generates a metadata-augmented archive format similar to the Save As... command, but does not change the filename and package format of the current project.
Scale Range Management The scale panel can help you specify the scale ranges at which layers should be displayed.
125
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The scale panel contains the list of the layers selected in a particular view. The scale panel can be activated by dragging the icon located in the bottom left corner just below the map. The map can be viewed at different scales by moving the red scale cursor to different points along the scale line. Changing the scale by moving the red scale cursor to different points will automatically update the view's scale box and of course the current bounding box.
Changing the scale line maximum and minimum values, will result in a different mix of the features being displayed, depending on which feature's range bars are dissected by the scale cursor. This change can be done in three different ways. You can do any of the following: 1. Double click on the scale bar, to display the Edit Scale Range dialog. 2. Right-click in the scale bar, and select Properties to display the Edit Scale Range dialog. 3. Drag one of the extremities of the bar with the mouse pointer. Feature types not toggled in the layer visibility will be highlighted in dark green on the Feature Type list and will not be affected by the scale line placement. In order to configure a WMS server with the scale configuration you designed, you must export your project as an OGC Web Map Context, and based on it, build a ContextProvider. See Saving a View as an OGC Web Map Context for more details on how to export a context. When the WMS server you access publishes "Scale Hint" information for a layer, this hint is converted to the Scale Range for this layer in the ERDAS APOLLO Style Editor. Further changes in the Scale Range panel will override the Scale Hint.
Style Rules Each rule is customizable through a set of parameters organized in tabs on the Style Properties dialog.
126
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Topics Uniform Rule ...... 127 Classification Rules ...... 144 Uniform Roads Rule ...... 164 Known Symbol Rule ...... 171 Feature Numberer Rule ...... 173 Variable Markers Rule ...... 176 Patterner Rule ...... 179 Symbol Roller Rule ...... 181 Common Elements ...... 183
Uniform Rule The Uniform styling rule is valid for applying the same default style (colors and symbols) to all of the features types in a layer. This is useful for demonstrating where the features of a layer are located.
127
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Whether you want to portray points, lines, or polygons, use this basic rule to control the various parameters relevant to the chosen geometry.
The Uniform rule is customizable through a set of parameters organized in the following tabs:
Graphic Tab: Edit parameters associated with drawing the feature geometry.
Marker Tab: Use the Marker tab to select the type of marker to portray your point symbols. Additionally, you may customize additional parameters to modify the marker's appearance such as the marker size, labeling properties, symbol type, color and fill.
This option is present only with the point geometry type.
Label Tab: Edit parameters associated with labeling the feature.
128
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Topics Uniform Rule for Point Features ...... 129 Uniform Rule for Line Features ...... 134 Uniform Rule for Polygon Features ...... 139 Uniform Rule Example ...... 144
Uniform Rule for Point Features
Graphic Settings
Antialiasing - Antialiasing is used for smoothing jagged edges in text characters and line segments. Enabling it may dramatically improve readability, but may affect the ERDAS APOLLO Style Editor's performance.
These anti-aliasing options are available from the drop-down menu:
None Antialiasing is not applied at all, resulting in faster performance but jagged edges may appear on text characters and line segments.
Shapes Only Antialiasing is applied only to line segments. Text at small sizes may appear jagged.
Text Only Antialiasing is applied to text only, but line segments may appear jagged.
Full This is the default value for this option. Antialiasing is applied to both text and line segments. This is the smoother and the slower rendering mode.
129
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Marker Settings
Size - Two values, expressed in pixels, define the width and height of the marker.
Only On Labels - Defines whether the marker will be rendered for each instance of a point feature or for each attached label. When markers are tied to the label, they are rendered after the clash management process. This renders an easier-to-read map with properly placed labels.
Selected Render a marker for each label generated. This takes place after the Clash Management process, meaning some labels and symbols may have been removed for ease of map viewing.
Unselected One marker will be rendered for each geometry, regardless of the Clash Management process.
Symbol - Choose a symbol in the drop-down list of standard symbols or by selecting an SVG, PNG, GIF or TrueType font file on your local computer or mounted network disks. The chosen symbol is resized according to the size expressed in the size option.
130
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
While browsing the existing symbols, you can add your own symbols and remove the existing ones. This is achieved through the context menu opened by right-clicking a symbol.
There are two kinds of symbols. Some symbols enclose the outline and fill color, while others can be customized using Inherits in this panel.
Blue Circle, Blue Square, Green Draws the symbol selected from the default symbol menu. Circle, Green Square, Red Circle, Red Square
Inherited Style Circle or Square Renders a Circle (or Square) whose colors are defined in the Inherits section of the Marker panel.
Inherits Section - Define the outline and fill colors for an Inherited Style SVG symbol.
When correctly encoded to allow inheritance, an SVG symbol can be modified by the ERDAS APOLLO Style Editor. This means you are able to change its color properties for both the outline and fill of the symbol. Stroke Paint - Defines the outline color for the selected Inherited Style symbol. Select colors from the drop-down color list or use the color palette by clicking the ... button. Set the stroke color to none by un-checking the box to the left of the colors drop-down list.
Fill Paint - Defines the fill color for the selected Inherited Style symbol. Select color from the drop-down color list or use the color palette by clicking the ... button. Set the fill color to none by un-checking the box to the left of the colors drop-down list.
When the chosen symbol is a TrueType font (generally a .ttf file), an additional panel opens to choose the symbol (glyph) from the list.
131
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Label Settings
Property - Lists all properties exposed by the data source (either WFS or local shapefile) where you select the one you want to use as the labeling property.
Font - Choose the font to be used for text labels through a standard font chooser.
The fonts available in the font chooser are the ones installed on your local computer. Ensure the font that you chose is available on your remote server. If the selected font is not available on the remote server, font substitution will take place and the produced map may be slightly different from the preview in the ERDAS APOLLO Style Editor. Color - Defines the text color for the label. Select a color from the drop-down list or use the color palette by clicking the ... button.
Halo - You can add a Halo to your labels. The Halo option is essentially a background color for your labels. You can use it to draw attention to the labels that you have created. You can select a color and width in pixels for the halo of your text labels. This functionality is useful if you want to be sure your text can be read when used in every
132
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
kind of map, regardless of the color used in the other layers. For example, you may want to set a black text and a white surrounding halo. In this way your text can be read regardless of the underlying layer colors.
Width - Sets the width of the halo in pixels. You can deactivate the halo by deselecting the check box in front of the size entry box.
Color - Defines the halo color for the label. A color can be chosen from the drop-down list or use the color palette by clicking the ... button.
Management - You may choose to align your feature labels in the same location with respect to the feature being labeled. Choosing the alignment management option allows you to pick the location in which the label should be located in terms of the point feature.
Alignment - Select where to render the label relative to the point (or geometry). There are nine values for label alignment.
Top Left Top Top Right
Left Center Right
Bottom Left Bottom Bottom Right
Anti Clashing - You can choose to avoid label text that "runs-into" other label text on your display. The Anti-Clashing option activates Clash Management whose goal is to avoid label overlapping at rendering time.
Max. Count - Sets the maximum number of labels to be kept after Clash Management. For example, if you have a layer with 1000 points, you may ask the Clash Management to:
Remove any overlapping labels.
Only keep a maximum number or a given number of labels (100, for example) to insure map readability.
Target Layer - Specify whether you want the labels to be drawn on the current layer or to be drawn on the Map Dressing layer.
This Labels are drawn on the current layer.
Dressing Labels are drawn on the Map Dressing layer. Using this method, the labels will be on the upper most layer for this provider. This ensures better readability of the produced map.
Label Distribution - Specify how you want labels to be placed on features with multiple geometries.
Biggest Only label the largest geometry in the collection
133
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
First Only label the first geometry in the collection
All Label all geometries in the collection
Uniform Rule for Line Features
Graphic Settings
Antialiasing - Antialiasing is used for smoothing jagged edges in text characters and line segments. Enabling it may dramatically improve readability, but may affect the ERDAS APOLLO Style Editor's performance.
These anti-aliasing options are available from the drop-down menu:
None Antialiasing is not applied at all, resulting in faster performance but jagged edges may appear on text characters and line segments.
Shapes Only Antialiasing is applied only to line segments. Text at small sizes may appear jagged.
134
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Text Only Antialiasing is applied to text only, but line segments may appear jagged.
Full This is the default value for this option. Antialiasing is applied to both text and line segments. This is the smoother and the slower rendering mode.
Paint - Selects a paint color for the feature.
Select this color from the drop-down color list or use the color palette by clicking the ... button.
Deactivate the Paint option by unchecking the box next to the color drop down option.
Width - Defines the line's width. This value is expressed in the unit chosen from the drop down unit selector. See the table below for details on width unit options.
SRS Units Width value is a number of units in the result image SRS. These units may be degrees, meters, inches or any other linear measure depending on the SRS used. This way width is strongly tied to the image scale.
Pixels Value is expressed in pixels in the resulting image, regardless of its scale.
Meters Width value is converted into meters in the resulting image SRS. This is somewhat the same behavior as the SRS Units option.
Percent Value is expressed as a percentage of the result envelope.
See section "7.10 Units" of W3C Scalable Vector Graphics (SVG) 1.1 for more details on unit specification. Cap - Choose the type of end caps for your linear features. End caps specify the shape of the endpoints of an open path.
Butt Terminate unclosed subpaths and dash segments with no added decoration. By default, end caps use this setting.
Round Terminate unclosed subpaths and dash segments with a round decoration that has a radius equal to half of the width of the line stroke.
135
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Square Terminate unclosed subpaths and dash segments with a square projection that extends beyond the end of the segment to a distance equal to half of the line width stroke.
Join - Sets how you want your lines to be joined together:
Bevel Join path segments by connecting the outer corners of their wide outlines with a straight segment. A beveled join will display corners as squared-off path segment corners, so that the joint appears flat rather than rounded or pointed.
Miter Join path segments by extending their outside edges until they meet. This is the default option. Miter joins path segments with sharp corners that extend to a single point.
Round Join path segments by rounding off the corner at a radius of half the line width.
Dashing - Set if you want lines to be continuous, dashed, or dotted.
Continuous ______
Dotted ......
Dashed ------
Dash Dot - . - . - . - . -
Dash Dot Dot - . . - . . - . . - . .
136
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Label Settings
Property - Lists all properties exposed by the data source (either WFS or local shapefile) where you select the one you want to use as the labeling property.
Font - Choose the font to be used for text labels through a standard font chooser.
The fonts available in the font chooser are the ones installed on your local computer. Ensure the font that you chose is available on your remote server. If the selected font is not available on the remote server, font substitution will take place and the produced map may be slightly different from the preview in the ERDAS APOLLO Style Editor. Color - Defines the text color for the label. Select a color from the drop-down list or use the color palette by clicking the ... button.
Halo - You can add a Halo to your labels. The Halo option is essentially a background color for your labels. You can use it to draw attention to the labels that you have created. You can select a color and width in pixels for the halo of your text labels. This functionality is useful if you want to be sure your text can be read when used in every kind of map, regardless of the color used in the other layers. For example, you may
137
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
want to set a black text and a white surrounding halo. In this way your text can be read regardless of the underlying layer colors.
Width - Sets the width of the halo in pixels. You can deactivate the halo by deselecting the check box in front of the size entry box.
Color - Defines the halo color for the label. A color can be chosen from the drop-down list or use the color palette by clicking the ... button.
Management - You may choose to align your feature labels in the same location with respect to the feature being labeled. Choosing the alignment management option allows you to pick the location in which the label should be located in terms of the point feature.
Alignment - Select where to render the label relative to the point (or geometry). There are nine values for label alignment.
Top Left Top Top Right
Left Center Right
Bottom Left Bottom Bottom Right
Anti Clashing - You can choose to avoid label text that "runs-into" other label text on your display. The Anti-Clashing option activates Clash Management whose goal is to avoid label overlapping at rendering time.
Max. Count - Sets the maximum number of labels to be kept after Clash Management. For example, if you have a layer with 1000 points, you may ask the Clash Management to:
Remove any overlapping labels.
Only keep a maximum number or a given number of labels (100, for example) to insure map readability.
Target Layer - Specify whether you want the labels to be drawn on the current layer or to be drawn on the Map Dressing layer.
This Labels are drawn on the current layer.
Dressing Labels are drawn on the Map Dressing layer. Using this method, the labels will be on the upper most layer for this provider. This ensures better readability of the produced map.
Label Distribution - Specify how you want labels to be placed on features with multiple geometries.
Biggest Only label the largest geometry in the collection
138
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
First Only label the first geometry in the collection
All Label all geometries in the collection
Uniform Rule for Polygon Features
Graphic Settings
Antialiasing - Antialiasing is used for smoothing jagged edges in text characters and line segments. Enabling it may dramatically improve readability, but may affect the ERDAS APOLLO Style Editor's performance.
These anti-aliasing options are available from the drop-down menu:
None Antialiasing is not applied at all, resulting in faster performance but jagged edges may appear on text characters and line segments.
139
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Shapes Only Antialiasing is applied only to line segments. Text at small sizes may appear jagged.
Text Only Antialiasing is applied to text only, but line segments may appear jagged.
Full This is the default value for this option. Antialiasing is applied to both text and line segments. This is the smoother and the slower rendering mode.
Paint - Selects a paint color for the feature.
Select this color from the drop-down color list or use the color palette by clicking the ... button.
Deactivate the Paint option by unchecking the box next to the color drop down option.
Width - Defines the line's width. This value is expressed in the unit chosen from the drop down unit selector. See the table below for details on width unit options.
SRS Units Width value is a number of units in the result image SRS. These units may be degrees, meters, inches or any other linear measure depending on the SRS used. This way width is strongly tied to the image scale.
Pixels Value is expressed in pixels in the resulting image, regardless of its scale.
Meters Width value is converted into meters in the resulting image SRS. This is somewhat the same behavior as the SRS Units option.
Percent Value is expressed as a percentage of the result envelope.
See section "7.10 Units" of W3C Scalable Vector Graphics (SVG) 1.1 for more details on unit specification. Cap - Choose the type of end caps for your linear features. End caps specify the shape of the endpoints of an open path.
Butt Terminate unclosed subpaths and dash segments with no added decoration. By default, end caps use this setting.
140
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Round Terminate unclosed subpaths and dash segments with a round decoration that has a radius equal to half of the width of the line stroke.
Square Terminate unclosed subpaths and dash segments with a square projection that extends beyond the end of the segment to a distance equal to half of the line width stroke.
Join - Sets how you want your lines to be joined together:
Bevel Join path segments by connecting the outer corners of their wide outlines with a straight segment. A beveled join will display corners as squared-off path segment corners, so that the joint appears flat rather than rounded or pointed.
Miter Join path segments by extending their outside edges until they meet. This is the default option. Miter joins path segments with sharp corners that extend to a single point.
Round Join path segments by rounding off the corner at a radius of half the line width.
Dashing - Set if you want lines to be continuous, dashed, or dotted.
Continuous ______
Dotted ......
Dashed ------
Dash Dot - . - . - . - . -
Dash Dot Dot - . . - . . - . . - . .
Fill - Selects a paint color for filling the area of a polygon.
Choose a color from the drop-down color list or use the color palette by clicking the ... button.
141
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Label Settings
Property - Lists all properties exposed by the data source (either WFS or local shapefile) where you select the one you want to use as the labeling property.
Font - Choose the font to be used for text labels through a standard font chooser.
The fonts available in the font chooser are the ones installed on your local computer. Ensure the font that you chose is available on your remote server. If the selected font is not available on the remote server, font substitution will take place and the produced map may be slightly different from the preview in the ERDAS APOLLO Style Editor. Color - Defines the text color for the label. Select a color from the drop-down list or use the color palette by clicking the ... button.
Halo - You can add a Halo to your labels. The Halo option is essentially a background color for your labels. You can use it to draw attention to the labels that you have created. You can select a color and width in pixels for the halo of your text labels. This functionality is useful if you want to be sure your text can be read when used in every kind of map, regardless of the color used in the other layers. For example, you may want to set a black text and a white surrounding halo. In this way your text can be read regardless of the underlying layer colors.
Width - Sets the width of the halo in pixels. You can deactivate the halo by deselecting the check box in front of the size entry box.
142
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Color - Defines the halo color for the label. A color can be chosen from the drop-down list or use the color palette by clicking the ... button.
Management - You may choose to align your feature labels in the same location with respect to the feature being labeled. Choosing the alignment management option allows you to pick the location in which the label should be located in terms of the point feature.
Alignment - Select where to render the label relative to the point (or geometry). There are nine values for label alignment.
Top Left Top Top Right
Left Center Right
Bottom Left Bottom Bottom Right
Anti Clashing - You can choose to avoid label text that "runs-into" other label text on your display. The Anti-Clashing option activates Clash Management whose goal is to avoid label overlapping at rendering time.
Max. Count - Sets the maximum number of labels to be kept after Clash Management. For example, if you have a layer with 1000 points, you may ask the Clash Management to:
Remove any overlapping labels.
Only keep a maximum number or a given number of labels (100, for example) to insure map readability.
Target Layer - Specify whether you want the labels to be drawn on the current layer or to be drawn on the Map Dressing layer.
This Labels are drawn on the current layer.
Dressing Labels are drawn on the Map Dressing layer. Using this method, the labels will be on the upper most layer for this provider. This ensures better readability of the produced map.
Label Distribution - Specify how you want labels to be placed on features with multiple geometries.
Biggest Only label the largest geometry in the collection
First Only label the first geometry in the collection
All Label all geometries in the collection
Label distribution - Specify how to label multi-polygon features: all polygons of the collection, the first one, or the biggest one.
143
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Uniform Rule Example Here is a sample map, composed of three layers and produced by the ERDAS APOLLO Style Editor using Uniform style rules: Uniform - Sample Styles
Placename Layer Composed of three features with point geometry. They are displayed in green with a fill color. No labels have been drawn for these points.
Rivers Composed of lines and are rendered in blue with a 1 pixel width.
Land Use Composed of polygons rendered in yellow with a red outline of 1 pixel width.
Classification Rules Classifying data is the process of grouping your data together into classes that have similar values. One classifies data in order to make the different data in your map easier to understand and manage. You can also classify your data to discover and expose spatial patterns in your geodata that are not obvious. The ERDAS APOLLO Style Editor includes two different methods to classify your data. The type of classification that you choose should depend on the type of data you intend to classify.
Discrete Classification - If your data are categorical, such as unique names for land use parcels or types of roads, you should choose the discrete classification type.
Range Classification - If your data are raw (such as population counts), ranked to show a progression of values (such as best to worst scholastic scores in a given
144
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
region), or represent percentages (such as percentage of given area that are affected by pollution), you should use the range classification type.
You can apply classification on any valid data type: points, lines or polygons. Simply open the properties of the layer you want to classify by right-clicking on the layer or double-click the layer itself. To help you create styles for each value or range of values of your classification, use the Classes Populator in the ERDAS APOLLO Style Editor. This tool creates a collection of styles by allowing you to modify their parameters according to a specified color palette or color gradient. You can also edit or create additional styles manually to append additional values to your classification or even create a brand new classification.
Topics Discrete Classification ...... 145 Range Classification ...... 154 Classification Rule Example ...... 162
Discrete Classification After you open the styling properties of a layer, choose the Discrete Classification option. The Discrete Classification style presents three tabs:
General Settings: Provides a set of options to configure a display for values for your specified classes. This panel offers the same options as the Uniform styling rule's Graphic panel. It changes according to the geometry you want to render. See the Graphic Settings section in Uniform Rule for Point Features (on page 129), Uniform Rule for Line Features (on page 134) or Uniform Rule for Polygon Features (on page 139) for more information about the options in the panel.
Classification Settings: Build your classification's classes.
Label Settings: Define your labeling options. This panel offers the same options as the Uniform styling rule's Label panel. See the Label Settings section in Uniform Rule for Point Features (on page 129) for more information about the options in the panel.
145
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Classification Settings
Property - In order to classify your data, you must choose a field from your geographic data that contains valid information for classification. If your layer references a valid table or object database, you may click the drop-down menu on the Property dialog. The menu exposes the fields in your table or object database that are valid for creating classifications for the selected layer's features.
Type - Defines the type of data you build your classification upon.
Literal Matching is done on a character-by-character basis between the key and the string value of the data field. This is the default matching type and corresponds to the most common usage.
Integer Matching is done on an integer basis. This may be useful when the classification keys are logically integers, but the feature data field has a real number type (values are rounded to the nearest integer before matching).
146
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Real Number Matching is done on a real number basis, with a limited precision of 1/1000th. This ensures that the right classification styles are chosen when using real number data, including between different computer architectures (values are rounded a bit before matching).
Styles - Define all your classification's classes either manually or by using the Classes Populator.
This table lists the already defined classes by their key value. There is an overview of the style associated with each class. Key: Value to which the selected feature's property should be rendered as defined in the associated style.
Style: This area displays an icon previewing the associated style (mainly line and fill color).
See Creating Classes Manually for Discrete Classification below for information on how to create and edit classes manually. Opacity - Opens a window to control the opacity level for the entire layer. Opacity ranges from 0 to 255 and is set once for the layer. You can also define an opacity level for one class by setting the "opacity" property of its associated style fill color.
Populate - Open the Classes Populator.
See Creating Classes with Classes Populator for Discrete Classification to learn how to use this tool.
147
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Creating Classes Manually for Discrete Classification Classes can be created manually. You must first create a new entry in the classes table, assign it a value and define a style for it based on the Labeled Basic Style type.
To create a new class: 1. Right-click on any class and select Insert. A new line is added to the Styles Table. 2. Enter a key value for your class. Right-click on this class and select edit. The Edit dialog opens. 3. Set the style options to reflect the display you want and then click the Close button to close the window and save your changes. Click the Next button to edit the following class (according to the Styles Table order).
148
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The following Edit window options are available to define a style for a specific class:
Title - Define a title for your classification. This title will be used when displaying a legend for your classification. If no values are entered here, the legend is generated with the key value as a title for the class.
Graphic - Define the display of the feature classification. The options are the same as for the Graphic panel of the Labeled Basic Style rule.
Paint - Selects a paint color for the feature.
Select this color from the drop-down color list or use the color palette by clicking the ... button.
Deactivate the Paint option by unchecking the box next to the color drop down option.
Width - Defines the line's width. This value is expressed in the unit chosen from the drop down unit selector. See the table below for details on width unit options.
SRS Units Width value is a number of units in the result image SRS. These units may be degrees, meters, inches or any other linear measure depending on the SRS used. This way width is strongly tied to the image scale.
Pixels Value is expressed in pixels in the resulting image, regardless of its scale.
Meters Width value is converted into meters in the resulting image SRS. This is somewhat the same behavior as the SRS Units option.
149
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Percent Value is expressed as a percentage of the result envelope.
See section "7.10 Units" of W3C Scalable Vector Graphics (SVG) 1.1 for more details on unit specification. Cap - Choose the type of end caps for your linear features. End caps specify the shape of the endpoints of an open path.
Butt Terminate unclosed subpaths and dash segments with no added decoration. By default, end caps use this setting.
Round Terminate unclosed subpaths and dash segments with a round decoration that has a radius equal to half of the width of the line stroke.
Square Terminate unclosed subpaths and dash segments with a square projection that extends beyond the end of the segment to a distance equal to half of the line width stroke.
Join - Sets how you want your lines to be joined together:
Bevel Join path segments by connecting the outer corners of their wide outlines with a straight segment. A beveled join will display corners as squared-off path segment corners, so that the joint appears flat rather than rounded or pointed.
Miter Join path segments by extending their outside edges until they meet. This is the default option. Miter joins path segments with sharp corners that extend to a single point.
Round Join path segments by rounding off the corner at a radius of half the line width.
Dashing - Set if you want lines to be continuous, dashed, or dotted.
Continuous ______
Dotted ......
Dashed ------
Dash Dot - . - . - . - . -
150
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Dash Dot Dot - . . - . . - . . - . .
Fill - Selects a paint color for filling the area of a polygon.
Choose a color from the drop-down color list or using the color palette by clicking the ... button.
Next - Saves your modifications and displays the styles parameters for the next class according to the order of the layers.
Close - Saves your modifications and closes the window.
Creating Classes with Classes Populator for Discrete Classification Use the Classes Populator to easily populate classifications of your data. It provides an easy way to build classifications based on a color palette, color gradient, or a two color interpolation. The tool also lets you specify a fixed number of values (or value ranges when used from a Range Classification). To create classes using the Classes Populator: 1. Create a new Discrete Classification rule. Open the style properties and select the Classification panel. 2. Select a feature property to classify upon. 3. Select a type for the feature's property. 4. Click the Populate button. The Populate Style List dialog opens. 5. Set the General parameters on the Populate Style List dialog
Max. Value Count - Defines the maximum number of different values to be kept when generating classes.
151
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
When used with a Discrete Classification, the n -being the maximum number of values- first values coming from the features are kept while all other values are displayed using the default style as defined in the General panel of the Discrete Classification.
Paint - Selects a paint color for the feature.
Select this color from the drop-down color list or use the color palette by clicking the ... button.
Deactivate the Paint option by unchecking the box next to the color drop down option.
Width - Defines the line's width. This value is expressed in the unit chosen from the drop down unit selector. See the table below for details on width unit options.
SRS Units Width value is a number of units in the result image SRS. These units may be degrees, meters, inches or any other linear measure depending on the SRS used. This way width is strongly tied to the image scale.
Pixels Value is expressed in pixels in the resulting image, regardless of its scale.
Meters Width value is converted into meters in the resulting image SRS. This is somewhat the same behavior as the SRS Units option.
Percent Value is expressed as a percentage of the result envelope.
See section "7.10 Units" of W3C Scalable Vector Graphics (SVG) 1.1 for more details on unit specification.
Fill Color - Selects a paint color for filling the area of a polygon.
Choose a color from the drop-down color list or using the color palette by clicking the ... button.
152
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
6. Set the Advanced parameters
Max. Feature Count - Defines the maximum number of features to be retrieved from the data source, either local or remote, to build the classes. The check box in front of the input field allows you to de-activate this feature.
Reducing the maximum number of features to be retrieved may significantly improve classes building time if the data source holds a large amount of features.
When used, the classes' values are computed over the reduced set of data fetched. This means some values may not be taken into account when viewing the complete data set.
Clear Existing Styles - Determines whether the existing classes should be erased when generating new classifications.
If you want to create a brand new set of classification classes, choose True. If you want the newly generated classes to be appended to the existing ones, choose False.
Key Sorting - This section handles the generated classes order. This is important if you style your classification with the color gradient or color palette and you want the colors to reflect a data value.
Ordering - Even when doing a discrete classification, it is better to have values ordered in a logical way. Note that this setting has no effect on rendering, but may ease the editing of generated classes lists.
None Classified values are not sorted. This is the fastest option.
Natural Classified values are sorted lexicographically. This is the default option.
Numeric Classified values are sorted in a pseudo-numeric order.
153
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Reversed - When an ordering has been set on classification keys, you may reverse the resulting list.
7. Click OK for the classes to be generated and added to the Styles Table.
Range Classification After you open the styling properties of a layer and select the Range Classification option, the Range Classification Rule presents three panels:
General Settings: Provides a set of options to configure a display for values for your specified classes. This panel offers the same options as the Uniform styling rule's Graphic panel. It changes according to the geometry you want to render. See the Graphic Settings section in Uniform Rule for Point Features (on page 129), Uniform Rule for Line Features (on page 134) or Uniform Rule for Polygon Features (on page 139) for more information about the options in the panel.
Classification settings: This panel is similar to the Discrete Classification panel except for the lack of the feature's property type selection. Range classification assumes the property type is numeric.
Label Settings: Define your labeling options. This panel offers the same options as the Uniform styling rule's Label panel. See the Label Settings section in Uniform Rule for Point Features (on page 129) for more information about the options in the panel.
154
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Classification Settings
Property - Sets the feature's property upon which you build your classification. The drop-down list shows the complete list of available properties for the selected layer's features.
Range classification can only be made upon numeric values. This is why you cannot select a property type. The Discrete Classification - Classification panel allows this type of behavior. Entries - Define all your classification's classes either manually or by using the Classes Populator.
This table lists the already defined classes by their key value. There is an overview of the style associated with each class. Key: Range of values to which the selected feature's property should be rendered as defined in the associated style. The key values here are composed of two comma separated numeric values to represent the range.
155
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Style: This area displays an icon previewing the associated style (mainly line and fill color).
See Creating Classes Manually for Range Classification below for information on how to create and edit classes manually. Opacity - Opens a window to control the opacity level for the entire layer. Opacity ranges from 0 to 255 and is set once for the layer. You can also define an opacity level for one class by setting the "opacity" property of its associated style fill color.
Populate - Open the Classes Populator.
See Creating Classes with Classes Populator for Range Classification below to learn how to use this tool.
Creating Classes Manually for Range Classification Classes can be created manually. You must first create a new entry in the classes table, assign it a value and define a style for it based on the Labeled Basic Style type.
To create a new class: 1. Right-click on any class and select Insert. A new line is added to the Styles Table.
156
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
2. Enter a key value for your class. Right-click on this class and select edit. The Edit dialog opens. 3. Set the style options to reflect the display you want and then click the Close button to close the window and save your changes. Click the Next button to edit the following class (according to the Styles Table order). The following Edit window options are available to define a style for a specific class:
Title - Define a title for your classification. This title will be used when displaying a legend for your classification. If no values are entered here, the legend is generated with the key value as a title for the class.
Graphic - Define the display of the feature classification. The options are the same as for the Graphic panel of the Labeled Basic Style rule.
Paint - Selects a paint color for the feature.
Select this color from the drop-down color list or use the color palette by clicking the ... button.
Deactivate the Paint option by unchecking the box next to the color drop down option.
Width - Defines the line's width. This value is expressed in the unit chosen from the drop down unit selector. See the table below for details on width unit options.
SRS Units Width value is a number of units in the result image SRS. These units may be degrees, meters, inches or any other linear measure depending on the SRS used. This way width is strongly tied to the image scale.
157
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Pixels Value is expressed in pixels in the resulting image, regardless of its scale.
Meters Width value is converted into meters in the resulting image SRS. This is somewhat the same behavior as the SRS Units option.
Percent Value is expressed as a percentage of the result envelope.
See section "7.10 Units" of W3C Scalable Vector Graphics (SVG) 1.1 for more details on unit specification. Cap - Choose the type of end caps for your linear features. End caps specify the shape of the endpoints of an open path.
Butt Terminate unclosed subpaths and dash segments with no added decoration. By default, end caps use this setting.
Round Terminate unclosed subpaths and dash segments with a round decoration that has a radius equal to half of the width of the line stroke.
Square Terminate unclosed subpaths and dash segments with a square projection that extends beyond the end of the segment to a distance equal to half of the line width stroke.
Join - Sets how you want your lines to be joined together:
Bevel Join path segments by connecting the outer corners of their wide outlines with a straight segment. A beveled join will display corners as squared-off path segment corners, so that the joint appears flat rather than rounded or pointed.
Miter Join path segments by extending their outside edges until they meet. This is the default option. Miter joins path segments with sharp corners that extend to a single point.
Round Join path segments by rounding off the corner at a radius of half the line width.
Dashing - Set if you want lines to be continuous, dashed, or dotted.
158
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Continuous ______
Dotted ......
Dashed ------
Dash Dot - . - . - . - . -
Dash Dot Dot - . . - . . - . . - . .
Fill - Selects a paint color for filling the area of a polygon.
Choose a color from the drop-down color list or using the color palette by clicking the ... button.
Next - Saves your modifications and displays the styles parameters for the next class according to the order of the layers.
Close - Saves your modifications and closes the window.
Creating Classes with Classes Populator for Range Classification Use the Classes Populator tool to easily create all the classes of a classification. However, the panels slightly change in terms of handling numeric values as opposed to key values. To create classes using Classes Populator: 1. Create a new Range Classification rule. Open the style's properties and select the Classification panel. 2. Select a feature property to classify upon. 3. Select a type for the feature's property. 4. Click the Populate button. The Populate Style List dialog opens.
159
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
5. Set the General parameters on the Populate Style List dialog
Nb of Classes - Defines the number of classes to be generated.
Graphic Sources - You can query data from the data source, check the selected property's range values and then split it in "n" sub ranges (n being the number of requested steps).
Paint - Selects a paint color for the feature.
Select this color from the drop-down color list or use the color palette by clicking the ... button.
Deactivate the Paint option by unchecking the box next to the color drop down option.
Width - Defines the line's width. This value is expressed in the unit chosen from the drop down unit selector. See the table below for details on width unit options.
SRS Units Width value is a number of units in the result image SRS. These units may be degrees, meters, inches or any other linear measure depending on the SRS used. This way width is strongly tied to the image scale.
Pixels Value is expressed in pixels in the resulting image, regardless of its scale.
Meters Width value is converted into meters in the resulting image SRS. This is somewhat the same behavior as the SRS Units option.
160
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Percent Value is expressed as a percentage of the result envelope.
See section "7.10 Units" of W3C Scalable Vector Graphics (SVG) 1.1 for more details on unit specification. Fill Color - Selects a paint color for filling the area of a polygon.
Choose a color from the drop-down color list or using the color palette by clicking the ... button. 6. Set the Advanced parameters
Max. Feature Count - Defines the maximum number of features to be retrieved from the data source, either local or remote, to build the classes. The check box in front of the input field allows you to deactivate this feature.
Reducing the maximum number of features to be retrieved may highly improve classes building time if the data source holds a large amount of features.
When used, the classes' values are computed over the reduced set of data retrieved. This means some values may not be taken into account when viewing the complete data set.
Clear Existing Styles - Determines whether or not the already existing classes should be erased when generating new ones.
If you want to create a brand new set of classification classes, select True. If you want the newly generated classes to append the existing ones, select False.
Classification - Type - Select from three different classification types: Linear, Logarithmic, and Quantile to compute the bounds of the intervals. First choose the number of classes you want and the classification types. For example, you have a
161
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
population property for 20 regions in a country. The value range is from 0-20,000. You have chosen to display only five classes or intervals.
Linear Divides the value range into five equivalent intervals. For the example, the first class displays values from 0-4000 and the second class displays from 4000-8000. Each region that has less than a population of 4000 is drawn using the geometry properties assigned to the first classification interval.
Logarithmic Divides the value range into five intervals using a logarithmic progression to compute each interval range. Therefore, in the example, the first class is 0 to 10.89 and the second is 10.89 to 140.42. The interval sizes actually grow in an exponential way.
Quantile Each class contains the same number of features. Population counts (as opposed to density or percentage), for example, are usually not suitable for quantile classification because only a few places are highly populated. Quantiles are best suited for data that is linearly distributed; in other words, data that does not have disproportionate numbers of features with similar values.
7. Click OK for the classes to be generated and added to the Styles Tables.
Classification Rule Example Here is a sample map, composed of two layers and produced by the ERDAS APOLLO Style Editor using the Classification style rules:
Protected Areas Ranged classification with a style variation on the fill opacity (from 85 to 175).
162
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Land Use Discrete classification upon land usage code styled with a dedicated color palette.
163
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Uniform Roads Rule This rule is meant for rendering data representing types of roads. Although the parameters are similar to the Uniform Rule for Line Features (on page 134), the rendering process has been updated to enable users to portray roads and line segment junctions more efficiently. The labeling contained in this rule also allows road and river specific behaviors, such as spline labeling. This rule can be used with line geometry only. The rule configuration is composed of three panels.
Graphic Settings: As with the Uniform Rule for Line Features (on page 134) setting, you may configure the options for styling lines and center lines in terms of color, line types, end points and joining.
Label Settings: Define your labeling options.
Symbol Settings: Apply a symbol to the feature being drawn, either from those already supplied with ERDAS APOLLO Style Editor or by importing one of your own collections.
164
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Graphic Settings
Antialiasing - Antialiasing is used for smoothing jagged edges in text characters and line segments. Enabling it may dramatically improve readability, but may affect the ERDAS APOLLO Style Editor's performance.
These anti-aliasing options are available from the drop-down menu:
None Antialiasing is not applied at all, resulting in faster performance but jagged edges may appear on text characters and line segments.
Shapes Only Antialiasing is applied only to line segments. Text at small sizes may appear jagged.
Text Only Antialiasing is applied to text only, but line segments may appear jagged.
Full This is the default value for this option. Antialiasing is applied to both text and line segments. This is the smoother and the slower rendering mode.
Outline, Centerline - These groups set the line features of the road outline and centerline.
165
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Width - Defines the line's width. This value is expressed in the unit chosen from the drop down unit selector. See the table below for details on width unit options.
SRS Units Width value is a number of units in the result image SRS. These units may be degrees, meters, inches or any other linear measure depending on the SRS used. This way width is strongly tied to the image scale.
Pixels Value is expressed in pixels in the resulting image, regardless of its scale.
Meters Width value is converted into meters in the resulting image SRS. This is somewhat the same behavior as the SRS Units option.
Percent Value is expressed as a percentage of the result envelope.
See section "7.10 Units" of W3C Scalable Vector Graphics (SVG) 1.1 for more details on unit specification. Paint - Selects a paint color for the feature.
Select this color from the drop-down color list or use the color palette by clicking the ... button.
Deactivate the Paint option by unchecking the box next to the color drop down option.
166
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Label Settings
Property - Lists all properties exposed by the data source (either from a WFS or local shapefile). Select the one you want to use as the labeling property.
Font - Choose the font to be used for text labels through a standard font chooser.
The fonts available in the font chooser are the ones installed on your local computer. Ensure the font you have chosen is available on your remote server. If the selected font is not available on the remote server, font substitution will take place and the produced map may be slightly different from the preview in the ERDAS APOLLO Style Editor. Color - Defines the text color for the label. Select a color from the drop-down color list or by using the color palette by clicking the ... button.
Placement - You may choose to align your feature labels in the same location with respect to the feature being labeled. Choosing the alignment management option allows you to pick the location in which the label should be located in terms of the point feature.
Horizontal Labels are written horizontally at the centroid of the feature geometry.
167
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
On Curve (Stairs) Individual characters from the text are drawn along the curve without being rotated, producing a staircase effect.
On Curve Individual characters from the text are drawn and rotated to follow the curve.
Over Curve Individual characters from the text are drawn and rotated to follow the curve, but are offset to "float" over the curve.
Under Curve Individual characters from the text are drawn and rotated to follow the curve, but are offset to "hang" under the curve.
Offset - The number of pixels to offset the label from the road.
Path Smoothing - The amount of "smoothing" to apply to the label text.
168
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Symbol Settings
Symbol - Defines the symbol to be used. Click Browse button to choose the symbol in the Select Symbol dialog.
Add new items (SVG, PNG, GIF or TrueType font) and remove the existing ones by right-clicking in the Select Symbol dialog.
169
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
If you choose to add a new item, a browse window opens directly in ERDAS APOLLO Style Editor's Symbols folder where you find other useful images (for example, in Road_Signs you find a shield to properly label U.S. routes).
Inherits - This group of options is specific to SVG symbols which allow color override.
If the selected symbol is not an SVG, or if it is an SVG which does not support this feature, this group is not accessible and its options are displayed in light grey. Fill Paint - Define the interior color of the selected symbol.
Stroke Paint - Defines the outline color of the selected symbol.
Label
Label Property - Lists all properties exposed by the data source (either from a WFS or local shapefile) and allows you to pick the one you want to use as the labelling property.
Font - Choose the font to be used for text labels through a standard font chooser.
Color - Defines the text color for the label. Select a color from the drop-down color list or by using the color palette by clicking the ... button.
Geometry
Size - Define the size of your symbol in pixels.
Uniform Roads Rule Example Here is a sample map, composed of two layers and produced by the ERDAS APOLLO Style Editor using Uniform Roads style rules:
Highways Displays a red centerline with a black outline.
170
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Roads Displays a gray centerline with a black outline.
Known Symbol Rule This rule is meant to display symbols quickly for selected features rather than portray their feature geometry. For performance reasons, it only allows the selection of the symbol from a fixed, predefined set of fast-to-render markers rather than allowing the selection of an arbitrary SVG, PNG, or GIF file as the other rules do. This rule can be used with any kind of geometry. The configuration is composed of three panels.
Graphic Settings: Provides a set of options to configure a display for values for your specified classes.
Symbol Settings: Configure the appearance of your symbol in terms of size and rotation angle.
Label Settings: Define your labeling options. This panel offers the same options as the Uniform styling rule's Label panel. See the Label Settings section in Uniform Rule for Point Features (on page 129) for more information about the options in the panel.
Graphic Settings
Antialiasing - Antialiasing is used for smoothing jagged edges in text characters and line segments. Enabling it may dramatically improve readability, but may affect the ERDAS APOLLO Style Editor's performance.
These anti-aliasing options are available from the drop-down menu:
171
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
None Antialiasing is not applied at all, resulting in faster performance but jagged edges may appear on text characters and line segments.
Shapes Only Antialiasing is applied only to line segments. Text at small sizes may appear jagged.
Text Only Antialiasing is applied to text only, but line segments may appear jagged.
Full This is the default value for this option. Antialiasing is applied to both text and line segments. This is the smoother and the slower rendering mode.
Stroke, Fill - Colors to use to draw and fill the symbols.
Paint - Selects a paint color for the feature.
Select this color from the drop-down color list or use the color palette by clicking the ... button.
Deactivate the Paint option by unchecking the box next to the color drop down option.
Symbol Settings
Known Name - Choose one of the symbol shapes:
Square
Circle
Triangle
172
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Cross
Plus
Moon
Pentagon
Hexagon
Size (pixels) - Define the width and height of the symbols to be displayed.
Angle - Set a rotation angle for the symbols to be displayed.
Known Symbol Rule Example Here is a sample map, composed of three layers and produced by the ERDAS APOLLO Style Editor using Known Symbol style rules:
Place Names White circles with a black stroke
Protected Areas Green crosses
Land Parcels Yellow filled triangles with a red stroke
Feature Numberer Rule The Feature Numberer marks the features with sequential numbers based on the distance of the feature's centroid from the center of the map. A symbol can be specified, in which case the label containing the feature number is overlaid on top of it. A maximum number of symbols/labels can
173
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
be set; if reached, only the features that are the nearest to the map center get numbered and displayed. This rule can be used with any kind of geometry. The configuration is composed of three panels.
Graphic Settings: Provides a set of options to configure a display for values for your specified classes. This panel offers the same options as the Uniform styling rule's Graphic panel. It changes according to the geometry you want to render. See the Graphic Settings section in Uniform Rule for Point Features (on page 129), Uniform Rule for Line Features (on page 134) or Uniform Rule for Polygon Features (on page 139) for more information about the options in the panel.
Marker Settings: Select a symbol on which the numeric counter labels are overlaid.
Numbering Settings: Set aspects of the rule that affect numbering.
Marker Settings Use this panel to select a symbol on which the labels representing the numeric counter will be overlaid. It contains the following configurable properties:
Symbol - Select a symbol already present in the symbol library of the provider, or import a new one by clicking the Browse ... button.
Size - Set the width and height (in pixels) to which the chosen symbol will be resized for display on the map. Select an appropriate marker size according to the numbering font, so that the text appears "circled" by the selected symbol.
174
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Numbering Settings This panel contains the properties related to the numbering (and subsequent labeling) of features.
Font - Choose the font to be used for text labels through a standard font chooser.
The fonts available in the font chooser are the ones installed on your local computer. Ensure the font that you chose is available on your remote server. If the selected font is not available on the remote server, font substitution will take place and the produced map may be slightly different from the preview in the ERDAS APOLLO Style Editor. Color - Defines the text color for the label. Select a color from the drop-down list or use the color palette by clicking the ... button.
Halo - You can add a Halo to your labels. The Halo option is essentially a background color for your labels. You can use it to draw attention to the labels that you have created. You can select a color and width in pixels for the halo of your text labels. This functionality is useful if you want to be sure your text can be read when used in every kind of map, regardless of the color used in the other layers. For example, you may want to set a black text and a white surrounding halo. In this way your text can be read regardless of the underlying layer colors.
Width - Sets the width of the halo in pixels. You can deactivate the halo by deselecting the check box in front of the size entry box.
Color - Defines the halo color for the label. A color can be chosen from the drop-down list or use the color palette by clicking the ... button.
Management
Max Count - Constrain the number of numbered features to be displayed on the map. For example, a Max Count of 5 limits the display to only the five nearest interest points. If the checkbox is left unchecked, no constraints are applied and all features are drawn.
175
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Store As - When set, it instructs the rule to store a list of (feature, number) pairs in the rendering context for later processing. This is useful when the rule is used in conjunction with external clients.
Variable Markers Rule This rule is meant to pin a marker on a geometry, optionally scaling and rotating it according to the feature's property values. This rule is also known under the name "Pinner." This rule can be used with any kind of geometry. The configuration is composed of three panels.
Graphic Settings: Provides a set of options to configure a display for values for your specified classes. This panel offers the same options as the Uniform styling rule's Graphic panel. It changes according to the geometry you want to render. See the Graphic Settings section in Uniform Rule for Point Features (on page 129), Uniform Rule for Line Features (on page 134) or Uniform Rule for Polygon Features (on page 139) for more information about the options in the panel.
Marker Settings: Define the marker to be used and how to configure rotation and scaling according to the feature's properties.
Label Settings: Define your labeling options. This panel offers the same options as the Uniform styling rule's Label panel. See the Label Settings section in Uniform Rule for Point Features (on page 129) for more information about the options in the panel.
176
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Marker Settings
Anti Clashing - Activate the Clash Manager on the generated marker. The Clash Manager is in charge of making all markers visible and avoiding overlap either by slightly moving them or by grouping some of them into a single marker if they are to be drawn in the same area. Clash Management is made according to the map request's scale.
177
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Symbol - Defines the symbol to be used. Click Browse button to choose the symbol in the Select Symbol dialog.
Add new items (SVG, PNG, GIF or TrueType font) and remove the existing ones by right-clicking in the Select Symbol dialog. If you choose to add a new item, a browse window opens directly in ERDAS APOLLO Style Editor's Symbols folder where you find other useful images (for example, in Road_Signs you find a shield to properly label U.S. routes).
Inherits - This group of options is specific to SVG symbols which allow color override.
If the selected symbol is not an SVG, or if it is an SVG which does not support this feature, this group is not accessible and its options are displayed in light grey. Fill Paint - Define the interior color of the selected symbol.
Stroke Paint - Defines the outline color of the selected symbol.
Size Source - Determine how the size of the marker will be computed according to the selected feature's property, a property's value range, and a marker size range. The final marker size is computed by mapping the value range to the marker size range linearly.
Property - The property to use to determine the size of the marker.
Value Range - The minimum and maximum values of the property. Property values outside of this range will automatically be clipped to the nearest bound.
Marker Size Range - The minimum and maximum sizes for the marker.
Orientation Source - Determine how the orientation of the marker will be computed according to the selected feature's property and a rotation value range. The final rotation is computed by linearly mapping the property value range to the rotation range (0 to 360 degrees).
178
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Property - Numeric property used when varying the rotation of the marker.
Value Range - The minimum and maximum values of the property. Property values outside of this range will automatically be clipped to the nearest bound.
Patterner Rule This rule is meant to fill polygonal geometries with a symbol serving as a pattern. A template mechanism on the symbol file name allows you to change the symbol based on the values of the feature type's properties. The rule configuration is made of three panels:
Graphic Settings: Provides a set of options to configure a display for values for your specified classes. This panel offers the same options as the Uniform styling rule's Graphic panel. It changes according to the geometry you want to render. See the Graphic Settings section in Uniform Rule for Point Features (on page 129), Uniform Rule for Line Features (on page 134) or Uniform Rule for Polygon Features (on page 139) for more information about the options in the panel.
Pattern Settings: Where you define the pattern to be used.
Label Settings: Define your labeling options. This panel offers the same options as the Uniform styling rule's Label panel. See the Label Settings section in Uniform Rule for Point Features (on page 129) for more information about the options in the panel.
179
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Pattern Settings
Symbol Template - Here you may provide a link to a local or remote symbol through an HTTP link.
You may also use a relative reference to the rendering symbol directory of the portrayal engine. You may also enter strings with template parameters that evaluate to the name of a symbol file in the renderer library. Parameters within curly brackets are substituted with the corresponding feature property values to generate the symbol template filename. Example: lib/{TYPE}-{CODE}.png
Size - The pixel-equivalent width and height of a pattern title
Pattern Color Sources
Foreground - Here you may select an integer (RGB 32 bits) property of the feature whose value will be used as the pattern foreground color.
Background - Here you may select an integer (RGB 32 bits) property of the feature whose value will be used as the pattern background color.
180
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Symbol Roller Rule The Symbol Roller styling rule stamps scaled/rotated symbols along curves. It obtains the symbols to use for stamping by cycling through a user-configured list. The Symbol Roller rule is composed of two panels.
Graphic Settings: Provides a set of options to configure a display for values for your specified classes. This panel offers the same options as the Uniform styling rule's Graphic panel. See the Graphic Settings section in Uniform Rule for Line Features (on page 134) for more information about the options in the panel.
Symbol Settings: Provides the configuration mechanism for the list of symbols used for stamping.
Use this panel to insert, edit, delete, and reorder the entries of the list of symbols used for stamping. Note that the rule cycles the elements in the list to determine the next symbol to apply, so the order of the entries affects the rendering. Right-click to open the menu options.
New - Creates a new entry, and opens the companion configuration dialog. The entry is inserted in the list when the dialog is closed by clicking OK. See the New Entry dialog below for more information.
Move Up - Moves the current entry up by one position.
Move Down - Moves the current entry down by one position.
Delete - Removes the current entry for the list (destructive operation).
Properties - Shows the companion configuration dialog for the current entry. The Next option is a simple shortcut to skip to the next entry once the current one is configured.
181
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
New Entry Dialog
This dialog opens when you click New or Properties in Symbol Rollers dialog.
Symbol - Defines the symbol to be used. Click Browse button to choose the symbol in the Select Symbol dialog.
Add new items (SVG, PNG, GIF or TrueType font) and remove the existing ones by right-clicking in the Select Symbol dialog. If you choose to add a new item, a browse window opens directly in ERDAS APOLLO Style Editor's Symbols folder where you find other useful images (for example, in Road_Signs you find a shield to properly label U.S. routes).
Inherits - This group of options is specific to SVG symbols which allow color override.
182
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
If the selected symbol is not an SVG, or if it is an SVG which does not support this feature, this group is not accessible and its options are displayed in light grey. Fill Paint - Define the interior color of the selected symbol.
Stroke Paint - Defines the outline color of the selected symbol.
Symbol Orientation - Change the orientation of the symbol by dragging either endpoint of the arrow so that it points in the desired direction.
Common Elements This section describes windows and palette commonly used in the style definition like color palette or font chooser.
Color Chooser The Color Chooser opens from anywhere in the application where a color is requested. It offers the possibility to pick one color from an RGB palette or to make a specific color with Hue-Saturation-Brightness values or Red-Green-Blue values. It also offers the ability to set an opacity level for a rendered color. Color Chooser - Swatches Panel
Select one of the swatches available from the complete palette or from the recently used colors (in the "recent" palette showing the recently chosen colors). The Preview section displays a set of sample usage of the selected color for texts, areas, and reverse texts.
183
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Color Chooser - HSB Panel
This panel allows you to select a color by giving its hue-saturation-brightness values or selecting from within the color gradient. The panel provides, as an indication, the values of the selected color in RGB. Color Chooser - RGB Panel
184
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The RGB (Red-Green-Blue) panel allows you to select a color by entering its RGB values (ranging from 0 to 255). Color Chooser - Opacity Panel
The opacity panel provides a way to set an opacity or transparency level to the selected color. Opacity values range from 0 to 255, 0 being totally transparent and 255 completely opaque.
185
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Font Selector
The font selector is a window used each time a font has been requested as your input. It offers basic font selection behavior and allows you to select one of the fonts installed on your local machine. Be sure to select a font that is also available on the server where you want to deploy your styles. If the selected font is not available on the server, the server will substitute the most similar system font available.
Business Data in the Catalog The most common use of the ERDAS APOLLO catalog is to store imagery, vectors, and service providers. However, you can also catalog business data files such as spreadsheets, PDFs, movies, and other documents. You can add business data using the ERDAS APOLLO Data Manager, the ERDAS APOLLO Catalog Web Interface, or the REST interface of the ERDAS APOLLO Catalog. After you add business data, you will be able to locate it and view it in the Search tab of the ERDAS APOLLO Geospatial Portal or on the Browse page of the ERDAS APOLLO Catalog Web Interface.
Business Data with Exif Metadata When you crawl image data that contains Exif metadata, ERDAS APOLLO will automatically extract and store the Exif metadata in the catalog. The Exif metadata can be viewed in Data Manager or in the Catalog Web Interface. In Data Manager, the Exif metadata for a dataset is
186
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
displayed under the Free Metadata node in the Properties tab. In the Catalog Web Interface, the Exif metadata for a dataset is displayed as properties in the FREE_METADATA section of the web page for a dataset.
Defining Metadata with GIM Files ERDAS APOLLO allows you to define metadata to be associated with a cataloged business document through the use of an optional auxiliary file called a Generic Item Metadata (GIM) file. A GIM file is an xml file that includes metadata about the business document and is associated to it using a naming convention. To associate a GIM file with a business data file, name the GIM file with same name as the business data file but append an extra ".gim" extension to the name. For example, if the business data file name is BalboaPark.png, the GIM file should be named BalboaPark.png.gim. Copy or save the GIM file into the same folder as the business data file. Create the GIMf file before crawling the business data file. ERDAS APOLLO looks for and reads the information in the GIM file when the business data file is crawled. The xml schema for a GIM file includes the following:
Tag Description and Example Optional or Mandatory item type Object Type (mime type) - the type of the object is a Concept that is identified Mandatory by a name. An object type can have a parent object type so it is possible to build a tree of object types. type="image/png"
187
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
" parameter is included. Footprint coordinates should always be specified in x,y or long,lat order.
The following is an example of a complete GIM file based on the example snippets from the table above:
188
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Viewing Business Data in the Catalog Web Interface You can search for business data documents on the Browse page of the Catalog Web Interface (see "Browsing and Searching Content" on page 18) by selecting "Documents" in the Data Type Filter. The Catalog Web Interface displays all of the documents returned by the search. When you click the name of a resource, Catalog Web Interface uses the mime type of the resource to launch the correct application so you can view it.
189
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
190
S E C T I O N 5 Coordinate Reference Systems This section explains how coordinate reference systems are used in ERDAS APOLLO. ERDAS APOLLO software and documentation use the terms "Coordinate Reference System (CRS)" and "Spatial Reference System (SRS)" interchangeably.
In This Section Coordinate Reference System Engines ...... 191 Passing CRS Parameters in Web Requests ...... 192 Adding a Custom CRS ...... 192
Coordinate Reference System Engines ERDAS APOLLO uses several coordinate reference system engines to manage the geospatial data stored in its catalog and to communicate with the wide variety of clients that use ERDAS APOLLO data and services. The primary ERDAS APOLLO coordinate system engine supports over 4,700 geographic and projected coordinate reference systems. These coordinate reference systems as well the transformations that convert coordinates between the various systems are based on the EPSG Geodetic Parameter Dataset. The EPSG Geodetic Parameter Dataset is a collection of coordinate reference systems and transformations originally created by the European Petroleum Survey Group and now maintained by the International Association of Oil and Gas Producers (OGP). In this system, a coordinate reference system is specified by referencing a simple four or five digit number commonly referred to as an EPSG code. A second coordinate reference system engine used by ERDAS APOLLO is based on the ERDAS IMAGINE projection system. ERDAS APOLLO utilizes a subset of ERDAS IMAGINE raster libraries to read various types of image files. In these cases, the ERDAS IMAGINE projection system is used to read and interpret the georeferencing information and coordinate reference system associated with the image file. A third coordinate reference system engine used by ERDAS APOLLO is based on the Intergraph GeoMedia and Geospatial SDI common coordinate system platform (CCS). When ERDAS APOLLO crawls vector data it uses CCS to read and interpret the coordinate reference system associated with the vector data. An internal representation of a CCS coordinate reference system, called a CCS moniker, is used when ERDAS APOLLO communicates with the Geospatial SDI WMS service. Because the WMS service is used to generate thumbnails for raster data, CCS is also needed when crawling raster data. When ERDAS APOLLO uses the ERDAS IMAGINE projection system or the Geospatial SDI common coordinate system to read data, it always converts the coordinate reference system information back to an EPSG code so that the information maintained in the ERDAS APOLLO catalog is stored in the primary ERDAS APOLLO coordinate system.
191
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Passing CRS Parameters in Web Requests ERDAS APOLLO supports two different syntaxes for passing coordinate reference system parameters in web requests. The first is an OGC standard based on a simple syntax of code:value, where code is either "EPSG" or "AUTO". "EPSG" is followed by the EPSG code of the coordinate reference system. "AUTO" is used for Automatic projections, as defined in the WMS 1.1.1 specification appendix. Examples of CRS parameters in code:value syntax are:
EPSG:4326 for the WGS84 geographic system
EPSG:32632 for the UTM 32 North projection based on the WGS84 datum
AUTO:42003,9001,-100,45 for an Automatic CRS in UTM, meters, centered on (-100,45)
Coordinate reference system parameters may also be passed as Universal Resource Names (URNs). CRS URNs as defined by OGC must have the form: urn:opengis:def:crs:authority:version:code.
"authority" can be one of "OGC" or "EPSG"
"version" will generally be empty
"code" is the value given by the authority
Examples of CRS parameters in URN syntax are:
urn:opengis:def:crs:OGC::84 for the WGS84 geographic system
urn:opengis:def:crs:EPSG::32632 for the UTM 32 North projection based on the WGS84 datum
CRS parameters in code:value or URN syntax can be used in HTTP-GET and HTTP-POST requests and can be found in Service Metadata (capabilities) documents as well as in other XML outputs such as responses to a DescribeFeatureType request or in a GML output.
Adding a Custom CRS Although many common coordinate reference systems are supported by the ERDAS APOLLO, ERDAS IMAGINE and CCS coordinate reference system engines, you may encounter cases where the CRS of your data is not supported in one or more of the engines. In these cases, you can customize each of the CRS engines as needed so that ERDAS APOLLO can crawl and serve your data.
192
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
For raster data, all three engines must support the CRS of the data. The ERDAS APOLLO and CCS engines are needed for vector data. Refer to the Troubleshooting sections Checking for Unsupported EPSG Code Failures during a WMS Request (on page 211) and Checking for Unsupported EPSG Code Failures When Crawling Vector Data (on page 212) for detailed instructions on generating and interpreting log files to check for CRS failures.
Topics Adding a Custom ERDAS APOLLO Coordinate Reference System 193 Adding a Custom ERDAS IMAGINE Coordinate Reference System 200 Adding a Custom Geospatial SDI Coordinate Reference System 201
Adding a Custom ERDAS APOLLO Coordinate Reference System Follow the instructions in these sections to add a custom CRS to the native ERDAS APOLLO CRS engine.
Topics Unzipping cots-srs.jar ...... 193 Creating or modifying usersref.xml ...... 194 Modifying coordinate_system_category.xml ...... 197 Rezipping new files into cots-srs.jar ...... 198 Updating ERDAS APOLLO Data Manager ...... 198 Restarting the Application Server ...... 199
Unzipping cots-srs.jar All of the ERDAS APOLLO coordinate reference system related files are located in the cots.srs.jar file which is located in the
sref.xml - contains a factory reference location - do not modify this file
factorysref.xml - default ERDAS CRS file - contains the information for all ERDAS-supported CRSs - do not modify this file
ionicsref.xml - contains additional CRSs requested by customers
usersref.xml - contains any custom CRSs - this file is not included in the installation. It is created it when you add a custom CRS
193
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
coordinate_system_category.xml - groups CRSs found in factorysref,xml, ionicsref.xml, and usersref.xml into Geographic, Projected, or Custom categories
Unzipping cots.srs.jar may also unpack some files not listed above. Do not modify any of these files. The entry file is sref.xml. It contains INCLUDE references to the other files.
Creating or modifying usersref.xml If usersref.xml already exists, you can skips steps 1 and 2, open the existing usersref.xml in a text editor and create a new entry after the last closing tag. 1. Create a new usersref.xml by opening any text editor and copying or typing the following lines into the new file:
2. Save the new file as usersref.xml (in the same folder where you unzipped cots-srs.jar) 3. Open either ionicsref.xml or factorysref.xml from the previously unzipped cots-srs.jar file and find a
194
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
6. Change the PROJCS ID number to the EPSG number you are using for this custom CRS. 7. Change the NAME value to the name you are using for the custom CRS. 8. Change the UNIT ID to the code that represents the units used in the coordinate system (feet, meters, kilometers, etc.) Valid UNIT ID codes can be found in the factorysref.xml file. 9. Change the GEOCS ID to the code that represents the datum or spheroid used for the custom CRS. Valid SPHEROID ID and DATUM ID codes can be found in the factorysref.xml file. When a standard EPSG code DATUM ID conflicts with SPHEROID ID, GEOCS ID, or PROJCS ID, a value of 7100000 is added to the DATUM ID to eliminate the conflict. For example, in factorysref.xml, DATUM ID 6052 conflicts with PROJCS ID 6052. To prevent the conflict, the DATUM ID is renamed to 7106052. All GEOCS definitions that reference DATUM ID 6052 in factorysref.xml are updated to DATUM ID 7106052. 10. Change the parameter values (PARAMETER NAME) as needed for projection you are adding. 11. Save and close the usersref.xml file. This is an example of a newly created usersref.xml defining a Projected CRS with an EPSG code of 26852. Note that the UNIT ID has been changed from 9001 to 9003 (meters to U.S. survey feet) and that false easting and northing are now expressed in U.S. survey feet instead of meters.
195
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
196
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Modifying coordinate_system_category.xml Adding your new CRS to a logical location in coordinate_system_category.xml will make it easier to find and select your CRS in other ERDAS APOLLO commands. 1. Navigate to the folder where you unzipped cots-srs.jar and open coordinate_system_category.xml in a text editor. 2. Browse through coordinate_system_category.xml to decide where to add your new coordinate system. Notice that the categories have a two-level hierarchy. There are only two categories in the top level: Geographic Coordinates Systems and Projected Coordinate Systems. These two categories are split into many subcategories representing locations around the world. If you want to add your CRS to an existing location category, be sure to select one in the correct top level category. If you decide not to use an existing category, you can create your own category in either the Geographic Coordinate Systems section or the Projected Coordinate Systems section. To do so, add opening and closing tags for a new category name. For example, here is one for a category called "Custom":
Ensure any name provided does not conflict with an existing name in the file. The new
4. Save coordinate_system_category.xml and close the text editor.
197
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Rezipping new files into cots-srs.jar After you have created or modified usersref.xml and/or coordinate_system_category.xml, you must integrate them back into cots-srs.jar. 1. First stop the ERDAS APOLLO application server. 2. Navigate to
Updating ERDAS APOLLO Data Manager The cots-srs.jar file modified for ERDAS APOLLO Server is also used by ERDAS APOLLO Data Manager. For each installation of ERDAS APOLLO Data Manager, perform the following steps: 1. Open a DOS command prompt window and navigate to: C:\ProgramData\Hexagon\ERDAS APOLLO Data Manager\Configuration\org.eclipse.osgi\bundles 2. To find the location of the file, type the following at the DOS prompt: dir /s cots-srs.jar This command will return the folder name that contains cots-srs.jar file used by ERDAS APOLLO Data Manager. The following highlights the folder returned in a sample installation: C:\ProgramData\Hexagon\ERDAS APOLLO Data Manager\Configuration\org.eclipse.osgi\bundles>dir /s cots-srs.jar Volume in drive C is OS Volume Serial Number is XXXX-XXXX
Directory of C:\ProgramData\Hexagon\ERDAS APOLLO Data Manager\Configuration\org.eclipse.osgi\bundles\7\1\.cp\lib
11/14/2014 04:41 PM 424,770 cots-srs.jar 1 File(s) 424,770 bytes
198
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Total Files Listed: 1 File(s) 424,770 bytes 0 Dir(s) 250,358,890,496 bytes free
C:\ProgramData\Hexagon\ERDAS APOLLO Data Manager\Configuration\org.eclipse.osgi\bundles> 3. Make a backup copy of the cots-srs.jar file located in the folder from step 2. In the example above the cots-srs.jar file is in the following folder: C:\ProgramData\Hexagon\ERDAS APOLLO Data Manager\Configuration\org.eclipse.osgi\bundles\7\1\.cp\lib 4. Copy the cots-srs.jar from the
Restarting the Application Server Many ERDAS APOLLO configuration tasks require you to stop and restart the ERDAS APOLLO application server. To stop or start the ERDAS APOLLO application server: 1. Open the Microsoft Windows Services utility. You can find the Services utility in the Administrative Tools section of the Windows Start menu or Start screen 2. If you are using JBoss as your application server select ERDAS APOLLO JBoss Application Server 7.1.1. If you are using Tomcat as your application server select ERDAS APOLLO Tomcat Application Server.
Right click on the selected service and select Start, Stop or Restart.
199
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Adding a Custom ERDAS IMAGINE Coordinate Reference System ERDAS IMAGINE coordinate reference systems are defined in
Example of an entry in epsg.plb
200
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Element Element Name Description Color
CRS Name The name of the CRS as it will be displayed in the metadata.
EPSG Code The EPSG code for this CRS. You can check the EPSG Geodetic Parameter Registry at http:\www.epsg-registry.org\ to verify that your number is unique.
Projection Identifier Identifies the map projection in the mapprojections.dat file to use.
Spheroid Name Identifies the name of the spheroid to use in the spheroid.tab file to use.
Datum Name Identifies the name of the datum. There is a list of the commonly associated datums within the spheroid’s definition in the spheroid.tab file.
Zone Number This is applicable only to the UTM and State Plane projections and is specified in sptable.tab.
For everything else, this should be zero.
Projection Parameters The projection parameters for this CRS, such as false easting, false northing, longitude of the central meridian, etc. The mapprojections.dat file indicates which parameters must be specified for each projection.
Units The unit of measurement used in the coordinate system. This unit must have an entry in the units.dat file.
Adding a Custom Geospatial SDI Coordinate Reference System The ERDAS APOLLO WMS Service uses the Geospatial SDI WMS Service that serves data registered in the ERDAS APOLLO Catalog. The ERDAS APOLLO WMS Service is used for all WMS GetCapabilities and GetMap requests. WMS GetCapabilities requests are passed directly to the SDI WMS Service. WMS GetMap requests are routed to either the
201
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
internal SDI vector renderer or to the ERDAS APOLLO raster renderer, depending on the type of data. The ERDAS APOLLO vector data crawling service also uses the Geospatial SDI vector geoprocessing infrastructure. The vector data crawling service crawls and catalogs shapefiles, FGDB, GML, and database vector data. In ERDAS APOLLO, EPSG CRS-based definitions are widely used in the system because, after being cataloged, the data is predominantly served using OGC Services with EPSG as the authority for the CRS. The SDI-based vector data crawling and WMS services do not use the ERDAS APOLLO CRS. These services use an SDI internal CRS as well as a CCS based coordinate reference system engine. During a WMS request or during data crawling, the following flow occurs when accessing the data with an attached source CRS.
For raster data with an associated CRS
ERDAS APOLLO crawls and catalogs the raster data. The source data CRS is mapped to ERDAS APOLLO EPSG code. The EPSG code is also mapped to the SDI internal CRS representation. The associated EPSG CRS is displayed on the properties tab in ERDAS APOLLO Data Manager.
For shapefile data with an associated ESRI .prj file and FGDB data with an embedded ESRI WKT string
The WKT string in the .prj file or the FGDB-embedded ESRI WKT string is mapped to the SDI internal CRS representation.
When the vector crawling or WMS services interact with ERDAS APOLLO, the internal CRS representation is converted to an EPSG CRS before being passed to ERDAS APOLLO. The associated EPSG CRS is displayed on the properties tab in ERDAS APOLLO Data Manager.
For GML data with an embedded srsName
If the srsName is of the form "EPSG:", the EPSG code is extracted from the srsName and is mapped to the SDI internal CRS representation.
When the vector crawling or WMS services interact with ERDAS APOLLO, the internal CRS representation is converted to an EPSG CRS before being passed to ERDAS APOLLO. The associated EPSG CRS is displayed on the properties tab in ERDAS APOLLO Data Manager.
For vector data in a Oracle, Microsoft SQL Server, or PostGIS database
The internal database Spatial Reference System Identifier (SRID) is mapped to the SDI internal CRS representation.
When the vector crawling or WMS services interact with ERDAS APOLLO, the internal CRS representation is converted to an EPSG CRS before being passed to ERDAS APOLLO.
202
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The associated EPSG CRS is displayed on the properties tab in ERDAS APOLLO Data Manager.
The SDI-based vector crawling and WMS services support all standard EPSG codes as of the EPSG 8.5 dataset. However, they do not support GML srsName strings of a form other than "EPSG:". Also, in some cases they do not support ESRI WKT string to EPSG code mappings. For these cases, an SDI CRS plugin system is provided that allows custom CRS definitions to be added to the system and provides srsName or ESRI WKT string to EPSG code mappings. The CRS plugin system uses a configuration file to provide a mapping between source data CRS and the SDI internal CRS representation. It also provides a mapping between SDI internal CRS representation and EPSG code. The CRS plugin system configuration file is located here: ...\Program Files\Common Files\Hexagon\Common\CSFStore\CSFStore.config The CSFStore.config file is used in the following cases:
If the vector crawling or WMS services are unable to map the source data CRS to an internal CRS representation then the CSFStore.config file provides the mapping.
If the vector crawling or WMS services are unable to map the internal CRS representation to an EPSG code then the CSFStore.config file provides the mapping.
If the WMS Service is unable to map the WMS GetMap request EPSG code based CRS parameter to an internal CRS representation code then the CSFStore.config file provides the mapping.
There may be cases where a service is able to perform one of these mapping steps but fails on the other. For example, the WMS Service may be able to convert an ESRI WKT string to internal CRS representation but fails to convert the internal CRS representation to an EPSG code.
Topics Mapping between EPSG Code and WMS Service Internal CRS Representation ...... 203 Mapping a Source Data WKT or GML srsName to an SDI Internal CRS representation ...... 205 CSFStore.config Examples ...... 207
Mapping between EPSG Code and WMS Service Internal CRS Representation The RegisterEPSGCodes utility application can be used to help create the mappings between EPSG codes and the CCS based coordinates references systems used by the WMS service. The RegisterEPSGCodes utility is used in the following cases.
The vector crawling or WMS services are unable to map the WMS Service internal CRS representation to an EPSG Code.
203
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The WMS request EPSG code based CRS parameter is not understood by the WMS Service internal CRS system.
In these cases, the CSFStore.config file is used to map an EPSG CRS definition file (.csf file) to an EPSG code. The RegisterEPSGCode utility automates entering the mapping instructions within the CSFStore.config file. Perform the following steps to map the EPSG .csf file to an EPSG code. 1. Create an EPSG CRS definition file (EPSG.csf) file by performing the following steps:
Create a CRS definition file for the source data CRS using CCSDefCSF.exe tool located in %CommonProgramFiles%\Intergraph\Coordinate Systems\3.0\Program.
Documentation for this tool is available at %CommonProgramFiles%\Intergraph\Coordinate Systems\3.0\Resdlls\0009\CommonCoordinateSystemsHelp.chm.
Save the CRS definition file to
2. Run RegisterEPSGCodes.exe, found in the
204
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
3. Enter the EPSG code to be mapped in numeric form. Multiple, comma separated EPSG codes may be entered together. 4. Click Register. a. If the utility is successful, the Registration Status area displays: EPSG code [] successfully added. b. If the utility is not successful, the Registration Status area displays one of the following failure messages:
Unable to find [EPSG.csf] in [..\ERDAS APOLLO\tools\RegisterEPSGCodes\bin\] application directory.
Ensure the .csf file is located in the same directory as RegisterEPSGCodes.exe. Failed to copy [EPSG.csf] to […\Hexagon\Common\CSFStore]. No CRS definition file was found for the provided EPSG code. The CCSCsfDef tool must be used to manually build the CRS definition file as outlined in Step 1. Once built, the .csf file must be placed in the same directory as the RegisterEPSGCodes utility before attempting to register the .csf file.
[…\Hexagon\Common\CSFStore\CSFStore.config] already contains an ].
The CSFStore.config file already contains a mapping between CRS definition file and EPSG code.
Input [] is not a valid EPSG code.
The EPSG code entered is not valid. The EPSG code provided must be an integer between 0 and 2147483648. 5. Click the Restart IIS AppPools button to automatically restart the DecodingServiceAppPool, ApolloCatalogWMSAppPool, and ApolloCatalogWMSPublicAppPool. Restarting the IIS AppPools on a production ERDAS APOLLO server will cause a brief outage of the OGC WMS service while the WMS AppPools recycle. 6. Close the utility after all codes have been registered and IIS AppPools have been restarted.
Mapping a Source Data WKT or GML srsName to an SDI Internal CRS representation If the vector crawling or WMS services are unable to map the source data CRS to an internal CRS representation, the CSFStore.config file is used to provide the mapping. The steps to provide the mapping differ based on the whether the source data is defined in a standard EPSG code or a custom EPSG code.
205
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Mapping to custom EPSG codes Perform the following steps to provide the mapping if the source data is in a custom coordinate system: 1. First perform all steps from Mapping between EPSG Code and WMS Service Internal CRS Representation (on page 203) defined above. This will map a WMS Service internal CRS definition file (.csf file) to its corresponding EPSG code. 2. Open %CommonProgramFiles%\Hexagon\Common\CSFStore\CSFStore.config using a text or XML editor. 3. Find the
206
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Mapping to standard EPSG codes Perform the following steps to provide the mapping if the source data is in a standard EPSG coordinate system: 1. Open %CommonProgramFiles%\Hexagon\Common\CSFStore\CSFStore.config using a text or XML editor. 2. Create as new CRS definition as shown below:
CSFStore.config Examples This is an example of a CSFStore.config entry that fixes cases when the vector crawling or SDI WMS service is unable to map a source data CRS in ESRI WKT form to an internal CRS:
207
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
208
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
209
S E C T I O N 6 Troubleshooting In This Section Checking for Unsupported EPSG Code Failures during a WMS Request 211 Checking for Unsupported EPSG Code Failures When Crawling Vector Data 212
Checking for Unsupported EPSG Code Failures during a WMS Request ERDAS APOLLO may appear to successfully crawl raster data but fails to generate thumbnails. When this occurs, the following symptoms will manifest.
WMS GetCapabilities calls on the ERDAS APOLLO catalog fail for any OGC client
WMS GetLayer calls on the crawled data fail in Geospatial Portal
If these failures occur, perform the following steps to determine if the failure is caused by an unsupported EPSG code. 1. Check
211
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Restarting the IIS AppPools on a production ERDAS APOLLO server will cause a brief outage of the OGC WMS service while the WMS AppPools recycle. 3. Perform the WMS operation again. 4. Open
The WMS Service is unable to map the WMS request EPSG code to an internal CRS representation. The CSFStore.config file must be used to perform the mapping. Refer to Adding a Custom Geospatial SDI Coordinate Reference System (on page 201).
Checking for Unsupported EPSG Code Failures When Crawling Vector Data If the failure occurs when crawling vector data, perform the following steps to determine if the issue is an unsupported EPSG code. 1. Check
If the log file contains:
"Cannot load […] into a CoordSystem", or
"epsgCode […] format not supported" or
212
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
"epsgCode […] with EPSG number format […] is not supported." or
"Cannot convert code […] into a moniker."
The WMS service is unable to map the source data SRS to WMS Service internal CRS representation. The CSFStore.config file must be used to map the source data CRS to a WMS Service Moniker. Refer to Adding a Custom Geospatial SDI Coordinate Reference System (on page 201).
If the log file contains:
"Attempt to convert moniker […] into EPSG code failed." or
"Cannot convert moniker[…] into EPSG code",
The WMS Service is unable to map the internal CRS representation to an EPSG code. The CSFStore.config file must be used to map the WMS Service internal CRS representation to an EPSG code. Refer to Adding a Custom Geospatial SDI Coordinate Reference System (on page 201).
213
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
214
S E C T I O N 7 Appendix A: Coordinate Reference Systems In This Section ERDAS APOLLO CRS Definition ...... 215 ERDAS IMAGINE Projection System ...... 228
ERDAS APOLLO CRS Definition All of the ERDAS APOLLO coordinate reference system related files are located in the cots.srs.jar file which is located in the
sref.xml - contains a factory reference location - do not modify this file
factorysref.xml - default ERDAS CRS file - contains the information for all ERDAS-supported CRSs - do not modify this file
ionicsref.xml - contains additional CRSs requested by customers
usersref.xml - contains any custom CRSs - this file is not included in the installation. It is created it when you add a custom CRS
coordinate_system_category.xml - groups CRSs found in factorysref,xml, ionicsref.xml, and usersref.xml into Geographic, Projected, or Custom categories
Unzipping cots.srs.jar may also unpack some files not listed above. Do not modify any of these files. The entry file is sref.xml. It contains INCLUDE references to the other files. The following tables describe the entries that can be found in each of these files and can be used as a reference for adding new coordinate reference systems to usersref.xml.
CRS Configuration Tags These tags are used for configuring and defining the overall ERDAS APOLLO CRS system. They are primarily found in sref.xml and in most cases don't need to be modified or added to userref.xml.
Tag Attributes Description
SREF The root element of the XML file
STORAGE
215
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
TYPE The type of storage to use. Allowed values are FILE or MEMORY
OPTION Define one option
NAME The option name
VALUE The option value
INCLUDE Include a file
NAME The file name to include (usually a relative path)
OPTIONAL If yes, the file is an optional one and no error is generated if it is missing
INCLUDEESRI Include the ESRI mapping file (see structure info below)
NAME The file name to include
OPTIONAL If yes the file is an optional one and no error is generated if it is missing
NAMESPACE Defines additional namespaces of IDs
ASSOCIATE Associates other ids to an existing id
STORAGE The storage tag should be the first child of the SREF root tag. It defines the type of storage to use. Currently two types are available:
FILE: Uses a btree file as database support
MEMORY: Uses a memory map. This is intended for a small CRS database.
216
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
OPTION The option tag defines options (hints) about different conversions to the CRS or ERDAS APOLLO Data Manager. The following options are defined:
useostn97: specify if the ostn97 conversion is used to go from OSGB1936 to WGS84. This conversion uses 1,000,000 bands that are stored into memory.
parseesriid: specify if the INCLUDEESRI instruction should really parse the esri ids file.
unknownDatumAsWGS84: if set (default is yes) an unknown datum is considered as equal to WGS84 during datum transformation. If not set an error will be produced during datum transformation.
The option names are case insensitive and their usual values are 'yes' or 'no' (also case insensitive).
INCLUDE The 'include' tag allows the inclusion of other files. It allows splitting the configuration into several files and acts as if the content of the included file is inline.
INCLUDEESRI The INCLUDEESRI tag references a simple text file that defines associations between EPSG codes and ArcSDE system names. The text file should contain one line per mapping. Each line has the following structure: EpsgId=EsriName[=IsForced] Where
EpsgId is the EPSG code of the coordinate reference system
EsriName is the name used in the ESRI SDE Server
IsForced is an optional boolean whose usage is required to force mapping of EPSG id greater than 32767. If IsForced is not set, all mappings for ids greater than 32767 are ignored.
NAMESPACE Used to define their custom namespace IDs. For example, to add the FIPS and NASA namespaces, add the block:
217
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
ASSOCIATE The projected and geographic system include other associated IDs by having their tags added to the system's definition. Currently the tags OGC, ESRI, DMS and ALIAS are defined. Their ID attribute is associated to the system as another ID candidate which can only be used to get the system reference through the CRS manager. Generally, the ESRI ID is defined in another file named esri.txt and associated with the EPSG ID through the INCLUDEESRI tag in the main sref.xml file. Nevertheless, it is possible to associate other IDs to each defined objects, using the namespace mechanism. Example:
CRS Definition Tags These tags are used for defining ERDAS APOLLO coordinate reference. You can review factorysref.xml to see examples of how these tags are used. You can copy excerpts from factorysref.xml into userref.xml and then modify the copied version as needed to create your own custom coordinate reference systems definitions. To create your own custom coordinate system, all objects listed in the table below must be defined.
Tag Attributes Description
UNIT Defines a unit
MERIDIAN Defines a meridian
SPHEROID Defines a spheroid
DATUM Defines a datum
GEOCS Defines a geographic system
PROJCS Defines a projected system
218
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
COORDINATESYSTEM Defines a coordinate system Used to define the axis unit of a coordinate system. This allow to support XXXX ids.
UNIT
Items Description
ID The unit ID
NAME The unit name
The unit factor relative to the reference unit. The reference unit is VALUE the meter for metric units and the radian for angular units.
Example:
MERIDIAN
Items Description
ID The meridian ID
NAME The meridian name
The offset from Greenwich longitude VALUE in degrees
The offset from Greenwich latitude in DELTA degrees (only used in EXTENDEDMERIDIAN)
Example:
219
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
SPHEROID
Items Description
ID The spheroid ID
NAME The spheroid name
FLATTENING The 1/f value
The length of the semi-major axis in SEMIMAJORAXIS meters
Example:
DATUM
Items Description
The datum ID When a standard EPSG code DATUM ID conflicts with SPHEROID ID, GEOCS ID, or PROJCS ID, a value of 7100000 is added to the DATUM ID to eliminate the ID conflict. All references to the DATUM ID are updated. For example, in factorysref.xml, DATUM ID 6052 conflicts with PROJCS ID 6052. To prevent the conflict, the DATUM ID is renamed to 7106052. All GEOCS definitions that reference DATUM ID 6052 in factorysref.xml are updated to DATUM ID 7106052.
NAME The datum name
SPHEROID The spheroid definition
The method used to transform this datum to the WGS84 datum (Values are PV, CFR, GO or SHIFT) Default is PV which stands for Position Method Vector, Coordinate METHOD Frame Rotation, Geographic Offset and Shift.
220
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
CFR/PV additional parameters (The values comes from the EPSG database)
SHIFTX The X shift in meters (default is 0)
SHIFTY The Y shift in meters (default is 0)
SHIFTZ The Z shift in meters (default is 0)
ROTX The X rotation (default is 0)
ROTY The Y rotation (default is 0)
ROTZ The Z rotation (default is 0)
SCALEFACTOR The scale factor
GO additional parameters
ROTX The X offset (default is 0)
ROTY The Y offset (default is 0)
Example:
GEOCS
Items Description
ID The geographic system ID
NAME The geographic system name
221
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
UNIT The angular unit definition
MERIDIAN The meridian definition
DATUM The datum definition
(Optional) If provided, indicates the geometry ordinates order for this ORDER CRS. Valid values are: "XY", "YX" (default), "XYZ", "YXZ", "XYZT".
Example:
PROJCS
Items Description
ID The projected system identification
NAME The projected system name
UNIT The projected unit definition
GEOCS The geographic system definition
PROJECTION The projection definition
The area of validity of the projected VALIDITY system.
(Optional) If provided, indicates the geometry ordinates order for this ORDER CRS. Valid values are: "XY" (default), "YX", "XYZ", "YXZ", "XYZT".
222
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
The validity information is defined by four attributes: X1,Y1,X2,Y2. Currently it is automatically defined for some projections as Transverse Mercator. The values must be set in the associated geographic system. Example:
PROJECTION
Items Description
NAME The projection name
PARAMETER A set of projection parameters
Each parameter has the following attributes
NAME The parameter name
The parameter value, alternatively a parameter can be given as deg/min/ VALUE sec using three attributes instead of one
DEG
MIN
SEC
223
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
If present, it must have the value Greenwich to specify that the unit is REF relative to Greenwich instead of the prime meridian of the geographic system.
Projection Parameters
Albers Conical
central_meridian
latitude_of_origin
standard_parallel_1
standard_parallel_2
false_easting
false_northing
EquiCylindrical
central_meridian
standard_parallel_1
false_easting
false_northing
Lambert Azimuthal Equal Area
central_meridian
latitude_of_center
azimuth
false_easting
false_northing
224
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Lambert Conformal Conic same as Albers Conical
Lambert Conformal Conic 2sp same as Albers Conical
Lambert Conformal Conic 2sp same as Albers Conical Belgium
Lambert Conformal Conic 1sp same as stereographic
Mercator same as Polar stereographic
Mollweide
central_meridian
false_easting
false_northing
Oblique Stereographic
central_meridian
latitude_of_origin
scale_factor
false_easting
false_northing
Orthographic
central_meridian
latitude_of_origin
false_easting
false_northing
Polyconic same as Polar Stereographic
Polar Stereographic
225
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
central_meridian
latitude_of_center
false_easting
false_northing
Transverse Mercator same as Oblique Stereographic
Oblique Mercator
latitude_of_center
longitude_of_center
rectified_grid_angle
azimuth
scale_factor
false_easting
false_northing
Hotine Oblique Mercator same as ObliqueMercator
Swiss Projection same as Oblique Mercator
Sinusoidal same as Mollweide
Spatial Oblique Mercator
false_easting
false_northing
ascending_orbit
inclination_orbit
226
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
satellite_ratio
path_flag
satellite_period
Spatial Oblique Mercator B
false_easting
false_northing
satellite_number
path_number
The latitude and longitude in the projection parameters are given in the underlying geographic system unit, for example, longitudes are relative to the prime meridian of the geographic system. If this is not the case, use the REF attribute. Example:
COORDINATESYSTEM
Items Description
ID The coordinate system ID
NAME The coordinate system name
XYUNIT The unit of the XY axis
ZUNIT The unit of the Z axis (if any)
Example:
227
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Object Sharing Objects can be defined and then shared. The general rules are: a. Objects must be defined before being used. b. IDs must be unique among all definitions. c. Objects are reused and shared based on their IDs. In this first example, a new geographic system is defined and as part of that definition a new UNIT, ID=9108 is also defined.
In the second example we first define unit and then use it in the definition of the new geographic system.
You can use the UNSHARED tag to redefine a local definition. In this example we redefine a datum to use another Bursa-Wolf transformation variant, but only locally for the geographic system.
ERDAS IMAGINE Projection System All of the CRS information that the ERDAS IMAGINE Projection System needs is contained in the following files.
228
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
epsg.plb
mapprojections.dat
spheroid.tab
units.dat
sptable.tab
The first file, epsg.plb, is located in this folder:
Example of an entry in epsg.plb
Element Element Name Description Color
CRS Name The name of the CRS as it will be displayed in the metadata.
EPSG Code The EPSG code for this CRS. You can check the EPSG Geodetic Parameter Registry at http:\www.epsg-registry.org\ to verify that your number is
229
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
unique.
Projection Identifier Identifies the map projection in the mapprojections.dat file to use.
Spheroid Name Identifies the name of the spheroid to use in the spheroid.tab file to use.
Datum Name Identifies the name of the datum. There is a list of the commonly associated datums within the spheroid’s definition in the spheroid.tab file.
Zone Number This is applicable only to the UTM and State Plane projections and is specified in sptable.tab.
For everything else, this should be zero.
Projection Parameters The projection parameters for this CRS, such as false easting, false northing, longitude of the central meridian, etc. The mapprojections.dat file indicates which parameters must be specified for each projection.
Units The unit of measurement used in the coordinate system. This unit must have an entry in the units.dat file.
mapprojections.dat This file contains definitions of all the most commonly used map projections. The entries in the epsg.plb file must be linked to one of the projection definitions in mapprojections.dat using the projection identifiers. You do not need to modify this file to add a custom CRS.
230
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Example entries from the mapprojections.dat file
Projection Parameter in mapprojections.dat The entries in mapprojections.dat file also indicate which parameters you need to supply in the epsg.plb for a CRS associated with the projection.
231
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
In the figure below, the items highlighted in purple are the parameters you must provide in an epsg.plb entry for a CRS associated with the Albers Conical Equal Area projection. The items highlighted in silver indicate the measurement type of each item.
Example of Projection Parameters in mapprojections.dat
232
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
spheroid.tab This file contains the mathematical definitions of the most commonly used spheroids, along with definitions of the datums that are most commonly used with the spheroid. You do not need to modify this file to add a custom CRS. In the example below a spheroid name (GRS 1980) is highlighted in purple and one of the datums associated with the GRS 1980 spheroid (HARN) is highlighted in cyan.
233
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Example of a Spheroid definition with multiple Datums in mapprojections.dat
234
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
units.dat This file contains all of the units of measure most commonly used for coordinate systems and projections. The file is divided into different blocks representing different measurement types such as angles, distance, and area. Each block contains a list of units that ERDAS IMAGINE can recognize, along with a conversion factor that is used internally by the software. You do not need to modify this file to add a custom CRS.
235
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Example of Units in units.dat
236
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
sptable.tab This file contains definitions for the State Plane coordinate systems that are used in the United States of America. You do not need to modify this file to add a custom CRS.
Example of State Plane definitions in sptable.dat
237
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
238
S E C T I O N 8 Appendix B: Schema and Database Mapping for WFS When configuring an ERDAS APOLLO WFS provider you need to have an XML Schema document for your feature types and a mapping document to establish correspondence between your schema and the data source. In most cases the default schema and mapping files generated automatically by ERDAS APOLLO Data Manager will be sufficient. The following sections provide more information on defining an application schema and database mapping for situations that require finer grained control.
In This Section GML Application Schema and Mapping to Databases ...... 239 Map Generation Transformer ...... 299 Protecting Data ...... 308 Schema Generator ...... 311 From-SQL Generator ...... 313 WFS Loader ...... 315
GML Application Schema and Mapping to Databases The Web Feature Server (WFS) makes it possible to expose data to the world, providing a view or an abstraction of the physical data. This is achieved through the definition of an Application Schema, that is interoperable, ISO compliant, and prevents users from gaining visibility into the nature of the computational infrastructure. For example, no one will know if the data is stored in data files, in a database or computed on the fly. A subset of the existing data can be presented while keeping confidential information out of reach. The exposed features are named Geospatial objects, and are a translation of the actual underlying data. The WFS responds to the requirements of a secure web service for interoperable exchange of geospatial objects, compliant with ISO, exposing one or multiple restricted views on an existing proprietary data resource. The figure below shows the relationship between the data model used inside the content repository and the GML application schema exposed by the WFS. The relationship between those two models is achieved through a "mapping" mechanism which is configured at the time of setting up the service. The possibility of publishing a data model that is different from the internal one depends on the software used to deploy the nodes. The mapping is the configuration that describes the link between the Feature Type definition and the objects stored in the underlying engine. The mapping document associated with a WFS presents the necessary information for the WFS to convert client requests to queries understood by the data server. It also converts the result into a compliant collection of features. Therefore, it makes the link between the internal data structure and the published information. This section's purpose is to expose the different types of Feature Type relations, how to express these relations in a GML Application schema, how to implement them in a relational database and finally how to map this internal relational data model with the exposed object model.
239
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Internal Data Model versus Exposed Feature Types
Topics Key Concepts ...... 241 GML Application Schema ...... 241 Feature and Feature Type ...... 242 Mapping ...... 242 Feature Schema Configuration ...... 243 Feature Mapping ...... 245 Explicit Mapping Definition Steps ...... 249 SQL Mapping Definition Steps...... 250 Automatic Mapping Definition Steps ...... 252 Relational (Explicit) Mapping Definition Steps ...... 253 Mapping of Enumerations ...... 267 Control Mapping Correctness ...... 271 Moving to GML3 ...... 271 Set Up an ERDAS APOLLO WFS Serving GML-SF (Simple Feature) 274 Feature Mapping Tags ...... 275
240
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Key Concepts To map an Application Schema onto a Database Model, it is necessary to understand clearly what each of those words mean. The scope of this section is to provide a short explanation.
Application Schema The ISO 19109 standard "Rules for application schema" provides the following definition and purpose of an application schema: An application schema provides the formal description of the data structure and content required by one or more applications. An application schema defines:
The content and structure of data;
Specifications of operations for manipulating and processing data by an application.
The purpose of an application schema is twofold:
to provide a computer-readable data description defining the data structure, making it possible to apply automated mechanisms for data management;
to achieve common and correct understanding of the data, by documenting the data content of the particular application field, and thereby making it possible to unambiguously retrieve information from the data.
ISO 19109 application schemas are defined in a conceptual schema language: the Universal Modeling Language (UML). In the case of a geospatial application schema, the concepts of the General Feature Model (GFM) are mapped to the concepts of the UML conceptual language. The General Feature Model is a model of concepts required to classify a view of the real world expressed in UML. The objects that are classified are called features; relations between features are feature associations and inheritance. Feature Types have properties that are feature attributes, feature operations and feature association roles. The GFM is a meta model of feature types [ISO01b]. As an application schema deals with representing features, the structure of the GFM has to be kept in mind while creating the application schema. For more detailed information refer to the ISO19109 document.
GML Application Schema A Geographic Markup Language (GML) application schema is an XML schema that describes one or more types of geographic objects [OGC03]. One can consider the GML application schema as a physical implementation of an ISO 19109 application schema. GML application schemas define the encoding of geospatial information. GML application schemas are used by Web Feature Servers (WFS) to encode geospatial data into GML and deliver it over the Web. User’s Application Schemas have to extend the basic types defined in the GML Schema in order to be manageable by a WFS and be compliant with the GML specification (Figure below).
241
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
GML Schema Structure
Feature and Feature Type A feature is an abstraction of real world phenomena. It is a geographic feature if it is associated with a location relative to the Earth. The state of a feature is defined by a set of properties. The number of properties a feature may have together with their names and types are determined by its type definition, the feature type. An abstract feature type provides a set of properties common to several feature types. A concrete feature (by opposition to abstract) must derive from this type and may specify additional properties.
Mapping GML Application Schemas are object-oriented while most databases are relational. The mapping consists of writing a correspondence between a GML Application Schema document and a Database Model, thus it is in an object-to-relational mapping. The way the mapping is done is specific to a vendor. ERDAS writes the mapping in an XML document that can be built either using one of the command-line tools coming along with ERDAS APOLLO, or manually. In some cases, the mapping is implicit and does not need any document.
242
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Feature Schema Configuration The XML Schema associated with a WFS gives the GML Application Schema (structure) needed by the WFS to expose its feature types. The schema provides the type descriptions structure for each feature type and its properties.
GML Application Schema Construction A XML Schema definition document should be provided for the feature types to be published as GML, either through a WFS or not. The syntax has to conform to the W3C XML Schema specification and respect the GML constraints. This schema does not need to be built manually if it is provided by an authority. It could also be built with one of the tools provided in the ERDAS APOLLO distribution (see the Tools and Viewer section). Note that such a schema is independent from the vendor who provides an infrastructure to expose the features. Only the limitations of the vendor's product are to be considered. Here’s a sample of a GML feature Type named "Road". Example: A Simple Feature Type Definition
243
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
See the "Feature Mapping" section below for a complete explanation of the types of mappings available, and which one to use depending on the case. 1. Decide the names of the features types to publish. The first task is to build the list of feature type names to publish. It often closely correlates with relational table names or entities of the real world (building numbers, land usage types, tree locations). 2. Decide the names, types and cardinalities of the properties. For each of the feature types, decide which properties will be visible. These can be a sub-set of the existing data properties, or a super-set where calculated properties are defined, or a 1 to 1 matching with actual properties. For each property, figure out its type (integer, string) and cardinality. It is strongly recommended to reuse existing types as often as possible. This is because when mentioning existing schema's in
244
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Control the Schema correctness and GML FeatureType definition:
Check whether the schema is syntactically correct by using any third-party commercial tool that performs XML and XML Schema validation (xalan or saxon).
To see if the feature type schema is correct, wait until the WFS service is fully configured, and ask for a DescribeFeatureType on all the feature types of the WFS. It should provide an answer that matches the definitions.
Feature Mapping This section introduces the key aspects of the mapping configuration:
What is mapping
What are the different types of mapping
How to choose what mapping to use
Explicit Mapping
SQL Mapping
Automatic Mapping
Relational (Explicit) Mapping
Mapping of Enumerations
Other Mappings
Mapping Concepts The mapping is the configuration that describes the way ERDAS WFS achieves the link between the FeatureType definition and the objects returned by the underlying engine. The mapping document associated with an ERDAS WFS presents the necessary information for the WFS to convert client requests into queries understood by the data server. It also converts the result into a compliant collection of features. Therefore, it makes the link between the internal data structure and the published information.
245
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
WFS Mapping
The mapping file, written in XML, defines how the features types declared in the XML schema document are mapped onto the underlying data server. The mapping file name is either referenced by the "MAPPING" parameter of the provider (see the "Provider Configuration" section) or the mapping information is in the feature schema file. The mapping information is contained in several tags:
Mapping Methodology To map a set of Feature Types to database tables and relations, we propose several ways to achieve the mapping. Each applies in given situations and this section provide guidance in choosing the appropriate type of mapping.
Types of Mapping The mapping can be explicit or implicit. If the mapping is explicit, then the file will contain all the information needed by the connector to manage the mapping. This is the case for the "Explicit Mapping" where for each element of the FeatureType, there will be an explicit link to an attribute
246
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
of a table or a view. The mapping can also be implicit and completely managed by the connector or the framework itself. This is the case when the mapping is done by the code of the connector based on internal hypothesis or knowledge.
Explicit Mapping: Explicit mapping is where a fully specified details of the feature are mapped to a database. With this mapping, define the mapping by hand in an explicit way, or use a tool to build it from the database model or from the GML Schema.
SQL Mapping: The SQL mapping allows taking a table or multiple tables and asking the framework to make a 1:1 mapping from the table to a dynamically created feature. Implementing this, makes going from Table to Feature simple. There are no feature types to define and no complex mapping to do. The mapping from the tables to the feature type is implicit and managed by the framework.
Automatic Mapping: This mapping is somehow the reverse of the SQL mapping. In automatic mapping, define a FeatureType in GML Application Schema and then submit the FeatureType to the engine that will create all the tables needed to support. The mapping from the FeatureType to the tables is implicit and managed by the framework.
Relational (Explicit) Mapping: It is an explicit mapping, but where several tables are mapping onto a single feature type with complex properties.
Auto-Generated Mapping: This mapping, derived from the Automatic Mapping, permits generating the mapping file instead of having the framework manage it. It allows a user to make changes in the mapping to fit the database model.
XML Enumeration and Relational Enumeration Mappings: Allows mapping of enumerated values to an XML list or a table.
Choose a Mapping To find out which mapping is best, look at these tips:
If there are simple tables or Shapefiles be to publish in a minute, use the SQL mapping.
If there are simple tables or Shapefiles, but well formatted, well named or retyped attributes are to be exposed, use the explicit mapping. Use one of the "runfromsqlxxx" script to build the schema and mapping files automatically from the data source.
If there are complex GML FeatureTypes and the database is not yet built, use the Automatic mapping to create the tables.
If there are a set of tables whose columns should appear in a single GML Feature Type, define a Relational Explicit Mapping.
If there are a complex GML Application Schema with some of the data types being abstract in the GML Specification, the Auto-Generated Mapping is required to build the tables from the schema, and to be able to substitute those abstract types with real ones.
247
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
If there are a set of feature types with enumerated values for some of the properties use the XML Enumeration Mapping if the values are listed in the schema or the Relational Enumeration Mapping if those values are stored in a table.
Mapping Tags Description The mapping file is made of XML elements, named
248
Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll.
Explicit Mapping Definition Steps Also named "specific mapping" this mapping makes no assumptions on the correspondence between the feature type structure and the actual data. Create the GML schema definition of the feature type (see previous section). Edit the mapping document so that each property of the feature type is mapped to the correct corresponding data field. The following section describes all the possible tags accepted in the mapping document. Most of them apply in the explicit mapping. All of the connectors support this type of mapping. This description explains how to fill the XML mapping document when the data source supports SQL requests and the mapping is explicit. For non-relational or specific data sources, please call ERDAS to obtain the appropriate guide. Follow these steps: 1. Build a 249 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. 10. If more request types are required beyond those supported by the Basic WFS, add an SQL Mapping Definition Steps This type of mapping allows a much lighter configuration, as the mapping manager achieves a one-to-one conversion from the SQL schema to the feature type schema. So, NO GML Schema is necessary when this mapping type is used. This type of mapping allows building the feature type schema from the database schema. Simply define the name of the table to publish and the framework does the job of building the feature type description. (Note: For non-relational or specific data sources connectors, the mapping may be implicit or explicit with specific behavior. Please call ERDAS to obtain the appropriate guide.) When this type of mapping is used, the 250 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. element to restrict its scope to the given database schema (or user). An alternative is to do an explicit mapping and adding the "user" attribute in the 251 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Automatic Mapping Definition Steps This type of mapping is the way to convert a given feature schema onto a database schema based on feature type definitions. To achieve this mapping, it is first necessary to use the "Schema Generator" tool that builds a SQL script to generate the tables. As the mapping manager uses the same logic as the schema generator tool, the mapping is done automatically at run time. Note that this type of mapping still allows mapping rules since these rules are used when generating the SQL script. For example, a mapping rule can tell if a sub-collection is stored as a Blob, binary large object, or if it is expanded in each of its components in the data store. When the XML Schema document describing the feature types is the starting point, and the database structure can be created from it, this type of mapping applies. Automatic mapping is also a convenient way to set-up storage for complex feature types. This mapping implies a two - step process: First, run the "Schema Generator" tool provided with the distribution. As entry parameters, it takes the name of the XML schema, and, optionally, the name of the mapping document. The output is a SQL script for the database schema generation (tables, indexes, or sequences). Then, at run time, the framework does the mapping automatically. In term of mapping directives, the 252 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. You can name the Lock-Id field (predefined as "LK") differently, as soon as you add a Relational (Explicit) Mapping Definition Steps It starts with defining a simple Explicit Mapping for each of the tables to map with one feature type per table. Then, changed have to be done like described below in order to map the relations. 253 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. The first case described is for a composition where a single feature type gets its properties from a nested table. Another case is the association where several feature types have their own existence but are related (like the Parcel/Person relationship). By definition, "The aggregation is a special type of association used to represent a "part of" relationship between two feature types. A key indicator of an aggregate relationship is feature types that share a lifetime. If the containing feature type is destroyed the contained feature type is destroyed with it." And "A composition is the strongest relationship between two feature types. Composition is a special form of aggregation that indicates not only lifetime association but typically exclusive containment as well." Composition The explanation is based on the Road vs. Lane relationship where a Road is composed of one or more Lanes as shown in the UML diagram below. Road-Lane UML Diagram It is assumed that the underlying database is Oracle and the relationship between the ROAD and LANE tables is based on a primary key - foreign key relationship as in the diagram below. Road-Lane Relational Diagram As soon as an Explicit Mapping has been produced for the Road and Lane feature types, there should be a GML Application Schema with those two feature types defined, as in the "Simple Feature Type Definition" example above. Note that the GML3 rules are being used to define 254 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. complex properties. Avoid relying on the old-fashioned GML2 syntax. Review the "Moving to GML3" section below for guidelines on how to get familiar with GML3 and how to migrate GML2 schemas to GML3. Example: Road and Lane Feature Types In this example, the Road feature type has a "centerLine" geometric property and a "streetName". Of course, as it inherits from gml:AbstractFeatureType, it has a set of additional properties like "gml:name" and "gml:description". Those properties will appear in the mapping file if they are mapped with a table column in the database. The Lane feature type has a Polygon-type geometric property, and the gml:name inherited property will be mapped. To explicitly map those feature types onto SQL tables, a mapping file similar to the "Sample Explicit Mapping File" example above is needed. That same mapping extended to include the Lane feature type will look like the example below. Example: Road and Lane Mapping 255 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. ... In that mapping example, notice that the mapped elements are the feature type names (Road and Lane) and not the complex type names (RoadType and LaneType). This is a constraint relating to GML3 model. For GML2 feature types, the complex type names have to be mapped. Now, express each road as composed of one or more lanes. First extend the GML schema to add a "hasLanes" property (cardinality 1..n) to the RoadType type and define the "HasLanesType" type that will hold the Lane features. The schema become like in the example below. Example: Related Road and Lane Feature Types 256 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. schemaLocation="http://schemas.opengis.net/gml/3.1.1/base/feature.xsd"/ > The next step consists in expressing the relation in the mapping file and mapping it to the database tables and foreign keys. The relation itself will be modeled using a 257 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. "wfs:Road" and "wfs:Lane" are respectively the parent and child ends of the relation. "wfs:hasLanes" is the source property name. "C_ROAD_ID" is a column of the "LANE" table that models the target field of the relation and the source field being the ROAD_ID in the ROAD table. Setting "ownership" to true means that when a Road feature is deleted the underlying Lanes will be removed as well. Finally, extend the mapping of the wfs:Road type to tell that it is involved in a relation. This is done first by changing its "generation" attribute from its default value to "relational" and second by assigning it a "wfs:hasLane" property which is the source of the relation, through the ROAD_ID key in the ROAD table. The mapping file now looks like below. Example: Road and Lane Relational Mapping ... 258 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Below is a sample GML output from this WFS for the Road feature type. It is clear that one or more Lane types are linked to the parent Road. Example: Road and Lane Sample GML3 Output Association We use associations (which are neither aggregations nor compositions) when there is no ownership between the object types, and when the relation is "one to many" or "many to many". It will be modeled with an intermediary table, like in the example below. 259 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. The example describes the ownership relation between Parcels and Persons, like illustrated in the diagram below. A person can own zero, one or many parcels while a parcel belongs to at least one or many persons. If a person owning a parcel dies the parcel continues to exist, only the relation between that specified person and the parcel will disappear. Also once a parcel is deleted (because of a split or merge for instance), the person continues to exist. The complete mapping and schema files for this example are available in the distribution, under the data/erdas-apollo/db/oracle/ParcelPerson directory. They should be copied to config/erdas-apollo/providers/vector so that they can be referenced by their name in the providers.fac. The SQL instructions to build the tables and data are also provided. Parcel-Person UML Diagram It is assumed that the underlying database is Oracle and the relationship between the PARCEL and PERSON tables is based on a "many to many" relationship, the REL_PARCEL_PERSON holding the relations, as in the diagram below. 260 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Parcel-Person Relational Diagram As soon as an Explicit Mapping has been produced for the Parcel and Person feature types, a GML Application Schema appears with those two feature types defined, as in the "Simple Feature Type Definition" example above. Note that the GML3 rules are being used to define complex properties. Avoid relying on the old-fashioned GML2 syntax. Review the "Moving to GML3" section below for guidelines on how to get familiar with GML3 and how to migrate GML2 schemas to GML3. Example: Parcel and Person Feature Types 261 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. In this example, the Parcel feature type has an "extent" geometric property and an ID. Of course, as it inherits from gml:AbstractFeatureType, it has a set of additional properties like "gml:name" and "gml:description". Those properties will appear in the mapping file if they are mapped with a table column in the database. The Person feature type has an ID, and a set of firstName and lastName properties. To explicitly map those feature types onto SQL tables, a mapping file similar to the "Sample Explicit Mapping File" example above is needed. That same mapping extended to include the Person feature type will look like the example below. Example: Parcel and Person Mapping ... 262 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. In that mapping example, notice that the mapped elements are the exported type names (Parcel and Person) and not the complex type names (ParcelType and PersonType). This is a constraint relating to GML3 model. For GML2 feature types, the complex type names have to be mapped. Now, express each parcel as owned by one or more persons. First extend the GML schema to add a "owner" property (cardinality 1..n) to the ParcelType type and define the "PersonPropertyType" type that will hold the Person features. The schema becomes like in the example below. Example: Related Parcel and Person Feature Types 263 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. The next step consists in expressing the relation in the mapping file and mapping it to the database tables and foreign keys. The relation itself will be modeled using a 264 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. The final mapping file now looks like below. Example: Parcel and Person Relational Mapping ... Below is a sample GML output from this WFS for the Parcel feature type. It is clear that one or more Person types are linked to the parent Parcel. 265 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Example: Parcel and Person Sample GML3 Output In such an association of feature types, you can run WFS GetFeature requests with a filter applying on a property of the child type. The request below searches for Parcels owned by Persons among which at least one is named "Dimitri". 266 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. The complete mapping and schema files for this example are available in the distribution, under the data/erdas-apollo/db/oracle/ParcelPerson directory. They should be copied to config/erdas-apollo/providers/vector so that they can be referenced by their name in the providers.fac. The SQL instructions to build the tables and data are also provided. Limitations and Extensions WFS Transactions on Complex Features: When a feature has a complex property (i.e. a property of cardinality larger than 1, or a property which has sub-properties), an Update transaction cannot apply on a part of that property (i.e. an item of the collection or a sub-property). It is necessary to update the whole property: the property will be deleted and re-inserted with its new content. Mapping of Enumerations Regardless of the type of mapping used, it is useful to have properties whose values are taken from a list instead of being a "wild" string. ERDAS supports two types of enumeration: XML Enumerations when the list of values is defined in the GML Application Schema and Relational Enumerations when the list of values is stored in a table in the database. This sections explains how to configure your enumeration type so that it will be transparently treated as such. XML Enumerations The three key elements to configure an XML Enumeration property are: Defining a type holding the list of values Declaring the type of the property, with a multiple cardinality Telling the mapping file that the property is an enumeration Based on a basic example, here is the illustration on the configuration steps needed for setting up an XML Enumeration. The example used the BOSTON_ORA "BUSINESS" feature type on which a "Nature" property is added. The allowed values for this property are: SCHOOL, HOSPITAL, JAIL, HOME, Restaurant, RESTAURANT, Library and LIBRARY. So, we define a simple XML type deriving from "String", which values are those listed. The XML Schema code to add into the boston_ora.xsd file is: 267 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Then, you have to add a property to your feature type, using the above type, and with a cardinality of more than 1. For the BUSINESS feature type, we give the name "Nature" to this property and we define it as below: Relational Enumerations This type of enumeration uses a database table to store the enumeration values. This solution is generally applied either when you already have sets of values stored in a separate table, or when the set of values goes beyond the limit for XML Enumerations. The main steps needed to configure a Relational Enumeration property are: Declare a simple XML Type in your schema, for that property Add the mapping of this property in your mapping file Add a Once again, we take the BOSTON "BUSINESS" feature type example to explain and illustrate the configuration. If we consider the BUSINESS feature type is mapped with a relational table in 268 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. a database, we can as well consider that a second table, named CITIES, exists, to hold the State and City code of the cities. Our job is to add a "CityCode" property to the BUSINESS feature type, ensuring that the values for that property are taken from the CITIES table. The SQL code to create the CITIES table can be: CREATE TABLE CITIES ( CITY_ID VARCHAR2(20 BYTE) NOT NULL, CITYCODE INTEGER ); Declaring a CityCodeType simple type in the schema and adding a "CityCode" property with this type to the BUSINESS feature type is rather straight forward: ... In the database, a new column has to be defined for the BUSINESS table. We name it "CITYLINK". It must hold the same type as the key column of the CITIES table. And if your RDBMS supports constraints, you can link the BUSINESS.CITYLINK field with the CITIES.CITY_ID key column. Then, that CITYLINK column is mapped with the "CityCode" property in the mapping file: ... 269 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. four attributes holding the types or columns mentioned above. For the CityCode property, it can look like: Limitations and Extensions Transactions (WFS-T operations): you cannot execute transactions on a feature type containing one or more properties defined by a Relational Enumeration if that property is not of type String. This is due to the fact that the value is used as key for reverse-resolving the row ID and that key is a string. Filters: Property values which are defined in a Relational Enumeration cannot be used in search criteria, except if they are defined as strings. Filters can only use exact match operators: Equals or Differs. The table containing the values can also contain other columns which can participate in the search. This feature provides the ability to give alternate values to each row (a string in another language, for example) and have those values taken into account in the search phase. Note that the output value is taken from the first column. In practice, you just need to mention one or more additional columns in the RelationalEnumeration.column attribute, so that it could look like: column="CITYCODE,EUCODE,USCODE". 270 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Control Mapping Correctness If a syntax error is encountered by the WFS service in its mapping file, either the global service will refuse to start or the provider will not be accessible. Requesting the capabilities of the provider and checking its content verifies that the content of the Moving to GML3 This section aims to clarify what parts of GML3 is supported in ERDAS APOLLO, and how to adopt it or migrate services to that new specification. ERDAS APOLLO support of GML3 There are five major reasons why ERDAS made the huge investment to support the new OGC GML3 specification: More and more data providers expressed the wish to publish WFS services with complex data types and GML2 does not provide the appropriate framework to achieve it The OGC WFS 1.1.0 specification provides a good set of new features, but that specifications makes GML3 support mandatory GML3 defines new types of geometries which were not standardized before, e.g., Arc, Curve and Surface. GML3 defines new feature types in order to increase the standardization of vertical models: temporal, units of measure and coverages are just a few examples The new property-value model, at the heart of GML3, allows a much clearer semantic for readers of GML3 documents especially for complex properties. GML3 Concepts and Schemas Before reading the GML 3.1 specification, be familiar with the GML concepts as the document has more than 500 pages. Specification can be downloaded from the OGC web site. There are some shortcuts to understanding the GML3 and being ready to use it: 271 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. From the GML 3.1 specification (numbered 03-105r1), read sections 21 and 23, which are guidelines to using GML3 schemas. ERDAS has configured a sample GML3-based WFS, named ATLGML3_SHAPE, relying on the usual configuration files (types and mapping). Browse those files and send WFS 1.1 requests to that WFS to see how the schema is defined and how the GML3 output is structured. When comfortable, migrate the services to the GML3. The next section explains how to achieve this. Setting Up a ERDAS WFS Serving GML3 There are several ways to prepare a GML3-based WFS. The first situation is whether a GML3 schema already exists, and a WFS is to be built on top of it. This is fast, as only the mapping file and the SQL scripts need to be built in order for the database to be generated. This can be done using one of the "Schema Generator" command-line tools provided as part of the ERDAS APOLLO distribution. It currently only applies to Oracle and Postgres provider types. The second situation is if a database ready, and the mapping and the schemas to be are to be constructed. The "From SQL Generator" command-line tools will do the work. Just make sure to provide the "-gml3" option to the script so that GML3-compliant schemas will be build. The third situation is if a set of WFS providers is up and running, and they are to be transformed so that they will properly respond to GML3-based requests. This migration can be done in a few steps explained in the next section. Migrating a GML2 WFS to GML3 Assuming that there is an entry in the WFS providers.fac and this entry references a schema file (through the "types" parameter) and a mapping file (through the "mapping" parameter). If the provider is to become GML3-compliant, the providers.fac does not have to change, the servlet will analyze the types and mapping files and decide to enable GML3 or not. The types file should be changed: The import clause for the "feature.xsd" schema has to be relocated. Its value is probably one of: schemaLocation="http://www.opengis.net/namespaces/gml/core/feature.xsd" /> or schemaLocation="http://schemas.opengis.net/gml/2.1.2/feature.xsd"/> 272 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. It should become: If the feature types hold complex properties, i.e., properties whose value is not a simple one like string, date, integer, those property definitions have to be adapted to match the GML3 property model. Such a property cannot have more than one value and this value is likely to be remote. So, it has to be split into a 2-level definition. The top level is the property name and the underlying level is the property value. It will often lead to defining a new complexType in the schema. The mapping file has to be adapted to match the following rules: If the gml namespace is included, it has to be relocated to the same URL as for the types file. The If mapping the gml:name and/or the gml:description properties of the feature type to a column in a table, add the compatible="gml2" attribute in the This action is needed because with GML3 the gml:name property has a cardinality of 0..n and has an optional "codeSpace" attribute. To be able to map it to a simple string, tell the servlet should be instructed to keep that the GML2 behavior. The GML3 output of the service will remain valid. That action also has to be taken if the gml:description property is to be mapped to a simple string, as its GML3 definition allows it to be either a simple string or a reference to a remote value. If the mapping does not take advantage of any of the properties inherited from AbstractFeatureType, set the "compatible" attribute to "pure". Some more advanced rules also apply, but as they relate to particular case, they will be treated on a case-by-case basis. 273 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Set Up an ERDAS APOLLO WFS Serving GML-SF (Simple Feature) For a WFS to server features matching the GML Simple Feature Profile (also known as Level 0), you need to import the feature schema ending with "gmlsf.xsd". So, the import clause could look like: schemaLocation="http://schemas.opengis.net/gml/3.1.1/profiles/gmlsfProf ile/1.0.0/gmlsf.xsd"/> You can build that schema manually or produce it with the "From-SQL Generator" tool, taking care of setting both parameters: -gml3 and -cl 274 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Feature Mapping Tags This section presents the detail of the configuration XML tags. They are divided in several sections, for each type of information: The The Metadata The Capabilities Feature Type section The The The The The The Mapping Section The Mapping Tag Element Allowed Attributes Description (* means multiple occurrences) Parent Mapping document root the root element of the mapping (1) The SQL Tag 275 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Mapping defines the mapping associated to a feature type. (2) SQL name the name of the feature type to map or the template name to use for 'sql' generation. If using "%", all tables found in the associated source will be mapped, including System tables if the user is allowed to view them. generation specifies the kind of mapping. specific: the specified elements are mapped (default) auto: the element mapping is automatically generated sql: the type is created from the database relational: to map related tables onto a single feature type autogen: same as "auto" mapping but can be changed manually simple: same as specific without capability of mapping complex types onto a complex SQL type. schema used when generation=sql. It specified a template for the schema/user to address. If not specified, the null value is used leading to processing all schemas available to the user. compatible used to force the mapping be compatible with GML2. Allowed values are pure or gml2. 'pure': the parent gml:AbstractFeatureType is considered empty. 'gml2': the gml3 type is made compatible with GML2. (gml:name and gml:description properties are considered simple strings with cardinality maximum of 1) Sub-Elements of the SQL Tag Table SQL defines the mapping of a type to a table nameSQL the table name alias a possible table alias to use in query generation 276 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. user a schema name if the table does not belong to the current schema (Oracle only) defines the set of alternative tables to invoke based TableScale Table on the scale from the request. There can be 0 to n instances of scaleMax defines the maximum scale at which the current Table is invoked (inclusive). Default is infinity. scaleMin defines the minimum scale at which the current Table is invoked (inclusive). Default is 0. nameSQL the table name user A schema name if the table does not belong to the current schema alias a possible table alias to use in query generation Primary SQL (3) name or nameSQL the column name of the primary key. Several columns can be given (comma separated) fid can have one of the following values: · true: the primary key matches the XML ID requirements, so no encoding is needed · auto: the primary key is generated by the database (for insert operation) The fid="auto" option is not supported for PostgreSQL/PostGIS as this DBMS does not support the unique identifier auto-generation option. Oracle does, based on UUIDs. · false: the primary key doesn’t match the XML ID requirements · generated: the primary key is generated by the wfs (as a long or a string) type a comma separated list of the type of each column (schema type).If not specified, default to xsd:string, unless 'auto' is specified for fid 277 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. allowInsertId if set to true (default is false), the feature IDs are kept (if present) during Insert operations. This is mainly intended to transfer features from one WFS to another. Sets no mapping for the primary key. It will lead to NoPrimary SQL absence of "fid" in the outputs. defines the mapping of the foreign key in auto Foreign SQL mapping nameSQL the column name of the foreign key (used in auto mapping) Element * SQL defines the mapping of one element name the name of the element to map (the feature element name) nameSQL the column name (not required in auto mapping) typeSQL the type of the column (only required for Object and Array types) force Optional field. The only allowed value is "mandatory". It forces the element to have a minimum cardinality of 1 and to become able to be null. This is mainly used when there are several optional geometries in a type to force the mapped ones to become mandatory. This helps retrieve the default geometry property. measure Optional measure unit name. See and nameSQLCol2 the name of the second column (not required in automatic mapping) used to map the end time of a TimePeriod. SQL, defines the mapping of one attribute Attribute * Element name the name of the attribute to map (the feature element name) 278 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. nameSQL the column name defines the mapping of a geometry element (used in Geometry * SQL databases that do not have geometry data types) name the name of the geometry element nameSQL the comma separated list of column names (this defines the mapping of a point) dontCheckName if set to true (the default is false) the column names are not checked for characters requiring the use of quote filterName the column name to use in filter expression, default is to use the nameSQL value functionName the name of a function which is used on the select part and enclosed the nameSQL (mainly applies to MySQL, the function name being "asText") Lock SQL defines the mapping of the lock field nameSQL the column name defines the specific mapping for generation of GetMap (see the Advanced Configuration appendix). MapGen SQL There can be 0 to n instances of scaleMin defines the minimum scale at which the current MapGen applies (inclusive). Default is 0. scaleMax defines the maximum scale at which the current MapGen applies (inclusive). Default is infinity. 279 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. PCDATA the content of this element is a list of formats for which the MapGen capability is disabled. Several separators can be used - among them are comma, MapGenFormat SQL blank, carriage return and line feed. Formats are case-insensitive and are expressed as HTML, GML, SVG, XML, ... Field * MapGen defines the properties to output. name the name of a database column name to use. PCDATA a string that will replace the column name in the underlying request. Optional. a where clause which will be added (with an And) to the underlying request. Optional, and only applicable Where MapGen to providers using a SQL query language (Shapefiles do not!) an ending clause that will be added to the underlying request (typically, a group by or a sort order). Last MapGen Optional, and only applicable to providers using a SQL query language (Shapefiles do not!) prevents computation of the feature identifier, when it NoIdGeneration MapGen is irrelevant. NoQueryGenera if specified, no query will be sent to the data source MapGen tion for the specified scale range defines a relationship between two types (a source type has a relation with a target type). The relation is not used in the "auto" mapping. The relation must be Relation Mapping defined after the mapping of both types. It can be noticed that in case of a many-to-many relationship, targetSQL and sourceSQL contain the primary key of the sourceType and targetType. sourceType the name of the source type of the relation targetType the name of the target type of the relation source the name of the source element in the source type 280 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. target the name of the target element in the target type -if not specified, in a one-to-x relationship, the targetSQL field is used and if not defined, it defaults to the primary key association the name of the association table (used only for many-to-many relationships). In this case, the types of the field must be the types of the primary keys of the source and target types. targetSQL the name of the target field either in the target type or in the association table. sourceSQL the name of the source field in the association table (used only for many-to-many relationships) ownership indicator of ownership. Implies cascaded deletions of the related objects. (In case of a many-to-many relationship, the delete occurs only in the association table) The possible values are: false = no automatic delete occurs true = the source owns the related objects, so they are deleted. reverse a boolean used in a many-to-many relationship to automatically add the reverse relationship (the default is false) targetTable the name of another table holding the relation data build a mapping between a simple type and a table of values. The table of values has a primary key and several columns with at least one containing values. The logic is to store the primary key of a value in the RelationalEnum feature table instead of the value. Note that the SQL SQL eration type of the primary key and the SQL type of any elements of the mapped type must match. As the type is mapped, this is valid for all elements of this type. If you have a element of the enum type which has a max cardinality > 1, it will not work name the name of the simple type to map. It is usually an enumeration type. nameSQL the name of the SQL table containing the value pkey the name of the primary key 281 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. column a comma-separated list of column names containing some values Sub-elements of the Element tag defines the types used in a collection Type * Element name the type name mark the element to be stored as a blob (the element should be a Blob Element collection) mark the collection elements to handle its own FID. It implies that the HandleFID Element WFS does NOT recognize this FID as a valid FID of get feature request mark the collection elements to use an enumeration mapping where the collection is mapped onto a string. Each character of the string is one element of the collection. This tag has no effect if the element is Enumeration Element not a collection. This reduces the query done to insert/retrieve the feature and allows to use the property in the filter like a simple property. Metadata Section The Info Tag 282 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Element (* means multiple Allowed Attributes Description occurrences) Parent Document root the root element of the information section Info (2) name the type name linked to the information (7) base the name of the parent type whose info should be inherited by this type info Sub-Elements of the Info Tag 283 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Info PCDATA defines the title associated to the type and Title exported in the capabilities Info PCDATA defines the abstract associated to the type Abstract and exported in the capabilities Info PCDATA defines the list of supported SRS, SRS separated by a space. The first SRS is the internally used one (4). overwrite boolean value (true, false) defining if the list of SRSs exposed in the capabilities document is exclusively composed of the current list or if the SRSs coming from the data are added. Default: false. BoundingBox * Info defines the bounding box SRS the box SRS minx the X value of the lower left point miny the Y value of the lower left point maxx the X value of the upper right point maxy the Y value of the upper right point Info PCDATA defines the supported operations as a comma separated list. Allowed values are *, # , Insert, Delete, Update, Lock, Query and Native. Warning: some operations Operations may not be supported by all connectors. "*" means all operations. # means Query, Insert, Delete, Update. If not defined, the default is "Query". (5) Info as ERDAS WFS Servlet is also able to support the WMS Specification, this tag Dimension * describes the behavior of the getMap and publishes the dimension and extent for conformance to WMS Specification. (6) 284 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. name the dimension name that will be published in the WMS capabilities document. It must be prefixed with DIM_ in the requests, except for TIME and ELEVATION property the feature property name (default is name) unit the unit name (mandatory attribute, value cannot be empty) symbol the symbol name default the default value (optional) PCDATA the extent: see (6) Info PCDATA the template url of the metadata url (see MetadataURL section in Advanced Configuration appendix). If this string is Metadata empty, the DefaultMetadata option is used. If this one is also empty, the provider global default is used. type the type of the metadata (default is TC211) Acceptable values are TC211, FGDC, 19115, 19139. Info PCDATA the template url of the legend url (see LegendURL section in Advanced Configuration appendix). If this string is Legend empty, the DefaultLegend option is used. If this one is also empty, the provider global default is used. Info,Option This options allows to configure the output produced by the GetLegendGraphic through SLD rules. This element can be either in tho Info section for a single LegendConfig feature type, or in the Option section for global application. 285 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. width, height the width and height of the drawing area (default width is 18, default height is 12) widthOffset the offset between the image border and the drawing area (default 5) offset the y space between two drawing areas textRightOffset the offset between the text and the image border (default 5) textBottomOffset the offset between the bottom of the drawing area and the text (default 3) fontSize the text font size in points (default 10) fontName the text font name (default Arial) fontStyle the text font style (use bold for a bold font, defaults to normal) outline boolean. If set, an outline is drawn around the drawing area (default false) outlineColor the color of the outline (default black) textColor the text color (default black) backColor the image background color (default is white). Used only if not present in the request scale the scale factor to apply when drawing (default 4). It means that the rule is drawn scaled up and down, e.g., the marker size will be reduced by the scale factor. Info PCDATA defines if the WMS layer built on top of the feature type can be queried. The default Queryable value is "true". So, this tag clears the queryable flag for the given layer. 286 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Info defines the scale hint to give to WMS layers. Not that the scaleMin defines the minimum scale (default 0) scaleMax defines the maximum scale (default is max) * means multiple occurrences An occurrence of the "Mapping" element can appear for each feature type. A single element can group several feature type mappings. For a given feature type, if its schema is in the same file as the mapping, the In common situations, the "Primary" element is mandatory. If not mentioned, the "fid", which value is based on this element, will not be permanent. Moreover, this element is the only one allowed for a mapping of type "sql". In the case of an Oracle Spatial database, the value of the first SRS will be matched with the SRID given in the USER_SDO_GEOM_METADATA table, whatever value it has. Operation "Native": This declaration indicates that in the capabilities document the In the case of ERDAS, the attributes vendorId and safeToIgnore for this element are ignored. The content of the element is directly passed through as a Transaction to the JDBC source. No response is returned. That means that for a SQL request, a SELECT order will provide no data back. However, a CREATE, an INSERT or a DROP will do something. This operation does not enforce the interoperability concept and is a threat as it allows the database to be altered. For the ERDAS WFS, the JDBC-type data sources are the only ones that support that "native" operation, i.e. Oracle, Oracle OCI, Postgres, DBF, ODBC and MS-Access. The Shapefiles and ArcSDE connectors do not support it. Dimension: 287 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. First, it allows the publishing in the WMS capabilities document one or more name: The name that will appear in the capabilities document for the elements property: the property name of the feature type. unit: A character string indicating the type of unit of the property. This value is not checked by the ERDAS WFS. It is only used to provide the necessary information in the capabilities document as the "units" attribute. This attribute is mandatory. Example: kilometer, m, second, time, etc. symbol: will produce the "unitSymbol" attribute in the default: A default value to use if the request does not mention this dimension as parameter. If no value is defined, the request will do no filtering on this property. This value will also be used for the "default" attribute of the The element to insert as PCDATA in the 288 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Examples: The Capabilities Feature Type Section: The Export Tag 289 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Element (* means Allowed Attributes Description multiple occurrences) Parent Document the export section defines the types which are Export root really declared in the capabilities document generation the value can be: · mapped: mapped types are exported if they are not explicitly removed, added types are also exported · exportOnly: only explicitly exported types are exported Sub-Elements of the Export Tag Add * Export Name the type name to add Remove * Export name the type name to remove Collection Section: The Collection Tag 290 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Element (* means Allowed multiple Attributes Description Parent occurrences) Document Name the type name to use as collection or as member root element. If the type name is not of type Association, the type name will be used as collection. The typename can be a global element or a Collection type. (The first element whose type is Association will be used as feature Member) If the type name is of type Association, the collection element is unchanged, and the member element is replaced with this one. Options Section: The Option Tag 291 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Element (* means Allowed multiple Values Description Parent occurrences) Document A set of options applying to all feature types Option root Option gml2, This option specifies the use of an agressive method to compute gml3 the geometry type from SQL."gml2" is for GML2 types, "gml3" for AgressiveSQLMa GML3 types. The option may also be specified in the pping providers.fac file as an provider property. This is not always an accurate method. (Default: disabled) Option true, false Allows the output of deprecated GML3 geometries, lighter than AllowDeprecated the new ones, when the actual geometry complies. Default: false. GML3 Option true, false This option, if set, emulates the distance sort for the output of the AllowFullDistanc WMS GetFeatureInfo request. If not set, the system assumes the eEmulation closest feature is returned first by the provider. (Default: false) Option true, false If set, the model verifier will be a little more permissive. Among AllowLaxGMLMo others, it will allow attributes for GML3 properties. (Default: false) del Option true, false This option allows the GML reader included in the WFS to tolerate some minor errors (like entering invalid enumeration AllowLaxParsing values...). (Default: false). Option true, false If set, the default legend template is used even if no Legend tag AlwaysGenerate is defined: the LegendURL tag is forced in the capabilities Legend document (Default: false). Option true, false If set, the default metadata template is used even if no Metadata AlwaysGenerate tag is defined: the MetadataURL tag is forced in the capabilities Metadata document (Default: false). 292 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Option true, false It applies to WFS transactions. If set, the WFS will check that something is locked (or unlocked) before processing a delete or CheckSomething update request. The default value is false. Warning: if set, any Locked request to delete nonexistent features while no other feature is locked will return an error message. Option true, false This allows the WFS to compute the Option 0,1,2 This option forces the schema produced with an SQL Mapping to conform to the OGC-GML Simple Feature Profile. (Default: not ConformToSimpl set). The value of the option is the conformance level (0,1,2). eFeatureProfile Option positive The default dpi to use in the renderer for GetMap operations DefaultDPI number DefaultLegend Option string Defines the default path template for legend files location DefaultMetadata Option string Defines the default path template for metadata files location DoNotRewriteSc Option true, false This option prevents the WFS from rewriting the schema location hemaLocation with a location relative to itself. Default is false. Option true, false If true, requests not to embed SVG images/symbols but produce DontEmbedSVG external url instead Option true, false This options allows the WFS to output the produced GML as a continuous stream without doing internal copy. So It requires less memory and there is no need for the MaxMemorySize option to DoStreamGML produce large output. Restriction: It implies to envelope computation. (Default: false). Option encoding This specifies the charset used to encode the GML response, the GetCapabilities response and the DescribeFeatureType EncodingCharset response. (Default: utf-8). Option encoding This specifies the charset used to encode the SHAPE response ShapeEncodingC to a GetFeature. (Default: utf-8). harset 293 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Option positive This option is used during generation of 8 bits images (GIF or integer PNG8). It defines the minimum alpha value to be FilterAlphaMin non-transparent. (Default: 128). Option positive This option is used during generation of 8 bits images (GIF or integer PNG8). It defines the minimum distance to be distinct from the reference color. (Default: 1000). FilterDistanceMin Option true, false This option forces the WFS to follow the order of axis defined by EPSG when an EPSG SRS is used. It mainly applies to geographic projections, for which EPSG sets the FollowEPSGDef latitude-longitude order and some OGC specifications set the longitude-latitude order. (Default: false) GenerateUpperC Option true, false If true, sets the use of uppercase in AUTO mapping mode ase Option true, false If true, requests to generate PNG with 8-bit depth instead of Generate8BitsPN 24-bit. This makes the PNG output compatible with Microsoft G Internet Explorer versions <= 6.0, which cannot deal with RGBA PNG. This option always overrides the QUALITY parameter. Option true, false Request to have the default GML output format to be GML2 or GMLOutputFollo GML3 depending of the actual model used. If not set, the default wModel is GML2 for WFS 1.0 and GML3 for WFS 1.1 or above. Option true, false If set, this option allows you to use and expose the SRS defined in the mapping file and ignore the SRS defined in the data (such IgnoreDataSRS as a prj file forshapefiles). It currently only applies to shapefiles. Default value is false. See also the Info "SRS" element, "overwrite" attribute. Info, true, false This option allows to configure the output produced by the Option GetLegendGraphic through SLD rules. This element can be either in tho Info section for a single feature type, or in the Option LegendConfig section for global application. See that same element in the "Info" section for detail of each attribute. 294 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Option number The max memory size to allocate per request in bytes. This is a hint. It is currently used in the GML generation. A negative or MaxMemorySize zero value puts everything in memory. (Otherwise a backup file is used, well it is slower but safer...) Option true, false If set, this option forces the output of the WFS to strictly obey the OGC-published schemas. It mostly impacts the set of OGCStrictConfor FilterCapabilities in the WFS 1.1 capabilities document. Keeping mance this value set to false allows you to extend the set of FilterCapabilities to other operators. Option true, false If true, requests not to compute the box of the resulting feature OptimizeGMLOut collection. This prevents from rewriting the GML output stream to put put the computed box at the beginning Option true, false It applies to WFS "Delete" transactions. If set, the WFS will never check if something has been deleted. Otherwise (the default RemoveDeleteCh behavior), the WFS will check if there has been a deletion. If eck there was a deletion and the transaction still exists it will throw an error. Option true, false It applies to WFS "Update" transactions. If set, the WFS will never check if something has been updated. Otherwise, the WFS RemoveUpdateC will check if there has been an update (this is the default heck behavior). If there was an update and the transaction still exists, it will throw an error. Option string This option specifies the schema location attribute written into GML output. It is written as-is, no correctness check is done. The default behavior of the WFS is to generate one relative to itself, but sometimes it may be convenient to force the location of the SchemaLocation various schemas. Option none, This option defines how the WFS outputs the SRS. The default is SHORT, as the user typed it, "SHORT" forces the code:value notation SRSOutputForm URN, (e.g. EPSG:26986), "URN" forces the URN notation, at URNCON "URNCONVERT" sets the URN notation converted into the OGC VERT codes (e.g. EPSG:4326 gives OGC:84). Option true, false Requests to generate a pixel space pattern using a method more UsePixelPatternV compatible with Adobe Viewer. Default is false. 2 295 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Option true, false requests to output UTC dates instead of GMT ones (UTC = GMT UseUTCDate + 12h). (Default: false) User Functions Section: The UserFunction Tag Element (* means multiple Allowed Attributes Description occurrences) Parent UserFunction Document root defines a user function implemented in the back-end database name the user function name as exported in the capabilities and used in the filter nameSQL the database function name (or procedure name) Sub-Elements of the UserFunction Tag 296 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Parameter * UserFunction Defines the nth parameter type type the parameter type (default to string) nbr the number of parameter to repeat (default is 1) UserFunction optional element to define the function returned type. If not Return specified, the returned type is not a string. type defines the return type of the function Units Definition Section: The UnitDefinition Tag Element (* means multiple Allowed Parent Attributes Description occurrences) UnitDefinition Document root References a dictionary used for measures PCDATA The URL to the units dictionary 297 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Units Association Section: The UnitAssociation Tag Element (* means Allowed Attributes Description multiple occurrences) Parent Unit Association Document associates a measure unit to a property of a root feature type type the feature type name the property name (defined by an Element tag) measure the unit name (one of the internal ones, or one defined in the unit dictionary given by the UnitDefinition tag WMS Layer Hierarchy Section: The WMS Tag Element (* means multiple Allowed Attributes Description occurrences) Parent WMS Document root defines some behavior of the WMS interface built on top of the WFS 298 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Sub-Elements of the WMS Tag Element (* means Allowed Attributes Description multiple occurrences) Parent Layer WMS, Layer Defines a node in the layer structure of the WMS title the title that will appear in the WMS capabilities document type for a layer corresponding to an actual feature type, the name of that feature type name only applies to layers which are not feature types. It will allow the category layer to be used in requests. Map Generation Transformer The Map Generation (MapGen) transformer is an additional configuration in the WFS mapping file used for changing the default server response to the GetMap request. This configuration can speed up processing at certain scales, extract unnecessary data columns and apply conditional filtering, grouping and ordering clauses to the original requests. Warning: Please ensure that the Feature Mapping process detailed in Feature Mapping Tags (on page 275) is fully understood before using the MapGen transformer. Topics Using MapGen ...... 300 MapGen Tags and Attributes ...... 302 MapGen Tag ...... 302 Feature Properties (Re)definition ...... 302 scaleMin and scaleMax ...... 304 Filter - The "Where" Tag ...... 304 The "Last" Tag ...... 306 Warning: MapGen and Portrayal Rules ...... 307 Scale Dependent Table ...... 307 299 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Using MapGen This section describes examples where Map Generation Transformation can be used to ensure smart and fast output. The use cases described here are only a few examples and one may find other practical applications of MapGen. The main aim of MapGen is to improve the map generation performance by not referencing unnecessary information from the data source. Properties Selection When mapping GI data, sometimes only the feature's geometric property, or location information is of interest. Imagine a simple world map displaying only the boundaries of countries is to be created. However, there is a set of linear data for country boundaries that also includes several other properties such as population and economic statistics. A GetMap that queries only the geometry will greatly improve performance. However, a GetFeatureInfo query needs to be performed on a country and all the attribute values must be retrieved. Without a particular configuration, the GetMap request will extract all property values and geometry. If there are too many properties to retrieve, the GetMap request will return with poor performance. Using MapGen, select the specific properties to be employed for map generation. In the example below, the CITY feature has many properties (ADMIN_LEVEL, POPULATION, ECOSTAT, BOUNDARY). For each MapGen block, the Scale Dependent Filtering The goal is to display cities in the world map. At the world scale, all cities cannot be displayed as this will result in thousands of points overlapping thus rendering the map unreadable. Moreover, executing this GetMap request may return poor performance due to the large quantity of features. Therefore, to logically portray cities, extract only the major cities at world level and then display more and more smaller cities depending on the zoom level. This can also be done with MapGen by using feature properties filters for each specified scale range. In the example below, the CITY feature has several MapGen blocks, one per scale range. A Scale Dependent Geometries Imagine that the cities to display actually have two geometries: a point to denote the center of the city and a polygon that denotes the city's extent. Using MapGen, either the polygon or point can be displayed depending on the scale of the map. 300 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. In the example below, the CITY feature has one published geometry, named "Boundary" but the underlying table has a second geometric column, named "CENTER". In the first MapGen block (which denotes the highest scale), the BOUNDARY column has been replaced with the CENTER column. Example of MapGen for the CITY Feature Type [...] Scale Dependent Table Several data tables can be set up, each having the same structure but a different set of data and each to be invoked at a different scale range. The configuration is explained in section 5.10 below. 301 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. MapGen Tags and Attributes The following DTD portion defines the MapGen elements and attributes. For more information about the mapping tags, refer to the appendix on feature type mappings. MapGen Tag MapGen is defined in the WFS feature mapping file by one or more The existing mapping configuration tags are still needed to provide default behavior and other types of requests such as GetCapabilities, GetFeatureInfo, DescribeFeatureType, and GetFeature. Remember that the MapGen tag only applies to GetMap requests. Feature Properties (Re)definition Each 302 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. "Name1" is the name of the Feature's property and "name2" is the name of the field to actually use in the underlying data source. "name2" only has to be set if the "name1" property has to be replaced with something else. The properties can also be redefined with an SQL clause. For example, if the property has a numerical value, apply a formula and use it in conjunction with a "group by" operator. Warning: If the [...] 303 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. scaleMin and scaleMax In order to emulate the last two use cases presented, the scale interval attributes in the MapGen tag need to be set. Setting this interval by mentioning one or more MapGen sections at one per scale interval allows varying the display and filtering in accordance to the scale value of the request. In this example, the mapping configuration is such that MapGen will be used between scales 1:1000 and 1:2000. For all other scales, classical mapping that maps all the columns in an Filter - The "Where" Tag An optional where the clause is a string which must be valid for the data source. Beware that the quote character could need encoding as "'" (e.g.: [...] 304 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. In the example, cities with more than 100 000 inhabitants have been extracted from the data source and will be portrayed at or above a scale of 1:50 000 000. 305 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. The "Last" Tag This optional tag permits a grouping or sorting clause to be appended onto an SQL statement. Below is an example that uses the round(EF.GEOM.SDO_POINT.X,0),round(EF.GEOM.SDO_POINT.Y,0),NULL),NULL,NU LL) 306 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. To clarify this example: The MapGen mapping is applied above the scale of 1:100 000 000. The The The properties of the features have now been redefined. Since a new feature will result from the use of the "GROUP BY" tag, SQL operations such as MAX, AVERAGE, COUNT(*) can be performed. Also, new geometries can be created through the Oracle syntax: MDSYS.SDO_GEOMETRY(2001,NULL,MDSYS.SDO_POINT_TYPE( round(EF.GEOM.SDO_POINT.X,0),round(EF.GEOM.SDO_POINT.Y,0),NULL),NULL,NU LL). Warning: MapGen and Portrayal Rules Each time a GetMap query is received by the ERDAS APOLLO WFS servlet (and if the requested map scale is in the bounds defined in one of the MapGen tag), the MapGen configuration is used to build the data extraction request. The features extracted are then portrayed by application of portrayal styles and rules. Please ensure that the MapGen configuration outputs the properties needed by the portrayal as the styles and rules applied to the features properties that have been extracted. Scale Dependent Table Set up several data tables each having the same structure but a different set of data and each to be invoked at a different scale range. The configuration consists of defining 307 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. For GetFeature requests, the server currently does not analyze the Filter to determine the scale. Add a parameter: In HTTP-Get, add the STDSCALE parameter to the request; In HTTP-POST, add the stdScale attribute to the Sample Mapping code with Table scales: The "scale" mentioned in this section refer to the "Standard Scale" as defined by OpenGIS in the WMS 1.1.1 specification. Protecting Data Data often has a commercial and/or legal value and, therefore, protecting data is a major concern for data providers. This section describes a set of configurations that provide restrictions on published data. Disabling some of the request types that can be sent to the service Hiding columns to show only a subset of the underlying data Disabling output formats to prevent the actual data from being extracted Adding a Copyright or a Watermark Topics Disabling Interfaces ...... 308 Hiding Columns ...... 309 Disabling Output Formats ...... 310 Adding a Copyright or a Watermark ...... 310 Disabling Interfaces Service Providers over vector data automatically support the OGC-WMS and OGC-WFS interfaces. This means that a user can request maps as well as features. A data provider may want to allow map output but not deliver the vector data as features, or, conversely, provide access to data but restrict the ability to create a map. These restrictions can be activated by setting the "Enabled Interfaces" field on the "Miscellaneous" tab of the Edit Provider feature of ERDAS APOLLO Data Manager. Supported 308 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. parameter values are "wms", "wfs" or both. This disables the associated set of request types: for "wms", the WMS GetCapabilities, GetMap and GetFeatureInfo and for "wfs", the WFS GetCapabilities, DescribeFeatureType, GetFeature, LockFeature and Transaction. WFS Operations In the mapping file of the WFS Provider, the WMS Operations By default, a WFS Provider supports the three basic WMS request types including GetFeatureInfo. To restrict the allowed request types, set the Hiding Columns When a vector provider's mapping file is created using SQL mapping or the FromSQLGenerator tool, the mapping between the feature type attributes and the table columns is often one-to-one. However, it is possible to hide some of the columns to prevent disclosure of useless or critical information or produce lighter results. To achieve this, create explicit mapping and schema files: In the Mapping file, remove the corresponding In the Schema file, remove the declaration of the properties that are no longer mapped with a column name. Submit a DescribeFeatureType request to see that the removed properties are no longer visible. A GetFeature request will confirm that the corresponding column values are hidden. 309 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Disabling Output Formats When the provider is configured, the servlet will automatically publish, in the WMS Capabilities document a set of formats in which the maps or feature information can be requested. This set of formats can vary depending on the underlying data type, raster, vector or coverage. There may be a requirement to remove some of the formats and reject requests asking for those formats. This can be done easily by setting the "Hidden Map Formats" and "Hidden Info Formats" fields in the "Styling Info" tab page of the provider definition. The values are a comma-separated list of format names. For raster formats, the possible values are GIF, JPEG, PNG, SVG, TIFF, WBMP and XBMP. These correspond respectively to the mime-types image/gif, image/jpeg, image/png, image/svg+xml, image/tiff and GeoTIFF, image/vnd.wap.wbmp and image/x-bmp. For information formats, the values are GML, HTML, TXT and XML, and correspond respectively to the mime-types application/vnd.ogc.gml, text/html, text/plain and text/xml. If all the possible formats are disabled, the service capabilities document will become invalid against the DTD or schema. In addition, the client applications could behave strangely when querying the service. Adding a Copyright or a Watermark When maps are produced by the service, the owner of the service could expect the intellectual property of that map to be preserved. This section lists the steps to add text or an image into a map or GML document. Add Text to a Map Access the ERDAS APOLLO Data Manager, highlight the Service Provider in the Explorer view, right-click, then select Edit Provider -> Security Parameters and enter the text in the Copyright field. The text you enter will appear in the upper left corner of the image if you request a map, or in the header of your GML document if you extract features. For this solution, you can only use text and you cannot change the location or the appearance of the text. Add a Graphic to a Map If you are managing vector data layers and want a raster image to be added to the output, use the map dressing function of the ERDAS APOLLO Style Editor and follow these steps. 1. Navigate to 310 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. 4. Create your watermark or rename an existing file to watermark.gif. The file must be a *.gif format. 5. Copy the watermark.gif file to Data > Add Map Source > WebMap Server (HTTP) Enter the URL: (http:// Skip the Login User/password step if the service is not secured. 7. Add the vector and raster layers on which you want to see the watermark. Using the Style Editor, select Data > Add Map Source > Web Map Server (HTTP) and add your raster layer. Using the Style Editor, select Data > Add Data Source > Web Map Server (HTTP) to add your vector layer. 8. Add your raster/vector layers and watermark symbol to preview. The preview window shows what you will see for the services in the Web Client. 9. Export your changes as a OGC Web Map Context XML file using the Style Editor (File >Export Context...). For example, save the OGC Web Map Context XML file to your desktop. 10. Navigate to Schema Generator The Schema Generator tool is used to build a database generation script based on a given XML schema of feature types. It supports Oracle and PostgreSQL. To use the command-line tool: 1. Open a console window. 2. cd 311 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. 3. For Oracle run ./runoraschemagen.bat 4. For PostgreSQL run: ./runpgschemagen.bat Running the script with no argument will produce an explanation of each parameter: Common options -schema SCHEMAURL [-mapping MAPPINGURL] where SCHEMAURL is a URL to the schema file where MAPPINGURL is a URL to the mapping file -verbose to output more information -forceauto to use an auto mapping if none is provided -usetargetspace to dump types belonging to the schema target namespace -ignoreknowntypes to ignore types derived from feature association, geometry property types... -usepkstring to specify the use of a string as the primary key type in mapping auto SQL generation options -bestfit tries to only use types reachable from the schema target namespace -out to output to the given file in utf-8 format SQL generation options: ------intermedia to generate Oracle Intermedia compatible layout -remove to generate remove orders -delete to generate delete orders -lock to generate the tables used in the lock mechanism (no other option is required) Mapping generation options: ------autogen to generate autogen mapping Autogen Specific options: ------infogen to generate info section with all operations enabled if not present -srs SRS to specify an srs for the info gen section -allowfidinsertion to allow the insertion of fid during insert operation 312 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. -lax to apply the laxist GML model verification (see also the allowLAXGMLModel mapping tag) Example cd For PostgreSQL: ./runpgschemagen.bat -schema boston_ora.xsd -mapping boston_ora.xml -out boston_ora.sql From-SQL Generator The From-SQL tools are used to build mapping and schema files based on database models. There are six separate tools (.bat files) for the following six data sources: Oracle - runfromsqlora.bat PostgreSQL - runfromsqlpg.bat ESRI Shapefile - runfromsqlshp.bat ESRI ArcSDE - runfromsqlsde.bat Microsoft SQL Server 2008 - runfromsqlsqlserver.bat DGN files (through the FIO plug-in) - runfromsqlfme.bat Each tool is also accessible through the Data Manager when managing vector services using the "Create Types and Mapping" link. To use the command-line tool: 1. Open a console window. 2. cd 313 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. In counterpart, the -factory option starts from a pre-defined provider, with a mapping and types file already built. In this case additional parameters, instead of being passed as arguments to the command, are taken from the existing files. The main use case for this -factory option is to build a more complete and explicit mapping file based on a simple one such as one expression and SQL mapping. Example: cd For Oracle data, the -table and -schema arguments values must be uppercase. For PostgreSQL data, the -table and -schema arguments values must have the exact case (generally, lowercase). For ArcSDE connections to succeed, add the jsdeXX_sdk.jar file (and possibly the jpe[XX]_sdk.jar and icu4j.jar files) provided with the ESRI ArcSDE product in the Remarks The produced mapping file contains all the columns from the table. Manually remove the columns that are not to be published. The mapping file does not mention a Primary key column. It is set to The mapping table does not mention any The mapping and types files are overridden if they exist. The mapping and types file paths can use absolute or relative paths, relative being relative to the tool directory. ".." can be used, and under Windows, "/" or "\" or mixed. The srs parameter is used to fill the mapping file with the Bounding Box information. The syntax used for the srs parameter will be set into the mapping file, either 314 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. code:value or urn:opengis:def:crs:..... For databases where the srs value is set in the database (ArcSDE, for example), the srs given as argument will be added to the mapping file. The original srs will be set first, unless the -srsover is set to true. In that case, only the srs given as argument is added to the mapping file. In addition, the "overwrite" attribute of the The set permitted Operation is "Query". This needs to be changed if transactions are to be allowed. If some of the published columns from the mapping file are removed, also remove the published properties from the schema file. Under Oracle, the schema file gives geometries a type named "gml:GeometryAssociationType" or "gml:GeometryPropertyType" if the -gml3 option is used. Replace it with the actual geometry property type: gml:PointPropertyType, gml:LineStringPropertyType, gml:PolygonPropertyType or Multi-* geometry property types as described in the OGC WFS 1.0.0 specification. An alternative is to use the -agressive option to let the tool guess the appropriate geometry type. The GML-Simple Feature profile option (-cl n) only produces valid output if combined with the -gml3 option. The "n" argument is the conformance level, which value can be 0, 1 or 2. Currently ERDAS APOLLO produces the same output whatever level is chosen. An alternative to the command-line From-SQL generator tools is to use the Data Manager, in which the action "Create Types and Mappings" does the same job as the command-line tools. WFS Loader Often WFS feature collections, available either as GML files or in a WFS, need to be copied into another WFS. The WFS Loader tool helps achieve this transfer operation. The WFS Loader tool is located in the 315 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Configuration of the input feature collection and the output WFS-T: The configuration of the input feature collection and destination WFS-T can be accomplished by setting up an XML file named XML Script. A set of sample scripts are provided in the distribution, under 316 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. XML Scripts Structure The general structure is: The starting XML tag is always . The first two tags, namely 317 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. GML files with a directory path. The "ID" attribute is an identifier that will be used in subsequent instructions. Note that if there are several GML files directories, the Customized Configuration of the WFS Loader Tool 1. Update the wfs.fac file to have a provider correspond to the WFS. We recommend defining a new provider with the proper connection string and the appropriate schema and mapping files. Ensure that the database tables are created before running the script including the "LOCKTIMEOUT" table used for WFS Locking. Check also that the mapping file allows the "Insert" operation to be performed on the features types to use. 2. Put the GML files in one or more directories under Features in a WFS If the features are in a WFS instead of in a directory of GML files, it will be necessary to execute a GetFeature request on the originating WFS to place the resulting feature collection in the destination WFS-T. A sample script corresponding to this situation is located at 318 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. In this script, a second 319 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. A 320 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. Appendix C: Shapefile RTree Builder In order to handle spatial data efficiently, a database system needs an indexing mechanism that will help it retrieve data items quickly according to their spatial location. However, traditional methods such as linear, hash, B-Tree or Quad-Tree indexing are not well-suited for data objects located in multi-dimensional spaces. The schema below shows how an R-Tree with a dynamic index structure meets this need. RTree Structure An R-tree is a height-balanced tree similar to a B-Tree with records in its leaf nodes containing pointers to data objects in the database. A n-dimensional rectangle determines the bounding box of the indexed spatial object. Each parent node entry contains the smallest rectangle that spatially surrounds all rectangles in the child node as shown in the schema above. The ERDAS APOLLO Shapefile RTree Builder tool will generate an RTree index file for a shapefile, enabling faster searches in the data in that file. The RTree index file will be created in the same folder as the shapefile, will have the same base name but the .shp extension will be replaced with .rtr. The Shapefile RTree Builder tool is part of the command-line tools provided in the ERDAS APOLLO distribution. It is also available behind the "Index Data" link in the Administration Console when managing a ShapeFile provider. To use the command-line tool: 1. Open a console window. 2. cd 321 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. 3. Run runrtreebuilder.bat [basedir] [shapefile name] [maxcapacity] [mincapacity] basedir : base directory containing the shape files shapename : the shape file name or name pattern (without any extension) maxcapacity : RTree maximum node capacity mincapacity : RTree minimum node capacity Example: C:\Program Files\Hexagon\ERDAS APOLLO\tools\ows>runrtreebuilder.bat "C:\Program Files\Hexagon\ERDAS APOLLO\data\erdas-apollo\shapes\atlanta" roads 100 50 A recent performance analysis indicates that the values '100, 50' are best choices for maxcapacity and mincapacity for most types of data. Running the script with no argument will produce an explanation of each parameter as shown above. 322 Technical Support and Information Hexagon Geospatial provides several ways to access information and to contact support, including self-help tools and phone support. Self-help Support Tools Hexagon Geospatial provides several electronic self-help support tools to answer your support questions 24 hours a day, 7 days a week. 1. Go to Hexagon Geospatial Support (http://www.hexagongeospatial.com/support). 2. Under the Please Sign In heading, type your user name and password and click Login. If you are not a registered user, click the Not a Registered User? link. To search the knowledge base: 1. In the Knowledge Search box on the left, type your question or key words for a search. 2. In the box to the right of the Knowledge Search box, begin typing the product name. Then select the product from the drop-down list. If you want to search among all products, leave the second box empty. This field is case sensitive. To search posted documents for your product: 1. Click the Products (A-Z) tab. 2. From the Product Family list, click the link to your product family. 3. On the Family page for your product, click the link for ERDAS APOLLO. 4. Select the desired document from the Product Information list. Release Notes and Issues Resolved might not be available for the initial release of a product because an initial release has all new features and no updated features. Some minor releases might not provide Release Notes or Issues Resolved. Phone Support and Other Links For support phone numbers or to submit sales inquiries, general questions, and comments, click the appropriate tabs at the top of the Hexagon Geospatial Support (http://www.hexagongeospatial.com/support) page. 323 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. 324 Creating Styles with Properties • 54 Creating Styles with SLD • 54 Index CSFStore.config Examples • 202 A D About Us • 13 Data Sources • 87 Adding a Copyright or a Watermark • 302 Delivering Data • 37 Adding a Custom CRS • 188 Delivering Image and Point Cloud Data with Adding a Custom ERDAS APOLLO Streaming Services • 46 Coordinate Reference System • 189 Delivering Image Data with a Web Adding a Custom ERDAS IMAGINE Coverage Service (WCS) • 40 Coordinate Reference System • 195 Delivering Map Images with a Web Map Adding a Custom Geospatial SDI Service (WMS) • 38 Coordinate Reference System • 196 Delivering Vectors/Features with a Web Adding Coverage Resources • 95 Feature Service (WFS) • 47 Adding Features Resources • 88 Deploying Styles • 61 Adding Raster Resources • 93 Disabling Interfaces • 300 Administration Options • 35 Disabling Output Formats • 302 Advanced Search • 20 Discrete Classification • 141 Appendix A Displaying Statistics in a Map • 62 Coordinate Reference Systems • 209 Appendix B E Schema and Database Mapping for WFS • 233 ERDAS APOLLO Catalog REST Interfaces Appendix C • 23 Shapefile RTree Builder • 312 ERDAS APOLLO CRS Definition • 209 Authenticated Connections • 97 ERDAS APOLLO REST Endpoints • 25 Automatic Mapping Definition Steps • 246 ERDAS APOLLO Style Editor • 81 ERDAS IMAGINE Projection System • 222 B Explicit Mapping Definition Steps • 243 Browsing and Searching Content • 18 F Business Data in the Catalog • 181 Feature and Feature Type • 236 Feature Mapping • 239 C Feature Mapping Tags • 268 Catalog Web Interface • 15 Feature Numberer Rule • 168 Checking for Unsupported EPSG Code Feature Properties (Re)definition • 295 Failures during a WMS Request • 205 Feature Schema Configuration • 237 Checking for Unsupported EPSG Code Filter - The • 296 Failures When Crawling Vector Data • From-SQL Generator • 305 206 Classification Rule Example • 158 G Classification Rules • 140 Common Elements • 178 Georeferenced Coverages • 43 Control Mapping Correctness • 264 GetLegendGraphic Request • 39 Coordinate Reference System Engines • GML Application Schema • 235 187 GML Application Schema and Mapping to Coordinate Reference Systems • 187 Databases • 233 Coverage Portrayal Service (CPS) • 66 Creating or modifying usersref.xml • 190 Creating Styles • 53 325 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. H P Hiding Columns • 301 Passing CRS Parameters in Web Requests • 188 J Patterner Rule • 174 Portraying and Styling Data • 51 JSON Model • 31 Preferences • 85 Producing KML • 64 K Protecting Data • 300 Key Concepts • 235 Publishing External Content • 32 Known Symbol Rule • 166 Q L Querying and Filtering • 26 Layers • 102 Limitations • 66 R Logging In • 15 Range Classification • 150 Relational (Explicit) Mapping Definition M Steps • 247 Main Window • 83 Requesting a Reference to a Coverage • 42 Managing Catalog Records • 22 REST Background • 23 Managing Data Sources • 99 Restarting the Application Server • 194 Managing Projects • 86 Result Representations/Encodings • 30 Managing Styles • 117 Rezipping new files into cots-srs.jar • 193 Map Generation Transformer • 292 Map Navigation • 107 S MapGen Tag • 294 Scale Dependent Table • 299 MapGen Tags and Attributes • 294 Scale Range Management • 121 Mapping • 236 scaleMin and scaleMax • 296 Mapping a Source Data WKT or GML Schema Generator • 303 srsName to an SDI Internal CRS Set Up an ERDAS APOLLO WFS Serving representation • 200 GML-SF (Simple Feature) • 267 Mapping between EPSG Code and WMS SQL Mapping Definition Steps • 244 Service Internal CRS Representation • Starting the ERDAS APOLLO Style Editor • 198 82 Mapping of Enumerations • 260 Style Rules • 122 Modifying coordinate_system_category.xml Style Templates • 52 • 192 Styled Layer Descriptor (SLD) • 68 Moving to GML3 • 264 Styling Data • 116 Symbol Roller Rule • 176 O OGC Compliant HTTP Request Samples • T 50 Technical Support and Information • 315 Operational Concept • 67 Testing the CSW Endpoint • 34 Overview of ERDAS APOLLO • 5 The • 298 Troubleshooting • 205 326 Fehler! Verwenden Sie die Registerkarte 'Start', um Heading 1 dem Text zuzuweisen, der hier angezeigt werden soll. U Uniform Roads Rule • 159 Uniform Rule • 123 Uniform Rule Example • 140 Uniform Rule for Line Features • 130 Uniform Rule for Point Features • 125 Uniform Rule for Polygon Features • 135 Unzipping cots-srs.jar • 189 Updating ERDAS APOLLO Data Manager • 193 Using MapGen • 292 V Variable Markers Rule • 171 Views • 113 W Warning MapGen and Portrayal Rules • 299 Web Coverage Service Requests • 41 Web Feature Service Requests • 48 Web Map Service Requests • 38 WFS Loader • 307 WMS HTTP POST Requests • 39 WSDL and WCS HTTP SOAP Requests • 45 WSDL and WFS SOAP Requests • 49 WSDL and WMS HTTP SOAP Requests • 40 327 element must contain the name of that table. If a data server table is mapped onto a feature type, create as many
element. For SQL mapping, follow these steps: The process followed by the mapping manager is to analyze the SQL metadata and build the feature type schema accordingly. The minimum information to provide is the name of the table to map, and the script 'generation="sql' so that the manager knows it has to do the mapping. However, additional explicit information can be provided, like the primary key column name, so that some flexibility is retained. 1. Build a
element. Each TableScale will mention a scale range (scaleMin and scaleMax attributes), the table name (nameSQL attribute), and possibly the user and alias attributes with a purpose similar to the corresponding elements of the
element. For GetMap and GetFeatureInfo requests from which the Scale value can be deducted, the appropriate table will automatically be chosen.