CoordinateConcatenator
Retrieves the value of all the feature's coordinates into an attribute, separated by the delimiter characters.
Parameters
This parameter can contain either an arbitrary string or a character, which is inserted between each coordinate set.
This parameter can also contain either an arbitrary string or a character, which is inserted between each x/y/z element of each coordinate.
Characters can be expressed as regular characters but they can also include any number of control characters.
Special character sequences (Advanced Editor only) are interpreted as shown below:
Sequence | Description |
---|---|
Ctrl+Shift+h (^H) |
Backspace (0x08) |
Ctrl+Shift+l (^L) |
Form feed (0x0c) |
Ctrl+Shift+j (^J) |
Newline (0x0a) |
Ctrl+Shift+r (^M) |
Carriage return (0x0d) |
Ctrl+Shift+i (^I) |
Tab (0x09) |
Ctrl+Shift+k (^K) |
Vertical tab (0x0b) |
Defining Special Characters
You can define special characters through the Basic or Advanced Editors. Click Open Editor from the parameter menu:
Basic Text Editor
Select Constant from the String Type column (or, in some transformers, the Value column) and click on the empty field in the column:
Click the browse button to the right of the column to open an Edit Value dialog. In this editor, enter characters using the shortcut keys from the table above.
Advanced Text Editor
Enter characters using the shortcuts from the table above.
Note: To see tab characters, click the Options menu on the bottom left and select Show Spaces/Tabs.
This parameter specifies which elements in the coordinate to output. For example, if the coordinate has a value of Z, only the z coordinate will be output.
Provides an option to output coordinate values in full precision. Full precision displays the number of decimals required to guarantee that every unique 64-bit real number has a unique string value. Every unique number will look different. The default value is No.
If the Full Precision parameter is set to No, the coordinates may or may not be rounded off. For example, if rounding off the value a bit greatly reduces the number of decimal values, then this rounded off representation would be used instead. On the other hand, if the input coordinates have very unique decimal values, then they may not get rounded off. The table below illustrates an example of each case.
If the Full Precision parameter is set to Yes, the output will contain coordinates in full precision which are identical to the input coordinates. The table below illustrates two example coordinates along with their output values when the precision parameter is set to No and Yes:
Example | Input coordinates | Precision: No | Precision: Yes |
---|---|---|---|
1 | (1.399999999999, 1.599999999999) | (1.4, 1.6) | (1.399999999999, 1.599999999999) |
2 | (30.26360151448, 20.65415887961) | (30.26360151448, 20.65415887961) | (30.26360151448, 20.65415887961) |
This attribute stores the value of the feature's coordinates.
Usage Notes
- This transformer works only for point, line, area, and donut features. Aggregate features will give invalid values.
- If Coordinate Element(s) to Include contains Z and the features contain two-dimensional data, only the x and y coordinates will be stored.
Editing Transformer Parameters
Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace. More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers. To access a menu of these options, click beside the applicable parameter. For more information, see Transformer Parameter Menu Options.
Transformer Categories
Search FME Knowledge Center
Search for samples and information about this transformer on the FME Knowledge Center.