SimpleMapServer GIS directory structure

<Back home>

A) Data organisation:

The map server can look for layer data inside a list of directories.
This list is configured in the mapServlet property file (named 'mapServer.props' by default) like this:
    map_producer_data_path=/home/gilles/gis;/usrb/gis
Note that the list separator is ';'

In the following example the data folder is called 'gis'. It contains one sub-directory for each available layer.
In these sub-dir, if there is a 'layer.conf' file then the server will parse it. If the parsing is ok, the layer is added to the server catalogue.

Example: the gis data folder is called 'gis'


In this 'gis' folder there are 6 layers, lets look at the URBEX one, it contains 8 levels of detail (lod).
The highest resolution data file are in the 'lod_0' folder, the succesive lods (lod_1, lod_2...) contain reduced data files.
Each lod as is own directory, the lod directory name has to be like 'lod_x'.
Each lod directory contains several tile data files(7 in this case: the .raws). The name of these files is defined in the layer.conf file.
A data file has to have the same name in every lod folder:



The corresponding URBEX .conf file is here

B) Layer configuration:

Bellow are the settings that have to be configured in the layer configuration file (layer.conf):

Parameter name
Required
Meaning
Example of value
Comment
name
YES
 the name of the layer, will be used in Opengis request. has to be unique MODIS if multiple: ; separated
title (or description)
NO
 the title of the layer Modis mosaic 2006 description was used before version 0.712, is still supported
abstract
NO
 a more procise description of the layer    
keywords
NO
 the list of keywords for this layer, they are put in the capabilities Satellite images, Envisat, Meris, Asar , separated
metadataUrl
NO
 an URL where matadata info on this layer can be seen http://somewhere/info.html  
metadataType
NO
 the type of the metadata has to be: TC211 or FGDC default is FGDC
metadataFormat
NO
 the format of the metadata output

image/gif; text/xml; etc...

 
 
     
nums_files
YES
 number of tiles/files in this layer 1  
type
YES
 layer type vector/raster  
bytesPerPixel
YES
 number of bytes per pixel 1/2/3  
colorsModel
NO
 layer pixels use an indexed color model, need a colortable indexed comment if not needed
colorTable
NO
 path to the colorTable file /home/user/gis/urbex/colortable.dat see also colorTable format
transparent
DEPEND
 transparent color index in colorTable index comment if not needed
transparentColor
DEPEND
 transparent color to be used on this layer #000000 not needed if colorTable is used
projection
NO
 projection used in the data file EPSG:32761 if nothing, platte-carre is assumed
style
NO
 style informations style=default
style=./green_circle.style,./icon.style,./red_triangle.style

- Can be a list of style files, comma separated

- Can be a color code like #ff0000, used to draw the vectors
logoText
NO
 a small text that will be written over the map image ESA data  
logoImage
NO
 a small image that will be stamped over the map image    
logoPos
NO
 the logo position: can be in a corner, on a side or at center # 0 1 2
# 3 4 5
# 6 7 8
published
NO
      
 
     
file0_bbox
YES
 bounding box limit for each tile 180 90 180 -90 leftUp-on leftUp-lat rightDown-lon rightDown-lat
file0_filename
YES

tile filename

vector file

landsat.raw

world.vec

shorelines.shp

 If file extension is .shp or .SHP, then it is assumed it is a shapefile.
file0_num_lods
YES
 tile number of lods 1  
 
     
file0_lod0_res
YES
 resolution for tile 0 lod 0 1024 512 in pixels: width height
 
     

Table 1: layer settings

PINK: layer info; published in capabilities
GREEN: layer level setting
BLUE: tile level setting
ORANGE: tile-lod level setting

Note: for the colorTable and style files, the path can be absolute, or relative if it starts with './ '.

 

C) Color table file format:

This file contains one line per entrty:
- no blank line is allowed (except at the end of the file)
- line format is: index red green blue quantity label
- field separator is space or tab
- # is for comment line
- quantity means that the same rgb values will be repeated (to be verified)

for example:
# index red green blue quantity label
0 34 140 30 1 'Evergreen Needleaf Forest'

 

D) Style file format:

Parameter name
Required
Meaning
Example of value
Comment
shapeLabel
NO
 Only for shapefile: to display a label for the shape, this is the name of the header-field as it appear in the .dbf file.
 NAME  
title
YES
 title of the style that will be put in the capabilities icon style  
legendUrl
NO
 URL where can be fount the style legend.Will be put in the capabilities http://somewhere/icon.html  
legendFormat
NO
 format of the legend document image/gif, text/html/ etc  
abstract
NO
 abstract of the style: procise description    
name
YES
 name of the style that will be put in the capabilities point as icon  
point.color
DEPEND
 the color used to draw a point #ff0000 #RRGGBB
point.shape
DEPEND
 the shape used to represent a point

possible value:

circle, triangle, square

  
point.size
DEPEND
 size of the shape in pixels 10  
point.icon
DEPEND
 an file file used to represent a point ./icon.gif if icon is used, the last 3 settings are inoperent
 
     

Table 2: style settings

<Back home>