JutulDarcy.jl 项目使用与配置教程

1. 项目目录结构及介绍

JutulDarcy.jl 是一个使用 Julia 语言编写的多相多组分 Darcy 流 reservoir 模拟器。项目目录结构如下：

JutulDarcy.jl/
├── .gitattributes
├── .gitignore
├── Artifacts.toml
├── LICENSE
├── Project.toml
├── README.md
├── docs/
│   └── ... # 文档相关文件
├── examples/
│   └── ... # 示例代码
├── ext/
│   └── ... # 扩展模块
├── src/
│   └── ... # 源代码
├── test/
│   └── ... # 测试代码
└── workflows/
    └── ... # GitHub Actions 工作流文件

• src/: 包含项目的所有源代码。
• test/: 包含用于验证代码正确性的测试代码。
• examples/: 提供了一些使用 JutulDarcy.jl 的示例。
• docs/: 项目文档的源文件。
• workflows/: 包含 GitHub Actions 的工作流文件，用于自动化项目的某些任务。
• .gitattributes 和 .gitignore: 配置 Git 的一些行为，如忽略某些文件。
• Artifacts.toml, LICENSE, Project.toml, README.md: 项目的配置文件和说明文档。

2. 项目的启动文件介绍

项目的启动通常不需要特定的启动文件。用户需要做的是将 JutulDarcy.jl 添加到 Julia 的项目中，然后可以使用 using JutulDarcy 来加载这个包。

以下是一个基本的启动示例：

using Pkg
Pkg.add("JutulDarcy")

using JutulDarcy

# 其他代码...

3. 项目的配置文件介绍

JutulDarcy.jl 的配置主要通过 Project.toml 文件来进行。这个文件定义了项目依赖和项目元数据。

Project.toml 文件示例：

[package]
name = "JutulDarcy"
uuid = "..."
version = "0.2.44"

[dependencies]
Jutul = "..."
GLMakie = "..."
TimerOutputs = "..."
ProgressMeter = "..."
# 其他依赖...

[extras]
# 额外配置...

用户通常不需要直接修改这个文件，除非需要添加或修改项目依赖。

在使用 JutulDarcy.jl 进行模拟时，还需要配置模拟参数，这些参数可以在模拟函数中设置或通过读取 .DATA 文件自动配置。例如：

file_path = "path/to/SPE9.DATA"
case = setup_case_from_data_file(file_path)
result = simulate_reservoir(case)

在 .DATA 文件中，可以配置模型的各种参数，如网格、流体属性、井参数等。