PointOnAreaOverlayer

Example:发现含有点区域

在这个例子中，我们有食品摊贩的点数据集和一组表示街区多边形。

为了找到一个供应商是在附近，我们的食品供应商的指向点输入端口，社区连接区输入端口。

在参数对话框，默认设置将提供正确的结果。注意，属性>累加模式被设定为呼入，这将从含附近多边形的每个点添加属性。

纵观食品供应商分输出，我们可以看到，含有邻属性已被添加。

纵观区域的输出，该_overlaps属性告诉我们，食品摊贩在邻近地区的存在多少。

Example:生成多个点的列表包含在一个区域

使用相同的食品供应商分和附近的多边形与前面的例子中，我们也可以建立一个包含所有食品供应商对于给定的邻域的列表属性。

在参数对话框，使生成的输出“区”名单，给列表中的名称，然后选择要包含的属性。

检查输出，我们可以看到，锦绣附近包含7个食品摊贩，和这些厂商的名称和说明都包含在一个列表属性。

空间变形金刚比较矩阵

Transformer	Can Merge Attributes	Alters Geometry	Counts Related Features	Creates List	Supported Types*	Recommended For
SpatialFilter	是	No	No	No	点文本曲线区域	Testing for the existence of spatial relationships between two sets of features, and routing them according to whether they pass or fail the test(s).
SpatialRelator	是	No	是	是	点文本曲线区域	Identifying the nature of spatial relationships between two sets of features.
区域OnAreaOverlayer	是	是	是	是	区域	Finding polygon overlaps and extracting them into new geometry.
LineOnAreaOverlayer	是	是	是	是	曲线 and Area	Finding intersections between lines and polygons, and splitting the lines where they intersect with the polygons.
LineOnLineOverlayer	是	是	是	是	曲线	Finding intersections between line features, splitting them, and generating new line geometry as well as points representing the intersections.
PointOnAreaOverlayer	是	No	是	是	点 and Area 文本 and Area	Identifying points that fall within polygons, and merging attributes between them
点OnLineOverlayer	是	是	是	是	点 and Curve 文本 and Curve	查明点上线下跌，并分裂成线新的几何体。
点OnPointOverlayer	是	No	是	是	点文本	在相同的位置确定的点（在公差范围内），并把它们之间的属性。
Intersector	是	是	是	是	点文本曲线区域	寻找路口所有输入功能之间，无论几何（任选包括自相交），拆分功能，并创造新的几何形状。
限幅器	是	是	No	No	点文本曲线区域固体光栅点云	针对一组快船的比较功能特点，并在分裂或沿着帆船界的特色。输出新的和不变的几何形状，识别为内部或外部快船。
NeighborFinder	是	In some cases	No	是	点文本曲线区域	识别最接近的其他特征（一个或多个），以每个特征被认为，无论是在另一组的特征或相同的功能集内。
TopologyBuilder	是	是	No	是	点文本曲线区域	分析特征之间的空间关系来计算的拓扑结构，拆分功能以及创建代表拓扑显著节点，边和面新的几何，关联的属性。

* NOTE:曲线包括直线，圆弧和路径。区域包括多边形，甜甜圈，和椭圆。

空间变压器的选择对性能的影响

空间分析运算,部分icularly 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.

When there are multiple ways to configure a workspace to reach the same goal, it is often best to choose the transformer most specifically suited to your task.As an example, when comparing address points to building polygons, there are a few ways to approach it.

该 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:

该 second example uses a PointOnAreaOverlayer, followed by a Tester.该 features output are the same as in the first method, but the transformer is optimized for this specific task.该 difference in processing time is substantial - from 54.3 seconds in the first configuration, down to 13.7 seconds in the second one.

With a PointOnAreaOverlayer and a Tester:

If performance is an issue in your workspace, look for alternative methods, guided by geometry.

点

点 (including text) features against which areas will be compared.

区域

区域 features against which points will be compared.

点

点 features, with attributes added according to transformer parameter configuration.Geometry is unmodified.

区域

区域 features, with attributes added according to transformer parameter configuration.Geometry is unmodified.

Features with invalid geometries will be rejected and output via this port.

Rejected features will have anfme_rejection_codeattribute with one of the following values:

INVALID_POINT_GEOMETRY_TYPE
INVALID_POLYGON_GEOMETRY_TYPE
INVALID_POLYGON_GEOMETRY_VERTICES
INVALID_POLYGON_GEOMETRY_DEGENERATE
EXTRA_POLYGON_FEATURE

Rejected Feature Handling: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 optionand as aworkspace parameter。

Transformer

通过...分组

该 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.

集团By模式

过程在结束（封闭）: This is the default behavior.Processing will only occur in this transformer once all input is present.

过程当组更改（高级）: 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.

参数

Overlap Count Attribute

该Overlap Count Attribute添加到输出点特征的数量 area features that they were inside of.该Overlap Count Attributeadded to output area features holds the number of point features that they contained.

地区第一

If地区第一is set to是, then the PointOnAreaOverlayer assumes that all Area features will enter the transformer before any Point features.This can reduce memory use of the PointOnAreaOverlayer if you have many Point features to overlay.Any further Area features that arrive after the first Point feature will be logged with a warning and discarded.

If the集团By模式parameter is set to过程当组更改, the地区第一requirement applies to each group separately.This means that the Area and Point features from the first group must enter the transformer before the Area and Point features from the second group.

Aggregate Handling

Choose how aggregate geometries are to be handled.

解聚：Decompose aggregates into their individual components.

拒绝：Do not process aggregates and output them via the 港口。

Attribute Accumulation

If attributes on the incoming and original feature share the same name, but are not geometry attributes that start with fme_, then they are deemed conflicted.

Accumulation Mode

合并传入: 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.

只使用传入: The original feature will have all of its attributes removed, except geometry attributes that start with fme_.该n, all of the attributes from one (arbitrary) incoming feature will be placed onto the original.

Conflict Resolution

使用原始: If a conflict occurs, the original values will be maintained.

使用入站: If a conflict occurs, the values of the incoming will be transferred onto the original.

Prefix

If theAccumulation Modeparameter is set to前缀传入, this value will prefix attributes that are being added to the original feature from the incoming feature.

Generate List on Output ‘Point’

When enabled, adds a list attribute to the Point output features, and the attributes of each area containing an output point are added to that point's list.

Note that no intersections between area features are computed.

‘Point’ List Name

Enter a name for the list attribute.

注意：列表属性are not accessible from the output schema in Workbench unless they are first processed using a transformer that operates on them, such asListExploderorListConcatenator。Alternatively,AttributeExposercan be used.

Add To 'Point' List

所有属性: All attributes will be added to the output Point features.

所选属性: 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 ‘Area’

When enabled, adds a list attribute to the Area output features, and the attributes of each point contained by an output area are added to that area's list.

Note that no intersections between area features are computed.

‘Area’ List Name

Enter a name for the list attribute.

注意：列表属性are not accessible from the output schema in Workbench unless they are first processed using a transformer that operates on them, such asListExploderorListConcatenator。Alternatively,AttributeExposercan be used.

Add To 'Area' List

所有属性: All attributes will be added to the output Area features.

所选属性: Enables the Selected Attributes parameter, where specific attributes may be chosen for inclusion.

所选属性

Enabled whenAdd To 'Area' Listis set to所选属性。Specify the attributes you wish to be included.

How to Set Parameter Values

Using the Text Editor

该 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.

文本 Editor

Using the Arithmetic Editor

该 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.该refore, the names of these functions (in the form @<function_name>) should not be used as literal string values.

Related Transformers

字符串函数	这些功能操作和格式字符串。
特殊的角色	一组控制字符在文本编辑器中提供。
数学函数	数学函数在两种编辑器中可用。
时间/日期函数	日期和时间函数是在文本编辑器中提供。
数学运算符	这些运营商都在算术编辑器中使用。
FME特征函数	这些收益主要功能特定的值。
FME参数	FME和工作区特有的参数可被使用。
创建和修改用户参数	创建您自己的可编辑参数。

Processing Behavior	Group-Based
Feature Holding	是
Dependencies
FME Licensing Level	FME Professional Edition and above
Aliases
History
Categories	Filters and Joins Spatial Analysis

典型用途

它是如何工作的？

使用注意事项

选择空间变换器

组态

输入端口

输出端口

参数

编辑变压器参数

定义值

参考

FME社亚搏国际在线官网区