Overview

HTTPS SSH

What is this repository for?

geomIO is a MATLAB-based toolbox to create 3D volumes based on series of 2D vector drawings. These volumes are thought to be used as input geometries for thermomechanical deformation models (e.g. Stokes flow)

In numerical models material properties can be defined (1) on elements (e.g. in body-fitted finite element), or (2) on a set of Lagrangian markers (Eulerian, ALE or mesh-free methods). Other methods such as level sets exist but are not discussed here. The purpose of geomIO is to painlessly convert drawings into material properties (1) by creating a mesh that fits the contours of the shapes drawn or by (2) assigning material phases to markers inside the shapes drawn. Users can draw a series of 2D drawings that represent 2D cross sections in the 3D space. geomIO is then used to create 3D volumes by interpolating between the cross sections. Material properties can the be assigned to markers inside the volumes. Body-fitted mesh in 3D are not supported yet.

  • For the moment, please cite geomIO as follows:

    Baumann, Tobias, and Arthur Bauville. "geomIO: A tool for geodynamicists to turn 2D cross-sections into 3D geometries." EGU General Assembly Conference Abstracts. Vol. 18. 2016.

Getting started

  1. Clone this repository, either through SSH, i.e. git clone git@bitbucket.org:geomio/geomio.git, or through HTTPS git clone https://bitbucket.org/geomio/geomio.git.
  2. Change to the geomIO directory using the MATLAB console and type install_geomIO
  3. Add the provided expression to the startup.m file of your MATLAB installation.
  4. In case the MATLAB startup folder and startup.m do not exist, you may find more information here.
% startup.m (unix-version)


% geomIO installation
addpath(genpath('/FULL/PATH/TO/GEOMIO/INSTALLATION/geomio/src'));

Licence

Copyright (c) 2015-, JGU Mainz, Arthur Bauville & Tobias S. Baumann
All rights reserved.

geomIO 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, version 3 of the License.

geomIO 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 geomIO. If not, see <http://www.gnu.org/licenses/>.

Full license is available here

How to use

Documentation is available here

Acknowledgements

geomIO's development has been supported by the European Research Council under the European Community's Seventh Framework program (FP7/2007/2013) with ERC starting grant agreement no.258830.