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

References

J. D. Hunter, "Matplotlib: A 2D Graphics Environment", Computing in Science & Engineering, vol. 9, no. 3, pp. 90-95, 2007.