Home > Documentation > Installation > Linux

Installing MIEZEPY on Linux

Currently Linux only supports an installation through the terminal. In the following steps we will install python and the recquired dependencies to run the package both in scripting and GUI mode. Note that at this point the installation of MIEZEPY requires basic knowledge in terminal input.

1. Downloading the source

Example imageThe GitHub repository of the MIEZEPY project can be downloaded here. As the download completes the user is required to unzip the .zip content and open a terminal window in the downloaded folder. This can be done by either rightclicking an empty field within the folder and selecting Open terminal or directly entering cd Path/to/folder in an already opened terminal window.

2. Installing Python 3

The MIEZEPY package has been written exclusively in python and supports only python 3. To this effect an installation of python 3 is required to run the software. If not already present it is possible to install it through the following command:

$ sudo apt-get install python3.7

Furthermore, we require to install a common package manager for python called pip through:

$ sudo apt-get install python3-pip

The last step might not be necessary as for some python versions pip is included by default. If the installation is successful we can proceed by checking the installation versions:

$ python3 --version
$ pip3 --version

If the above command fails try to replace pip3 ith pip as pip not being installed by default on linux it might select the former namespace. Finally, the output should be the version numbers of python and pip above 3.6.6 and 18.1 (at the time of writing) respectively.

Example image

3. Installing the dependencies and software

The MIEZEPY package has dependencies on some common (like numpy) and less common (like PyQt) python libraries. These need to be installed in order to launch the package. In any terminal window enter the following commands:

$ sudo pip3 pip3 install -r requirements.txt
$ sudo pip3 install git+git://github.com/pyqtgraph/pyqtgraph.git
$ sudo pip3 install git+git://github.com/AlexanderSchober/simpleplot_qt.git

The first command installs the requirements defined in the requirements.txt file included in the repository. The second line installs a graphical PyQt library and the third command install the ploting library derived from PyQt and pyqtgraph. Finally the software can be installed through the command:

$ python3 setup.py install

4. Testing the installation

Once the installation is finished the software can be tested by launching the python interpreter through:

$ python3
    >> import miezepy
    >> miezepy.__version__

This should provided the version number of the downloaded distribution.