Table of Chapters Contents
1 Linux pip install
2 Next steps

Contents

Table of Contents 1 Linux pip 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 pip install

These are the install instructions for Linux/pip. 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

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 may want to copy the data files to your Desktop or another convenient location. To do this, navigate on the command line to your desired destination folder (for help, see this Cookbook section). Then, use the command:

  move_data_files.py

This will copy all of the PmagPy example files to your current directory. NB: If you have a developer install, you can simply navigate to PmagPy/data_files, and move_data_files.py will not be needed.

1.7 Keeping PmagPy up-to-date

To stay up to date with new features and bug fixes, you should periodically update both PmagPy packages.

 
  pip install pmagpy --upgrade --no-deps

To check the currently installed version number for pmagpy (or any other Python package), run:

  conda list

If you ever need to uninstall pmagpy or pmagpy-cli:

 
  pip uninstall pmagpy

or

  pip uninstall pmagpy-cli

2 Next steps

Back to the Cookbook!