An open source stereographic plotting program for structural geology and based on Mplstereonet.
Clone or download
tobias47n9e Merge pull request #78 from katrinleinweber/master
reflect new resolver recommendation
Latest commit 5f22576 Jan 22, 2018

README.md

InnStereo

InnStereo (abbreviated from Innsbruck Stereographic) is an open-source program for stereographic projections, also called stereonets. It is developed for data processing in geology, structural-geology and related fields. The program itself is build on top of other open-source libraries, most importantly MPLStereonet.

Website

Visit the user friendly website at: http://innstereo.github.io/

Documentation

The latest documentation can be read on this page:

Documentation Status

Installation

Check the releases page for builds for your system:

Development Version

Currently the best way to test the program is to do the following on Linux or a Linux-Virtual-Machine. In both cases it is a good idea to test within a virtual environment:

  1. Install the Python 3 packages of Matplotlib, Numpy, Git, Scipy. The project targets GTK+ version 3.14 and above.

  2. Download the newest version of MPLStereonet:

pip3 install git+git://github.com/joferkington/mplstereonet.git
  1. Clone this repository:
git clone https://github.com/tobias47n9e/innstereo
  1. Copy and compile the glib-schemas (as supuser in the project directory):
cp ./data/org.gtk.innstereo.gschema.xml /usr/share/glib-2.0/schemas/
glib-compile-schemas /usr/share/glib-2.0/schemas/
  1. Run the program by executing the following code in the project folder.
python3 -m innstereo

Ubuntu 16.04

On a fresh install of Ubuntu you will probably need to execute the following commands for Innstereo to run:

$ sudo apt-get install git python3-numpy python3-numpy python3-matplotlib python3-pip
$ sudo python3 -m pip install mplstereonet

$ git clone https://github.com/tobias47n9e/innstereo
$ cd innstereo
$ sudo cp data/org.gtk.innstereo.gschema.xml /usr/share/glib-2.0/schemas/
$ sudo glib-compile-schemas /usr/share/glib-2.0/schemas/

$ python3 build_translations.py
$ python3 -m innstereo

Please note that building the translations probably requires you to configure a Zanata API key (User Configuration). The file needs to be created in ~/.config/zanata.ini (Press CTRL+H in your home directory to show the folder).

It contains the following lines:

[servers]
translate_zanata_org.url=https://translate.zanata.org/zanata/
translate_zanata_org.username=YOUR-ZANATA-USER-NAME
translate_zanata_org.key=YOUR-API-KEY

Development

InnStereo is developed open-source, and anybody is welcome to participate. There are many ways in which to participate (Documentation, testing, bug-reporting, user-interface improvements). If you would like to participate you can email Tobias or open an issue. More advanced users can also fork the repository and create pull requests.

Known Issues

The program is still in development and some features are still missing. The most important things are listed in this file:

Known issues

Digital Infrastructure

InnStereo is based on the following open-source projects:

Code Metrics

The code quality is constantly monitored using Landscape. Software-testing will be implemented as soon as possible.

Code Health Build Status