HOME | DOWNLOAD | DOCUMENTATION | FAQ |

*The current version of SHTOOLS is 3.2 (released June 20, 2016)*

# What is SHTOOLS?

SHTOOLS is an archive of Fortran 95 and Python software 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.

SHTOOLS is extremely versatile:

- It can accommodate any standard normalization of the spherical harmonic functions ("geodesy" 4π normalized, Schmidt semi-normalized, orthonormalized, and unnormalized).
- Both real and complex spherical harmonics are supported.
- Spherical harmonic transforms are calculated by 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. - One can choose to use or exclude the Condon-Shortley phase factor of (-1)
^{m}with the associated Legendre functions. - The spherical harmonic transforms are proven to be accurate to approximately degree 2800, corresponding to a spatial resolution of better than 4 arc minutes.
- Routines are included for performing localized multitaper spectral analyses.
- It is OpenMP compatible and OpenMP thread-safe.
- Routines are included for performing standard gravity and magnetic field calculations, such as computation of the geoid and the determination of the potential associated with finite-amplitude topography.
- The routines are fast. Spherical harmonic transforms and reconstructions take on the order of 1 second for bandwidths less than 600 and about 3 minutes for bandwidths close to 2800.

# How do I install SHTOOLS?

The most recent release of SHTOOLS can be downloaded from GitHub. Installation of SHTOOLS can be as simple as executing the following command in a unix terminal:

make

To run the Fortran 95 and Python tests, enter

make fortran-tests

make python-tests

To compile the OpenMP version of the fortran routines, enter

make fortran-mp

More information can be found on the GitHub wiki and in the SHTOOLS documentation. Keep up to date by following SHTOOLS on Twitter.

# How do I use SHTOOLS?

SHTOOLS can be used in any Fortran 95 or Python program. The base SHTOOLS software is written in Fortran 95, and Python wrappers allow simple access to all fortran-compiled routines. SHTOOLS makes use of the freely available Fourier transform package FFTW and the linear algebra packages LAPACK and BLAS.

# How much does it cost?

The SHTOOLS software package is entirely free and open source. SHTOOLS can be modified and distributed according to the revised BSD license.

Institut de Physique du Globe de Paris | University of Sorbonne Paris CitÃ© | © 2016 SHTOOLS |