Northgate StruMap Feature Representation

StruMap features consist of geometry and attributes. In particular, all StruMap features contain a strumap_type attribute, which identifies the geometric type of the feature.

In addition to the generic FME feature attributes that FME Workbench adds to all features (see About Feature Type Attributes), this format also adds format-specific attributes (Format Attributes).

Attribute Name	Contents
strumap_type	There are five types defined for the strumap_type attribute. Range: strumap_point \| strumap_line \| strumap_line_symbol \| strumap_polygon \| strumap_displayed_text Default: No default Note: strumap_displayed_text is used in place of both strumap_text and strumap_ftext because the latter types are not supported by the writer.
strumap_id	The StruMap ID number of the feature. This helps the writer identify the components of each feature. Features that are meant to be part of an aggregate feature should share the same ID. For the reader, this is automatically set. For the writer, if this is not specified, then each feature is considered a single output feature when written to file. Range: Positive integers Default: No default
strumap_child_id	The StruMap child ID of the feature. If the feature is a part of an aggregate feature, the Child ID will identify its position in the feature. Note that the parent feature must be passed to the writer before the child. Range: Positive integers Default: No default

Attribute Name

Contents

strumap_type

There are five types defined for the strumap_type attribute.

Range:

strumap_point |

strumap_line |
strumap_line_symbol |
strumap_polygon |
strumap_displayed_text

Default: No default

Note: strumap_displayed_text is used in place of both strumap_text and strumap_ftext because the latter types are not supported by the writer.

strumap_id

The StruMap ID number of the feature. This helps the writer identify the components of each feature. Features that are meant to be part of an aggregate feature should share the same ID.

For the reader, this is automatically set. For the writer, if this is not specified, then each feature is considered a single output feature when written to file.

Range: Positive integers

Default: No default

strumap_child_id

The StruMap child ID of the feature. If the feature is a part of an aggregate feature, the Child ID will identify its position in the feature. Note that the parent feature must be passed to the writer before the child.

Range: Positive integers

Default: No default

Points

strumap_type: strumap_point

This indicates that the feature is a StruMap point. Additional attributes include:

Attribute Name	Contents
strumap_angle	The angle of the rotated symbol. Range: Real Default: No default

Attribute Name

Contents

strumap_angle

The angle of the rotated symbol.

Range: Real

Default: No default

Lines

strumap_type: strumap_line

This indicates that the feature is a StruMap line. Additional attributes include:

Attribute Name	Contents
strumap_line_style	The line style of the line. Range: integers greater than or equal to 0 Default: No default
strumap_red	The red intensity of the line. This must be used together with strumap_green and strumap_blue in order to be used by the StruMap writer. Range: Integer from 1 to 255 Default: No default
strumap_green	The green intensity of the line. Range: Integer from 1 to 255 Default: No default
strumap_blue	The blue intensity of the line. Range: Integer from 1 to 255 Default: No default
strumap_flowdir_position	The position of the flow direction. This must be used with the strumap_flowdir_easting and strumap_flowdir_northing attributes. Range: 0 (not set) \| 1 (flow from point 1 to point 2) \| 2 (flow from point 2 to point 1) \| 3 (bidirectional flow) \| 4 (blocked) Default: No default
strumap_flowdir_x1	The x coordinate for the first point in terms for the strumap_flowdir_position. Range: Real Default: No default
strumap_flowdir_y1	The y coordinate for the first point in terms for the strumap_flowdir_position. Range: Real Default: No default
strumap_flowdir_x2	The x coordinate for the second point in terms for the strumap_flowdir_position. Range: Real Default: No default
strumap_flowdir_y2	The y coordinate for the second point in terms for the strumap_flowdir_position. Range: Real Default: No default
strumap_mask_x{<number>}	The x coordinate of the mask. <number> is a positive integer used to indicate the order of the mask. Hence, in order for this to be valid, it has to be used in conjunction with strumap_mask_y{<number>} and strumap_mask_length{<number>} where <number> share the exact same value. As a result of this mechanism, more than one mask can be added to each line feature. Range: Real Default: No default
strumap_mask_y{<number>}	The y coordinate of the mask. See strumap_mask_x. Range: Real Default: No default
strumap_mask_length {<number>}	The length of the gap. See strumap_mask_x. Range: Real Default: No default

strumap_type: strumap_line_symbol

This indicates that the feature is a StruMap line symbol. This is actually a component of a StruMap line and cannot be written to file on its own in terms for the StruMap definition; however, it can represented by other formats. Additional attributes include:

Attribute Name	Contents
strumap_linesym_num	The line symbol number of the line symbol. Range: integers greater or equal to 0 Default: No default
strumap_linesym_angle	The rotation of the line symbol. Range: Any real number Default: No default
strumap_linesym_scale	The scale factor of the line symbol. Range: Any real number Default: No default

Attribute Name

Contents

strumap_linesym_num

The line symbol number of the line symbol.

Range: integers greater or equal to 0

Default: No default

strumap_linesym_angle

The rotation of the line symbol.

Range: Any real number

Default: No default

strumap_linesym_scale

The scale factor of the line symbol.

Range: Any real number

Default: No default

Polygons

strumap_type: strumap_polygon

This indicates that the feature is a StruMap polygon. The first and last coordinates of the polygon must be the same.

Additional attributes include:

Attribute Name	Contents
strumap_seed_x	The x coordinate of the seed for the polygon. Range: Real Default: Defaults to the x coordinate of the first point in the polygon.
strumap_seed_y	The y coordinate of the seed for the polygon. Range: Real Default: Defaults to the y coordinate of the first point in the polygon.

Attribute Name

Contents

strumap_seed_x

The x coordinate of the seed for the polygon.

Range: Real

Default: Defaults to the x coordinate of the first point in the polygon.

strumap_seed_y

The y coordinate of the seed for the polygon.

Range: Real

Default: Defaults to the y coordinate of the first point in the polygon.

Text

strumap_type: strumap_displayed_text

StruMap displayed text features are used to specify annotation information. Each text feature has a location defined by a single point geometry, and can have its text string, style, justification, and rotation angle set independently.

The following table lists the special FME attribute names used to control the strumap_display_text settings.

Attribute Name	Contents
strumap_attr_code	A text string representing the attribute short code as defined in the rule file.
strumap_attr_value	A text string containing the value of the attribute.
strumap_height	The height of the strumap_attr_value in ground units.
strumap_width	The width of the strumap_attr_value in ground units.
strumap_red	The red color component of the strumap_attr_value.
strumap_green	The green color component of the strumap_attr_value.
strumap_blue	The blue color component of the strumap_attr_value.
strumap_angle	The angle at which the strumap_attr_value is displayed.
strumap_position	The justification of the strumap_attr_value. Range: 0 (not set) \| 1 (bottom left) \| 2 (center left) \| 3 (top left) \| 4 (bottom center) \| 5 (center center/ original position) \| 6 (top center) \| 7 (bottom right) \| 8 (center right) \| 9 (top right) Default: No default
strumap_min_length	The minimum length of span on which to display bubble. Range: Positive real numbers Default: 0
strumap_circle	Indicates that an ellipse should be drawn instead of a box. Range: true Default: false
strumap_box	Indicates that a box should be drawn. Range: true Default: false
strumap_solid	Indicates that the ellipse or the box should be filled. Range: true Default: false
strumap_line	Indicates that a line should be drawn from the text to the item. Range: true Default: false
strumap_arrow	Indicates that an arrow should be drawn on a line. Range: true Default: false