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.
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.
Next, you need to install wxPython.
Most recently (on Ubuntu 18.04.2), I’ve had success with simply running:
However, in the past this didn’t work and still may not work for all Linux distributions. Try the above command first, and if that fails, try working through the instructions below.
Carefully read through this page and look for a compatible wheel for your distribution. Download the appropriate wheel and then install it:
Be sure to replace the wheel name above with the actual wheel you downloaded.
Or install the wheel from the download site directly:
Again, you will need the replace the link above with the link appropriate for your OS.
Run python on your command line.
You should see something like this:
If you don’t see that, go back and reinstall Anaconda.
Once you have successfully started the python interactive prompt, try:
You may have an error like this:
If so, exit the python interpreter (quit()) and try:
(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.
Here are the steps to clone and install PmagPy.
If your result is not “/bin/bash”, you will need to reset it. See this question for more details.
Test core functionality:
Test the GUIs:
If you get an error about “pythonw”, you may need to link “python” to “pythonw” with the command:
If you get any other errors, or if any of the test 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.
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.
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:
This will grab all of the latest code from Github, and will be immediately available to you.
Back to the Cookbook!