RST Evaluation
Scripts for analysing shear experiments from the Schulze RST.pc01 ring shear tester.
Quick Guide to rst-evaluation
The software rst-evaluation
is a series of scripts to semi-automatically
evaluate shear experiments done at the Helmholtz Laboratory for Tectonic
Modelling. In principle, it may be used for other measurements done in a
similar setup, but it was build with our standardized workflow in mind.
Installation / Download
Windows Installer
Download the latest Windows release: setup_RST_pick_GUI_0.2.5.exe
Linux or Windows Command Line (without sample data)
To install for Linux or to use it from a Windows command line we advise to install the the software using pip:
python -m pip install git+https://git.gfz-potsdam.de/analab-code/rst-evaluation.git
To run the GUI-Version:
rstevaluation
if the Python script folder is on your $PATH$
variable, alternatively
python -m rstevaluation
should work for all systems (in some cases you need to use python3
).
Using this version you can also access the functions for your personal project, for example by using:
import rstevaluation.analysis
Linux or Windows Command Line (with sample data)
Download the repository and run the scripts as needed.
The main scripts are located in RSTpicking and to run the scripts you should
use python RST_main.py
(Windows) or python3 RST_main.py
(Unix). That will
open a GUI providing the necessary details to open data files and analyse full
folders.
RSTpicking
The software features several independent components that can be used for file conversion, manual picking, analysis or a fully featured analysis.
The main component of this software is RSTpicking
which incorporates the
functionality of all other components. There are two different scripts that run
the picking and analysis. It is recommended to use RST_pick_GUI.py
which
makes use of a user interface and allows the user to easily change the
parameters and projects. RST_main.py
is an older version that is less
flexible and requires the user to manually edit the settings in the script.
Other Components
For a more detailed description of the other components see the Documentation and the readme files in the individual folders.
Acknowledgements
The original scripts for version 0.0.1 (4260ec45) in this repository have been provided by M. Warsitzka @warsitzka_at_ig.cas.cz and contain scripts that have been developed by M. Ritter.
Warsitzka, Michael; Ge, Zhiyuan; Schönebeck, Jan-Michael; Pohlenz, Andre; Kukowski, Nina (2019): Ring-shear test data of foam glass beads used for analogue experiments in the Helmholtz Laboratory for Tectonic Modelling (HelTec) at the GFZ German Research Centre for Geosciences in Potsdam and the Institute of Geosciences, Friedrich Schiller University Jena. GFZ Data Services. http://doi.org/10.5880/GFZ.4.1.2019.002
This software reuses images for the user interface that are part of matplotlib (Hunter, 2007).
Citation
Please cite this repository as:
Rudolf, Michael; Warsitzka, Michael (2021): RST Evaluation - Scripts for analysing shear experiments from the Schulze RST.pc01 ring shear tester. GFZ Data Services. https://doi.org/10.5880/GFZ.4.1.2021.001