Table of Chapters Contents
1 Linux developer install
2 Next steps

Contents

Table of Contents 1 Linux developer install
 1.1 Install Python
 1.2 Install wxPython
 1.3 Test your python
 1.4 Install PmagPy
 1.5 Test PmagPy
 1.6 Finishing up
 1.7 Keeping PmagPy up-to-date
2 Next steps

1 Linux developer install

These are the install instructions for Linux/developer. If this isn’t your operating system, or you want a developer install, go back to the Cookbook and select the correct link.

1.1 Install Python

First, you will need to download a scientific Python distribution. We strongly recommend Anaconda. Be warned, your computer comes with a version of Python already installed; but this pre-installed version does NOT have everything you will need to run PmagPy, so you will still need to download Anaconda.

1.2 Install wxPython

Next, you need to install wxPython.

1.3 Test your python

Run python on your command line.

You should see something like this:

 
Python 3.6.1 |Anaconda custom (x86_64)| (default, May 11 2017, 13:04:09)  
[GCC 4.2.1 Compatible Apple LLVM 6.0 (clang-600.0.57)] on darwin  
Type "help", "copyright", "credits" or "license" for more information.  
>>>

If you don’t see that, go back and reinstall Anaconda.

Once you have successfully started the python interactive prompt, try:

 
    import wx  

You may have an error like this:

    ImportError: libwx_gtk3u_core-3.0.so.0: cannot open shared object file: No such file or directory  

If so, exit the python interpreter (quit()) and try:

    export LD_LIBRARY_PATH=~/anaconda3/lib/python3.6/site-packages/wx/  

(If you are using a non-Anaconda Python, your path to wx may be different).

Try again to import wx. If it now works, you may want to add that line to the end of your .bashrc file so that you don’t have to specify the path each time.

For more details about this issue, see this explanation and this Github issue for more information.

1.4 Install PmagPy

Here are the steps to clone and install PmagPy.

1.5 Test PmagPy

Test core functionality:

Test the GUIs:

If any of these commands don’t work, go back and carefully follow the install instructions. If you still have a problem, try the Troubleshooting section. If you don’t find an answer there, check out the existing Github issues and create a new one if necessary.

1.6 Finishing up

Accessing example data files:

There are many data files used in the examples of programs and for use with the textbook Essentials of Paleomagnetism. You can find these in PmagPy/data˙files.

1.7 Keeping PmagPy up-to-date

You will want to stay up to date with PmagPy development. To update your developer install, you will just need to navigate to the PmagPy directory and run:

    git pull

This will grab all of the latest code from Github, and will be immediately available to you.

2 Next steps

Back to the Cookbook!