# df-water

**Repository Path**: lainegates/df-water

## Basic Information

- **Project Name**: df-water
- **Description**: 2D-DDA稍修改的程序：
（1）添加通过“时间步”或“物理模拟时间”控制水位功能。
（2）根据水位可设置节理参数

参数调整通过config.json文件实现
- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2019-02-28
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# df-water

#### 介绍
2D-DDA稍修改的程序：
（1）添加通过“时间步”或“物理模拟时间”控制水位功能。
（2）根据水位可设置节理参数

参数调整通过config.json文件实现

#### 软件架构
软件架构说明


#### 安装教程

1. 将df.exe放置在英文格式目录。

#### 使用说明

1. 准备好工程目录，目标内需有"data.df"、"parameters.df"和"extraConfig.json"。
2. 在命令行执行"df.exe ${targetPath}" ， 如"df.exe D:\\DDA_project"
3. 等待计算完成
4. 将easyDDA指向工程目录，使用DG查看计算结果。

# 参数文件config.json !!!只支持英文!!!，内容说明：
|参数名|意义|
|------|-----|
|savePerSteps|代表每隔多少步保存一次结果|
|waterBy|写"step"或"time"，前者代表按时间步设定水位，后者代表按模拟的物理时间模拟水位|
|jointNumInCmpt| 节理参数的个数，！！！要与parameters.df中的节理个数一致|
|waterUnit| 水的比重，取1/0.98~=0.1020408，花岗岩为取的2.7/0.98~=0.27|
|waterLevels| 水位的值，"keys"保存“time”或"step"变换的时刻，“levels”为对应“keys”的值的水位|
|jointsLib| 所有的joint参数，使用符串来标识，这样一组节理参数可多次使用|
|waterJointConfig| 长度与waterLevels的"keys"长度一致。每个子数组中值的个数必须与"jointNumInCmpt"一致|

# 出错处理
1. 如使用命令行操作，可直接在命令行看出错原因
2. 如未使用命令行，可看log文件。有"df_log.txt"、"df_debug_log.txt"和"error.txt"，以及运行程序目录下的"extraConfig.log"

#### 码云特技
1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2. 码云官方博客 [blog.gitee.com](https://blog.gitee.com)
3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解码云上的优秀开源项目
4. [GVP](https://gitee.com/gvp) 全称是码云最有价值开源项目，是码云综合评定出的优秀开源项目
5. 码云官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6. 码云封面人物是一档用来展示码云会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)