Table of Chapters Contents
1 OSX pip install
2 Next steps

Contents

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

1 OSX pip install

These are the install instructions for OSX/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 Test your python

To make sure that you have installed Python successfully, type 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.  
>>>

(Press control-D to exit)

1.3 Install PmagPy

1.4 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.5 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.6 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!