1. 计算程序 - 模板格式定义

1.1. 概念介绍

计算程序是指对统计程序的统计结果进行再运算（四则运算）的统计程序。

1.1.1. 统计对象

统计的结果。

1.1.2. 统计方法

四则运算 +,-,*,/。

1.1.3. 统计区间

统计区间使用统计程序的统计区间。

1.2. 格式定义

示例

{
    "connector": {
        "MYSQL": {
            "host": "127.0.0.1:3306"
        }
    },
    "track": true,
    "source": {
        "CO": {
            "object": [
                "BoilerSteamCoefficient;collectos_id = 'BoilerSteamCoefficient'",
                "CalorificValueOfFuel;collectos_id = 'CalorificValueOfFuel'"
            ]
        },
        "ST": {
            "object": [
                "FuelConsumption;statistics_id = 'FuelConsumption'",
                "VapourProduction;statistics_id = 'VapourProduction'"
            ]
        }
    },
    "result": {
        "expr": "VapourProduction / FuelConsumption * BoilerSteamCoefficient/CalorificValueOfFuel ",
        "precision": 3
    },
    "statistics_id": "ThermalEfficiency",
    "statos_name": "热效率",
    "description": "热效率的统计",
    "name": "ThermalEfficiency",
    "type": "calculate"
}

1.3. 参数说明

1.3.1. connector

• MYSQL:
  • 定义连接MYSQL的参数，格式:ip:port,用作将计算结果写入数据库。

1.3.2. source

• ST(STATOS):定义计算程序依赖的统计程序的统计id(statisticsID),格式参见统计版本样例
• CO(COLLECTOS):定义计算统计依赖的离线数据,格式参见统计版本样例
• STCD:指明source源的数据来自 _admin_statos_current_day 数据表,格式同ST
• STCM:指明source源的数据来自 _admin_statos_current_month 数据表,格式同ST
• STCY:指明source源的数据来自 _admin_statos_current_year 数据表,格式同ST

1.3.3. track

调试开关,开启之后程序会打印更多的信息。

1.3.4. statistics_id

统计程序的统计ID。

1.3.5. statos_name

统计程序的名称。

1.3.6. name

统计程序可执行文件的名称。

1.3.7. result

1.3.7.1. precision

统计结果的精度

1.3.7.2. expr

• 表达式，计算的表达式，针对source块里面定义的值的表达式。
• 支持四则运算。
• 不支持函数。
• 示例:

"expr":"totalCumulativeActivePower / CumulativeFlow" // 支持
"expr":"A + B - C"  // 支持
"expr":"max(A + B)" // 不支持

1.3.8. type

标识这个统计脚本是用于统计还是计算 type的值有 statistics,calculate;statistics用于统计,calculate用于计算。

1.4. 注意

• 如果要单独执行统计程序要将statistics_id,statos_name,name 写入到parmas的json块，并且把params保存为json文件。