@math-pro/statistics

统计分析工具，提供均值、中位数、方差、标准差等描述性统计指标，以及数据分布可视化。

安装

npm install @math-pro/statistics
# or
pnpm add @math-pro/statistics

Peer Dependencies: react >= 18, react-dom >= 18

使用

组件

import { Statistics } from '@math-pro/statistics'

function App() {
  return (
    <Statistics
      data={[
        { values: [2, 4, 4, 4, 5, 5, 7, 9], label: '数据集 A' },
        { values: [1, 3, 5, 7, 9],           label: '数据集 B' },
      ]}
    />
  )
}

Hook

import { useStatistics, Statistics } from '@math-pro/statistics'

function App() {
  const { data, setData, summary } = useStatistics([
    { values: [2, 4, 4, 4, 5, 5, 7, 9], label: '示例' },
  ])

  return (
    <>
      <Statistics data={data} />
      {summary && (
        <ul>
          <li>均值：{summary.mean.toFixed(2)}</li>
          <li>中位数：{summary.median}</li>
          <li>标准差：{summary.stdDev.toFixed(2)}</li>
        </ul>
      )}
    </>
  )
}

API

<Statistics />

| Prop | 类型 | 说明 | |------|------|------| | data | DataSet[] | 数据集列表 | | className | string | 自定义 CSS 类名 |

DataSet

| 字段 | 类型 | 说明 | |------|------|------| | values | number[] | 数值数组 | | label | string | 数据集名称（可选） |

StatsSummary

| 字段 | 类型 | 说明 | |------|------|------| | mean | number | 均值 | | median | number | 中位数 | | mode | number[] | 众数 | | variance | number | 方差 | | stdDev | number | 标准差 | | min | number | 最小值 | | max | number | 最大值 | | count | number | 数据个数 |

useStatistics(initialData?)

返回值：

| 字段 | 类型 | 说明 | |------|------|------| | data | DataSet[] | 当前数据集 | | setData | (data: DataSet[]) => void | 更新数据集 | | summary | StatsSummary \| null | 汇总统计（数据为空时为 null） |

开发

# 构建
pnpm build

# 监听模式
pnpm build:watch

# 类型检查
pnpm typecheck