MOLASSES

MOLASSES is an in-progress fluid flow simulator, written in C. It is not yet complete and is in need of testing and additional programming before it can be used effectively.

MOLASSES stands for MOdular LAva Simulation Software for Earth Science.

MOLASSES requires the GDAL C libraries and a C compiler. To get the GDAL libraries, install gdal-devel on your UNIX machine. We have tested this program on computers that use the C compiler gcc.

Before compilation of MOLASSES it is prudent to modify the Makefile in this directory for your use. Check to make sure that the installation path and the path to GDAL are properly set. Modify the module numbers at the top of the Makefile to change the model algorithm to what you require.

To compile and install MOLASSES execute the following commands:

	make
	make install

You may need to be in super-user mode to perform make install.

To run the code after installation, use the command

	molasses <config-file>

where <config-file> is a text configuration file. A sample configuration file (sample.cfg) is given in the main directory. An elevation model is required to run molasses, and at least one output file path and one vent location must be given in the configuration file. More information is documented in the docs directory.

DEM_FILE = raster_samples/flat_1300x1300.asc
ELEVATION_UNCERT = 0

#Output
OUTFILE_A_THICKNESS = this-is/an-ascii-list-of-inundated-cells.tsv
#OUTFILE_R_HITMAP = this-is/a-binary-raster-map-of-inundation.tif
#OUTFILE_R_THICKNESS = this-is/a-raster-map-of-flow-thickness.tif
#OUTFILE_R_ELEVATION = this-is/a-raster-map-of-the-preflow-DEM.tif
#OUTFILE_R_NEW_ELEV = this-is/a-raster-map-of-the-post-flow-DEM.tif

#Model Parameters
MODAL_THICKNESS = 1

NEW_VENT
VENT_EASTING = 650
VENT_NORTHING = 650
VENT_PULSE_VOLUME = 1
VENT_TOTAL_VOLUME = 7000

To uninstall MOLASSES run make uninstall

Jacob Richardson (jarichardson@mail.usf.edu)

Laura Connor (lconnor@usf.edu)

Chuck Connor (cbconnor@usf.edu)

Copyright 2014, Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0). http://creativecommons.org/licenses/by-nc/3.0/