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

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

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

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.

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