WTOAAM/dataContract

风电机组发电性能分析算法

用于与风电机组发电性能分析系统集成，算法版本v1.2

名词/术语

index： 表示数组索引
分析类型： 表示 针对风电机组发电性能的不同分析，例如：静态偏航误差、功率曲线散点分析、变桨功率分析等
直驱风电机组： 无齿轮箱
半直驱风电机组：有齿轮箱且结构较双馈风电机组简单
双馈风电机组： 有齿轮箱且结构较半直驱风电机组复杂
非直驱风电机组： 有齿轮箱，包括：半直驱风电机组、双馈风电机组

风电机组发电性能分析类型

分析类型列表

分析类型名称	包名	类名	方法名	数据源	Code
数据情况
机组分钟级SCADA数据记录完整度分析	algorithm.dataIntegrityOfMinuteAnalyst	DataIntegrityOfMinuteAnalyst	executeAnalysis	minute	data_integrity_minute
机组秒级SCADA数据记录完整度分析	algorithm.dataIntegrityOfSecondAnalyst	DataIntegrityOfSecondAnalyst	executeAnalysis	second	data_integrity_second
风资源分析
机组风速频率分析	algorithm.windSpeedFrequencyAnalyst	WindSpeedFrequencyAnalyst	executeAnalysis	minute	wind_speed_frequency
机组风向玫瑰分析	algorithm.windDirectionFrequencyAnalyst	WindDirectionFrequencyAnalyst	executeAnalysis	minute	wind_direction_frequency
机组风速均值分析	algorithm.windSpeedAnalyst	WindSpeedAnalyst	executeAnalysis	minute	wind_speed
功率曲线分析
机组有功功率曲线分析	algorithm.powerCurveAnalyst	PowerCurveAnalyst	executeAnalysis	minute	power_curve
机组逐月有功功率散点2D分析	algorithm.powerScatter2DAnalyst	PowerScatter2DAnalyst	executeAnalysis	minute	power_scatter_2D
机组逐月有功功率散点3D分析	algorithm.powerScatterAnalyst	PowerScatterAnalyst	executeAnalysis	minute	power_scatter
额定功率分析
机组额定功率和风速分析	algorithm.ratedPowerWindSpeedAnalyst	RatedPowerWindSpeedAnalyst	executeAnalysis	minute	rated_power_windspeed
机组额定风速分析	algorithm.ratedWindSpeedAnalyst	RatedWindSpeedAnalyst	executeAnalysis	minute	rated_windspeed
性能特性分析
机组风能利用系数和有功功率分析	algorithm.cpAnalyst	CpAnalyst	executeAnalysis	second	cp
机组风能利用系数和风速分析	algorithm.cpWindSpeedAnalyst	CpWindSpeedAnalyst	executeAnalysis	second	cp_windspeed
机组风能利用系数时序分析	algorithm.cpTrendAnalyst	CpTrendAnalyst	executeAnalysis	second	cp_trend
机组叶尖速比和有功功率分析	algorithm.tsrAnalyst	TSRAnalyst	executeAnalysis	second	tsr
机组叶尖速比和风速分析	algorithm.tsrWindSpeedAnalyst	TSRWindSpeedAnalyst	executeAnalysis	second	tsr_windspeed
机组叶尖速比时序分析	algorithm.tsrTrendAnalyst	TSRTrendAnalyst	executeAnalysis	second	tsr_trend
机组叶尖速比-Cp-功率分析	algorithm.tsrCpPowerAnalyst	TSRCpPowerAnalyst	executeAnalysis	second	tsr_cp_power
机组发电机转速和有功功率分析	algorithm.generatorSpeedPowerAnalyst	GeneratorSpeedPowerAnalyst	executeAnalysis	minute	speed_power
机组发电机转速和转矩分析	algorithm.generatorSpeedTorqueAnalyst	GeneratorSpeedTorqueAnalyst	executeAnalysis	minute	speed_torque
静态偏航误差分析
机组静态偏航误差分析	algorithm.yawErrorAnalyst	YawErrorAnalyst	executeAnalysis	second	yaw_error
变桨特性分析
机组最小桨距角分析	algorithm.minPitchAnalyst	MinPitchAnalyst	executeAnalysis	second	min_pitch
变桨-转速-转矩（功率）协调分析
机组变桨和有功功率协调性分析	algorithm.pitchPowerAnalyst	PitchPowerAnalyst	executeAnalysis	minute	pitch_power
机组变桨和发电机转速协调性分析	algorithm.pitchGeneratorSpeedAnalyst	PitchGeneratorSpeedAnalyst	executeAnalysis	minute	pitch_generator_speed
温度传感器性能分析
机组环境温度传感器分析	algorithm.temperatureEnvironmentAnalyst	TemperatureEnvironmentAnalyst	executeAnalysis	minute	temperature_environment
机组大部件温度传感器分析	algorithm.temperatureLargeComponentsAnalyst	TemperatureLargeComponentsAnalyst	executeAnalysis	minute	temperature_large_components
尚未归类的分析类型
机组变桨和叶尖速比及风能利用系数分析	algorithm.pitchTSRCpAnalyst	PitchTSRCpAnalyst	executeAnalysis	second	pitch_tsr_cp

数据契约

输入数据契约

说明

键 dataContractType 表示 数据契约类型说明
键 dataContractType.type 表示 数据契约类型，其值数据类型为字符串且非空，值 GenerationAnalysisOfTurbine 为风电机组发电分析
键 dataContractType.version 表示 数据契约类型版本，其值数据类型为字符串且非空，值 1.2.0 为 用于与风电机组发电性能分析系统集成


键 dataContract 表示 数据契约说明
键 dataContract.autoOrManual 表示 区分调用来源是自动触发，还是人工触发，其值数据类型为字符串且非空，枚举值：automatic、manual，值：automatic 表示自动触发；manual 表示人工触发；

键 dataContract.dataFilter 表示 数据筛选
键 dataContract.dataFilter.powerFarmID 表示 电场编号， 其值数据类型为字符串且非空
键 dataContract.dataFilter.turbines 表示 发电设备（风电机组等）编号信息， 其值数据类型为数组，当其值为null时分析该场站的所有机组
键 dataContract.dataFilter.beginTime 表示 数据开始时间， 其值数据类型为字符串,格式：yyyy-MM-dd hh:mm:ss 当值为null时不进行当前数据批次数据进行开始时间筛选
键 dataContract.dataFilter.beginTime 表示 数据开始时间， 其值数据类型为字符串,格式：yyyy-MM-dd hh:mm:ss 当值为null时不进行当前数据批次数据进行开始时间筛选
键 dataContract.dataFilter.endTime 表示 数据截止时间， 其值数据类型为字符串,格式：yyyy-MM-dd hh:mm:ss 当值为null时不进行当前数据批次数据进行截止时间筛选
键 dataContract.dataFilter.excludingMonths 表示 排除指定月份数据， 其值数据类型为数组,格式：yyyy-MM 当值为null时不排除指定月份数据

键 dataContract.dataFilter.customFilter 表示 自定义scada数据测点筛选， 其值数据类型为对象 ,当值为null时不进行自定义筛选
键 dataContract.dataFilter.customFilter.valueWindSpeed 表示 自定义scada数据风速测点筛选， 其值数据类型为对象 ,当值为null时不进行风速测点的自定义筛选
键 dataContract.dataFilter.customFilter.valueWindSpeed.min 表示 自定义scada数据风速测点最小值筛选， 其值数据类型为数值 ,当值为null时不进行风速测点最小值的自定义筛选
键 dataContract.dataFilter.customFilter.valueWindSpeed.max 表示 自定义scada数据风速测点最大值筛选， 其值数据类型为数值 ,当值为null时不进行风速测点最大值的自定义筛选

键 dataContract.dataFilter.customFilter.valuePitchAngle 表示 自定义scada数据桨距角测点筛选， 其值数据类型为对象 ,当值为null时不进行桨距角测点的自定义筛选
键 dataContract.dataFilter.customFilter.valuePitchAngle.min 表示 自定义scada数据桨距角测点最小值筛选， 其值数据类型为数值 ,当值为null时不进行桨距角测点最小值的自定义筛选
键 dataContract.dataFilter.customFilter.valuePitchAngle.max 表示 自定义scada数据桨距角测点最大值筛选， 其值数据类型为数值 ,当值为null时不进行桨距角测点最大值的自定义筛选

键 dataContract.dataFilter.customFilter.valueActivePower 表示 自定义scada数据有功功率测点筛选， 其值数据类型为对象 ,当值为null时不进行有功功率测点的自定义筛选
键 dataContract.dataFilter.customFilter.valueActivePower.min 表示 自定义scada数据有功功率测点最小值筛选， 其值数据类型为数值 ,当值为null时不进行有功功率测点最小值的自定义筛选
键 dataContract.dataFilter.customFilter.valueActivePower.max 表示 自定义scada数据有功功率测点最大值筛选， 其值数据类型为数值 ,当值为null时不进行有功功率测点最大值的自定义筛选

键 dataContract.dataFilter.customFilter.valueGeneratorSpeed 表示 自定义scada数据发电机转速测点筛选， 其值数据类型为对象 ,当值为null时不进行发电机转速测点的自定义筛选
键 dataContract.dataFilter.customFilter.valueGeneratorSpeed.min 表示 自定义scada数据发电机转速测点最小值筛选， 其值数据类型为数值 ,当值为null时不进行发电机转速测点最小值的自定义筛选
键 dataContract.dataFilter.customFilter.valueGeneratorSpeed.max 表示 自定义scada数据发电机转速测点最大值筛选， 其值数据类型为数值 ,当值为null时不进行发电机转速测点最大值的自定义筛选

键 dataContract.configAnalysis 表示 分析类型配置，其值数据类型为数组，且非空，至少包含一个分析类型
键 dataContract.configAnalysis[index].package 表示 分析类型的包名，其值数据类型为字符串且非空
键 dataContract.configAnalysis[index].className 表示 分析类型的类名，其值数据类型为字符串且非空
键 dataContract.configAnalysis[index].methodName 表示 分析类型的类方法名，其值数据类型为字符串且非空
键 dataContract.configAnalysis[index].scada表示 分析使用scada数据的数据源/时间粒度，其值数据类型为字符串且非空，枚举值：minute、second，值: minute 指定分析类型使用scada分钟级数据；second 指定分析类型使用scada秒级数据

键 dataContract.graphSets 表示 分析输出图形配置，其值数据类型为对象，且非空
键 dataContract.graphSets.DgeneratorSpeed 表示 直驱发电机转速轴系设置，其值数据类型为对象且非空
键 dataContract.graphSets.DgeneratorSpeed.step 表示 直驱发电机转速轴系的步长设置，其值数据类型为数值且非空，默认值： 5；
键 dataContract.graphSets.DgeneratorSpeed.min 表示 直驱发电机转速轴系的最小值设置，其值数据类型为数值且非空，默认值： 0；
键 dataContract.graphSets.DgeneratorSpeed.max 表示 直驱发电机转速轴系的最大值设置，其值数据类型为数值且非空，默认值：30；

键 dataContract.graphSets.IgeneratorSpeed 表示 非直驱发电机转速轴系设置，其值数据类型为对象且非空
键 dataContract.graphSets.IgeneratorSpeed.step 表示 非直驱发电机转速轴系的步长设置，其值数据类型为数值且非空，默认值： 200；
键 dataContract.graphSets.IgeneratorSpeed.min 表示 非直驱发电机转速轴系的最小值设置，其值数据类型为数值且非空，默认值： 1000；
键 dataContract.graphSets.IgeneratorSpeed.max 表示 非直驱发电机转速轴系的最大值设置，其值数据类型为数值且非空，默认值：2000；

键 dataContract.graphSets.DgeneratorTorque 表示 直驱发电机转矩轴系设置，其值数据类型为对象且非空
键 dataContract.graphSets.DgeneratorTorque.step 表示 直驱发电机转矩轴系的步长设置，其值数据类型为数值且非空，默认值： 10000；
键 dataContract.graphSets.DgeneratorTorque.min 表示 直驱发电机转矩轴系的最小值设置，其值数据类型为数值且非空，默认值：0；
键 dataContract.graphSets.DgeneratorTorque.max 表示 直驱发电机转矩轴系的最大值设置，其值数据类型为数值且非空，默认值：100000；

键 dataContract.graphSets.IgeneratorTorque 表示 非直驱发电机转矩轴系设置，其值数据类型为对象且非空
键 dataContract.graphSets.IgeneratorTorque.step 表示 非直驱发电机转矩轴系的步长设置，其值数据类型为数值且非空，默认值： 2000；
键 dataContract.graphSets.IgeneratorTorque.min 表示 非直驱发电机转矩轴系的最小值设置，其值数据类型为数值且非空，默认值：0；
键 dataContract.graphSets.IgeneratorTorque.max 表示 非直驱发电机转矩轴系的最大值设置，其值数据类型为数值且非空，默认值：12000；

键 dataContract.graphSets.cp 表示 风能利用系数轴系设置，其值数据类型为对象且非空
键 dataContract.graphSets.cp.step 表示 风能利用系数轴系的步长设置，其值数据类型为数值且非空，默认值： 0.5；
键 dataContract.graphSets.cp.min 表示 风能利用系数轴系的最小值设置，其值数据类型为数值且非空，默认值：0；
键 dataContract.graphSets.cp.max 表示 风能利用系数轴系的最大值设置，其值数据类型为数值且非空，默认值：2；

键 dataContract.graphSets.tsr 表示 叶尖速比轴系设置，其值数据类型为对象且非空
键 dataContract.graphSets.tsr.step 表示 叶尖速比轴系的步长设置，其值数据类型为数值且非空，默认值： 5；
键 dataContract.graphSets.tsr.min 表示 叶尖速比轴系的最小值设置，其值数据类型为数值且非空，默认值：0；
键 dataContract.graphSets.tsr.max 表示 叶尖速比轴系的最大值设置，其值数据类型为数值且非空，默认值：30；

键 dataContract.graphSets.pitchAngle 表示 桨距角轴系设置，其值数据类型为对象且非空
键 dataContract.graphSets.pitchAngle.step 表示 桨距角轴系的步长设置，其值数据类型为数值且非空，默认值： 2
键 dataContract.graphSets.pitchAngle.min 表示 桨距角轴系的最小值设置，其值数据类型为数值且非空，默认值：-1；
键 dataContract.graphSets.pitchAngle.max 表示 桨距角轴系的最大值设置，其值数据类型为数值且非空，默认值：20；

键 dataContract.graphSets.activePower 表示 有功功率轴系设置，其值数据类型为对象且非空
键 dataContract.graphSets.activePower.step 表示 有功功率轴系的步长设置，其值数据类型为数值且非空，默认值： 250；
键 dataContract.graphSets.activePower.min 表示 发有功功率轴系的最小值设置，其值数据类型为数值且非空，默认值：0；
键 dataContract.graphSets.activePower.max 表示 有功功率轴系的最大值设置，其值数据类型为数值且非空，默认值：额定功率*1.2；

#### 示例：

```
{
    "dataContractType": {
        "type": "analysisExecuteOrder",
        "version": "1.2.0"
    },
    "dataContract": {
        "autoOrManual":"automatic",
        "dataFilter": {
            "powerFarmID": "010-00001",
            "turbines": [
                "010-00001-0001",
                "010-00001-0002"
            ],
            "dataBatchNum": "B2024042211-0",
            "beginTime": "2023-01-01 00:00:00",
            "endTime": "2023-12-31 23:59:59",
            "excludingMonths": [
                "2023-12",
                "2023-09"
            ],
            "customFilter": {
                "valueWindSpeed": {
                    "min": 3.0,
                    "max": 25.0
                },
                "valuePitchAngle": {
                    "min": 2,
                    "max": null
                },
                "valueActivePower": {
                    "min": 10,
                    "max": 2500
                },
                "valueGeneratorSpeed": {
                    "min": 10,
                    "max": 2500
                }
            }
        },
        "configAnalysis": [
            {
                "package": "algorithm.powerCurveAnalyst",
                "className": "PowerCurveAnalyst",
                "methodName": "executeAnalysis",
                "scada":"minute"
            },
            {
                "package": "algorithm.powerScatter2DAnalyst",
                "className": "PowerScatter2DAnayst",
                "methodName": "executeAnalysis",
                "scada":"minute"
            },
            {
                "package": "algorithm.windSpeedFrequencyAnalyst",
                "className": "WindSpeedFrequencyAnalyst",
                "methodName": "executeAnalysis",
                "scada":"minute"
            },
            {
                "package": "algorithm.generatorSpeedPowerAnalyst",
                "className": "GeneratorSpeedPowerAnalyst",
                "methodName": "executeAnalysis",
                "scada":"minute"
            }
    ],
    "graphSets": {
        "DgeneratorSpeed": {
            "step": 5,
            "min": 0,
            "max": 30
        },
        "DgeneratorTorque": {
            "step": 10000,
            "min": 0,
            "max": 100000
        },

        "IgeneratorSpeed": {
            "step": 200,
            "min": 1000,
            "max": 2000
        },
        "IgeneratorTorque": {
            "step": 2000,
            "min": 0,
            "max": 12000
        },
        "cp": {
            "step": 0.5,
            "min": 0,
            "max": 2
        },
        "tsr": {
            "step": 5,
            "min": 0,
            "max": 30
        },
        "pitchAngle": {
            "step": 1,
            "min": -1,
            "max": 20
        },
        "activePower": {
            "step": 250,
            "min": 0,
            "max": 2000
        }
    }
}

}

```

返回数据锲约