NeighborFinder
找到每个基本特性的最近候选特性,并将它们的属性合并到基本特性上。也可以只在候选模式中使用,其中每个特性依次被视为基础,并与所有其他特性进行比较,但不与自身进行比较。
典型的使用
- 识别最近的特征
- 在指定的距离内识别特征
- 添加最接近候选点的点(例如在离车站最近的轨道上添加点)
- 在某个方向上找到最近的特征(通过过滤得到的候选角度)
- 通过计算一定距离内的邻居来计算集群或密度
它是如何工作的?
NeighborFinder通常有两套功能基地和候选人。对于每个基本特性,转换器根据邻近性和参数选择来检查候选项是否匹配。它可以检查最接近的候选特征,或一个固定的最接近的候选特征的最大数量,或所有落在基本特征指定距离内的候选特征。
将一个匹配候选对象的属性添加到基本特性中,包括:
- 来自匹配候选的属性
- 计算属性,包含匹配的距离、角度和坐标
- 插值点在最接近候选点的基底上的坐标
来自多个匹配候选项的属性可能存储在属性列表。
输出包括匹配具有这些新属性的基本特性,无与伦比的基础特性(不变)无与伦比的候选人(不变)。
NeighborFinder只适用于2D几何图形;如果输入的几何图形是3D的,那么它的z坐标将被忽略。转换器完全支持点、线、弧、椭圆、多边形和甜甜圈,对其他类型的几何图形的支持有限。根据用户的选择,多边形、椭圆和甜甜圈可以作为线或区域进行处理。
候选人只有模式
可以在a中使用NeighborFinder候选人只有模式,其中只考虑候选输入特性。在这种模式下,每个特性依次被视为基础,并与所有其他候选特性(但不包括它自己)进行比较。属性共享和输出行为与上面相同。
属性启用仅候选项模式输入参数。当输入仅设置为候选端口时,将删除基本输入端口。
在本例中,我们有一组没有有用属性的包裹多边形,以及一个用于标记的点数据集,它具有地址属性。我们想要提取地址并将它们应用到包裹多边形中。
虽然PointOnAreaOverlayer如果执行类似的比较,则无法找到与点正好落在多边形外部的匹配,如1132所示。我们会用一个邻居。
地块多边形作为基地特征-变压器将尝试查找匹配的特征。
地址点连接为候选人-将搜索匹配项,然后将新属性提供给基本要素。
在参数对话框中,邻居的号码找到被设置为1,因为我们只希望使用最接近的一个匹配项。治疗多边形作为设置为区域。
注意,默认设置为积累模式-合并候选项-将候选项的属性复制到基本特征(这是我们想要的)。
输出匹配地块多边形现在具有来自其最近候选匹配的属性。
选择空间变压器
许多转换器可以评估空间关系并执行空间连接——分析拓扑结构、合并属性,有时还可以修改几何形状。通常,选择最特定于您需要完成的任务的方法将提供最佳性能结果。如果有不止一种方法可以做到这一点(通常是这种情况),那么花时间在性能测试替代方法上可能是值得的。
为了正确分析空间关系,所有的特征都应该在同一个坐标系中。的Reprojector对于在工作空间中重新投影功能可能很有用。
变压器 |
可以合并属性 |
改变几何图形 |
统计相关功能 |
创建列表 |
支持的类型* |
推荐用于 |
---|---|---|---|---|---|---|
SpatialFilter | 是 | 没有 | 没有 | 没有 |
|
|
SpatialRelator | 是 | 没有 | 是 | 是 |
|
|
AreaOnAreaOverlayer | 是 | 是 | 是 | 是 |
|
|
LineOnAreaOverlayer | 是 | 是 | 是 | 是 |
|
|
LineOnLineOverlayer | 是 | 是 | 是 | 是 |
|
|
PointOnAreaOverlayer | 是 | 没有 | 是 | 是 |
|
|
PointOnLineOverlayer | 是 | 是 | 是 | 是 |
|
|
PointOnPointOverlayer | 是 | 没有 | 是 | 是 |
|
|
部门间 | 是 | 是 | 是 | 是 |
|
|
限幅器 | 是 | 是 | 没有 | 没有 |
|
|
NeighborFinder | 是 | 在某些情况下, | 没有 | 是 |
|
|
TopologyBuilder | 是 | 是 | 没有 | 是 |
|
|
* 注意:曲线包括直线、圆弧和路径。区域包括多边形、甜甜圈和椭圆。
空间分析可能是处理密集型的,特别是当涉及大量特征时。如果您想调整工作区的性能,这是一个很好的开始。
当有多种方法来配置工作空间以达到相同的目标时,通常最好选择最适合您的任务的转换器。例如,当比较地址点和构建多边形时,有几种方法可以接近它。
第一个例子,使用空间过滤器测试点是否落在多边形内,产生正确的结果。但空间滤波器是一个相当复杂的变压器,能够测试多种条件,并接受广泛的几何类型。它并没有针对我们在这里分析的特定空间关系进行优化。
使用空间过滤器:
第二个例子使用PointOnAreaOverlayer,后面跟着一个测试人员。特征输出与第一种方法中的相同,但是变压器针对此特定任务进行了优化。在处理时间上的差异是很大的-从第一个配置中的54.3秒,下降到第二个配置中的13.7秒。
用一个点覆盖层和一个测试仪:
如果工作区中存在性能问题,请在几何图形的指导下寻找其他方法。
配置
输入端口
如果一个特性被路由到两个基地和候选人输入端口,然后功能将比较自己,因为他们都是一个基地和候选人。
如果输入被设置为候选人只有,不会有基地端口。所有候选人将与所有其他的候选人,却不会拿自己跟自己比较。
特征从匹配的候选者接收属性,根据在转换器中定义的参数,并作为输出保留。
如果与定义的条件匹配,则将提供属性的功能。候选项不输出。
在仅候选者模式(输入参数设置为仅候选者)中,候选者将同时作为候选者和基,因此也将从匹配中接收属性并输出。
输出端口
如果候选人找到特征,然后从最近的候选人功能被添加到基地功能和基地功能通过匹配端口。
如果生成列表已启用,所有属性或来自多个匹配的选定属性候选人可以添加到新的列表属性。
此外,还有一些其他属性被添加到基地在通过匹配端口:
属性 | 描述 |
---|---|
_距离 | 从基座到匹配候选的距离 |
_角度 | 最接近的内插基点和最接近插值候选点之间的角度。 |
_closest_base_x,_closest_base_y | 底座相对于候选特征的功能上最接近插点的坐标。 |
_closest_candidate_x,_closest_candidate_y | 相对于基体特征的候选特征上最接近插点的坐标。 |
_candidate_angle | 从(_closest_candidate_x,_closest_candidate_y)到候选特征中的下一个顶点的角度。如果(_closest_candidate_x,_closest_candidate_y)等于候选特征的最后一个顶点,那么candidate_angle将从候选特征的前顶点(_closest_candidate_x,_closest_candidate_y)的角度。 |
_candidate_label_angle | 该_candidate_angle调整,这样,如果作为一个文本旋转时,该文本将运行由左到右。该角度被保证是大于或等于270且小于360,或大于或等于0且小于或等于90。 |
所有角度都是从水平方向逆时针测量的。如果角度定义不明确(例如,当候选人多边形包含在基地多边形),它们设置为0。
如果没有候选人发现在最大距离内的特征,然后基地功能将通过不匹配数据库端口。
候选人功能不在最大距离对任何人基地功能通过不匹配的candidate端口。候选人超过邻居的号码找到参数也将在此处输出(仅使用前x个匹配数)。如果生成列表未启用,则最大距离,但不是最近的,将从不匹配的candidate端口。这是因为它们没有以任何方式使用;它们的属性根本不会合并到基础上。
参数
分组依据 | 默认行为是使用整套功能为一体的集团。此选项允许您选择定义哪些群体表单属性。 |
按模式分组 | 结束处理(阻塞):这是默认行为。只有当所有输入都存在时,才会在此转换器中进行处理。 组更改时处理(高级):此转换器将按顺序处理输入组。输入流上Group By参数值的更改将触发对当前累积组的处理。这可能会提高总体速度(特别是对于多个大小相等的组),但如果输入组没有真正排序,则可能会导致不希望的行为。
使用注意事项分组依据
有两个典型的使用原因组更改时处理(高级)。第一种是要分组处理的传入数据(已经按顺序排列)。在这种情况下,结构根据使用情况而不是性能考虑来指定组。 第二个可能的原因是潜在的业绩增长。 当数据已经排序(或使用SQL排序依据声明)由于FME需要较少的工作。如果数据需要排序,可以在工作区中对其进行排序(尽管增加的处理开销可能会抵消任何收益)。 根据数据流的数量排序变得更加困难。多个数据流几乎不可能按正确的顺序排序,因为所有特性都匹配分组依据值必须在属于下一个组的任何特征(任何特征类型或数据集)之前到达。在这种情况下,使用分组依据具有结束处理(阻塞)可能是等效和简单的方法。 注:多个特征类型和来自多个数据集的特征通常不会以正确的顺序自然出现。 与许多场景一样,使用数据在工作区中测试不同的方法是确定性能提升的唯一确定方法。 |
输入 | 基地和候选人-接受基本和候选特征(默认)。如果一个特征同时被路由到基和候选输入端口,那么特征将与它们自身进行比较,因为它们既是基也是候选。 候选人只有-只接受候选功能。将没有基本输入端口。所有候选人都将与所有其他候选人进行比较,但不会与自己进行比较。 |
邻居的号码找到 | 将包含在由列表指定的列表中的候选特征的最大数目。生成列表参数。最接近的候选功能将包含在列表中。 如果该值为0或为空,则对将包含在列表中的邻居数没有限制。 |
最大距离 | 最大距离是以输入特征的坐标单位来测量的。 中指定的列表生成列表包含在基的最大距离内的所有候选特征。在最大距离的候选人将被包括在最接近的候选人名单中。 如果数值为0或空白,则在最大距离上没有限制。 |
在基特征上插入顶点 | 如果是,则(_closest_base_x,_closest_base_y)将插入到基地如果插入定义良好,则为特征。例如,如果候选人多边形包含在基地多边形,将不进行插入。 如果是,最接近的顶点将插入到基地以及作为属性添加的功能。此选项仅适用于直线、多边形、路径、圆弧、椭圆和圆环。 |
将措施视为 | 添加到基础上的度量可以视为离散的,这意味着它们将从最近的已知测量值中获取,或者连续的,这意味着它们将从最近的点进行插值。 |
候选人优先 | 如果是,然后全部候选人必须在任何基地特征。如果候选人特征在基地功能,此选项设置为是,和候选人在所有计算中将忽略此功能。 |
治疗多边形作为 | 线:为了向后兼容,多边形、圆环或椭圆将被视为直线(即其边界线)。 地区:多边形、圆环或椭圆将被视为一个区域,任何与该区域重叠的几何图形都将与该区域相距0距离。 |
用候选项替换Measures/Z | 如果候选者是一条线,而基是一个点,这将指定是否应将度量值和z值从候选者复制到基。z值将等于候选点上最接近底面的插值z值。测量值将被插值或使用最接近的已知测量值,具体取决于将措施视为参数。 如果候选人不是一条线,或者基数不是一个点,这将没有效果。 |
如果基准站和候选特征相同的名称,属性,但不是几何属性是下手fme_,然后,他们被视为冲突。
积累模式 | 合并候选人:基本功能将保留自己所有的未发生冲突的属性,而将另外获得任何未冲突属性的候选特征了。这种模式将处理基础上的冲突属性冲突解决参数。 前缀候选:基本功能将保留其自身的所有属性。此外,基函数将获取反映候选特征属性的属性,名称以前缀参数。 只使用候选:基本特征将删除其所有属性,但以口蹄疫_。然后,来自一个(任意)候选特征的所有属性都将被放置到基础上。 |
冲突解决 | 使用底座:如果发生冲突,基值将保持不变。 使用候选项:如果发生冲突,候选值将转移到基上。 |
前缀 | 为了防止被忽略,因为基本属性已经存在一个候选属性,可以选择指定时,它被添加到该基地将被应用到每个候选属性的前缀。该参数时,才会启用时,积累模式是前缀候选。 |
生成列表
启用后,增加了列表属性的匹配输出功能。此参数很有当邻居的号码找到大于1。
最近的候选名单名称 | 输入列表属性的名称。 注:列表属性无法从工作台中的输出模式访问,除非首先使用对其进行操作的转换器对其进行处理,例如监听器或列表连接器。或者,属性Exposer可以使用。 |
添加到列表 | 所有属性:所有属性都将添加到输出功能中。 选定属性:启用“选定属性”参数,其中可以选择要包含的特定属性。 |
选定属性 | 当“添加到列表”设置为“选定属性”时启用。指定要包含的属性。 |
编辑变压器参数
使用一组菜单选项,可以通过引用工作空间中的其他元素来分配transformer参数。更高级的功能,如高级编辑器和算术编辑器,也可以在一些转换器中使用。要访问这些选项的菜单,请单击在可适用的参数旁边。有关更多信息,请参见变压器参数菜单选项。
定义值
有几种方法可以定义在转换器中使用的值。最简单的方法是简单地键入一个值或字符串,其中可以包括各种类型的函数,如属性引用、数学和字符串函数以及工作区参数。有许多工具和快捷方式可以帮助构造值,通常可以从value字段附近的下拉上下文菜单中获得。
使用文本编辑器
文本编辑器提供了一个方便的方法来构造从各种数据源,如属性,参数和常量,其中该结果被直接使用的参数中的文本字符串(包括正则表达式)。
使用算术编辑器
算术编辑器提供了一个方便的方法来构造从各种数据源,如属性,参数和特征函数,其中结果被直接使用的参数内的数学表达式。
条件值
根据一个或多个测试条件,要么通过或失败的设定值。
内容
表达式和字符串可以包括多个功能,字符,参数等。
当设定值 - 无论是直接在参数输入或使用的编辑之一构造 - 字符串和表达式包含字符串,数学,日期/时间或FME特征函数将具有评价这些功能。因此,这些功能的名称(在形式@ <FUNCTION_NAME>)不应该被用作文字字符串值。
参考
加工行为 |
|
特点控股 |
是 |
依赖 | |
FME许可级别 | FME专业版及以上 |
别名 | NeighbourFinder |
历史 | |
分类 |
FME社亚搏国际在线官网区
FME社区是演示亚搏国际在线官网、操作、文章、常见问题等的地方。获取问题的答案,向其他用户学习,并对新功能提出建议、投票和评论。
搜索关于睦邻者的所有结果在FME社区。亚搏国际在线官网
例子可能包含在政府开放执照下的信息-温哥华