landlab-parallel

Some utilities for working with landlab in a parallel environment.

Installation

pip install git+https://github.com/mcflugen/landlab-parallel.git

NOTE: To run the example, you'll need to install mpi4py, which may be easiest to do in a conda environment,

conda create -n mpi4py mpi4py
conda activate mpi4py

Run

The run_example.py command has a simple command-line interface,

run_example.py SIZE [--mode {raster,odd-r}] [--seed SEED]

• SIZE: Integer. The grid will have dimensions (SIZE, 2 * SIZE).
• --mode: Optional. Grid layout type. Choices:
  • raster
  • odd-r
• --seed: Optional. Integer random seed for initializing grid elevations.

Example

NOTE: If you are on a Mac, you may need to first set the fabric interface used by libfabric,

export FI_PROVIDER=tcp

To run an example,

mpiexec -n 4 python ./run_example.py 128 --mode=odd-r --seed=1945

Contributors

• Eric Hutton

Release Notes

0.1.0 (not yet released)

• Initial code import #1
• Added new function, vtu_dump, that dumps a landlab grid to vtu format #2.
• Added new function, pvtu_dump, that compbines a set of vtu files #3.
• Fixed an issue where the lower-left corner of the tiles were not be calculated correctly #4.
• Added a command-line argument, mode, that allows the user to modify the type of grid used for the example #5.
• Added a command-line argument, seed, that allows the user to provide a seed for the random number generator used to create the initial elevations #6.
• Added a new component, Uplift, that uplifts the landscape #7.
• Modified the time loop to exchange ghost node data after every component is updated and also added drainage area to the list of data fields that are exchanged #8.
• Fixed a bug where the mode passed from the cli was ignored #9.
• Mask-out data at closed nodes when writing to vtu #10.
• Fixed an issue where ghost nodes were not being set correctly for some hex grids. #12.
• Added support for creating d8-style tiles, which connect diagonal nodes #13.