Reader Directives

The directives processed by the SAIF reader are listed below. The suffixes shown are prefixed by the current <ReaderKeyword> in a mapping file. By default, the <ReaderKeyword> for the SAIF reader is SAIF.

DATASET

Required/Optional: Required

The value for this keyword is the name of the SAIF dataset file. A typical mapping file fragment specifying an input SAIF dataset looks like:

SAIF_DATASET /usr/data/SAIF/92i080.zip

Workbench Parameter: Source SAIF File(s)

IDs

Required/Optional

Optional

This optional specification is used to limit which of the available and defined SAIF addressable objects are read. If there are no IDs specified, then all defined and available addressable objects are read.

Tip: The SAIF Utilities package can be used to list the IDs present in a SAIF dataset.

The syntax of the IDs keyword is:

<ReaderKeyword>_IDs <SAIF ID1> \
	<SAIF ID2> … \
	<SAIF ID3> 

The list of IDs can also be specified across multiple <ReaderKeyword>_IDs statements, in which case the union of all IDs statements are used.

The example below selects only the roads for input during a translation:

SAIF_IDs roads

SEARCH_ENVELOPE

Using the minimum and maximum x and y parameters, define a bounding box that will be used to filter the input features. Only features that interact with the bounding box are returned.

If all four coordinates of the search envelope are specified as 0, the search envelope will be disabled.

Mapping File Syntax

<ReaderKeyword>_SEARCH_ENVELOPE <minX> <minY> <maxX> <maxY>

Note: If all four coordinates of the search envelope are specified as zero, the search envelope will be disabled.

Required/Optional

Optional

Workbench Parameter

Minimum X, Minimum Y, Maximum X, Maximum Y

SEARCH_ENVELOPE_COORDINATE_SYSTEM

This directive specifies the coordinate system of the search envelope if it is different than the coordinate system of the data.

The COORDINATE_SYSTEM directive, which specifies the coordinate system associated with the data to be read, must always be set if the SEARCH_ENVELOPE_COORDINATE_SYSTEM directive is set.

If this directive is set, the minimum and maximum points of the search envelope are reprojected from the SEARCH_ENVELOPE_COORDINATE_SYSTEM to the reader COORDINATE_SYSTEM prior to applying the envelope.

Required/Optional

Optional

Mapping File Syntax

<ReaderKeyword>_SEARCH_ENVELOPE_COORDINATE_SYSTEM <coordinate system>

Workbench Parameter

Search Envelope Coordinate System

CLIP_TO_ENVELOPE

This directive specifies whether or not FME should clip features to the envelope specified in the SEARCH_ENVELOPE directive.

Values

YES | NO (default)

Mapping File Syntax

<ReaderKeyword>_CLIP_TO_ENVELOPE [yes | no]

Workbench Parameter

Clip To Envelope