跳到主要内容

实体统计

图标​

EntityStatistics_image1.png

功能​

按指定方法统计关于实体属性的自定义表达式指标

例子
  • 可以统计一个用户群体的平均财富（财富值是该Agent的个体属性）
  • 可以统计一个交易者群体个体收益率中位数，个体利润率 = 个体当前收益（个体属性） / 个体当前成本（个体属性）

工作机制​

  • 组件需要指定统计对象实体、计算指标和统计方法
  • 系统先按表达式计算每个实体的指标，然后使用指定的统计方法汇总每个个体的指标，最终得到统计结果
  • 统计值可以设置多个，每个统计值都如上机制工作

设置方法​

EntityStatistics_image1+1.png

统计对象​

EntityStatistics_image1+2.png

  • 每次点击添加统计目标按钮，会新增一行表达式输入框
  • 输入框要求填写返回值格式为[Entity]的表达式
  • 系统在统计时会考虑所有表达式行所指定的统计对象

统计值​

EntityStatistics_image1+3.png

  • 新增统计值

    点击添加统计值，会新增一个统计值单元如上图

  • 局部关键字

    系统默认Entity作为统计目标的局部关键字，用于后续的实体属性统计指标表达式，也可以更改

  • 定义计算指标

    输入栏要求填写能返回Number的表达式，且应关于实体属性（即由"Entity.property_name"构造的）

    EntityStatistics_image4.png

  • 统计值命名

    输入的命名内容将会以String格式作为将来访问统计组件输出的键，即将以"statistics_component_name.key_name"进行访问

    EntityStatistics_image5.png

  • 选择统计方法

    下拉菜单选择，系统以此方法计算汇总所有对象的计算指标

    EntityStatistics_image6.png

    • Max：取最大值
    • Min：取最小值
    • Avg：取平均值
    • Median：取中位数
    • StdDeV：取标准差
    • Sum：取和
    • Count：计数，多个相同值仅计数1次

组件输出数据​

  • 输出的各个统计值，格式为Number
  • 访问统计结果
    • 流程后续组件可以"statistics_component_name.statictics_value_name"的方式访问
    • 本组件的动作后计算也可以使用"This.statictics_value_name"的方式访问

案例​

模型案例

3个交易者分别以本金1000、2000、3000交易后，当前资产变为1100、1800、3600，统计他们的平均收益率为6.67%，个体收益率 = 当前资产 / 本金 -1