qc3-numericdatathresholdcheck

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 环境