SuperAPI AI 工具集

jinko-trial-viz

数据与分析

查看项目

更新于 10-16 07:23

技能介绍

用途:管理 Jinkō TrialVisualization 项目项,包括为试验创建可视化、配置图表分区、获取已存可视化内容以及运行可视化 sanity 检查。试验执行、结果下载和计算图表数据(trial.results.aggregate_*)仍由 jinko-trial 负责,不要仅为读取数据而创建可视化。

前提:需要已初始化的 jinko-sdk 连接,且 SDK 满足其 metadata.requires_sdk 范围。先运行 jinko-sdk-setup 技能(../jinko-sdk-setup/SKILL.md),检查通过后再继续。会话码只能交换一次,因此在本技能自身 SDK 进程前需再次调用 get_session_code。若未找到该技能,可从 novainsilico/jinko-skills 安装。

核心流程:解析试验 trial = client.get_trial(trial_sid);经用户明确确认后创建绑定试验的空可视化 viz = trial.create_empty_trial_visualization(folder=..., name=..., description=...);按需配置分区,如 viz.timeseries、viz.scalars、viz.scatter_plots、viz.survival_analysis、viz.contribution_analysis、viz.data_overlay / viz.patients_overlay、viz.filters / viz.groups,以及 viz.set_selected_arms(...)、viz.set_equate_baseline(...)、viz.set_time_unit(...) 等顶层选项。每次创建或更新后运行并打印 viz.sanity,报错则返回并修复。可随时再次调用分区 setter 重新配置,每次调用只修补该分区。

SDK 接口:trial.create_empty_trial_visualization(...) 与 trial.create_trial_visualization_from_json(...);client.list_trial_visualizations(...)、client.iter_trial_visualizations(...)、client.get_trial_visualization(sid);viz.content(revision=...)、viz.sanity / viz.sanity_at(revision, only=[...])。各分区子服务提供 get()/clear() 及专属 setter。完整示例见 references/trial-viz-typed-api.md。

脚本用法:安装 SDK 后可通过 PATH 控制台脚本或 python -m 运行,例如: python -m jinko.cli.trial_viz list --limit 20 python -m jinko.cli.trial_viz create --trial-sid tr-... --name "My trial viz" --timeseries Drug --scalar AUC python -m jinko.cli.trial_viz get --trial-viz-sid tv-... --output-file viz.content.json python -m jinko.cli.trial_viz sanity --trial-viz-sid tv-... --only timeseries --only scatterPlots 超出脚本标志的散点、叠加、过滤或分组配置,需在 Python 中直接使用类型化子服务。

文件夹规范:优先在试验同文件夹或专用分析文件夹中创建;通过 --folder 或 folder= 传入文件夹 id 或精确名称;无法解析的显式文件夹应视为错误,不得静默创建到项目根目录;同一分析追加图表时应复用已有可视化,调用相应分区 setter 而非重复创建。

输出期望:创建或修改时报告 TrialVisualization SID、核心项 id、快照 id、可用时的 revision 与 URL、创建或修补的分区、以及 sanity 错误或警告(保留后端字段名);获取时按需返回或保存完整 JSON 内容。限制:资料未提供收费、价格、平台支持范围等更多信息。