/lomo

LoMo - an open source tool for analyzing lock filling processes

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

LoMo

LoMo is an open source tool for analyzing lock filling processes. It uses an one-dimensional shallow water model to simulate the wave propagation in the lock chamber. Beside the filling time, the forces acting on the ship in longitudinal direction are computed.

Installation

LoMo can be run using our released runtime images. Download and extract the ZIP or TAR.GZ archive depending on your operating system. On Windows you can execute bin\lomo.bat with a double click. On a UN*X system execute bin/lomo.

To build LoMo from source a Java JDK 11+ is required. Make sure the environment variableJAVA_HOME is pointing to your JDK. LoMo is build and run using the Gradle Build Tool:

git clone https://github.com/baw-de/lomo.git
cd lomo
git checkout -t <TAG>
gradlew.bat run        # Windows
./gradlew run          # UN*X systems

After installing LoMo you can continue reading our information on getting started.

Development

LoMo is developed at the Federal Waterways Engineering and Research Institute. It is based on an object-oriented software design to allow simple extension of the software.

LoMo is written in the Java programming language. Developing LoMo using IntelliJ IDEA should work well.

You are welcome to submit issues or pull requests on GitHub to support the development of LoMo.

Publications

The numerical core is described in detail in this paper, which we kindly ask you to cite if you are using LoMo:
Belzner, F., Simons, F. & Thorenz, C. (2018): 'An application-oriented model for lock filling processes', Proceedings of the 34th PIANC World Congress 2018, Panama. PDF

Further information

License

LoMo is distributed by the Federal Waterways Engineering and Research Institute and is freely available and open source, licensed under the GNU General Public License 3. See LICENSE.txt for details.

LoMo runtime images include the following third party libraries which are distributed under their own terms. See 3RD-PARTY.txt for details.