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

• 1. 计算程序 - 模板格式定义
  • 1.1. 修订记录
  • 1.2. 文档说明
  • 1.3. 概念介绍
    • 1.3.1. 统计对象
    • 1.3.2. 统计方法
    • 1.3.3. 统计区间
  • 1.4. 示例
  • 1.5. 参数说明
    • 1.5.1. connector
    • 1.5.2. source
    • 1.5.3. track
    • 1.5.4. statistics_id
    • 1.5.5. statos_name
    • 1.5.6. name
    • 1.5.7. result
      • 1.5.7.1. precision
      • 1.5.7.2. expr
    • 1.5.8. type
    • 1.5.9. 注意

1.1. 修订记录

1.2. 文档说明

本文档适用于 statistics_keeper V2.2.0版本

1.3. 概念介绍

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

1.3.1. 统计对象

统计的结果

1.3.2. 统计方法

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

1.3.3. 统计区间

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

1.4. 示例

{
    "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.5. 参数说明

1.5.1. connector

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

1.5.2. source

• ST(STATOS):定义计算程序依赖的统计程序的统计id(statisticsID),格式参见统计版本样例
• CO(COLLECTOS):定义计算统计依赖的离线数据,格式参见统计版本样例
• ST_CD: 指明source源的数据来自 admin_statos_current_day 数据表,格式同ST
• ST_CM: 指明source源的数据来自 admin_statos_current_month 数据表,格式同ST
• ST_CY: 指明source源的数据来自 admin_statos_current_year 数据表,格式同ST

1.5.3. track

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

1.5.4. statistics_id

统计程序的统计ID。

1.5.5. statos_name

统计程序的名称。

1.5.6. name

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

1.5.7. result

1.5.7.1. precision

统计结果的精度

1.5.7.2. expr

1. 表达式，计算的表达式，针对source块里面定义的值的表达式。
2. 支持四则运算。
3. 不支持函数。

4. 示例:

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

1.5.8. type

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

1.5.9. 注意

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