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.
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.
You can do the same for pmagpy-cli.
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 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:
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.
To stay up to date with new features and bug fixes, you should periodically update both PmagPy packages.
To check the currently installed version number for pmagpy (or any other Python package), run:
If you ever need to uninstall pmagpy or pmagpy-cli:
Back to the Cookbook!