The catalog configuration (catalogs.xml) file is used to configure the catalogs that are pub- lished via Express Server. Specifically it is used to define the following:
l Catalogs
l Catalog properties l Thumbspecs
In addition, it specifies which of these catalogs are spatially indexed and thus available via the OGC Web Map Server (WMS) interface. For more information about modifying the catalog con- figuration file for WMS seeConfiguring the WMS API Using XML Fileson page 184.
This section includes asample catalog configuration file and describes each of its editable ele- ments. Special catalog properties are described in the Reference section (for more information seeSpecial Catalog Propertieson page 138).
Chapter 10: Reference
The following elements of thecatalogs.xmlfile are available for editing:
l TheCatalogelement l The Path element
l TheBufferMergeRuleelement l TheWatermarkelement
l TheSizeConstraintelement
l TheThumbspecelement
l The Bands element
l The MaxWaveletSourceMP element l The BrowseIndexOnly element l The AllowItemDownload element l TheSpatialIndexelement l ThePropertyelement l TheMultiCatalogelement
l The SubCatalog element l TheGlobalselement
l The CatalogProps and ItemProps elements l The JPIPRoot element
l The ResponseHostPort element l The WMSCapabilitiesMime element
Samplecatalogs.xmlFile
Below is the text from a samplecatalogs.xmlfile similar to the one included with your install- ation of Express Server. It can be a useful reference when reading about the elements and attrib- utes and their values in the following topics.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<CatalogConfig xmlns="http://www.lizardtech.com" xmlns:wms="http:// www.opengis.net/wms" xmlns:xlink="http://www.w3.org/1999/xlink"> <Globals>
<BufferMergeRule fuzziness="3" method="pixelNonTransparentFuzzy"/> <ThumbSpec name="main" height="50" width="80"/>
LizardTech Express Server 9 User Manual <CatalogProps>Name,Description</CatalogProps> <ItemProps>Name,Description</ItemProps> <JPIPRoot>http://STTL-DEV-GUPPY.seattle.mycompany.local:9013/</JPIP Root> <MaxWaveletSourceMP>1000</MaxWaveletSourceMP> <BrowseIndexOnly>true</BrowseIndexOnly> <WMSCapabilitiesMime>text/xml</WMSCapabilitiesMime> <wms:Layer> <wms:Title></wms:Title> <wms:CRS>EPSG:4326</wms:CRS> </wms:Layer> </Globals>
<Catalog name="Geo" enabled="true">
<Path>C:\LizardTech\Express Server 9\SampleImages\geo</Path> <SizeConstraint height="2500" width="2500"/>
<Property name="Description"> A sampling of MrSID images
from LizardTech's customers who work with geographic imagery. </Property>
<Property name="ExportConstraint">2000,1500</Property> </Catalog>
<Catalog name="MODIS" enabled="true">
<Path>C:\LizardTech\Express Server 9\SampleImages\bm2002</Path>
Chapter 10: Reference
<SpatialIndex classID="{D090DD8B-3D12-4631-9787-0DC2CACDC3EA}"> <CRS>EPSG:4326</CRS>
</SpatialIndex>
<Property name="Name">MODIS Data 2002</Property>
<Property name="Description">A composite of four months of MODIS ob servations, with a spatial resolution of 1000m/pixel.</Property> <Property name="Credits">NASA's Earth Observatory</Property> <wms:Layer queryable="false" opaque="false" noSubsets="false"> <wms:Title>MODIS Data 2002</wms:Title>
<wms:KeywordList> <wms:Keyword>bluemarble</wms:Keyword> <wms:Keyword>MODIS</wms:Keyword> <wms:Keyword>satellite</wms:Keyword> </wms:KeywordList> <wms:Attribution>
<wms:Title>Dataset provided by Reto Stockli, NASA Earth Observator y, [email protected]</wms:Title>
<wms:OnlineResource xlink:type="simple" xlink:href="http://earthobs ervatory.nasa.gov/Newsroom/BlueMarble/BlueMarble_2002.html"/>
</wms:Attribution> </wms:Layer>
</Catalog>
<Catalog name="Missouri_RGB" enabled="true">
LizardTech Express Server 9 User Manual
<Bands>1,2,3</Bands>
<SpatialIndex classID="{D090DD8B-3D12-4631-9787-0DC2CACDC3EA}"> <CRS>EPSG:2817</CRS>
</SpatialIndex>
<Property name="Name">GeoEye RGBView</Property>
<Property name="Description">This RGB-NIR satellite data has been c ompressed into MG4 and reprojected into EPSG 2817 (NAD83(HARN) / Mi ssouri West). Here we display the R-G-B combination. Note how the Alpha band causes transparency at the corners</Property>
<Property name="Credits">Courtesy MJ Harden/GeoEye</Property> <wms:Layer queryable="false" opaque="false" noSubsets="false"> <wms:Title>GeoEye Missouri - RGB</wms:Title>
<wms:KeywordList> <wms:Keyword>Missouri</wms:Keyword> <wms:Keyword>Geoeye</wms:Keyword> <wms:Keyword>satellite</wms:Keyword> </wms:KeywordList> <wms:Attribution>
<wms:Title>Dataset provided courtesy MJ Harden/GeoEye</wms:Title> </wms:Attribution>
</wms:Layer> </Catalog>
<Catalog name="Missouri_NIR" enabled="true">
<Path>C:\LizardTech\Express Server 9\SampleImages\geoeye</Path>
Chapter 10: Reference <Bands>4,2,3</Bands> <BrowseIndexOnly>false</BrowseIndexOnly> <SpatialIndex classID="{D090DD8B-3D12-4631-9787-0DC2CACDC3EA}"> <CRS>EPSG:4326</CRS> </SpatialIndex>
<Property name="Name">GeoEye IR</Property>
<Property name="Description">This is the same dataset as "Missouri_ RGB" but renders the NIR-G-B combination</Property>
<Property name="Credits">Courtesy MJ Harden/GeoEye</Property> <wms:Layer queryable="false" opaque="false" noSubsets="false"> <wms:Title>GeoEye Missouri - IR</wms:Title>
<wms:KeywordList> <wms:Keyword>Missouri</wms:Keyword> <wms:Keyword>Geoeye</wms:Keyword> <wms:Keyword>IR</wms:Keyword> <wms:Keyword>satellite</wms:Keyword> </wms:KeywordList> <wms:Attribution>
<wms:Title>Dataset provided courtesy MJ Harden/GeoEye</wms:Title> </wms:Attribution>
</wms:Layer> </Catalog>
LizardTech Express Server 9 User Manual
TheCatalogElement
TheCatalogelement defines an Express Server catalog. It contains the following editable attrib- utes:
name
This is the name of the catalog. The name is used to specify the catalog in requests through the Web API.
If the name begins with a "." character, then this catalog is "hidden." That is, it does not appear in the list of catalogs returned by Express Server. However, even though it is not included in that list, it is still loaded and available for queries when specified by name.
Commas and spaces are not allowed as catalog names. You may use numbers and letters, dashes and underscores.
enabled
May be true or false, specifying whether the catalog is enabled or not. If set to false, then the catalog will not be loaded. The default value is true.
In addition to these attributes, eachCatalogelement must contain aPath element.
A catalog can also contain any of the following optional child elements:
l TheBufferMergeRuleelement l TheWatermarkelement
l TheSizeConstraintelement
l TheThumbspecelement
l The Bands element
l The MaxWaveletSourceMP element l The BrowseIndexOnly element l The AllowItemDownload element l TheSpatialIndexelement l ThePropertyelement
Chapter 10: Reference