Upset Plot Converter — Upset Plot 轉換器

Upset Plot Converter 将复杂的维恩图（超过4个集合）转换为更清晰的Upset Plots。

何时使用 当任务是将复杂的维恩图（超过4个集合）转换为更清晰的Upset时，使用此技能。对于需要显式假设、有界范围和可复制输出格式的数据分析任务，使用此技能。当您需要为缺失输入、执行错误或部分证据记录备用路径时，使用此技能。

主要特征 范围专注的工作流程与以下内容对齐：将复杂的维恩图（超过4个集合）转换为更清晰的Upset。打包的可执行路径：scripts/main.py。结构化的执行路径旨在保持输出的一致性和可审查性。

依赖项 请参阅上面的## Prerequisites以获取相关详细信息。 Python：3.10+。存储库基线用于当前打包的技能。 matplotlib：未指定。在requirements.txt中声明。 numpy：未指定。在requirements.txt中声明。

示例用法 请参阅上面的## Usage以获取相关详细信息。 cd "20260318/scientific-skills/Data Analytics/upset-plot-converter" python -m py_compile scripts/main.py python scripts/main.py --help 示例运行计划：确认用户输入、输出路径和任何必需的配置值。编辑文件中的CONFIG块或记录的参数（如果脚本使用固定设置）。运行python scripts/main.py并验证输入。审查生成的输出并返回最终工件，同时调用任何假设。

实现细节 请参阅上面的## Workflow以获取相关详细信息。 执行模型：验证请求、选择打包的工作流程并生成有界的可交付成果。输入控制：在运行任何脚本之前，确认源文件、范围限制、输出格式和接受标准。主要实现表面：scripts/main.py。首先要澄清的参数：输入路径、输出路径、范围过滤器、阈值和任何特定于域的约束。输出学科：保持结果可复制，明确识别假设，避免未记录的副作用。

快速检查 使用以下命令验证打包的脚本入口点可以在更深入的执行之前被解析。 python -m py_compile scripts/main.py

审计准备命令 使用这些具体命令进行验证。它们是故意自包含的，避免占位符路径。 python -m py_compile scripts/main.py python scripts/main.py

工作流程 在进行详细工作之前，确认用户目标、必需输入和不可协商的约束。验证请求是否与记录的范围匹配，如果任务需要不支持的假设，请提前停止。使用打包的脚本路径或仅使用实际可用的输入的记录推理路径。返回一个结构化的结果，该结果将假设、可交付成果、风险和未解决的项目分开。如果执行失败或输入不完整，请切换到备用路径并声明阻止完全完成的内容。

用法 from skills.upset_plot_converter.scripts.main import convert_venn_to_upset # 从集合数据 sets = { 'A': {1, 2, 3, 4, 5}, 'B': {4, 5, 6, 7, 8}, 'C': {3, 5, 7, 9, 10}, 'D': {2, 4, 6, 8, 10}, 'E': {1, 3, 5, 7, 9} } convert_venn_to_upset(sets, output_path="upset_plot.png") # 从列表数据 from skills.upset_plot_converter.scripts.main import upset_from_lists set_names = ['Genes A', 'Genes B', 'Genes C', 'Genes D', 'Genes E'] lists = [ ['gene1', 'gene2', 'gene3'], ['gene2', 'gene4', 'gene5'], ['gene3', 'gene5', 'gene6'], ['gene7', 'gene8', 'gene9'], ['gene1', 'gene10', 'gene11'] ] upset_from_lists(set_names, lists, output_path="gene_upset.png", title="Gene Intersections")

输入集： 字典：集合名称到集合/列表的元素 或 set_names：集合名称列表 lists：列表（每个包含元素） output_path：保存输出图像的路径 title：可选的图表标题 min_subset_size：要显示的最小子集大小（默认：1） max_intersections：要显示的最大交集数（默认：30）

输出 Upset Plot可视化的PNG文件。

注意 当维恩图超过4个集合时，它们变得难以阅读 Upset Plots提供了一个更清晰的替代方案来可视化集合交集 x轴显示集合交集作为点模式 条形高度表示每个交集的大小 自动按大小对交集进行排序以提高可读性

要求 matplotlib numpy pandas

风险评估 风险指标 评估级别 代码执行 Python/R脚本在本地执行 中等 网络访问 无外部API调用 低 文件系统访问 读取输入文件，写入输出文件 中等 指令篡改 标准提示指南 低 数据暴露 输出文件保存到工作空间 低 安全检查清单 无硬编码凭据或API密钥 无未经授权的文件系统访问（../） 输出不暴露敏感信息 提示注入保护已启用 输入文件路径已验证（无../遍历） 输出目录限制为工作空间