From efba777d89fba527ac3a8d35f7f6533e76fb48e0 Mon Sep 17 00:00:00 2001 From: jixingxing1234 Date: Fri, 2 Dec 2022 16:12:10 +0800 Subject: [PATCH] 1 --- README.md | 31 ++++++++++++++++++++++++++++++- 1 file changed, 30 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index dddb950..9dc81ce 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,31 @@ +会不断更新的！ # gks2d-str - +这是一个气体动理学格式（Gas-Kinetic Scheme, GKS）的求解器，支持二维结构化网格模拟，目的是方便有需求的科研工作者入门之用。 +如用作学术用途，请引用任意下列文献： +1) X. JI, F. ZHAO, W. SHYY, & K. XU (2018). A family of high-order gas-kinetic schemes and its comparison with Riemann solver based high-order methods. Journal of Computational Physics, 356, 150-173. +2) X. JI, & K. XU (2020). Performance Enhancement for High-order Gas-kinetic Scheme Based on WENO-adaptive-order Reconstruction. Communication in Computational Physics, 28, 2, 539-590 +## 功能 +1. 一维网格 2阶到5阶 GKS +2. 二维均匀结构化单块网格 2阶到5阶 GKS +3. 二维非均匀结构化单块网格 2阶到5阶 GKS +4. 有限体积框架；WENO重构；多步多阶，两步四阶 +## 安装 +### windows 和 visual studio 2019 +1. 创建新解决方案。 选择 “c++ windows桌面向导”，勾选 “将解决方案和项目放在同一目录”; 应用程序类型是 “控制台应用程序”; 选择 “空项目” +2. 把code文件夹（里面是所有源代码）和structured-mesh文件夹(是示例的结构化网格文件）复制到解决方案文件夹（和sln同目录）中。复制到其他文件夹或许也可以，关键点在于code文件夹和structured-mesh文件夹在一个目录下 +3. 在visual studio中添加code中的 .h文件 到头文件；添加code中的.cpp文件到 源文件 +4. 点击调试下拉菜单的 开始执行不调试（建议使用release（因为快）和x64（因为支持3.25GB以上的程序运行内存）编译）。编译成功，弹出控制台运行 +### linux 和 g++ +0. 目前linux下的安装教程可能是不完善的，因为我主要在windows下写程序 +1. 复制code文件夹和和structured-mesh文件夹到同一目录下，确保安装了g++，支持c++11或者以上标准，安装了openmp +2. cd到code文件夹下目录，使用cmake生成makefile（cmake已经在code文件夹里面了），这一步是在code文件夹同级生成makefile + cmake -B ../build +3. 使用cmake调用makefile生成可执行文件，这一步code文件夹同级生成build文件夹,可执行文件在build文件夹内 + cmake --build ../build +4. cd到build文件夹 执行可执行文件 main + +## 注 +程序 运行代码部分采用英文命名；注释部分采用中文+英文，以行文流畅易懂为准则，因此考虑到linux下不乱码，采用utf-8编码。在windows系统VS下添加注释建议安装[forceUTF-8插件](https://blog.csdn.net/weixin_43734095/article/details/104481436) 为了兼顾vs下使用utf-8编码的注释不会扰乱运行代码，注释统一用//，而不用/**/ +# 致谢 +感谢叶宇晨（北京大学）帮我测试了最初版本的代码 +感谢何志强博士告知我用git上传，尽管我现在仍一头雾水