diff --git a/book/_toc.yml b/book/_toc.yml index 7676879..6e83772 100644 --- a/book/_toc.yml +++ b/book/_toc.yml @@ -5,8 +5,8 @@ parts: - caption: Getting started with DALES! chapters: - file: running/changes.md - - file: running/settingup.ipynb - - file: running/compilation.ipynb + - file: running/settingup.md + - file: running/compilation.md - caption: Running your first case in DALES chapters: - file: running/testcase.ipynb diff --git a/book/running/compilation.ipynb b/book/running/compilation.ipynb deleted file mode 100644 index 056d951..0000000 --- a/book/running/compilation.ipynb +++ /dev/null @@ -1,119 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "(sec:compilation)=\n", - "# Compilation of DALES\n", - "\n", - "## Generic compilation\n", - "The next step after obtaining the code and installing required dependencies, is to build the code. As a starting point, we assume you are still in the main `dales` directory after checking out the main branch via git. It is advised the build the code in a different folder to better maintain overview. We therefore first move one directory up, make a new directory and move into that directory.\n", - "```{code} shell\n", - "cd ../\n", - "mkdir build\n", - "cd build\n", - "```\n", - "\n", - "We then invoke `cmake` on the directory where the code is placed. This will configure the build of the code.\n", - "```{code} shell\n", - "cmake ../dales \n", - "```\n", - "Finally, the code can be build with the following command:\n", - "```{code} shell\n", - "make \n", - "```\n", - "After successfull compilation, the executable `dales` is located in the subdirectory `bin/`. Compilation of the code may be sped up using the `-j ` specifier, with `nprocs` being the amount of parallel processes.\n", - "\n", - "## Compilation options\n", - "It is possible to specify optional features at the compilation stage of the model. These optional features can be activated by adding them as specifyers to the cmake command. CMake options are specified as `-D