Feature Definition File

A feature definition file provides a mapping from an OGR layer (collection of simple features) and an attribute name to a 'Feature'.

The mapping is essentially a base feature sub-classing partially configured for a specific data product.

If you change the feature definition file that is being used the feature setup has to be updated. This includes any rendering specified in the Feature Book.

A number of Feature Definition Files have been provided. These can be found in the following directory:

config/FeatureDefinitionMapping

File Format

The top of the file contains a 'VERSION=XYZ' string which identifies the file version.

A line beginning with a # is a comment and is ignored.

All other lines in the file specify a feature mapping. The format of the line is as follows:

layer, attribute, value, feature description,feature name,comma list of fields

Where:

Entry	Description
layer	is the '[layer]' entry in osmconf.ini in the case of OSM. For other data formats this is the layer name as reported by GDAL/OGR.
attribute	is the field that represents a feature. If this is a '*' then the layer is the feature.
value	is the value that the attribute must be. If this is '' then all values are valid. Currently only '' is valid.**
feature description	is the human readable feature name. The text should be enclosed in speech marks if it contains a comma.
feature name	feature name - normally the same as 'attribute' - currently not used but should be filled in.
comma list of fields	if left blank is the list of fields left after we have removed all the attributes that are being used.

Notes:

'VERSION=XYZ' - File format version. First version 101.
'#' - is start of comment. Comment marker has to appear at the start of line.
Data must start in the first column.
If a feature does not match then the feature name 'unspecified' is used to ensure that features are not lost on import.

Modifications or a New Definition File

If you make any useful modifications to any of the supplied Feature Definition files or you create new ones please share them with other MapLink Pro users by emailing to support@envitia.com