Skip to main content

Analysis tools for paleo/rock magnetic data

Project description

## What is it

PmagPy is a comprehensive set of tools for analyzing paleomagnetic data. It facilitates interpretation of demagnetization data, Thellier-type experimental data and data from other types of rock magnetic experiments. PmagPy can be used to create a wide variety of useful plots. It is designed to work with the MagIC database (https://earthref.org/MagIC), allowing manipulation of downloaded data sets as well as preparation of new contributions for uploading to the MagIC database. It also supports the use of IPython/Jupyter notebooks for fully documented and nicely illustrated data analysis.

## Main features

PmagPy is comprised of:
  • GUI programs for getting data into MagIC database format (pmag_gui), analyzing demagnetization data (demag_gui) and analyzing paleointensity data (thellier_gui). These GUIs are also availible for download as executable programs outside of this repository: - [Mac PmagPy Executable Application](https://github.com/PmagPy/PmagPy-Standalone-OSX/releases/latest) - [Windows PmagPy Executable Application](https://github.com/PmagPy/PmagPy-Standalone-Windows/releases/latest)

  • Command line programs for all sorts of paleomagnetic data analysis and wrangling (contained within the programs folder of the repository).

  • The pmagpy function module for paleomagnetic data analysis (pmagpy.pmag) and plotting (pmagpy.pmagplotlib) as well as a function module that further enables paleomagnetic data analysis within interactive computing environments such as the Jupyter notebook (pmagpy.ipmag). The functions within these modules are at the heart of the GUI and command line programs. With pmagpy in the python path (which is accomplished using pip, see below), these modules are can be imported (e.g. `import pmagpy.ipmag as ipmag`).

  • Example data files that are used in the examples provided in the PmagPy cookbook http://earthref.org/PmagPy/cookbook

Use of all these features is described in the cookbook and the underlying science behind the data and code can be explored in the book Essentials of Paleomagnetism: Third Web Edition (http://earthref.org/MagIC/books/Tauxe/Essentials/).

## How to use it

Full documentation for PmagPy installation and use is available in the PmagPy cookbook: http://earthref.org/PmagPy/cookbook

To get started: - find your command prompt and run “pip install pmagpy –upgrade” (for help finding your command prompt, see the [documentation](http://earthref.org/PmagPy/#command_line)) - next, download a zip file of the latest release here: [PmagPy latest release](https://github.com/ltauxe/PmagPy/releases/latest). Click on “Source code (zip)” or “Source code (tar.gz)” to download. - To install the software on a Mac or a PC, unzip the downloaded folder and double-click on the install script for your system. - Linux and advanced users on Mac and PCs can either clone the repository or download the latest release and then add the directory of the main repository folder (and the program directory for access to the command line programs) to their path. On a Mac, this can be done by adding these lines to the bash_profile (edited as necessary for where the PmagPy directory is on your local machine): `export PATH=~/PmagPy:./:$PATH`; `export PATH=~/PmagPy/programs:./:$PATH`

## Background and support

The code base for the PmagPy project has been built up over many years by Lisa Tauxe (Distinguished Professor of Geophysics at the Scripps Institution of Oceanography) supported by grants from the National Science Foundation. Ron Shaar (Senior Lecturer at the Hebrew University of Jerusalem), Lori Jonestrask and Nick Swanson-Hysell (Assistant Professor at UC Berkeley) have also made substantial contributions to the project.

## More information

This code and the PmagPy cookbook (http://earthref.org/PmagPy/cookbook) are companions to the the book Essentials of Paleomagnetism: Third Web Edition (http://earthref.org/MagIC/books/Tauxe/Essentials/) written by Lisa Tauxe with contributions from Subir K. Banerjee, Robert F. Butler and Rob van der Voo. The printed version of the book came out in January, 2010 from University of California Press (http://www.ucpress.edu/book.php?isbn=9780520260313).

## Licensing

This code can be freely used, modified, and shared. It is licensed under a 3-clause BSD license. See [license.txt](https://github.com/ltauxe/PmagPy/blob/master/license.txt) for details.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pmagpy-cli-0.10.1.tar.gz (701.8 kB view details)

Uploaded Source

Built Distribution

pmagpy_cli-0.10.1-py2-none-any.whl (808.3 kB view details)

Uploaded Python 2

File details

Details for the file pmagpy-cli-0.10.1.tar.gz.

File metadata

  • Download URL: pmagpy-cli-0.10.1.tar.gz
  • Upload date:
  • Size: 701.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pmagpy-cli-0.10.1.tar.gz
Algorithm Hash digest
SHA256 07fa947657f787c2c4f0fbb3ffd7da5ba2ce1d0b172ef4a1323a8d5c2c07e5b9
MD5 16bacd008d9244ff4d9d0fb3f6608d51
BLAKE2b-256 d9b8ba4a1d51018609277bbdbbb86e31f5c5b133af0616e868659473ff676a0d

See more details on using hashes here.

File details

Details for the file pmagpy_cli-0.10.1-py2-none-any.whl.

File metadata

File hashes

Hashes for pmagpy_cli-0.10.1-py2-none-any.whl
Algorithm Hash digest
SHA256 bc2481d871ebeb8375272a817cd6aff211a07f84903724af4d15bd86b0d70d47
MD5 ac65c881d625ff318e5f6fafd8e8c7b7
BLAKE2b-256 f14fd9767ab2979c2b4c806e794d8afefa9792beaa6be9e8140a34ba959fc5d9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page