预编译系统镜像指南

为了获得最佳的启动速度和性能，DataProcessforDQMC支持预编译系统镜像。预编译后的Julia启动时间从数秒缩短到毫秒级。

🚀 前置准备（首次使用）

如果您还没有安装Julia，请按照以下步骤操作：

1. 安装Julia

使用juliaup安装器（官方推荐）：

curl -fsSL https://install.julialang.org | sh

安装完成后，重新加载shell配置：

source ~/.bashrc  # 或 source ~/.zshrc

验证安装：

julia --version

2. 安装PackageCompiler

启动Julia REPL并安装PackageCompiler包：

julia

在Julia REPL中执行：

using Pkg
Pkg.add("PackageCompiler")

3. 安装DataProcessforDQMC包到全局环境

在Julia REPL中安装本地包到全局环境：

julia

在Julia REPL中执行：

using Pkg

# 方式1：仅使用（推荐）
Pkg.add(path="/path/to/DataProcessforDQMC")

# 方式2：开发模式（如需修改源代码）
Pkg.develop(path="/path/to/DataProcessforDQMC")

📦 构建系统镜像

启动 Julia 并执行：

using DataProcessforDQMC, PackageCompiler
DataProcessforDQMC.compile()

这将在 ~/.julia/sysimages/ 目录下生成 sys_dataprocessfordqmc.so 系统镜像文件（约380MB），并自动显示使用说明。

⚙️ 配置Julia启动器

将以下配置添加到您的 ~/.bashrc 或 ~/.zshrc 文件中：

# DataProcessforDQMC 预编译镜像启动器
function jd() {
    local sysimage="$HOME/.julia/sysimages/sys_dataprocessfordqmc.so"

    if [ ! -f "$sysimage" ]; then
        echo "Error: system image file not found: $sysimage"
        return 1
    fi

    if [ $# -eq 0 ]; then
        # 无参数：启动交互式会话并自动加载包
        echo "Starting DataProcessforDQMC interactive session..."
        julia --sysimage "$sysimage" -e 'using DataProcessforDQMC' -i
    else
        # 有参数：运行脚本或传递其他参数
        julia --sysimage "$sysimage" "$@"
    fi
}

# 开发版本（不使用系统镜像，实时加载代码修改）
alias jdd="julia -e 'using DataProcessforDQMC' -i"

然后重新加载配置：

source ~/.bashrc  # 或 source ~/.zshrc

🎯 使用方式

交互式会话

jd  # 启动预编译的DataProcessforDQMC交互会话

运行脚本

jd your_analysis_script.jl  # 使用预编译镜像运行脚本

开发调试

jdd  # 使用开发版本（实时加载代码修改）

🔄 何时需要重新编译

以下情况需要重新编译系统镜像：

1. 代码修改：修改了DataProcessforDQMC包的源代码
2. 依赖更新：更新了包的依赖项
3. Julia版本升级：升级了Julia版本
4. 函数签名变更：修改了公共API函数的参数

重新编译命令：

using DataProcessforDQMC, PackageCompiler
DataProcessforDQMC.compile()

💡 性能对比

📋 基本使用示例

多参数分析

# 启动预编译版本
jd

# 分析反铁磁相关比率
base_dir = "/path/to/simulation/data"
results = analyze_AFM_correlation_ratio_multi_parameter(
    base_dir,
    shift_point=(0.25, 0.0),
    filter_options=Dict(
        :prefix => "proj_bt_honeycomb_exact",
        :L => 6,
        :dtau => 0.1
    )
)

目录扫描

# 扫描符合条件的参数目录
dirs = scan_parameter_directories(
    base_dir,
    filter_options=Dict(
        :prefix => "honeycomb_model",
        :U => [3.0, 4.0, 5.0],
        :L => 12
    )
)

🛠️ 故障排除

系统镜像损坏

如果遇到奇怪的错误，尝试重新编译：

rm ~/.julia/sysimages/sys_dataprocessfordqmc.so

然后重新运行：

using DataProcessforDQMC, PackageCompiler
DataProcessforDQMC.compile()

路径问题

确认系统镜像文件已正确生成：

ls -la ~/.julia/sysimages/sys_dataprocessfordqmc.so

PackageCompiler未安装

如果编译失败，可能需要安装PackageCompiler：

using Pkg
Pkg.add("PackageCompiler")