ufz/ogs5

OpenGeoSys THM/C simulator version 5

C++NOASSERTION

OGS-5

General homepage: https://www.opengeosys.org/ogs-5
Keyword documentation: https://ogs5-keywords.netlify.com
Benchmarks: https://github.com/ufz/ogs5-benchmarks
ogs-users mailing list

Quickstart option 1: binary download

Go to the GitHub release page
Download the appropriate archive (*.zip for Windows, *.tar.gz for Linux, *.dmg for macOS) and unpack it
You will find the ogs-binary inside the bin-folder
Optional: Download and unpack the Data Explorer for OGS-5 too
Download and unpack benchmark files

Quickstart option 2: build from source

Prerequisites

Install a compiler
- Win: Download and install Visual Studio Community 2017, during installation select the workload Desktop Development with C++, uncheck everything else
- Linux: Install the following packages: make and build-essential
- macOS: Install Xcode from the AppStore and run the following in the command line: xcode-select --install
Install Git
Install CMake

Source code

Get the source code either by downloading as a zip-file or with Git:

git clone https://github.com/ufz/ogs5.git

Build

Then set-up a build directory, configure your build and compile the code:

cd [source-directory]
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release # Configures your build
cmake --build . --config Release    # Compiles the code

Further info

How to Build a CMake-Based Project, a nice overview how CMake works, contains also information for building with Visual Studio
Running CMake describes various to run CMake also from a GUI and how to set configuration options
Git tutorial and Git FAQs

Quickstart: Run an OGS benchmark

Open a command prompt and run the following:

cd [benchmark-directory] # e.g. ogs5-benchmarks-master/H/Theis/GWF_Theis_2D
[path-to-ogs-exe-folder]/ogs [benchmark name] # e.g. ../../build/bin/ogs GWF_Theis_2d

Contributing: Using Git and GitHub

To implement new features, every developer

forks this repository to have their own repo
creates a branch from master and implement their stuff
pushes the local branch to its GitHub repository
makes a pull request from its GitHub repository to the master branch in the ufz/ogs5 repository