qmesh3

Qmesh3 has been created as a temporary solution to allow qmesh to function with python3 and QGIS3 within a functional pip install to facilitate users access until the original qmesh updates are released. This repository has been created by Raul Adriaensen , contact email can be found here

qmesh is a software package for creating high-quality meshes using QGIS and Gmsh. The meshes can be used in finite element numerical models such as TELEMAC, Fluidity and Thetis. For more information please visit the project website.

Development, Maintenance and Licence

qmesh was developed and is maintained by Alexandros Avdis and Jon Hill. Please see file AUTHORS.md for more information.

qmesh is an open-source project distributed under the GNU General Public Licence v3 (GPL v3). The file LICENCE contains a complete copy of the licence.

The source code is freely available to download and adapt, under the conditions stated in the LICENCE file. However, we follow a closed-development approach, where maintenance and development is carried out by the package originators. We have opted for this approach to limit the resources needed for development: A larger development team necessitates larger management structures and significant CI/CD expenditure. Larger management structures will absorb time intended for other exciting and useful research. CI/CD expenditure could threaten our aim to offer a focused package, at no monetary costs to the users.

Documentation

You can access relevant documentation through the following avenues:

• The qmesh website.
• The qmesh synoptic manual.

Walk Through

Installation:

1. install GD-basisChangeTools/
2. install gmsh
3. install qgis, this installs the newest stable version of QGIS
   • some people seem to have more success first doing "sudo apt update"" and then "Sudo apt install qgis", this installs the available QGIS version on the system, which for WSL currently seems to be 3.10.14, for version info pre installation see here,
4. install qmesh3
   • not found QGIS errors, likely caused by multiple python versions installed locally, can be solved by adding /usr/bin (or the location where your qgis installation lives) to your Pythonpath
5. testing installation (optional) > "python -m unittest discover <test_directory>"

tutorials:

All key data files and videos have been placed together under this Onedrive. . A brief description of the files:

• Semi automated Mesh Generation of the Coastal Oceans with Engineering Structures Using Satellite Data

• great tutorial to get started, this was originally run on docker but can now be done without if the above installation is followed

• additioanl_tutorials_and_docker_installation

  • this material helped me to get going and explore all the options from the docker, qmesh-cli and learn some qgis tricks

• installating_qmesh_manually

  • in case the pip install breaks, instructions on how to setup qmesh manually can be found here

• tutorials_Angeloudis_Athnasios

  • an additional set of tutorials shared

Please read the relevant readme files in the OneDrive and the email chains to find the full information and names of those who kindly put all this content together

bugs to fix

• Currently runs until it saves the created mesh, but fails to convert this mesh into a shapefile again. This is due it being build on gmsh 2 and not 4 which uses a fileformat which maybe cannot be read by the program anymore, possible solutions are:

  • remove assert satement on line 927 in qmesh/mesh/mesh.py and hope the rest of the code can deal with the new mesh format
  • fix implementation adapted for the new file format version