Snipper

Features with polygon or line geometries are accepted. Aggregate features will be accepted if the Aggregate Handling parameter is Deaggregate.

Features with the shortened geometries are output through this port.

Features with the removed portions of the original geometries are output through this port.

Features without polygon or line geometries (for example, points and donut polygons) are output through this port. Aggregate features will be rejected if the Aggregate Handling parameter is Reject.

Distance (Value) or Distance (Percentage): The amount to snip from the beginning and end of the line can be specified as either a measurement in ground units or a percentage of the line's entire length, starting from the first coordinate.

A negative value specifies the final vertex on the line. Values larger than the measurement of the original line will be interpreted as the end point.

Each of these parameters may either be entered as a number, or can be taken from the value of a feature attribute by selecting the attribute name from the pull-down list.

If the Measurement Mode is 3D, and the linear feature has Z coordinates, all measurements will be taken as a distance from one vertex to the next in 3D space. Otherwise, only the X and Y coordinates will be considered, and measurements will be planar distances between vertices.

Measure (Relative to Start Point): The values specified in the Starting Location and Ending Location parameters refer to the absolute difference in the measure value of the start point of the original line and the start or end points of the resulting line respectively.

Negative values will be interpreted as the start point of the original line and values larger than the measurement of the original line will be interpreted as the end point.

If the Measure Name field is blank, the default measure values are used. Otherwise, the measure values with the name specified in the Measure Name field are used instead.

Measure (Value): The values specified in the Starting Location and Ending Location parameters refer to the measure values at the start and end points of the resulting line.

Any value less than the input’s starting measure will be interpreted as the start point of the original line and values larger than the input’s ending measure will be interpreted as the end point of the original line.

If the Measure Name field is blank, the default measure values are used. Otherwise, the measure values with the name specified in the Measure Name field are used instead.

Vertex: The vertices from the original line which are to form the first and last vertices of the resulting line are specified as a numeric index, with "0" being the first vertex of the line.

Negative numbers measure vertices relative to the last point in the line, with the value "-1" used to specify the vertex which is the last vertex of the line's geometry, "-2" the second last vertex, and so on. If the input vertex number is smaller than the negative absolute value of the total number of vertices, then it will be interpreted as the starting vertex of the original line and if it is larger than the total number of vertices, it will be interpreted as the ending vertex.

Each of these parameters may either be entered as a number, or can be taken from the value of a feature attribute by selecting the attribute name from the pull-down list.

Choose how aggregate geometries are to be handled.

Deaggregate: Decompose aggregates into their individual components.

Reject: Do not process aggregates and output them via the <Rejected> port.

Choose how Z coordinates are handled. This parameter does not have any effect on two-dimensional lines. This parameter is enabled when the Snipping Mode is Distance (Value) or Distance (Percentage).

2D: Only X and Y coordinates are considered.

3D: If the linear feature has Z coordinates, all measurements will be taken as a distance from one vertex to the next in 3D space.

The value used to determine the start of the resulting line when the Snipping Mode is Distance (Value), Distance (Percentage), Measure (Relative to Start Point), or Measure (Value).

The value used to determine the end of the resulting line when the Snipping Mode is Distance (Value), Distance (Percentage), Measure (Relative to Start Point), or Measure (Value).

The measure values with the specified name are used when the Snipping Mode is Measure (Relative to Start Point) or Measure (Value). If this parameter is blank, the default measure values are used.

The vertex from the original line which is to form the first vertex of the resulting line specified as a numeric index, with "0" being the first vertex of the line. This parameter is enabled when the Snipping Mode is Vertex.

The vertex from the original line which is to form the last vertex of the resulting line specified as a numeric index, with "0" being the first vertex of the line. This parameter is enabled when the Snipping Mode is Vertex.

Suppose you have a line with measures that range from 4 to 16. The Starting Location has the value 6 and the Ending Location has the value 8.

If the Snipping Mode is Measure (Value), the resulting feature would have measures that range from 6 to 8.

If the Snipping Mode is Measure (Relative to Start Point), the resulting feature would have measures that range from 10 (= 4 + 6) to 12 (= 4 + 8).

Using the Text Editor

The Text Editor provides a convenient way to construct text strings (including regular expressions) from various data sources, such as attributes, parameters, and constants, where the result is used directly inside a parameter.

Text Editor

Using the Arithmetic Editor

The Arithmetic Editor provides a convenient way to construct math expressions from various data sources, such as attributes, parameters, and feature functions, where the result is used directly inside a parameter.

Arithmetic Editor

Conditional Values

Set values depending on one or more test conditions that either pass or fail.

Parameter Condition Definition Dialog

Content

Expressions and strings can include a number of functions, characters, parameters, and more.

When setting values - whether entered directly in a parameter or constructed using one of the editors - strings and expressions containing String, Math, Date/Time or FME Feature Functions will have those functions evaluated. Therefore, the names of these functions (in the form @<function_name>) should not be used as literal string values.

Content Types

String Functions	These functions manipulate and format strings.
Special Characters	A set of control characters is available in the Text Editor.
Math Functions	Math functions are available in both editors.
Date/Time Functions	Date and time functions are available in the Text Editor.
Math Operators	These operators are available in the Arithmetic Editor.
FME Feature Functions	These return primarily feature-specific values.
FME Parameters	FME and workspace-specific parameters may be used.
Creating and Modifying User Parameters	Create your own editable parameters.

Note: Not all tools are available in all transformers.