SuperAPI AI 工具集

jk-data-table

数据与分析

查看项目

更新于 10-16 02:32

技能介绍

用途:通过 jinko-sdk 处理 Jinkō 数据表,用于试验叠加(trial overlays)或校准目标(calibration objectives)。行模式相同,适应度函数兼容性在元数据可用时报告。

主要能力:使用 client.create_data_table_from_csv() 处理 CSV 文件或字节;client.create_data_table_from_sqlite() 处理 SQLite 文件或字节;client.create_data_table_from_dataframe() 处理 pandas DataFrame。用 get_data_table()、content()、summary()、validate()、export() 检查已有数据表。创建或检查后,若数据表需通过 trial/calibration 的 dataTableDesigns 附加,检查 metadata.public.validForFitnessFunction。通过 jk-trial 附加数据表的试验流程需 validForFitnessFunction: True;点值叠加表可能上传成功但试验启动校验失败。

使用方式:建议在专用 Jinkō 文件夹内创建数据表,而非项目根目录。开始时询问或提议文件夹名,如 YYYY-MM-DD-<experiment-name>。优先复用精确匹配的已有文件夹:client.folders.get_by_name(name, exact_match_only=True)。若不存在,仅在用户确认或脚本以 --apply 运行时创建。解析出文件夹对象或 id 后,传给支持 folder 参数的 SDK 创建调用。修改 CSV 结构前先读 assets/data-table.json。支持点值行(obsId、time、value,可选 unit、armScope、ranges、weight、reference)和范围行(obsId、time、narrowRangeLowBound、narrowRangeHighBound,可选 unit、armScope、wide ranges、weight、reference)。time 使用 ISO-8601 时长字符串,如 PT0S、PT6H、P1D。

脚本示例:python skills/jk-data-table/scripts/create_data_table.py --source skills/jk-data-table/assets/toy_data_table_ranges.csv --method csv;加 --apply 执行创建;加 --folder 2026-06-15-fit-data --create-folder --apply 指定文件夹。检查:python skills/jk-data-table/scripts/inspect_data_table.py --data-table-sid dt-... --fitness --validate。

限制:资料未提供收费、价格、平台支持范围等细节。