---

name: "QC3_NumericDataThresholdCheck" description: "数值数据阈值检验工具。读取结构化数据文件（CSV、TSV、Excel等），检查数值字段是否在指定的门限范围内，不允许超出门限值之外，最后输出为同格式的文件。当用户需要对数据进行阈值检验、数值范围检查、数据质量控制等操作时使用此skill。"

name_zh: QC3_数值数据阈值检验算子 input_params:

• name: input_path type: string required: true description: 输入文件路径

• name: origin_output_path type: string required: true description: 输出文件路径（与输入文件格式相同）

• name: field_name type: string required: true description: 要检查的字段名

• name: max_value type: float required: true description: 最大值

• name: min_value type: float required: true description: 最小值

• name: qc_mark type: string required: true description: QC标记

• name: error_output_path type: string required: false description: 错误数据输出文件路径

• name: additional_condition type: string required: false description: 额外条件

• name: mark_field_name type: string required: false default: QC0000 description: 标记字段名

• name: id_field_name type: string required: false default: ID0000 description: ID字段名

output_params:

• name: origin_output_path type: csv_file description: 阈值检验后的结构化数据文件，带质控标记

• name: error_output_path type: csv_file description: 错误数据文件（可选），包含超出阈值范围的记录 tag: 数据校验 publisher: COMMUNITY

---

QC3_NumericDataThresholdCheck

功能说明

该skill提供数值数据阈值检验的能力，具体包括：

1. 读取结构化文件：支持 CSV、TSV、Excel 等多种格式的结构化数据文件
2. 数值阈值检验：将被检验表中的属性项值与门限比对，检查是否在门限范围
3. 输出结果：将检验后的数据输出为同格式的文件

核心功能

1. 数值数据阈值检验

通过执行 QC3_NumericDataThresholdCheck.py 脚本，读取输入文件，检查数值字段是否在指定的阈值范围内，并输出处理后的文件。

调用方式：

python scripts/QC3_NumericDataThresholdCheck.py --input_path <输入文件路径> --origin_output_path <输出文件路径> --field_name <字段名> --max_value <最大值> --min_value <最小值> --qc_mark <QC标记>

参数说明：

• --input_path：必填，输入文件路径（支持 CSV、TSV、Excel 等格式）
• --origin_output_path：必填，输出文件路径（与输入文件格式相同）
• --error_output_path：可选，错误数据输出文件路径
• --field_name：必填，要检查的字段名
• --max_value：必填，最大值
• --min_value：必填，最小值
• --additional_condition：可选，额外条件
• --qc_mark：必填，QC标记
• --mark_field_name：可选，标记字段名
• --id_field_name：可选，ID字段名

使用示例：

# 检查 DBH 字段在 0-100 之间
python scripts/QC3_NumericDataThresholdCheck.py --input_path data.csv --origin_output_path output.csv --field_name DBH --max_value 100 --min_value 0 --qc_mark "DBH阈值检验"

脚本说明

QC3_NumericDataThresholdCheck.py

• 功能：数值数据阈值检验的核心逻辑
• 调用接口：通过命令行参数接收输入输出路径和阈值配置
• 特性：
  • 支持多种结构化文件格式
  • 灵活的阈值配置
  • 保留原始数据格式
  • 详细的检验结果输出

data_io.py

• 功能：结构化文件读写工具
• 支持格式：CSV、TSV、Excel、SPSS
• 特性：
  • 自动检测文件编码
  • 多编码重试机制
  • 智能处理不同文件格式

注意事项

1. 确保输入文件存在且格式正确
2. 阈值配置格式必须为 字段名:最小值-最大值，多个字段用逗号分隔
3. 输出路径需要有写入权限
4. 脚本在用户本地执行，依赖 Python 环境
5. 支持 Windows 和 Linux 系统

依赖

• Python 3.x
• pandas 库
• chardet 库（用于自动检测文件编码）
• openpyxl 库（用于 Excel 文件处理）
• xlrd 库（用于旧版 Excel 文件处理）
• pyreadstat 库（用于 SPSS 文件处理）