Skip to content
View coastalme's full-sized avatar

Block or report coastalme

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Please don't include any personal information such as legal names or email addresses. Maximum 100 characters, markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
coastalme/README.md

CoastalME logo white background

CoastalME

The latest release is version 1.2.0 (18 Nov 2024).

The testing version (use at your own risk!) is 1.2.4 (23 Dec 2024).

By Andres Payo and David Favis-Mortlock and others.

Table of contents

About

CoastalME (Coastal Modelling Environment) is a Free and Open Source software for geospatial modelling to simulate decadal and longer coastal morphological changes.

It is an engineering tool for advanced modellers seeking to simulate the interaction of multiple coastal landforms and different types of human interventions.

Payo et al. (2017) described in detail the rationale behind CoastalME and demonstrated how it can be used to integrate; the Soft Cliff and Platform Erosion model SCAPE, the Coastal Vector Evolution Model COVE and the Cross Shore model CSHORE.

The software is written in C++ following the object-oriented paradigm. Source code documentation using Doxygen is available here.

The C++ source code is available for download under GNU open source license.

Quick Start

CoastalME builds easily using Linux. If you wish to run CoastalME on Windows, then we currently recommend using the Windows Subsystem Linux (WSL) software to do this.

Create a local copy of the github repository, for example by downloading a zipfile, then unpacking it or cloning. We suggest unpacking it to something like "/home/YOUR NAME/Projects/CoastalME/", this is then your CoastalME folder.

git clone https://github.com/coastalme/coastalme

In a terminal window (i.e. at a command-line prompt) move to the CoastalME folder.

Then move to the the src folder Then run run_cmake.sh.

cd CoastalME/src
./run_cmake.sh

If you get a "Permission denied" message -bash: ./run_cmake.sh: Permission denied you will have to grant permission using chmod a+x run_cmake.sh, chmod a+x cshore/make_cshore.sh and then ./run_cmake.sh

If you see error messages about missing software (for example, telling you that CMake cannot be found or is too old, or GDAL cannot be found or is too old) then you need to install or update the software that is causing the problem.

Run make install make install. This will create an executable file called cme in the CoastalME folder.

Edit cme.ini to tell CoastalME which input file to read (for example, in/test_suite/minimal_wave_angle_230/minimal.dat). You'll need to make sure that the "Path for output" listed in cme.ini (for example, out/test_suite/minimal_wave_angle_230) exists. If it doesn't exist, then create it: mkdir -p out/test_suite/minimal_wave_angle_230/.

Run cme ./cme. Output will appear in the "Path for output" folder.

To test that your installation is running correctly, you can run a suite of pre-defined tests by running the following commands:

chmod a+x run_test_suite.sh
./run_test_suite.sh

The chmod comand will ensure that you have permission to execute the run_test_suite.sh file.

Once you have CoastalME (CME) up and running, you can reduce the quantity of output (it can be overwhelming!) in several ways.

  • Change "Content of log file" in the main CME input file for any of the test suite runs (the name of this main input file is listed in cme.ini, both are simple text files). If you set "Content of log file" to zero, then CME won't output a log file; setting it to 4 (all output) is really only useful to developers.

  • Change "GIS vector files to output" and "GIS vector files to output" in the main CME input file. These are both set to "all" in the test suite files on GitHub. Instead of "all" you can list the space-separated codes for only the output that you want to see. A list of CME GIS output codes is in codes.txt"

Enjoy!

References

See DOI for the first release of the source code.

How to cite

Payo, A., Favis-Mortlock, D., Dickson, M., Hall, J. W., Hurst, M. D., Walkden, M. J. A., Townend, I., Ives, M. C., Nicholls, R. J., and Ellis, M. A.: Coastal Modelling Environment version 1.0: a framework for integrating landform-specific component models in order to simulate decadal to centennial morphological changes on complex coasts, Geosci. Model Dev., 10, 2715–2740, https://doi.org/10.5194/gmd-10-2715-2017, 2017.

How to build from source

See BUILDING.md

How to contribute

See CONTRIBUTING.md

Code of Conduct

See CODE_OF_CONDUCT.md

Credits

Devised by Andres Payo and David Favis-Mortlock. Lead developer and Version Control Administrator is David Favis-Mortlock

Popular repositories Loading

  1. coastalme coastalme Public

    Coastal Modelling Environment (CoastalME): geospatial modelling to simulate coastal morphological changes, decadal and longer.

    C++ 2 1