How to run BIE

BIE Example Guide by Martin D. Weinberg

This document describes how to run both scalar and MPI versions of the BIE system. We provide a suite of simple examples.

1. Introduction

Set of tests that exercise the BIE at the cli level. The testing directory has routines that test the functionality of particular classes and generate synthetic data for these tests.

The tests using two classes of models:

1. Splats: a collection (one or more) two-dimensional spatial Gaussian distribution of points which may attributes or not

2. Galaxy: a collection (one or more) three dimensional galaxy disk models characterized by an exponential scale length (that is, exp(-R/a), and scale height (based on a sech^2(z/h). Models with serveral flux attributes have been tested.

There are two versions of most tests: scalar machine and MPI-based parallel machine. The output should be statistically equivalent but will not be byte equivalent because of the distributed nature of the calculation.

2. Running

2.1 Scalar mode (no MPI) 2.2 Parallel (using MPI) 2.1 Scalar mode (no MPI)

From one of the scalar directories, execute the command:

../../../cli -f scriptX

where scriptX are one of the profiles in the directory.

The cli is the command-line interpreter. The -f file flag instructs the cli to take commands from the file.

2.2 Parallel (using MPI)

From one of the parallel directories, execute the command:

mpirun -v -np 32 ../../../cli -- -f scriptX -mpi

The -mpi instructs the cli to run in mpi mode.

3. More to come...