Performs a point-on-line overlay. Each input line is split at its closest place to any point within the specified point tolerance, and attributes are shared between related points and lines (spatial join).
Typical Uses
- Splitting lines where they overlay points
- 识别与点相交的线
- 识别落在一条线上的点
它是如何工作的？
PointonLineOverLayer比较点和线，分割一个点（或在指定距离的）线上的线条。每个生成的新行接收匹配原始行的点的属性，并且点从线路（空间连接）接收属性。功能（点和行）还会收到遇到的匹配数的计数。
在处理或拒绝之前，聚集体可以进行脱模。没有计算线性功能之间的交叉点。
Example:Overlaying points on lines
In this example, we perform an overlay of rapid transit stations points on rapid transit lines. The source data, as seen here, contains three individual transit routes, each one a single line feature.
The station points are close to the lines, but not right on them - generally within a meter.
该站连接到点输入端口，路由连接到线路输入端口。
在PointonLineOverlayer参数对话框中，我们输入了“5”的公差 - 意义5米，因为这些数据集是在UTM投影中，带有米的接地单元。我们还选择合并属性。
运输线在遇到在特定公差范围内的电台的情况下分开，如此通过随机着色输出线功能所示。属性在点和行之间共享，如在Renfrew Station的这些点属性中，它现在具有一个新的属性，指示它覆盖千年线。
输出线从遇到原始的未连接线的所有点接收属性 - 请参阅使用记录以获取更多详细信息。
使用说明
- Where point geometries are expected, Point Cloud geometries are not supported.
- Chopped Lines output via the Line output port receive the attributes of all points that matched the original input line (if a list is enabled). All points that the original line encountered are included - not only the endpoints of the new line segment.
To obtain attributes from points matching only the ends of the new line features, use a second transformer (consider another PointOnLineOverlayer, or aNeighborFinder）。
Z Values and Measures
If the input Line features have measures and/or 3D coordinates, measures and elevations (z values) are interpolated and assigned to points according to the selections made in the Attribute Accumulation parameters.
If Attribute Accumulation Mode is set to Drop Incoming Attributes, the measures and z values will be ignored. If it is set to Merge, Prefix, or Only Use Incoming Attributes, the appropriate values will be calculated and assigned to the points. If a z value is added to a 2D point, it will become 3D.
Choosing a Spatial Transformer
许多变形金刚可以评估空间关系并执行空间连接 - 分析拓扑，合并属性，有时修改几何。通常，选择最专用于您需要完成的任务的那个将提供最佳性能结果。如果有多种方式来做（通常是这种情况），则在性能测试备用方法上花费的时间可能是值得的。
To correctly analyze spatial relationships, all features should be in the same coordinate system. The重新设计may be useful for reprojecting features within the workspace.
空间变压器比较矩阵
变压器 |
Can Merge Attributes |
Alters Geometry |
Counts Related Features |
Creates List |
支持的类型* |
推荐 |
|---|---|---|---|---|---|---|
| SpatialFilter | 是 | 没有 | 没有 | 没有 |
|
|
| 斯卡利尔 | 是 | 没有 | 是 | 是 |
|
|
| AreaAreaoverlayer. | 是 | 是 | 是 | 是 |
|
|
| LineOnAreaOverlayer | 是 | 是 | 是 | 是 |
|
|
| LineOnLineOverlayer | 是 | 是 | 是 | 是 |
|
|
| Pointonareaoverlayer. | 是 | 没有 | 是 | 是 |
|
|
| PointonlineOverlayer. | 是 | 是 | 是 | 是 |
|
|
| PointonpointOvertLayer. | 是 | 没有 | 是 | 是 |
|
|
| 交叉管道 | 是 | 是 | 是 | 是 |
|
|
| 剪刀 | 是 | 是 | 没有 | 没有 |
|
|
| NeighborFinder | 是 | In some cases | 没有 | 是 |
|
|
| 拓扑基础 | 是 | 是 | 没有 | 是 |
|
|
* 注意：曲线includes Lines, Arcs, and Paths.区包括多边形，甜甜圈和椭圆形。
The Effect of Spatial Transformer Choice on Performance
Spatial analysis can be processing-intensive, particularly when a large number of features are involved. If you would like to tune the performance of your workspace, this is a good place to start.
当有多种方式配置工作空间达到相同目标时，最好最好选择最专门适合您的任务的变压器。例如，当将地址点与构建多边形进行比较时，有几种方法可以接近它。
The first example, using a SpatialFilter to test whether or not points fall inside polygons, produces the correct result. But the SpatialFilter is a fairly complex transformer, able to test for multiple conditions and accept a wide range of geometry types. It isn’t optimized for the specific spatial relationship we are analyzing here.
With a SpatialFilter:
The second example uses a PointOnAreaOverlayer, followed by a Tester. The features output are the same as in the first method, but the transformer is optimized for this specific task. The difference in processing time is substantial - from 54.3 seconds in the first configuration, down to 13.7 seconds in the second one.
使用PointonAreaoverlayer和测试仪：
如果性能是工作区中的问题，请查找以几何形状为引导的替代方法。
Configuration
输入端口
点
将对该线进行比较的点特征。
Line
将比较点的线特征。
输出端口
点
点features, with attributes added according to transformer parameter configuration. Geometry is unmodified, unless z-values have been extracted from lines.
Line
Line features which have been split at the location closest to matching points, with attributes added according to transformer parameter configuration.
<被拒绝>
使用无效几何形状的功能将通过此端口拒绝和输出。
Rejected features will have anfme_reimpe_code.属性包含以下值之一：
Invalid_point_geometry_type.
INVALID_LINE_GEOMETRY_TYPE
Invalid_line_geometry_vertices.
Invalid_geometry_degenerate.
拒绝功能处理：can be set to either terminate the translation or continue running when it encounters a rejected feature. This setting is available both as a defaultFME选项和as aworkspace parameter.
Parameters
变压器
| 通过...分组 | The default behavior is to use the entire set of features as the group. This option allows you to select attributes that define which groups to form. |
| 小组按模式 | Process At End (Blocking): This is the default behavior. Processing will only occur in this transformer once all input is present. Process When Group Changes (Advanced): This transformer will process input groups in order. Changes of the value of the Group By parameter on the input stream will trigger processing on the currently accumulating group. This may improve overall speed (particularly with multiple, equally-sized groups), but could cause undesired behavior if input groups are not truly ordered. Considerations for Using通过...分组
使用两种典型的原因Process When Group Changes (Advanced). The first is incoming data that is intended to be processed in groups (and is already so ordered). In this case, the structure dictates Group By usage - not performance considerations. The second possible reason is potential performance gains. 最有可能在已经对数据进行排序的（或使用A读取SQL订单声明）由于FME需要更少的工作。如果数据需求排序，则可以在工作区中排序（尽管添加的处理开销可能会否定任何增益）。 Sorting becomes more difficult according to the number of data streams. Multiple streams of data could be almost impossible to sort into the correct order, since all features matching a通过...分组value need to arrive before any features (of any feature type or dataset) belonging to the next group. In this case, using通过...分组借Process At End (Blocking)可能是等同和更简单的方法。 没有te:从多个多个功能类型和特性datasets will not generally naturally occur in the correct order. As with many scenarios, testing different approaches in your workspace with your data is the only definitive way to identify performance gains. |
Parameters
| Overlap Count Attribute | 添加到输出线性功能的重叠计数属性包含靠近它的点特征的数量。添加到输出点特征的重叠计数属性保持了点靠近的线性功能的数量。 |
| 点公差 | The Point Tolerance value is compared to the distance from the lines to the points, and the lines will be segmented if the distance is less than or equal to the Point Tolerance value. When such a match occurs, the attributes of the segmented lines are merged with the points and the attributes of the points are merged with the lines. |
| 汇总处理 | Choose how aggregate geometries are to be handled. Deaggregate：将聚合分解为各个组件。 Reject: Do not process aggregates and output them via the |
Attribute Accumulation
如果传入和原始功能上的属性共享相同的名称，但不是从中开始的几何属性fme_, then they are deemed conflicted.
没有te:On the PointOnLineOverlayer, Attribute Accumulation applies to the measures on a point in a similar way to how it applies to the attributes on a feature.
如果点和行上的措施共享相同的名称，那么它们被视为冲突。
The resolution of conflicted measures on points occurs in the same manner as the resolution of conflicted attributes on features. It is resolved according to the累积模式和Conflict Resolutionvalues.
| 累积模式 | Drop Incoming Attributes: Features retain their original attributes, and do not receive new attributes. 合并传入属性: The original feature will retain all of its own un-conflicted attributes, and will additionally acquire any un-conflicted attributes that the incoming feature has. This mode will handle conflicted attributes based on the Conflict Resolution parameter. 前缀传入属性: The original feature will retain all of its own attributes. In addition, the original will acquire attributes reflecting the incoming feature’s attributes, with the name prefixed with the Prefix parameter. 仅使用传入属性：原始功能将删除其所有属性，除了以fme_开头的几何属性。然后，将从一个（任意）传入功能的所有属性放在原件上。 |
| Conflict Resolution | 使用原件: If a conflict occurs, the original values will be maintained. Use Incoming: If a conflict occurs, the values of the incoming will be transferred onto the original. |
| Prefix | 如果累积模式参数设置为前缀传入，则该值将从传入功能添加到原始功能的前缀属性和度量。 |
Generate List on Output ‘Point’
启用后，将列表属性添加到点输出功能，并将输出点匹配的每行的属性添加到该点的列表中。
| '点'列表名称 | 输入列表属性的名称。 没有te:列表属性are not accessible from the output schema in Workbench unless they are first processed using a transformer that operates on them, such aslist exploder.要么ListConcatenator. Alternatively,AttributeExposercan be used. |
| Add To 'Point' List | All Attributes：所有属性将添加到输出点功能。 选定的属性: Enables the选定的属性parameter, where specific attributes may be chosen for inclusion. |
| 选定的属性 | Enabled whenAdd To 'Point' Listis set to选定的属性. Specify the attributes you wish to be included. |
Generate List on Output ‘Line’
When enabled, adds a list attribute to the Line output features, and the attributes of each point matching an original input line are added to each output line created from it.
| ‘Line’ List Name | 输入列表属性的名称。 没有te:列表属性are not accessible from the output schema in Workbench unless they are first processed using a transformer that operates on them, such aslist exploder.要么ListConcatenator. Alternatively,AttributeExposercan be used. |
| Add To 'Line' List | All Attributes: All attributes will be added to the output Line features. 选定的属性: Enables the选定的属性parameter, where specific attributes may be chosen for inclusion. |
| 选定的属性 | Enabled whenAdd To 'Line' Listis set to选定的属性. Specify the attributes you wish to be included. |
编辑变换器参数
使用一组菜单选项，可以通过引用工作区中的其他元素来分配变压器参数。一些变压器也可提供更高级的功能，例如高级编辑器和算术编辑器。要访问这些选项的菜单，请单击
除适用的参数旁边。有关更多信息，请参阅变压器参数菜单选项.
定义值
有几种方法可以在变压器中定义使用的值。最简单的是简单地输入值或字符串，其可以包括各种类型的函数，例如属性引用，数学和字符串函数和工作区参数。有许多工具和快捷方式可以帮助构造值的值，通常可以从与值字段相邻的下拉上下文菜单中提供。
How to Set Parameter Values
使用文本编辑器
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.
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.
Conditional Values
根据通过或失败的一个或多个测试条件设置值。
内容
Expressions and strings can include a number of functions, characters, parameters, and more - whether entered directly in a parameter or constructed using one of the editors.
内容类型
| These functions manipulate and format strings. | |
| 文本编辑器中提供了一组控制字符。 | |
| 两个编辑器都有数学函数。 | |
| These operators are available in the Arithmetic Editor. | |
| These return primarily feature-specific values. | |
| 可以使用FME和工作区的参数。 | |
| Working with User Parameters | Create your own editable parameters. |
Reference
处理行为 |
|
Feature Holding |
是 |
| 依赖性 | |
| FME许可级别 | FME Professional Edition and above |
| Aliases | |
| History | |
| Categories |
FME社亚搏国际在线官网区
FME社区是演示亚搏国际在线官网，TOS，文章，常见问题和更多的地方。获取您的问题的答案，从其他用户学习，并建议，投票和评论新功能。
Search forall results about the PointOnLineOverlayeron the FME Community.
例子可能包含根据开放政府许可证的信息 - 温哥华