标注 | 说明 | 数据类型 |
输入蜂窝基站表 | 输入表包含由无线网络提供商提供的蜂窝基站信息。 | Table View |
输出蜂窝基站点 | 包含输出蜂窝基站点的要素类。 | Feature Class |
输出蜂窝基站扇区 | 包含输出蜂窝基站扇区的要素类。 | Feature Class |
蜂窝扇区 ID 字段 | 指定唯一 ID 字段类型以及将添加到输出要素的字段。 当输入蜂窝基站表参数包含所有蜂窝扇区天线的唯一标识符时,请使用唯一 ID 值。当输入蜂窝基站表参数不包含所有蜂窝扇区天线的通用唯一标识符时,请结合使用其他 ID 类型值。
ID 类型选项如下:
| Value Table |
X 字段 | 输入表中包含蜂窝基站的 X 坐标的字段。 | Field |
Y 字段 | 输入表中包含蜂窝基站的 Y 坐标的字段。 | Field |
输入坐标系 | X 字段和 Y 字段参数中指定的坐标的坐标系。 | Coordinate System |
输出投影坐标系 | 输出基站和扇区的投影坐标系。 | Coordinate System |
方位角字段 (可选) | 输入表中包含天线信号方向的字段(蜂窝扇区)。 方位角字段值必须以 0 到 360 度之间的正度数表示,以北为基准方向按顺时针进行测量。 | Field |
默认起始方位角 (可选) | 未指定方位角字段时,将使用的天线信号(蜂窝扇区)的起始方位角值。 例如,三个蜂窝扇区位于同一位置,并且此参数设置为 0 度。 第一扇区以 0 度的方位角生成,第二扇区以 120 度的方位角生成,而第三扇区则以 240 度的方位角生成。 未指定方位角字段时,使用此参数。 方位角值必须以 0 到 360 之间的正度数表示。 默认值为 0。 | Double |
波束宽度字段 | 输入表中包含天线信号(蜂窝扇区)的全部或一半波束宽度值(角度)的字段。 波束宽度必须以 0 到 360 之间的正度数表示。 将 360 用于全向天线。 | Field |
波束宽度类型 (可选) | 指定输入像元类型表中表示的波束宽度值的类型。
| String |
默认波束宽度 (可选) | 未指定波束宽度字段时,将使用的天线信号(蜂窝扇区)的波束宽度(度)。 默认值为 90 度。 | Double |
半径字段 | 输入表中包含天线信号(蜂窝扇区)的半径长度(信号距离)的字段。 | Field |
半径单位 (可选) | 指定将用于半径字段的线性单位。
| String |
默认的半径长度 (可选) | 未指定径向字段时,将使用的天线信号(蜂窝扇区)的半径长度(信号距离)。 默认值为 2。 | Double |
摘要
根据来自蜂窝基站点表的输入纬度、经度、方位角、波束宽度和半径信息,创建蜂窝基站点和扇区面。
使用情况
使用此工具创建的蜂窝扇区面是所提供值的直观表示,不应将其解释为确切的扇区边界,因为波束宽度范围和径向距离可能会发生变化。
无线网络提供商以各种格式和样式提供蜂窝基站信息。 以非表格格式或方案接收数据并不罕见。 输入蜂窝基站表参数值必须是在顶部具有列名称的表。
无线网络提供商提供的表可能在一行中包含呼叫详细信息记录 (CDR) 和蜂窝基站信息。 以这种方式构造表时,必须将其分为两个表。 使用包含标识符字段、方位角、波束宽度和半径的表作为此工具的输入。
无线网络提供商提供的表可能在表的一行中包含多个蜂窝扇区的蜂窝基站信息。 以这种方式构造表时,必须将其他扇区信息分隔到另一行。
例如,如果输入蜂窝基站表参数值具有 10 条包含 Beginning Switch Identifier、Beginning Site Identifier、Beginning Sector Identifier、Beginning Sector Latitude、Beginning Sector Longitude、Beginning Sector Beamwidth、Ending Switch Identifier、Ending Site Identifier、Ending Sector Identifier、Ending Sector Latitude、Ending Sector Longitude 和 Ending Sector Beamwidth 字段的记录,请将此表重新格式化为包含 Switch Identifier、Site Identifier、Sector Identifier、Sector Latitude、Sector Longitude、Sector Azimuth 和 Sector Beamwidth 字段的新表。 新表将包含 20 条记录,其中前 10 条记录是起始扇区信息的值,后 10 条记录是结束扇区信息的值。 在原始表中给定记录的起始扇区和结束扇区具有相同信息的情况下,结束扇区将被识别为重复扇区,并将被忽略。
输入蜂窝基站表参数值的每条记录都必须具有唯一的 ID,代表每个唯一的蜂窝基站扇区天线。 如果表中存在重复的唯一 ID,则仅将一条记录添加至输出。
可将此工具的输出用作手机记录转要素类工具的输入。
需要输出投影坐标系以更准确地计算扇区半径、波束宽度和方位角属性。 请使用地图坐标系作为输出坐标系,以确保精度。
将忽略 SITEX 或 SITEY 字段中包含 null 或空值的输入记录。
以下字段将添加到输出中:
- UNIQUEID- 蜂窝扇区天线的唯一标识符。
- SITEX- 输入蜂窝基站表参数值的 x 坐标。
- SITEY- 输入蜂窝基站表参数值的 y 坐标。
- AZIMUTH- 输入蜂窝基站表参数值的方位角或基于默认起始方位角参数值的派生方位角。
- BEAMWIDTH- 输入蜂窝基站表参数值的波束宽度(角度)或默认波束宽度参数值。
- RADIUS- 输入蜂窝基站表参数值的径向长度(信号距离)或默认半径参数值。
- RADIUSUNIT- 距离值的线性单位。
- AZIMSRC- 从中派生方位角值的来源。
- INPUT - 在使用方位角字段参数时分配的值。
- DEFAULT - 在使用默认起始方位角参数时分配的值。
- BEAMSRC-从中派生波束宽度值的来源。
- INPUT - 在使用波束宽度字段参数时分配的值。
- DEFAULT - 在使用默认波束宽度参数时分配的值。
- RADIUSSRC- 从中派生半径值的来源。
- INPUT - 在使用半径字段参数时分配的值。
- DEFAULT - 在使用默认半径长度参数时分配的值。
RADIUSSRC、BEAMSRC 和 AZIMSRC 字段值用于标识蜂窝扇区面表示的生成方式。
无线网络提供商提供的表格中可能包含蜂窝基站信息表,其中将使用唯一 ID 字段定义所有唯一记录,或使用标识符字段组合定义表中的唯一记录。例如,表中可能包含站点标识符和扇区标识符字段,以唯一定义一些记录,但是表中的其他记录将通过位置区号标识符和蜂窝标识符字段来唯一定义。
- 当为输入表提供唯一 ID 字段时,需要将蜂窝扇区 ID 字段参数中的 ID 类型选项设置为唯一 ID。在同一参数中填充表示唯一 ID 的字段选项。
- 当为表提供多个 ID 字段以指示唯一性时,必须将所有 ID 字段均添加到输出中。对于每个 ID 字段,选择用于定义蜂窝扇区 ID 字段参数中的 ID 类型的 ID 类型值。在同一参数中填充其中包含 ID 信息相关字段的字段选项。该工具将组合这些 ID 字段,并在名为 UNIQUEID 的输出要素类中填充单个唯一 ID 字段。
如果在蜂窝扇区 ID 字段参数中指定了以下标识符字段,则会将其添加到输出中:
- SITEID - 蜂窝基站唯一标识符
- SECTORID - 蜂窝扇区唯一标识符
- SWITCHID - 无线网络交换机唯一标识符
- LACID - 位置区号唯一标识符
- CASCADEID - 无线网络 Cascade 中扇区的唯一标识符
- CELLID - 位置区号中扇区的唯一标识符
参数
arcpy.ca.CellSiteRecordsToFeatureClass(in_table, out_site_feature_class, out_sector_feature_class, id_fields, x_field, y_field, in_coordinate_system, out_coordinate_system, {azimuth_field}, {default_azimuth}, beamwidth_field, {beamwidth_type}, {default_beamwidth}, radius_field, {radius_unit}, {default_radius_length})
名称 | 说明 | 数据类型 |
in_table | 输入表包含由无线网络提供商提供的蜂窝基站信息。 | Table View |
out_site_feature_class | 包含输出蜂窝基站点的要素类。 | Feature Class |
out_sector_feature_class | 包含输出蜂窝基站扇区的要素类。 | Feature Class |
id_fields [id_fields,...] | 指定唯一 ID 字段类型以及将添加到输出要素的字段。 当输入蜂窝基站表参数包含所有蜂窝扇区天线的唯一标识符时,请使用唯一 ID 值。当输入蜂窝基站表参数不包含所有蜂窝扇区天线的通用唯一标识符时,请结合使用其他 ID 类型值。
ID 类型选项如下:
| Value Table |
x_field | 输入表中包含蜂窝基站的 X 坐标的字段。 | Field |
y_field | 输入表中包含蜂窝基站的 Y 坐标的字段。 | Field |
in_coordinate_system | X 字段和 Y 字段参数中指定的坐标的坐标系。 | Coordinate System |
out_coordinate_system | 输出基站和扇区的投影坐标系。 | Coordinate System |
azimuth_field (可选) | 输入表中包含天线信号方向的字段(蜂窝扇区)。 方位角字段值必须以 0 到 360 度之间的正度数表示,以北为基准方向按顺时针进行测量。 | Field |
default_azimuth (可选) | 未指定方位角字段时,将使用的天线信号(蜂窝扇区)的起始方位角值。 例如,三个蜂窝扇区位于同一位置,并且此参数设置为 0 度。 第一扇区以 0 度的方位角生成,第二扇区以 120 度的方位角生成,而第三扇区则以 240 度的方位角生成。 未指定方位角字段时,使用此参数。 方位角值必须以 0 到 360 之间的正度数表示。 默认值为 0。 | Double |
beamwidth_field | 输入表中包含天线信号(蜂窝扇区)的全部或一半波束宽度值(角度)的字段。 波束宽度必须以 0 到 360 之间的正度数表示。 将 360 用于全向天线。 | Field |
beamwidth_type (可选) | 指定输入像元类型表中表示的波束宽度值的类型。
| String |
default_beamwidth (可选) | 未指定波束宽度字段时,将使用的天线信号(蜂窝扇区)的波束宽度(度)。 默认值为 90 度。 | Double |
radius_field | 输入表中包含天线信号(蜂窝扇区)的半径长度(信号距离)的字段。 | Field |
radius_unit (可选) | 指定将用于半径字段的线性单位。
| String |
default_radius_length (可选) | 未指定径向字段时,将使用的天线信号(蜂窝扇区)的半径长度(信号距离)。 默认值为 2。 | Double |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 CellSiteRecordsToFeatureClass 函数。
import arcpy
arcpy.env.workspace = r"C:/data/city_pd.gdb"
arcpy.ca.CellSiteRecordsToFeatureClass("Sites_Phone_1",
"Phone_1_Sites_out",
"Phone_1_Sectors_out",
"SWITCH_ID SWITCH;SITE_ID SITEID;SECTOR_ID SECTORID",
"LATITUDE",
"LONGITUDE",
4326,
102100)
下面的独立脚本演示了如何在脚本中使用 CellSiteRecordsToFeatureClass 函数:
# Name: CellSiteRecordsToFeatureClass.py
# Description: Create cell site points and sector polygons based on input cell
# site table.
# Import script modules
import arcpy
# Set the workspace
arcpy.env.workspace = r"C:\data\city_pd.gdb"
# Set local parameters
in_table = "Sites_Phone_1"
out_sites = "Phone_1_Sites_out"
out_sectors = "Phone_1_Sectors_out"
# Set up IDs
# [ID Type, Field]
switch_id = ["SWITCH_ID","SWITCH"]
site_id = ["SITE_ID","SITEID"]
sector_id = ["SECTOR_ID","SECTORID"]
id_fields = [switch_id, site_id, sector_id]
x_field = "LATITUDE"
y_field = "LONGITUDE"
in_coor_system = 4326
out_coor_system = 102100
# Input Table Contains information that defines how sectors and sites are
# generated
azimuth_field = "AZIMUTH"
default_start_azimuth = 0
beamwidth_field = "BEAMWIDTH"
beamwidth_type = "FULL_BEAMWIDTH"
default_beamwidth = 90
radius_field = "RADIUS"
default_radius = "MILES"
default_radius_length = 2
arcpy.ca.CellSiteRecordsToFeatureClass(in_table,
out_sites,
out_sectors,
id_fields,
x_field,
y_field,
in_coor_system,
out_coor_system,
azimuth_field,
default_start_azimuth,
beamwidth_field,
beamwidth_type,
default_beamwidth,
radius_field,
default_radius,
default_radius_length)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是