# 程序文档教程 - [用户手册](https://docs.ihep.ac.cn/link/AA1DE9EC81CB7049B185CB1AA30FF01F25) - [介绍报告](https://docs.ihep.ac.cn/link/AAC492D66A53C94DB9A5559CABABD2D828) - [使用教程](https://www.bilibili.com/video/BV1e77j62Ewt/?spm_id_from=333.1387.homepage.video_card.click&vd_source=752a33a845dc197d2672a4790fc6a4cc) # 环境配置指南 **前提要求**:ROOT 框架已安装并配置完成。 本文档详细描述了从 GitLab 克隆项目后,如何配置运行环境。 ## 目录 1. [克隆项目](#1-克隆项目) 2. [安装依赖](#2-安装依赖) 3. [运行GUI](#3-运行-gui) 4. [可选配置](#4-可选配置) 5. [故障排除](#5-故障排除) 6. [支持的平台](#6-支持的平台) --- ## 1. 克隆项目 ```bash git clone
cd
``` --- ## 2. 安装依赖 ### 2.1 检查 ROOT 环境(确认已配置) ```bash # 验证 ROOT 是否正确配置 root --version ``` 如果未配置 ROOT,请先执行: ```bash source /path/to/root/bin/thisroot.sh ``` ### 2.2 Python 环境 ```bash # 确保 Python 3.8+ 已安装 python3 --version ``` 如果 Python 未安装,请先执行安装: ```bash sudo apt-get update # Ubuntu/Debian sudo apt-get install python3 python3-pip # Ubuntu/Debian #或 brew install python # macOS ``` 安装 Tkinter(用于 GUI): ```bash sudo apt-get install python3-tk # Ubuntu/Debian # 或 brew install python-tk # macOS ``` ### 2.3 CMake ```bash sudo apt-get install cmake # Ubuntu/Debian # 或 brew install cmake # macOS # 验证安装 cmake --version ``` ### 2.4 编译器 ```bash sudo apt-get install build-essential # Ubuntu/Debian # 或 xcode-select --install # macOS # 验证安装 gcc --version g++ --version ``` --- ## 3. 运行 GUI ```bash python3 program_gui.py ``` --- ## 4. 可选配置 ### 4.1 ROOT 环境变量持久化 如果每次启动终端都需要手动配置 ROOT,可以将其添加到 `~/.bashrc`: ```bash echo "source /path/to/root/bin/thisroot.sh" >> ~/.bashrc source ~/.bashrc ``` ### 4.2 配置文件 运行 GUI 后点击 "save config" ,会自动生成 `unfolding_config.json` 配置文件,可根据需要修改默认参数; 如果 `unfolding_config.json` 文件存在,运行 GUI 会自动加载其参数配置。 如果 `unfolding_config.json` 文件不存在,运行 GUI 保持默认参数配置。 --- ## 5. 故障排除 ### 问题1:GUI 无法启动 - Tkinter 错误 ```bash # 安装 Tkinter sudo apt-get install python3-tk # Ubuntu/Debian brew install python-tk # macOS ``` ### 问题2:编译失败 - 缺少依赖 ```bash sudo apt-get install libgsl-dev libfftw3-dev # Ubuntu/Debian ``` ### 问题3:缺少共享库 ```bash # 更新库缓存 ldconfig # 或者设置 LD_LIBRARY_PATH export LD_LIBRARY_PATH=/path/to/root/lib:$LD_LIBRARY_PATH ``` ### 问题4:ROOT 命令未找到 ```bash # 确保正确设置 ROOT 环境变量 source /path/to/root/bin/thisroot.sh ``` --- ## 6. 支持的平台 | 平台 | 状态 | 说明 | |------|------|------| | Linux (Ubuntu/Debian) | ✅ 支持 | 推荐使用 | | macOS | ✅ 支持 | 使用 Homebrew 安装依赖 | | Windows | ⚠️ 有限支持 | 建议使用 WSL | ### macOS 配置说明 ```bash # 使用 Homebrew 安装依赖 brew install python-tk brew install cmake ``` ### Windows 配置说明 建议使用 **Windows Subsystem for Linux (WSL)**: 1. 启用 WSL 功能 2. 安装 Ubuntu 发行版 3. 按照 Linux 配置步骤进行 --- ## 版本要求 | 软件 | 最低版本 | 推荐版本 | |------|----------|----------| | ROOT | 6.20 | 6.28+ | | Python | 3.8 | 3.10+ | | CMake | 3.16 | 3.20+ | | GCC | 7.0 | 11.0+ | --- ## 快速开始脚本 可以创建一个 `setup.sh` 脚本快速配置: ```bash #!/bin/bash echo "=== 克隆项目 ===" git clone
cd
echo "=== 配置环境 ===" source /path/to/root/bin/thisroot.sh sudo apt-get update sudo apt-get install python3 python3-pip sudo apt-get install python3-tk sudo apt-get install cmake sudo apt-get install build-essential echo "=== 启动 GUI ===" python3 program_gui.py ``` --- ## 联系信息 如有问题,请联系项目维护者: - 郭罗坤:guoluokun@mail.ustc.edu.cn - 张房越:fyzhang@ihep.ac.cn - 易晗:yih@ihep.ac.cn ## 代码更新订阅 如果想接收GitLab仓库更新的邮件推送,请发送邮件至yih@ihep.ac.cn,我们会将您加入邮件订阅列表。