用途:通过 jinko-sdk 处理 Jinkō 虚拟人群(vpop)与 vpop 设计的技术工作流,包括上传、生成、检查与编辑设计。
主要能力:client.create_vpop_from_csv() 或 client.create_vpop_from_dataframe() 直接上传 vpop;client.create_vpop_generator_from_design() 创建边际分布 vpop 设计;vpop_generator.generate_vpop_by_design() 由设计生成不可变 Vpop。生成的 vpop 视为产物,不原地编辑,应改设计后重新生成。
使用方式:优先使用脚本而非在对话中嵌入长 Python 示例。scripts/create_vpop_from_csv.py 上传 CSV(--method dataframe 走 pandas);scripts/create_vpop_generator_from_design.py 由 {id, distribution} 列表创建设计并可 --generate;scripts/inspect_vpop.py 检查内容、描述或统计;scripts/edit_vpop_generator_design.py 替换设计中的边际分布列表。示例:python skills/jk-vpop/scripts/create_vpop_from_csv.py --csv skills/jk-vpop/assets/toy_vpop.csv --apply。创建或更新项目项需显式确认或脚本加 --apply。
项目文件夹:建议在专用 Jinkō 文件夹内创建,而非项目根目录;可先询问或提议名称如 YYYY-MM-DD-<experiment-name>,用 client.folders.get_by_name(name, exact_match_only=True) 复用,不存在时经确认或 --apply 再创建,并将 folder=folder 传入支持的创建调用。
数据格式:CSV 每行一个患者,表头使用真实模型组件 ID(如 Dose、k_elim),而非年龄、体重等生物标签;边际设计为 {id, distribution} 列表,分布形状以 assets/distrib.json 为准。
限制:分布指导保持最小化,深入分布设计交由专门技能;描述符 ID 必须与真实模型组件 ID 匹配;未提供收费、平台与效果信息。