使用计算器风格求和寄存器进行统计

计算器风格求和寄存器(x, y)对列表的统计信息。

内容

• 使用计算器风格求和寄存器进行统计
  • 为什么使用这个包？
  • 示例
    • 平均值和标准差
    • 线性回归 & 相关系数
    • 峰值分析：x加权y的质心和宽度
  • 安装
  • 关于

为什么使用这个包？

当(x, y)对以序列形式呈现时，例如来自控制系统，使用此包来获取(x, y)对列表的摘要统计信息。不需要在内存中保留整个列表，此包将保留计算所有分析结果所需的累积值。

没有对添加包（如numpy或scipy）的外部依赖。仅使用Python标准库中的math包。

可以随时从求和寄存器中计算统计信息。

$(x, y)$ 值可以以任何顺序输入。没有必要对它们进行排序。

示例

In [1]: import pysumreg

In [2]: reg = pysumreg.SummationRegisters()

平均值和标准差

In [3]: reg.clear()
   ...: reg.add(1, -1)
   ...: reg.add(2, -2)
   ...: reg.add(3, -3)
   ...: print(f"{reg.mean_x=}")
   ...: print(f"{reg.stddev_x=}")
   ...: print(f"{reg.mean_y=}")
   ...: print(f"{reg.stddev_y=}")
   ...: print(f"{reg.min_x=}")
   ...: print(f"{reg.max_x=}")
   ...: print(f"{reg.min_y=}")
   ...: print(f"{reg.max_y=}")
   ...: print(f"{reg.x_at_max_y=}")
   ...: print(f"{reg.x_at_min_y=}")
   ...: 
reg.mean_x=2.0
reg.stddev_x=1.0
reg.mean_y=-2.0
reg.stddev_y=1.0
reg.min_x=1
reg.max_x=3
reg.min_y=-3
reg.max_y=-1
reg.x_at_max_y=1
reg.x_at_min_y=3

线性回归 & 相关系数

In [4]: reg.clear()
   ...: reg.add(1, -1)
   ...: reg.add(2, -2)
   ...: reg.add(3, -3)
   ...: print(f"{reg.correlation=}")
   ...: print(f"{reg.intercept=}")
   ...: print(f"{reg.slope=}")
   ...: 
reg.correlation=-1.0
reg.intercept=0.0
reg.slope=-1.0

峰值分析：x加权y的质心和宽度

In [5]: reg.clear()
   ...: reg.add(1, 0)
   ...: reg.add(2, 1)
   ...: reg.add(3, 0)
   ...: print(f"{reg.max_y=}")
   ...: print(f"{reg.centroid=}")
   ...: print(f"{reg.sigma=}")
   ...: 
reg.max_y=1
reg.centroid=2.0
reg.sigma=0.0

In [6]: reg.add(1.5, 0.5)
   ...: reg.add(2.5, 0.5)
   ...: print(f"{reg.max_y=}")
   ...: print(f"{reg.centroid=}")
   ...: print(f"{reg.sigma=}")
   ...: 
reg.max_y=1
reg.centroid=2.0
reg.sigma=0.3535533905932738

安装

可以使用以下任何命令安装此软件包

• pip install pysumreg
• conda install -c conda-forge pysumreg
• mamba install -c conda-forge pysumreg
• micromamba install -c conda-forge pysumreg

关于

版本	PyPI	Conda-forge	平台

Python	单元测试	代码覆盖率

• 文档：https://prjemian.github.io/pysumreg/latest
• 源代码：https://github.com/prjemian/pysumreg