GeophysicalModelGenerator.jl

GeophysicalModelGenerator.jl: A Julia package to visualise geoscientific data and create numerical model setups - Published in JOSS (2024)

https://github.com/juliageodynamics/geophysicalmodelgenerator.jl

Science Score: 100.0%

This score indicates how likely this project is to be science-related based on various indicators:

✓
CITATION.cff file
Found CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
✓
DOI references
Found 7 DOI reference(s) in README and JOSS metadata
✓
Academic publication links
Links to: joss.theoj.org, zenodo.org
✓
Committers with academic emails
6 of 19 committers (31.6%) from academic institutions
○
Institutional organization owner
✓
JOSS paper metadata
Published in Journal of Open Source Software

Keywords from Contributors

mesh

Last synced: 6 months ago · JSON representation ·

Repository

Import, process and interpret geophysical data sets to be used in numerical models.

Basic Info

Host: GitHub
Owner: JuliaGeodynamics
License: mit
Language: Julia
Default Branch: main
Homepage:
Size: 204 MB

Statistics

Stars: 83
Watchers: 8
Forks: 35
Open Issues: 19
Releases: 44

Created almost 5 years ago · Last pushed 6 months ago

Metadata Files

Readme Contributing License Code of conduct Citation Security Authors

GeophysicalModelGenerator.jl

Creating consistent 3D images of geophysical and geological datasets and turning that into an input model for geodynamic simulations is often challenging. The aim of this package is to help with this, by providing a number of routines to easily import data and create a consistent 3D visualisation from it in the VTK-toolkit format, which can for example be viewed with Paraview. In addition, we provide a range of tools that helps to generate input models to perform geodynamic simulations and import the results of such simulations back into julia.

A short summary of the package and its features are given below. For a detailed description of the package and to learn how to use it, have a look at the documentation.

README_img

Geophysical Model Generator

Main features

Some of the key features are: - Create 3D volumes of seismic tomography models. - Handle 2D data (e.g., along a cross-section), including surfaces such as the Moho depth. - Plot data along lines (e.g., drillholes) or at points (e.g., earthquake locations, GPS velocities). - Handle both scalar and vector data sets. - Grab screenshots of cross-sections or maps in published papers and view them in 3D (together with other data). - Create a consistent overview that includes all available data of a certain region. - Create initial model setups for the 3D geodynamic code LaMEM. - Import LaMEM timesteps.

All data is transformed into either a GeoData or a UTMData structure which contains info about longitude/latitude/depth, ew/ns/depth coordinates along with an arbitrary number of scalar/vector datasets, respectively. All data can be exported to Paraview with the write_paraview routine, which transfers the data to a ParaviewData structure (that contains Cartesian Earth-Centered-Earth-Fixed (ECEF) x/y/z coordinates, used for plotting)

Usage

The best way to learn how to use this is to install the package (see below) and look at the tutorials in the manual.

Installation

First, you need to install julia on your machine. We recommend to use the binaries from https://julialang.org. Next, start julia and switch to the julia package manager using ], after which you can add the package. julia-repl julia> ] (@1.6) pkg> add GeophysicalModelGenerator You can test whether it works on your system with julia-repl julia> ] (@1.6) pkg> test GeophysicalModelGenerator and use it with julia-repl julia> using GeophysicalModelGenerator

Dependencies

We rely on a number of additional packages, which are all automatically installed. - GeoParams.jl Defines dimensional units, and makes it easy to convert for km/s to m/s, etc. - WriteVTK.jl writes VTK files (to be opened with Paraview). - ImageIO.jl, FileIO.jl, Colors.jl to import screenshots from papers. - Interpolations.jl for interpolations (for example related to importing screenshots).

Visualising Alpine data

We have used this package to interpret various data sets of the Alps (mostly openly available, sometimes derived from published papers). You can download the resulting paraview files here (using the *.vts format), where we also included the julia scripts to do the work (some of which are also described in more detail in the tutorials). Just unzip the files and open the corresponding *.vts in Paraview.

https://seafile.rlp.net/d/22b0fb85550240758552/

If you want your data be included here as well, give us an email (or even better: send the files with julia scripts).

Contributing

You are very welcome to request new features and point out bugs by opening an issue. You can also help by adding features and creating a pull request.

Citing

If you find this package useful, please cite this paper:

Kaus B.J.P., Thielmann M., Aellig P., De Montserrat A., De Siena L., Frasunkiewicz J., Fuchs L., Piccolo A., Ranocha H., Riel N., Schuler C., Spang A., Weiler T. (2024). GeophysicalModelGenerator.jl: A Julia package to visualise geoscientific data and create numerical model setups. Journal of Open Source Software. 9(102), 6763. https://doi.org/10.21105/joss.06763.

Funding

Development of this software package was funded by the German Research Foundation (DFG grants TH2076/7-1 and KA3367/10-1), which are part of the SPP 2017 4DMB project project, the DFG Emmy Noether grant TH 2076/8-1, by the European Research Council under grant ERC CoG #771143 - MAGMA and by the German Ministry of Science and Education (BMBF) as part of project DEGREE. The project was initiated at a Terrestrial Magmatic Systems - TeMaS workshop with researchers from Frankfurt and Mainz where we realized that it is way too time-consuming to collect and visualise available data of a certain region.

Owner

Name: JuliaGeodynamics
Login: JuliaGeodynamics
Kind: organization

Repositories: 5
Profile: https://github.com/JuliaGeodynamics

Tools for the next generation computational geodynamics codes

JOSS Publication

GeophysicalModelGenerator.jl: A Julia package to visualise geoscientific data and create numerical model setups

Published

November 04, 2024

DOI

10.21105/joss.06763

Volume 9, Issue 103, Page 6763