ExoCubed is a general framework to simulate fluid dynamics with the geometry of a sphere. Specifically, it handles the simulation of planetary atmospheres with different models ranging from shallow-water models to fully 3-dimensional general circulation models. It employs a Riemann-solver approach, making it better tailored for the extreme worlds existent in the solar system, where the Mach number in certain parts of the atmospheres is high and brings about possible discontinuity/shocks.
Canoe can be installed on either a Linux distribution or on MacOS. Open a Linux or Mac terminal, you can clone this repo using the following command:
git clone https://github.com/chengcli/canoe
This will copy all source files into your local computer. You will need to install a few
system libraries before installing canoe. All following instructions are executed under
the canoe/ directory, which is referred to as the root.
We assume that homebrew is already installed on your Mac and we will
use brew to install required system libraries. The system libraries are listed in
Brewfile at the root. To install them all, execute
brew bundle
On a Ubuntu linux system, use apt to install
sudo apt install clang-format cmake nco libnetcdf-dev libpnetcdf-dev libboost-all-dev libeigen3-dev libgoogle-glog-dev openssh-server
On a Redhat linux system, use yum to install
sudo yum install clang-tools-extra cmake nco netcdf-devel boost boost-devel eigen3-devel glog-devel openssh
If multi-core parallelization is needed, these extra pacakges should be install
- mpich parallel library
Ubuntu linux:
sudo apt install libmpich-dev
Redhat linux:
sudo yum install mpich-devel
source ~/.bash_profile
- pnetcdf output
Redhat linux does not support pnetcdf natively. So it should be downloaded and install. The default installation directory is $HOME/opt/
cd external
./fetch_pnetcdf.sh
./install_pnetcdf.sh
cd ..
The minimum python version is 3.8.
All needed python libraries are collected in requirements.txt. We suggest using a
python virtual environment to install
these packages. If you are already using a virtual enviroment, install python packages
by
pip3 install -r requirements.txt
Otherwise, to create a python virtual environment:
python -m venv pyenv
This command will create an environment named pyenv in your current directory. Then, you
can use the previous command to install the python packages.
Register your pre-commit hooks using
pre-commit install
The contributor's guide explains the meaning of pre-commit.
After you completed the installation steps, you can build the canoe library.
The easiest way is to build it in-place, meaning that the build (binary files) are
located under root. To do so, make a new directory named build
mkdir build
All build files will be generated and placed under this directory. It is completely safe
to delete the whole directory if you want another build. cd to build and cmake
cd build
cmake ..
Specifically, if building 2D shallow water model on a cubed-sphere, use
cmake .. -DTASK=exo2
For 3D shallow water model on a cubed-sphere, use
cmake .. -DTASK=exo3
This command tells the cmake command to look for CMakeFiles.txt in the parent directory,
and start configuring the compile environment. Then compile the code by
make -j4
This comman will use 4 cores to compile the code in parallel. Once complete, all executable
files will be placed in build/bin.
- The Reference Forward Model (RFM) is provided optionally as a tool to generate opacity tables. The source code of this package is not publically available. Please contact Anu Dudhia ar Cheng Li to obtain access. The build process turns off RFM by default, to turn on building RFM, use
cmake .. -DRFM=ON
- The DIScrete Ordinate Radiative Transfer (DISORT) is provided optionally as a plan-parallel radiative transfer solver. The original source code was in Fortran77. Tim Downling translated it to C in 2011. The C-source code, version 2.1.3, is hosted at libradtran.org. The build process turns off DISORT by default, to turn on building DISORT, use
cmake .. -DDISORT=ON