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.9.1.tar.gz (761.2 kB view details)

Uploaded Source

Built Distribution

pmagpy_cli-0.9.1-py2-none-any.whl (805.7 kB view details)

Uploaded Python 2

File details

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

File metadata

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

File hashes

Hashes for pmagpy-cli-0.9.1.tar.gz
Algorithm Hash digest
SHA256 bd2fcd8be0bf16be909a6afab9173825a4cf31fbc9e453c7f8f0cbe667edd79e
MD5 6034470a68f6d32d4c6ef9cc4a8bb828
BLAKE2b-256 9f8c27460b80331d041cb3d6643f86d49b4edf6874b9b26288f6b644e2a9105c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pmagpy_cli-0.9.1-py2-none-any.whl
Algorithm Hash digest
SHA256 dbf22e6e4824184f31dee7adcf33bc7ad9d7096a545b7f918edbe879193c8c77
MD5 f461580624ce825ef34a27af07365c35
BLAKE2b-256 77af34ba80be948faf5c34b1a5cfe2512d8d68f5df04d1a65a9e2f23afcb8850

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