SuperAPI AI 工具集

jinko-vpop

设计与创作

查看项目

更新于 10-16 07:23

技能介绍

用途:该技能用于通过 jinko-sdk 进行技术性的 vpop 与 vpop 设计工作流,包括创建、上传、生成和检查 Jinkō 虚拟人群。

前提条件:需要已初始化的 jinko-sdk 连接,且 SDK 版本满足其 metadata.requires_sdk 范围。须先运行 jinko-sdk-setup 技能并通过其检查;会话码只能交换一次,调用本技能自身 SDK 进程前需重新调用 get_session_code。若未找到该技能,可从 novainsilico/jinko-skills 安装。

主要能力与用法:直接上传 vpop 用 client.create_vpop_from_csv() 或 client.create_vpop_from_dataframe();边际分布设计用 client.create_vpop_design_from_design();用 design.generate_vpop() 从 VpopDesign 生成不可变 Vpop。生成前检查 design.diagnostics 或 design.get_sanity(),先修复报告的错误。编辑现有设计的描述符与相关性通过 design.descriptors 与 design.correlations,而非替换原始载荷。

核心规则:Vpop 项目条目属生成/上传的产物,不能就地编辑;应编辑 vpop 设计再重新生成新 vpop。创建或更新项目条目需显式确认或脚本 --apply。CSV 表头与边际设计中的描述符 ID 在用于某模型时必须匹配真实的模型组件 ID;边际列表中的重复描述符 ID 会被拒绝。

项目文件夹:建议在专用 Jinkō 文件夹而非项目根目录中创建 vpop 与设计,开始时询问或提议形如 YYYY-MM-DD-<experiment-name> 的文件夹名;可复用精确匹配的已有文件夹 client.get_folder_by_name(name, exact_match_only=True);不存在时仅在用户确认或脚本带 --apply 时创建;解析出文件夹对象或 ID 后传 folder=folder。

随附资源:assets/toy_vpop.csv、assets/toy_marginals.json、assets/distrib.json(允许的边际分布形状的权威来源)。SDK 脚本以控制台脚本形式位于 PATH,也可用 python -m 运行,包括 jinko.cli.create_vpop_from_csv、jinko.cli.create_vpop_design_from_design、jinko.cli.inspect_vpop、jinko.cli.edit_vpop_design。

CSV 最小形状为每患者一行,例如 patientIndex,Dose,k_elim。边际设计使用 {"id": ..., "distribution": ...} 列表,脚本会转换为 SDK 所需的映射。

对数刻度分布注意:LogUniform 的 lowBound/highBound 是以 base 为底的指数;LogNormal 与 LogNormalTruncated 的 mean/stdev 是值对数的均值与标准差;LogNormalTruncated 的 posLowBound/posHighBound 直接限制值本身。将以值刻度传入对数参数可能生成错误数量级的 Vpop 且无诊断报错,生成后应先用 python -m jinko.cli.inspect_vpop --vpop-sid vp-... --statistics 读回统计。

限制:收费、价格与平台等细节暂未提供;分布设计应保持最小化,更深设计交由专门的分布技能。