网优自动化工具接口文档调用流程及输入数据格式说明.docx
- 文档编号:26650678
- 上传时间:2023-06-21
- 格式:DOCX
- 页数:22
- 大小:1.05MB
网优自动化工具接口文档调用流程及输入数据格式说明.docx
《网优自动化工具接口文档调用流程及输入数据格式说明.docx》由会员分享,可在线阅读,更多相关《网优自动化工具接口文档调用流程及输入数据格式说明.docx(22页珍藏版)》请在冰豆网上搜索。
网优自动化工具接口文档调用流程及输入数据格式说明
网优自动化工具:
接口文档、调用流程及输入数据格式说明
1.自动化工具服务器整体部署架构
操作系统:
WindowsServer200864位;内存建议:
64G~128G
硬盘:
10T(需要保存MRO数据);数据库:
Oracle11g
开发环境:
Web服务器:
Apache-Tomcat-7.0;JAVAJDK:
JDK1.7
MCR:
MATLABCompilerRuntime(目前使用Matlab2011a或2014a版本)
2.自动优化工具服务器FTP路径约定
✓各项网优自动优化工具的输入文件、输出文件统一采用FTP方式部署于自动优化服务器。
✓各项网优自动优化工具的FTP根目录,由各项自动优化工具固定保存,如下所示(暂定,待开发时确定),外部调用服务时,无需输入根目录。
◆PCI优化:
F:
/NetworkOptimization/PCI
◆TAC优化:
F:
/NetworkOptimization/TAC
◆ANR优化:
F:
/NetworkOptimization/ANR
◆功率优化:
F:
/NetworkOptimization/PWR
◆场景参数:
F:
/NetworkOptimization/SCE
✓在每个网优自动化工具的根目录下,再由集中优化平台根据任务需求,建立不同的任务目录,用于存放不同任务所需要的输入文件,如下举例:
◆如建立杭州网格1的PCI任务,可在PCI工具的根目录下建立文件夹,并上传文件,F:
/NetworkOptimization/PCI/TASK-HZ-GRID1-20160311/{XXX输入文件}
✓具体每项工具所需要的输入输出文件,详见后面章节描述
3.PCI自动优化工具
3.1.使用步骤流程及输入文件介绍
1>集中优化平台首先进行Mod3问题分析
确定PCI优化区域,确定待优化小区范围和保护带小区范围。
(举例确定如:
100个小区<30个基站>为待优化区域;20个小区<6个基站>为保护带区域)。
2>集中优化平台工参数据预处理:
针对上述确定的优化区域小区和保护带区域小区,提取工参数据,按照工具模板要求,形成工参输入数据。
如下详细说明:
如下工参文件:
src小区工参输入表.csv(实际使用时建议英文文件名)该表存储的是优化区域和保护带区域的小区工参输入,按照优化区域小区在前(白色),保护带小区在后(黄色)排列,并按照:
基站ID+小区CGI进行排序,并确定好优化区域基站个数(30个),和保护带基站个数(如6个)。
3>集中优化平台同频干扰数据预处理:
此表需要包含步骤2中确定的所有优化区域和保护带小区的同频测量相关干扰预处理数据,本环节涉及到对MR,DT,切换等三类数据的预处理,并根据省内要求的权重进行叠加后输出。
(本环节可提供单一处理后的文件,或分离的3个文件,下方详细介绍这两种方式)
✓方式一:
提供3个分离的文件方式:
(MR,DT,切换三类数据分别提供)
⏹
(1)src同频相关干扰输入表-MR数据中RSRP相关性.csv
⏹
(2)src同频相关干扰输入表-DT数据中RSRP相关性.csv
⏹(3)src同频相关干扰输入表-邻区对切换统计相关性.csv
✓
方式二:
提供一个加权处理后的总干扰相关文件的方式:
(需要省内对MR,DT,切换三类数据进行加权计算后输出)
⏹
(1)src同频相关干扰输入表(已通过加权计算后).csv
4>集中优化平台将准备好的数据,上传至自动优化工具FTP服务器的特定任务ID的路径下,并调用WebService系列接口进行PCI数据检验、和二次数据预处理、以及PCI优化计算。
举例:
假设采用上述方式2准备好文件,
(1)工参文件:
cellEngineerFile.csv
(2)干扰相关性数据:
cellCorrelationFile.csv,建立本次优化任务TASK-HZ-GRID1-20160311,将上述两个文件上传至FTP服务器路径:
F:
/NetworkOptimization/PCI/TASK-HZ-GRID1-20160311/cellEngineerFile.csv
F:
/NetworkOptimization/PCI/TASK-HZ-GRID1-20160311/cellCorrelationFile.csv
✓调用数据质量检验Service接口:
(暂定)pciCheckDataQua(StringcellEngineerFile,StringcellCorrelationFile,StringTaskID):
该函数输入文件路径和任务ID,主要功能是检查文件是否正确上传,并检查所输入的工参文件中小区CGI是否都包含MR和切换数据,判断是否有数据缺失,返回数据检查结果。
✓调用数据二次处理Service接口:
(暂定)pciGeneDataMatrix(StringcellEngineerFile,StringcellCorrelationFile,StringTaskID,StringpciParameter):
该函数输入文件路径和任务ID,以及PCI运行所需的参数字符串,接口进行数据二次处理,生成最终运行所需的干扰矩阵和配置文件,返回预处理结果。
✓调用PCI优化运行Service接口:
(暂定)pciRunTask(StringcellEngineerFile,StringcellCorrelationFile,StringTaskID,StringpciParameter):
该函数输入文件路径和任务ID,以及PCI运行所需的参数字符串,接口启动PCI计算工具,待运算完毕后,在任务ID所在路径下,生成优化结果文件。
✓调用PCI运行状态查询Service接口:
(暂定)pciProcessRate(StringcellEngineerFile,StringcellCorrelationFile,StringTaskID,StringpciParameter):
该函数查询该任务ID运行的状态和进度,返回结果。
✓注:
如采用方式1,则需要提供工参文件外,加3个相关性文件名,(暂定)StringsrcMRname,StringsrcDTname,StringsrcHOname
4.场景参数自动推荐工具
4.1.使用步骤流程及输入文件介绍
本工具主要的目的是:
通过集团/省内统一采集的海量数据,逐步建立和完善LTE现网优秀参数配置经验库,用于辅助新建站小区的初始参数规划配置,充分借鉴已充分优化地区的LTE参数配置经验,以减少优化人员工作量和技术水平要求,可快速辅助各地市网优人员将新入网小区的参数配置质量达到人工参数优化经验的水平。
1>集中优化平台首先进行多维数据关联提取
✓场景化参数自动推荐工具:
需要基于现网海量数据进行关联挖掘分析,训练出现网参数经验库,因此,首先需要省内用LTE现网的:
参数配置数据、MRO/MRS数据、工参数据、邻区配置、性能指标等多维度数据源进行关联预处理。
✓对于关联提取数据的时间要求,做如下说明:
以提取到参数数据的时间为中心点:
1)网管PM数据为参数数据当天加上前后各3天(共七天,按天粒度取平均值),2)MR数据为参数数据当天加上前后各1天(共三天,按天粒度取平均值),3)工参和邻区配置数据与提取参数数据时间保持一致(提取同一天)
a)Scene-CELL-PM-IMPORT(全量宏站小区特征性能全表样例,数据库表).csv
其中前4个字段省内无需准备,由自动化工具运算得出(小区ID主键、场景ID、场景划分名称、用户)
字段名含义
字段名
样例1
样例2
样例3
小区ID主键
BESTCELLID
ZJ-NEWC100-1
ZJ-NEWC100-2
ZJ-NEWC100-3
场景ID
TASKID
20151225-ZJ-NEW-31
20151225-ZJ-NEW-33
20151225-ZJ-NEW-15
场景划分名称
SCENAME
典型场景-31
典型场景-33
典型场景-15
用户
SCEUSER
WL
WL
WL
小区CGI
CGI
460-00-407432-1
460-00-735304-3
460-00-736117-1
小区名
CELLNAME
460-00-407432-1
460-00-735304-3
460-00-736117-1
省份
PROVINCE
ZJ
ZJ
ZJ
城市
CITY
台州
湖州
湖州
工参中场景
SCE
村庄
城区道路
城区道路
厂家
VENDOR
中兴
华为
华为
频段
FREQBAND
D
D
D
频点
EARFCN
37900
38100
37900
是否存在同频邻区
INTRAFREQ
1
1
1
是否存在异频邻区
INTERFREQ
1
1
1
是否存在室分邻区
INDOORFREQ
1
1
1
是否为相同方向角异频双层网小区
TWOLAYERSAMEAZI
1
1
1
是否为不同方向角异频双层网小区
TWOLAYERDIFFAZI
1
1
1
综合KPI(小区级无线接通率×(1-小区级无线掉线率)×(1-小区RRC重建比率)×小区切换成功率)
ALLRATE
0.998875404
0.998642415
0.995461028
弱覆盖比例(MRRSRP<-110dbm的采样点占比)
BADCOVER
0.07894876
0.017306495
0.022332657
重叠覆盖度(小区重叠覆盖度为MR样本点中测量到的邻区的电平和主小区电平(主小区RSRP>-110dBm)差大于-6dB且满足以上条件的邻区数目大于等于3的样本点的比例)
OVERCOVER
0.0003
0.0016
0.0001
过覆盖影响小区数(与本小区相关系数>1%的小区)
GOCOVER_CELL
2
4
2
本小区站高
HEIGHT
43.5
35
45
本小区下倾角
DOWNTILT
13
12
12
本小区RRC请求数(天粒度)
PRRC
12310
12263
16928
本小区切换请求数(天粒度)
PHO
3465
4035
8495
配置的LTE邻区个数
NBRNUM
35
41
45
邻区站间距均值(取0至5KM内邻区计算均值)
DISTANCE
508.3641409
423.8333996
884.859715
邻区站高均值(取0至5KM内邻区计算均值)
NBRHEIGHTAVG
27.17142857
32.60731707
26.84444444
邻区下倾角均值(取0至5KM内邻区计算均值)
NBRDOWNAVG
10.71428571
8.73902439
8.844444444
RRC连接建立成功率
AVG_RRC_ACCESSRATE
0.9997
0.999608333
0.9995375
E-RAB建立成功率
AVG_ERAB_ACCESSRATE
0.9992275
1
0.999883333
无线接通率
AVG_ACCESSRATE
0.9996375
0.999608333
0.999420833
无线掉线率
AVG_DROPRATE
0
0.000316667
0.0003875
切换成功率
AVG_HOFAILRATE
0.9994875
1
0.9980625
RRC连接重建比率
AVG_RRC_REESTRATE
0.00025
0.000645833
0.001641667
小区用户面下行平均时延
AVG_USERDELAY_DL
26.77083333
10.73958333
22.82291667
RRC连接平均建立时长
AVG_RRC_AVGTIME
23.45833333
22.55202333
23.4375
E-RAB平均建立时长
AVG_ERAB_AVGTIME
26.59375
26.16662667
28.33333333
上行每PRB平均吞吐量
AVG_ULBITPRB
64.7229625
40.9499375
41.21910833
下行每PRB平均吞吐量
AVG_DLBITPRB
404.5803333
174.7343292
222.9936458
MAC层上行误块率
AVG_MAC_ULBLER
0.000266667
0.0456375
0.026254167
MAC层下行误块率
AVG_MAC_DLBLER
0.000154167
0.001908333
0.0024875
平均RSRP
RSRP_MEAN
-94.1871
-92.1141
-89.1759
RSRP采样点总数
RSRP_ALL
18911
192760
114899
平均RSRQ
RSRQ_MEAN
-6.7412
-7.3965
-7.0581
RSRQ采样点总数
RSRQ_ALL
18911
192760
114899
平均ReceivedIPower
RECEIVEDIPOWER_MEAN
-118.2738
-118.0705
-119.418
ReceivedIPower采样点总数
RECEIVEDIPOWER_ALL
101246
100996
101202
平均SINRUL
SINRUL_MEAN
15.1644
0
0
SINRUL采样点总数
SINRUL_ALL
18764
0
0
平均PowerHeadRoom
POWERHEADROOM_MEAN
20.3329
0
0
POWERHEADROOM采样点总数
POWERHEADROOM_ALL
18615
0
0
b)Scene-CELL-PARA-IMPORT(全量小区参数全表样例,数据库表).csv
此文件包含现网全量参数取值,采用CSV格式,使用英文“!
”作为分隔符,截图如下所示:
各字段含义如下表
参数值编号
生成日期
省份
小区CGI
MO类别
MO序列
参数名称
参数取值
ZJ-2813876
2016-01-07
ZJ
460-00-393375-2
CELLALGOSWITCH
1
AcBarAlgoSwitch
ACBAR_SWITCH_STATIC
ZJ-2813877
2016-01-07
ZJ
460-00-393375-2
CELLALGOSWITCH
1
AqmAlgoSwitch
AqmAlgoSwitch-1
ZJ-2813878
2016-01-07
ZJ
460-00-393375-2
CELLALGOSWITCH
1
AvoidInterfSwitch
AvoidGeranInterfSwitch-0
ZJ-2813879
2016-01-07
ZJ
460-00-393375-2
CELLALGOSWITCH
1
BfAlgoSwitch
BfSwitch-1
ZJ-2813880
2016-01-07
ZJ
460-00-393375-2
CELLALGOSWITCH
1
CellSchStrategySwitch
AbnUeSchSwitch-0
ZJ-2813881
2016-01-07
ZJ
460-00-393375-2
CELLALGOSWITCH
1
CovBasedInterFreqHoMode
HANDOVERIMMEDIATELY
2>集中优化平台将准备好的数据,上传至自动优化工具FTP服务器的特定任务ID的路径下,并调用WebService系列接口进行场景化参数工具的数据质量检验、和二次数据预处理。
举例:
准备好上述格式文件:
(1)Scene-CELL-PM-IMPORT(全量宏站小区特征性能全表样例).csv
(2)Scene-CELL-PARA-IMPORT(全量小区参数全表样例).csv
建立本次场景参数数据分析任务TASK-HZ-GRID1-20160311,将上述两个文件上传至FTP服务器路径:
F:
/NetworkOptimization/SCE/TASK-HZ-GRID1-20160311/Scene-CELL-PM-IMPORT.csv
F:
/NetworkOptimization/SCE/TASK-HZ-GRID1-20160311/Scene-CELL-PARA-IMPORT.csv
✓调用数据质量检验Service接口(暂定)sceCheckDataQua(StringcellPMFile,StringcellParameterFile,StringTaskID)该函数输入文件路径和任务ID,主要功能是检查文件是否正确上传,判断是否有数据缺失,返回数据检查结果。
✓调用场景划分数据二次处理Service接口:
(暂定)sceGeneClusterData(StringcellPMFile,StringcellParameterFile,StringTaskID):
该函数输入文件路径和任务ID,接口进行数据的二次处理,生成场景划分结果,并将数据导入自动化工具数据库。
✓调用新测试小区场景匹配Service接口:
(暂定)sceRunTask(StringcellSceTestFile,StringoutputFile,StringTaskID,StringsceParameterList):
该函数输入文件路径和任务ID。
✓另:
对于输入的测试小区,每个小区可给出重点参数的推荐设置,存在于FTP的该TaskID下的路径中。
5.ANR自动优化工具
5.1.使用步骤流程及输入文件介绍
1>集中优化平台首先进行片区选择
确定ANR优化区域,确定待优化小区范围。
(建议先选择性能相对较差的某城市的片区,比如几个或多个站,基于这些站,提供相关数据)
2>集中优化平台数据预处理:
需要准备的数据包括四个数据模板,含工参,MRO统计值,网管数据以及现网邻区数据。
⏹
(1)工参数据
针对上述确定的优化区域所在的城市,提取该市全量的工参数据,按照工具模板要求,形成工参输入数据。
如下工参文件:
ANR_GCSJ.csv(实际使用时建议英文文件名)该表存储的是选定优化区域所在的城市的全量小区工参输入。
⏹
(2)邻区数据
现网邻区参数模板。
需要现网已配的邻区数据,提取该市全量的邻区数据。
主要包括现网已配的源小区CGI,目标小区CGI,频点和PCI等信息。
如下邻区文件:
ANR_LQSJ.csv:
⏹(3)网管数据
需要提取测试片区所在城市的全量的网管数据。
包含“LTE系统内邻区:
切换出平均请求次数(来源于OMC统计,一周内平均每天的切换次数)”,以及“LTE系统内邻区:
切换成功率(来源于OMC统计,一周内平均每天的切换成功率)”等。
如下为网管数据模板,ANR_NET_DATA.csv。
(4)MRO数据
需要对原始MRO数据进行解析,除省份厂家外,还包括源小区CGI,频点,PCI,以及“该邻频点RSRP与本小区频点RSRP差值的平均值 ”。
如下为MRO数据模板,ANR_MR_DATA.csv。
(MRO的模板需要程序开发,故请省里先完成功能开发,再按照模板要求,提取最近一段时间内的数据。
由于MRO数据量太大,可以提供片区及片区附近一两圈范围内的邻区数据。
其他数据都提供测试城市的全量数据。
)
3>集中优化平台将准备好的数据,上传至自动优化工具FTP服务器的特定任务ID的路径下,并调用WebService系列接口进行ANR数据检验、以及ANR优化计算。
举例:
假设采用上述方式准备好文件,
(1)工参文件:
ANR_GCSJ.csv
(2)邻区文件:
ANR_LQSJ.csv,(3)网管文件:
ANR_NET_DATA.csv(4)MRO文件:
ANR_MR_DATA.csv,建立本次优化任务,如:
TASK-城市–片区-用户-时间,具体如TASK-HZ-GRID1-USER1-201603110830(其中城市,片区,用户和时间都是根据各省情况细化,建议不要出现中文),将上述两个文件上传至FTP服务器路径:
F:
/NetworkOptimization/ANR/TASK-HZ-GRID1-USER1-201603110830/ANR_GCSJ.csv
F:
/NetworkOptimization/ANR/TASK-HZ-GRID1-USER1-201603110830/ANR_LQSJ.csv
F:
/NetworkOptimization/ANR/TASK-HZ-GRID1-USER1-201603110830/ANR_NET_DATA.csv
F:
/NetworkOptimization/ANR/TASK-HZ-GRID1-USER1-201603110830/ANR_MR_DATA.csv
✓调用数据检验Service接口:
(暂定)anrCheckDataQua(StringANR_GCSJ_File,StringANR_LQSJ_File,StringANR_NET_DATA_File,StringANR_MR_DATA_File,StringTaskID):
该函数输入文件路径和任务ID,主要功能是检查文件是否正确上传,并检查数据格式是否正确,比如检查是否为频点号,而不是绝对频率;判断是否有数据缺失,返回数据检查结果。
✓调用ANR优化数据导入接口:
(暂定)anrParseDataQua(StringANR_GCSJ_File,StringANR_LQSJ_File,StringANR_NET_DATA_File,StringANR_MR_DATA_File,StringTaskID):
该函数输入文件路径和任务ID,主要功能是进行输入数据的导入,返回数据导入结果。
该接口的调用基于数据检验接口的基础上。
✓调用ANR优化运行Service接口:
(暂定)anrRunTask(StringTaskID,StringavgDis,StringinnerDisMultiple,StringinnerPointPerDown,StringinnerPointPerUp,StringinnerRsrpSmall,StringinnerRsrpBig,StringinnerPointCountDown,StringouterDisMultiple,StringouterPointPerUp,StringouterRsrp,StringouterPointCountDown):
该函数输入任务ID,以及ANR运行所需的各类门限,包括:
平均站间距,室内站间距倍数,室内采样点占比上限,室内采样点占比下限,室内RSRP较小差值,室内RSRP较大差值,室内采样点个数下限;以及室外
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 自动化 工具 接口 文档 调用 流程 输入 数据格式 说明