邻居
找到候选人features closest to eachBasefeature and merges their attributes onto theBasefeature according to theAccumulation Modeparameter. Or, if输入被设定为候选人只是那performs the same operation using each候选人作为一个Basefeature, considering all other候选人s那but not itself.
输入端口
如果一个feature is routed to both theBaseand the候选人input ports, then features will be compared to themselves as they are both aBaseand候选人。
如果输入被设定为候选人只是, 这re will be noBase港口。All候选人swill be compared with all other候选人s,但不会与自己进行比较。
Output Ports
如果一个候选人feature is found, then all the attributes from the closest候选人功能已添加到Basefeature and theBasefeature is output via the匹配港口。In addition, several other attributes are added to theBase在它通过它输出之前的功能匹配port:
属性 | 描述 |
---|---|
_距离 | The distance from the Base to the matching Candidate |
_角度 | 最近的内插基点与最近的内插候选点之间的角度。 |
_closest_base_x, _closest_base_y | The coordinates of the closest interpolated point on the Base feature relative to the Candidate feature. |
_closest_candidate_x, _closest_candidate_y | 相对于基本特征的候选功能上最近插值点的坐标。 |
_candidate_angle. | 从(_closest_candid_cand_x,_closest_candiate_y)到候选功能中的下一个顶点的角度。如果(_closest_candide_x,_closest_candid_y)等于候选功能的最后一个顶点,则Candidate_Angle将是来自候选功能的上一个顶点的角度(_closest_candid_x,_closest_candid_y)。 |
_candidate_label_angle | The _candidate_angle adjusted so that if it is used as a text rotation, the text will run from left to right. This angle is guaranteed to be greater than or equal to 270 and less than 360, or greater than or equal to 0 and less than or equal to 90. |
如果there are no候选人features found to be within the maximum distance, then theBase功能将通过该功能输出不变UnmatchedBase港口。
候选人功能不在内部Maximum Distanceto anyBasefeature are output via the无与伦比的加工港口。此外,如果没有关闭候选名单名称被指定,然后在其中的任何功能Maximum Distance那but not closest, will be output from the无与伦比的加工港口。这是因为它们不以任何方式使用;它们的属性根本不合并到基本上。
Invalid features are output via the
Rejected features will have anfme_reimpe_code.attribute with one of the following values:extra_candidate_feature.那INVALID_BASE_GEOMETRY_VERTICES那Invalid_candidate_geometry_vertices.那INVALID_GEOMETRY_VERTICES。
参数
变压器
默认行为是使用整个输入功能作为组。此选项允许您选择定义要形成的组的属性。对所有这些属性具有相同值的每组特征将被处理为独立组。
如果输入被设定为Bases and Candidates,然后变形金机将有一个Base港口以及一个候选人port, and the transformer will look for the候选人最接近每个的功能Base特征。如果输入被设定为候选人只是,那么变形金刚只有一个候选人port and noBase港口。Each候选人will then also act as aBase。
Note:How parallel processing works with FME: seeAbout Parallel Processing有关详细信息。
此参数确定变压器是否应跨行进程执行工作。如果启用了,将为每个组的组启动一个过程通过...分组parameter.
并行处理水平
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.
Yes: This transformer will process input groups in order. Changes on the value of the通过...分组输入流上的参数将触发当前累计组上的批处理。如果组很大/复杂,则会提高整体速度,但如果输入组未真正订购,则可能导致不期望的行为。具体地,在两个输入端口变压器上,“按顺序”表示整个组必须在下一个组到达任何端口之前到达两个端口,使变压器按预期工作。这可能会在工作空间中仔细考虑,不应与两个端口的输入流混淆,这些流单独单独订购,但不同步。
No: This is the default behavior. Processing will only occur in this transformer once all input is present.
参数
将包含在列表中的最大候选功能数量关闭候选名单名称parameter. The closest candidate features will be included in the list.
必须为至少一个字符指定值找到的邻居数量andMaximum Distance参数。
以输入特征的坐标为单位测量最大距离。
列表中指明的列表关闭候选名单名称contains all of the candidate features that were within the maximum distance of the base.
必须为至少一个字符指定值找到的邻居数量andMaximum Distance参数。
Note:To get the distance from a givenBaseto all候选人features, use a very large number for this parameter and specify a关闭候选名单名称。
如果在基本功能上插入顶点isYes然后(_closest_base_x,_closest_base_y)将被插入到Base功能如果插入明确定义。例如,如果是候选人polygon is contained inside aBasepolygon, insertion will not take place.
如果在基本功能上插入顶点isYes,_closest_base_x,_closest_base_y顶点将插入到Basefeature as well as added as an attribute. This option only applies to Lines, Polygons, Paths, Arcs, Ellipses, and Donuts.
如果set toYes, 这n all候选人features must be input before anyBase特征。如果一个候选人feature is input after aBase功能和此选项设置为Yes, 这候选人所有计算中将忽略功能。
如果specified, a list will be built on the匹配输出,由来自的所有属性组成候选人features that were within maximum distance of theBase特征。
Note:List attributes从工作台中的输出架构无法访问,除非首先使用在它们上操作的变压器处理它们,例如ListExploderorListConcatenator。所有变压器显示在列表属性the Contents pane of the Transformer Help under清单。或者,AttributeExposer可以使用。
- Lines:多边形,甜甜圈或椭圆将被视为一条线(即其边界线),用于向后兼容。
- Areas:多边形,甜甜圈或椭圆将被视为一个区域,并且任何与该区域重叠的几何形状都会远离该区域的0距离。
Attribute Accumulation
如果基础和候选功能上的属性共享相同的名称,但不是从中启动的几何属性FME_然后他们被视为冲突。
合并候选人: The base feature will retain all of its own un-conflicted attributes, and will additionally acquire any un-conflicted attributes that the candidate feature has. This mode will handle conflicted attributes based on the解决冲突parameter.
字首候选人: The base feature will retain all of its own attributes. In addition, the base will acquire attributes reflecting the candidate feature’s attributes, with the name prefixed with the字首parameter.
只使用候选人:基本功能将删除其所有属性,除了从中开始的几何属性FME_。然后,将从一个(任意)候选功能的所有属性放在基础上。
Use Base: If a conflict occurs, the base values will be maintained.
Use Candidate: If a conflict occurs, the values of the candidate will be transferred onto the base.
为防止候选属性被忽略,因为基本属性已存在,您可以选择在添加到基础时将应用于每个候选属性的前缀。此参数仅启用何时启用Accumulation Modeis字首候选人。
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, clickbeside the applicable parameter. For more information, see变换器参数菜单选项。
变压器Categories
Example
All angles are measured in degrees counterclockwise from horizontal. Where angles are not well-defined (for example, when a候选人polygon is contained inside aBase多边形),它们设置为0。
使用说明
该变压器仅适用于2D几何形状;如果输入几何是3D,则其Z坐标将被忽略。
This transformer has full support for points, lines, arcs, ellipses, polygons, and donuts, and has limited support for other types of geometry. Polygons, ellipses and donuts may be processed as lines or areas, depending on user selection.
FME许可级别
FME专业版及以上
Technical History
Associated FME function or factory: ProximityFactory
搜索FME知识中心
搜索有关此变压器的样本和信息FME知识中心。
标签Keywords: MBR "minimum bounding rectangle" neighbourfinder