This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description


SHTOOLS is a Fortran 95 / Python library that can be used to perform spherical harmonic transforms and reconstructions, rotations of data expressed in spherical harmonics, and multitaper spectral analyses on the sphere.


  • A wide range of supported spherical harmonic functions:
  • real and complex,
  • different normalizations (Geodesy 4π, Schmidt semi-normalized, orthonormalized, unnormalized),
  • Condon-Shortley phase factor of (-1)m.
  • Selected applications and routines:
  • global spectral analysis, spherical harmonic rotations, Wigner 3j symbols,
  • localized multitaper spectral analyses, optimal window generation, spherical harmonic coupling matrices,
  • standard gravity and magnetic field calculations, computation of the geoid, finite-amplitude potential from topography.
  • Clean implementation of the spherical harmonic transforms:
  • Exact quadrature rules using either the sampling theorem of Driscoll and Healy (1994) where data are equally sampled (or spaced) in latitude and longitude, or Gauss-Legendre quadrature.
  • Accurate and fast to approximately degree 2800, corresponding to a spatial resolution higher than 4 arc minutes. Transforms and reconstructions take on the order of 1 second for bandwidths less than 600 and about 3 minutes for bandwidths close to 2800 on standard machines. The Fortran 95 routines are OpenMP compatible and OpenMP thread-safe.




sudo apt-get install libblas-dev liblapack-dev g++ gfortran libfftw3-dev tcsh


brew install fftw --with-fortran

Python Library

pip install pyshtools

Or, to install a developer version, download or clone the SHTOOLS repository, enter the SHTOOLS folder and then execute one of the following commands:

pip install .  # installs into the active python environment lib folder
pip install -v -e .  # installs into the SHTOOLS/pyshtools folder and links to the active python environment

Fortran Library

To install the Fortran 95 library, enter one of the following

make fortran
make fortran-mp  # Open-MP Fortran routines

Or, with OSX, use the brew package manager:

brew tap shtools/shtools
brew install shtools

To also install the OpenMP components, add --with-openmp to the last command.

More installation instructions and options can be found in the web documentation and GitHub wiki.


SHTOOLS can be invoked from Fortran 95, Python 2, or Python 3. The base SHTOOLS software is written in Fortran 95, and the Python library allows simple access to all fortran-compiled routines and offers helper routines as well as simple interfaces.

To get started, check out the following Python tutorial notebooks:

  • Introduction 1: Grids and Spherical Harmonic Coefficients [ipynb]
  • Introduction 2: Localization Windows and Spectral Analysis [ipynb]
  • Tutorial 1: Simple Spherical Harmonic Expansions [ipynb]
  • Tutorial 2: Localized Spectral Analysis on the Sphere [ipynb]
  • Tutorial 3: The SHTOOLS Class Interface [ipynb]
  • Tutorial 4: Spherical Harmonic Normalizations and Parseval’s theorem [ipynb]
  • Tutorial 5: Multitaper Spectral Estimation - SHWindows Class Interface [ipynb]
  • Tutorial 6: 3D Spherical Harmonic Plots [ipynb]

You can keep up to date by following SHTOOLS on Twitter.


SHTOOLS is open source (revised BSD license) and makes use of the freely available Fourier transform package FFTW and the linear algebra packages LAPACK and BLAS.


Wieczorek, M. A., M. Meschede, I. Oshchepkov, E. Sales de Andrade (2016). SHTOOLS: Version 3.3. Zenodo. doi:10.5281/zenodo.60010.

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pyshtools-3.4.tar.gz (17.8 MB) Copy SHA256 Checksum SHA256 Source Aug 30, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting