Initial commit.

Author: Daniel Ruprecht

.gitignore

@@ -0,0 +1,8 @@
+*.out
+*.mod
+*.o
+*.dat
+*~
+*.*~
+*.pyc
+*.out.dSYM

Doxyfile

@@ -0,0 +1,39 @@
+include makefile.defs
+
+all: compile
+
+compile:
+	cd $(CURDIR)/obj; make
+	cd $(CURDIR)/test/obj; make
+	cd $(CURDIR)/bin; make
+	cd $(CURDIR)/test/bin; make
+	cd $(CURDIR)/scaling/obj; make
+	cd $(CURDIR)/scaling/bin; make
+
+clean:
+	cd $(CURDIR)/obj; make clean
+	cd $(CURDIR)/test/obj; make clean
+	cd $(CURDIR)/bin; make clean
+	cd $(CURDIR)/test/bin; make clean
+	cd $(CURDIR)/test/scripts; make clean
+	cd $(CURDIR)/scaling/obj; make clean
+	cd $(CURDIR)/scaling/bin; make clean
+	rm -f *.dat
+	rm -f *.pyc
+	rm -f scripts/*.pyc
+	rm -f *.out
+	rm -f submit_*.sh
+
+cleandata:
+	rm -f *.dat
+	rm -f *.out
+	rm -f rename.sh
+	rm -f *.in
+	rm -f rur.*
+	rm -f *.rur
+	rm -f *.out
+	rm -f submit_*.sh
+
+.PHONY: test
+test:
+	python run_tests.py

Makefile

@@ -0,0 +1,44 @@
+Parareal F90 {#mainpage}
+============
+
+This is a lightweight standalone implementation of Parareal solving 3D Burger's equation using a forward Euler and a RK3SSP method as coarse and fine integrators. It contains three different implementations of Parareal, one based on MPI, one using OpenMP without pipelining and one using OpenMP with pipelining. All three versions compute the same result, the purpose of the code is to compare different implement strategies with respect to speedup, memory footprint and energy consumption.
+
+Documentation
+-------------
+
+If you have Doxygen installed, you can run *doxygen Doxyfile* in the base directory to generate HTML documentation of the code.
+
+How do I get set up?
+--------------------
+
+
+To build, you will need the following files in the base directory:
+  - preprocessor.f90
+  - makefile.defs
+
+In preprocessor.f90, a flag is defined that switch between linear advection and nonlinear advection (only the latter case is really Burger's equation, the other is a linear advection-diffusion problem). 
+
+In makefile.defs, the compiler is specified and compiler flags are set. The code needs no libraries, only a MPI compiler with -enable-threads and the correct flag to allow for OpenMP directives (e.g. -fopenmp for GCC). Just specify the compiler and the flags in makefile.defs and type make in the base directory.
+
+To run, need file
+  - system.defs
+
+The entries in system.defs are used to automatically build scripts to run the code on different platforms (see e.g. build_runscript.py in /scripts). There are several examples provided. If you want to include your own system, you will need to modify the following python scripts
+  - get_run_cmd.py
+  - build_runscript.py
+  - run_parareal.py 
+  - ...
+
+Python runscripts
+-----------------
+There is a collection of python scripts that automatically run the code with different configurations to generate different sets of data. The script run_parareal_scaling.py for example runs Parareal with different numbers of processors plus the fine integrator as reference and generates all data necessary to plot speedup.
+
+Test harness
+------------
+There is a set of tests, some written in Fortran and some in Python. Just type *python run_tests* in the base directory to start testing. If you add the flag *nof90* then only the high level python test scripts will be run.
+
+
+Who do I talk to?
+-----------------
+
+This code is written by Daniel Ruprecht.

README.md

@@ -0,0 +1,23 @@
+include ../makefile.defs
+include dependencies
+
+all: objects run_timestepper.out run_parareal_mpi.out run_parareal_openmp.out run_parareal_openmp_pipe.out
+
+# Update objects where necessary
+objects:
+	cd $(CURDIR)/../obj; make
+
+run_timestepper.out: ../obj/run_timestepper.o ../obj/timestepper.o
+	$(F90) $(FCFLAGS) $(DEP) ../obj/run_timestepper.o -o run_timestepper.out
+
+run_parareal_mpi.out: ../obj/run_parareal_mpi.o ../obj/parareal_mpi.o
+	$(F90) $(FCFLAGS) $(DEP) ../obj/run_parareal_mpi.o -o run_parareal_mpi.out
+
+run_parareal_openmp.out: ../obj/run_parareal_openmp.o ../obj/parareal_openmp.o
+	$(F90) $(FCFLAGS) $(DEP) ../obj/run_parareal_openmp.o -o run_parareal_openmp.out
+
+run_parareal_openmp_pipe.out: ../obj/run_parareal_openmp_pipe.o ../obj/parareal_openmp_pipe.o
+	$(F90) $(FCFLAGS) $(DEP) ../obj/run_parareal_openmp_pipe.o -o run_parareal_openmp_pipe.out
+
+clean:
+	rm -f *.out

bin/Makefile

@@ -0,0 +1,11 @@
+DEP=../obj/fluxes.o 
+DEP+=../obj/params.o
+DEP+=../obj/upwind.o 
+DEP+=../obj/weno5.o 
+DEP+=../obj/advection.o
+DEP+=../obj/diffusion.o 
+DEP+=../obj/boundaries.o
+DEP+=../obj/timestepper.o
+DEP+=../obj/parareal_mpi.o
+DEP+=../obj/parareal_openmp.o
+DEP+=../obj/parareal_openmp_pipe.o

bin/dependencies

@@ -0,0 +1,3 @@
+./rename.sh
+./rename_timings.sh $1
+zip -m rur_dora_$1.zip $1_*.rur

collect_rur.sh

@@ -0,0 +1 @@
+Daniel Ruprecht