Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/spamlab-iee/os

An open source, cross-platform structural geology analysis software
https://github.com/spamlab-iee/os

Last synced: about 2 months ago
JSON representation

An open source, cross-platform structural geology analysis software

Lists

README 

        
OpenStereo

==========



[![Build status](https://ci.appveyor.com/api/projects/status/pbjhw57vo0hq4lf9?svg=true)](https://ci.appveyor.com/project/endarthur/os-wv5v5)

[![Documentation Status](https://readthedocs.org/projects/openstereo/badge/?version=latest)](https://openstereo.readthedocs.io/en/latest/?badge=latest)

[![Gitter chat](https://badges.gitter.im/endarthur/os.png)](https://gitter.im/openstereo)



------------------------------------------------------------------------



OpenStereo is an open source, cross-platform software for structural geology analysis.



The software is written in Python, a high-level, cross-platform programming language and the GUI is designed with Qt5, which provide a native look on all OS. Numeric operations (like matrix and linear algebra) are performed with the Numpy module and all graphic capabilities are provided by the Matplolib library, including on-screen plotting and graphic exporting to common desktop formats (emf, eps, ps, pdf, png, svg).



OpenStereo is released under the GNU General Public License v.3.



Check the documentation here:



https://openstereo.readthedocs.io/



## Windows Installation



Download the installer .exe from the latest release:



https://github.com/spamlab-iee/os/releases/latest



When updating, please uninstall the previous version before installing the new.



## macOS Installation



Downloader the .app executable from the latest release:



https://github.com/spamlab-iee/os/releases/latest



On the first time executing a new download of OpenStereo, right click the .app file

select `Open` from the context menu and click open on the window that will appear.



Alternativelly, you can install OpenStereo from source by first installing pyqt5

(python3 will be installed as well for this) using [homebrew](https://brew.sh/):



```bash

$ brew install pyqt

```



Once that is done, install OpenStereo from this repository using pip3:



```bash

$ pip3 install https://github.com/spamlab-iee/os/tarball/master#egg=openstereo

```



## Linux Installation



### Ubuntu



First install pyqt5 and pip:



```bash

$ sudo apt install python3-pyqt5 python3-pip

```



Once that is done, install OpenStereo from this repository using pip3:



```bash

$ pip3 install https://github.com/spamlab-iee/os/tarball/master#egg=openstereo

```



### Mint Cinnamon



First install pyqt5, pip and setuptools from the distribution repository:



```bash

$ sudo apt install python3-pyqt5 python3-pip python3-setuptools

```



Then install wheel using pip:



```bash

$ pip3 install wheel

```



Once that is done, install OpenStereo from this repository using pip3:



```bash

$ pip3 install https://github.com/spamlab-iee/os/tarball/master#egg=openstereo

```



### Fedora



First install pyqt5:



```bash

$ sudo yum install python3-qt5



Once that is done, install OpenStereo from this repository using pip3:



```bash

$ sudo pip3 install https://github.com/spamlab-iee/os/tarball/master#egg=openstereo

```



### openSUSE



First install pyqt5:



```bash

$ sudo zypper install python3-qt5



Once that is done, install OpenStereo from this repository using pip3:



```bash

$ sudo pip3 install https://github.com/spamlab-iee/os/tarball/master#egg=openstereo

```



## Installation from Source



You can install this version of openstereo using:



```bash

$ pip install https://github.com/spamlab-iee/os/tarball/master#egg=openstereo

```



Additionally, install PyQt5 from PyPI (for python 2.7, use package python-qt5 instead).



Then run with



```bash

$ openstereo

```



or



```bash

$ python -m openstereo

```