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.
Visit the user friendly website at: http://innstereo.github.io/
The latest documentation can be read on this page:
Check the releases page for builds for your system:
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:
-
Install the Python 3 packages of Matplotlib, Numpy, Git, Scipy. The project targets GTK+ version 3.14 and above.
-
Download the newest version of MPLStereonet:
pip3 install git+git://github.com/joferkington/mplstereonet.git
- Clone this repository:
git clone https://github.com/tobias47n9e/innstereo
- 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/
- Run the program by executing the following code in the project folder.
python3 -m innstereo
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
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.
The program is still in development and some features are still missing. The most important things are listed in this file:
InnStereo is based on the following open-source projects:
The code quality is constantly monitored using Landscape. Software-testing will be implemented as soon as possible.