From 8b0aa9389bc0257bd9a855bc725b714a7da603a5 Mon Sep 17 00:00:00 2001 From: Paul Garlick Date: Thu, 2 Jul 2020 12:24:40 +0100 Subject: fullswof-utils: Add README file. * README.md: New file. --- README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..0027370 --- /dev/null +++ b/README.md @@ -0,0 +1,46 @@ +# FullSWOF-utils + +## Description + +The _FullSWOF-utils_ package provides pre-processing utility programs +for use with the [FullSWOF](https://www.idpoisson.fr/fullswof/) shallow water solver. The governing +system of equations (also known as the Saint-Venant equations) require +boundary conditions specifying the flow into the domain and the +surface elevation at the outlet. The programs provided by +_FullSWOF-utils_ allow fine-grained control of the flow at inlet and +outlet boundaries. Boundary condition files are generated in the +format required by the _FullSWOF_ solver. + +## Installation + +A convenient method to install _FullSWOF-utils_ is to clone the online +repository. On systems that have the _git_ version control system +installed the "_git clone_" command will create a new directory with +the complete set of files. + +To complete the installation the user need only issue the "make" +command from within the newly created directory. This command builds +the documentation in _info_ and _HTML_ formats. The _makeinfo_ +program, which is part of the [Texinfo](https://www.gnu.org/software/texinfo/) package, is a pre-requisite +for this step. + +## Requirements + +The _FullSWOF-utils_ programs are writtem in the _Python_ programming +language. The programs depend on two extra Python packages: + +1. [Matplotlib](https://matplotlib.org/) and +2. [Numpy](https://numpy.org/) + +## Documentation + +After installation, the _FullSWOF-utils_ documentation may be accessed +in _info_ format or _html_ format. The _info_ version may be read +using either the _info_ standalone reader or the _Emacs_ text editor. +The _html_ version may be read using a web browser. + +The _.info_ file is located in the _doc_ directory. The _html_ files +are located in the _manual_ directory. There are two _html_ options. +The file _fullswof-utils.html_ contains the full documentation on one +page. The file _html_node/index.html_ provides links to individual +pages, with one page for each node. -- cgit