NAME

MOLASSES

MOLASSES stands for MOdular LAva Simulation Software for Earth Science.

DESCRIPTION

MOLASSES is an in-progress fluid flow simulator, written in C. The MOLASSES model relies on a cellular automata algorithm to estimate the area inundated by lava flows.

CODE REQUIREMENTS

1. MOLASSES requires the GDAL C libraries and a C compiler. GDAL libraries and development files are available for many systems (http://trac.osgeo.org/gdal/wiki/DownloadingGdalBinaries); install both the gdal library and the header (development) files. We have tested this program on computers that use the C compiler gcc.

2. MOLASSES requires the memory management software GC (http://www.hboehm.info/gc/). Install both library (lib) and header files (dev). See the readme file in the external_files directory for additional info.

3. MOLASSES requires RNGLIB, a C library which implements random number generators (https://people.sc.fsu.edu/~jburkardt/c_src/rnglib/rnglib.html). Also, See the readme file in the external_files directory for additional info.

4. MOLASSES requires a DEM (Digital Elevation Model) in a format recognized by the GDAL code library. The DEM should extend beyond the boundaries of the lava flow(s).

5. MOLASSES requires a configuration file that is specified on the command line when executing the code.

LICENSE

Copyright (C) 2015-2020  
Laura Connor (lconnor@usf.edu)
Jacob Richardson 
Charles Connor

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>. 

COMPILING and INSTALING THE CODE

Before compilation of MOLASSES modify the makefile in the top-level directory for your use.

1. Check to make sure that the path to GDAL and gcc are properly set.

2. The module names at the top of the Makefile may be changed to accomadate alternative model algorithms. This name refers to a new C-code file (for the alternative algorithm) in the src directory.

To compile and install MOLASSES execute the following commands:

	make
	make install

'make' compiles the code; 'make install' copies the code to a 'bin' (program) directory specified in the top-level makefile.

PROGRAM EXECUTION

To run molasses type:

$PATH_TO_MOLASSES/$molasses $config_file

where $PATH_TO_MOLASSES indicates where the executable code is located, $molasses indicates the exact name of the compiled code, and $config_file indicates the name of the configuration file. It is most convenient if the configuration file resides in your working directory.