List of Transformers

You are here: Geometric Operators > LineOnLineOverlayer

LineOnLineOverlayer

This transformer performs a line-on-line overlay. During the overlay, all input lines are intersected against each other and resultant line features are created and output. Intersection points are turned into point features that contain the merged list of attributes of the original intersected lines.

Parameters

Transformer

ClosedGroup By

The Group By parameter specifies a series of attributes that must match on the features before they are considered for overlaying. This can be used to ensure that the overlay occurs only on certain groups of features. Click the browse button to select from a list of attributes.

ClosedParallel Processing Level

Note: How parallel processing works with FME: see About Parallel Processing for detailed information.

This parameter determines whether or not the transformer should perform the work across parallel processes. If it is enabled, a process will be launched for each group specified by the Group By parameter.

Parallel Processing Levels

Parameter Number of Processes
No Parallelism 1
Minimal coresThe processor, or CPU, is the physical part of the computer that performs mathematical calculations. It is the most important part of a computer system. Traditional processors have only one core on the processor, meaning that at any given time, only one set of calculations is being performed. If a processor is dual-core, this means the single chip contains hardware for two processors, now called cores to distinguish them from the single chip, running simultaneously, side by side. (Source: http://www.ehow.com/facts_5730257_computer-core-processors_.html) / 2
Moderate exact number of cores
Aggressive cores x 1.5
Extreme cores x 2

For example, on a quad-core machine, minimal parallelism will result in two simultaneous FME processes. Extreme parallelism on an 8-core machine would result in 16 simultaneous processes.

You can experiment with this feature and view the information in the Windows Task Manager and the Workbench Log window.

ClosedInput is Ordered by Group

Yes: This transformer will process input groups in order. Changes on the value of the Group By parameter on the input stream will trigger batch processing on the currently accumulating group. This will improve overall speed if groups are large/complex, but could cause undesired behavior if input groups are not truly ordered.

No: This is the default behavior. Processing will only occur in this transformer once all input is present.

Parameters

ClosedOverlap Count Attribute

The Overlap Count Attribute holds the number of line features that intersected the resultant feature.

ClosedList Name

If the optional List Name is supplied, then all output Points will include a list containing attributes of each line that intersected at that point. If the List Name is supplied AND Separate Collinear Segments is set to No, then all output Lines will include a list containing attributes of each collinear line that was merged. If the optional List Name is supplied, AND Separate Collinear Segments is set to Yes, then no merging will occur and so output Lines will not include a list.

Note: Attribute lists are not accessible from the output schema in Workbench unless they are first processed using a transformer that operates on them, such as ListExploder or ListConcatenator. All attribute list transformers are displayed in the Contents pane of the Transformer Help under Lists. Alternatively, AttributeExposer can be used.

ClosedSeparate Collinear Segments

No: All collinear segments are reduced to one representative segment.

Yes: All collinear segments are output.

Usage Notes

  • When attributes are merged between features, existing attributes are not replaced. Therefore if the two lines being overlaid contain attributes with the same name, then the values will not be transferred from one to the other. You can avoid this problem by renaming (AttributeRenamer), prefixing (AttributeExpressionRenamer), or removing (AttributeRemover) attributes to avoid name collisions.
  • When choosing to output only one segment for each collinear group, it may be difficult to predict which of the "original" geometries and attributes are preserved. In general, the features that arrive at the transformer FIRST will be the ones that form the separate segments. Use the FeatureHolder or Sorter transformers to change the sequence of features if this is important.
  • This transformer will preserve measures, based on the rules for the order of features described above.
  • Aggregates are not supported by this transformer.

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

Geometric Operators

FME Licensing Level

FME Professional edition and above

Search FME Knowledge Center

Search for samples and information about this transformer on the FME Knowledge Center.