SHTOOLS - Tools for working with spherical harmonics | INSTITUT DE PHYSIQUE DU GLOBE DE PARIS


Aller au compte twitter

Équipes de recherche

Planétologie et sciences spatiales

  SHTOOLS - Tools for working with spherical harmonics


SHTOOLS is an archive of fortran 95 based software that can be used to perform spherical harmonic transforms and reconstructions, rotations of spherical harmonic coefficients, and multitaper spectral analyses on the sphere.


While several collections of code currently exist for working with data expressed in spherical harmonics, this one is unique for several reasons:


  • It can accommodate any standard normalization of the spherical harmonic functions ("geodesy" 4π normalized, Schmidt semi-normalized, orthonormalized, and unnormalized).
  • Either real or complex spherical harmonics can be employed.
  • Spherical harmonic transforms are calculated by exact quadrature rules using either (1) the sampling theorem of Driscoll and Healy (1994) where data are equally sampled (or spaced) in latitude and longitude, or (2) Gauss-Legendre quadrature. A least squares inversion routine for irregularly sampled data is included as well.
  • 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.
  • 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.


SHTOOLS is invoked by standard subroutine and function calls in your fortran 90/95 program. For some routines, it will be necessary to have installed the Fourier transform package FFTW, as well as the linear algebra packages LAPACK and BLAS.


Developped by Mark Wieczorek