{"id":32136815,"url":"https://github.com/shtools/shtools","last_synced_at":"2025-10-21T04:40:52.948Z","repository":{"id":21407633,"uuid":"24725612","full_name":"SHTOOLS/SHTOOLS","owner":"SHTOOLS","description":"SHTOOLS - Spherical Harmonic Tools","archived":false,"fork":false,"pushed_at":"2025-07-26T13:50:35.000Z","size":467618,"stargazers_count":401,"open_issues_count":33,"forks_count":108,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-09-17T16:31:14.390Z","etag":null,"topics":["fortran","gravity-field","magnetic-field","python","slepian-functions","spectral-analysis","spherical-harmonics","topography"],"latest_commit_sha":null,"homepage":"https://shtools.github.io/SHTOOLS/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SHTOOLS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null}},"created_at":"2014-10-02T15:53:36.000Z","updated_at":"2025-09-12T13:22:39.000Z","dependencies_parsed_at":"2023-02-17T21:16:05.365Z","dependency_job_id":"d33aace8-ee10-4c77-be46-a02cc1addcb7","html_url":"https://github.com/SHTOOLS/SHTOOLS","commit_stats":{"total_commits":1226,"total_committers":19,"mean_commits":64.52631578947368,"dds":"0.22838499184339311","last_synced_commit":"3e8554528d18b8a518e689b65faf8e75ede2689c"},"previous_names":[],"tags_count":48,"template":false,"template_full_name":null,"purl":"pkg:github/SHTOOLS/SHTOOLS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SHTOOLS%2FSHTOOLS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SHTOOLS%2FSHTOOLS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SHTOOLS%2FSHTOOLS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SHTOOLS%2FSHTOOLS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SHTOOLS","download_url":"https://codeload.github.com/SHTOOLS/SHTOOLS/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SHTOOLS%2FSHTOOLS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280207158,"owners_count":26290613,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-21T02:00:06.614Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fortran","gravity-field","magnetic-field","python","slepian-functions","spectral-analysis","spherical-harmonics","topography"],"created_at":"2025-10-21T04:40:50.707Z","updated_at":"2025-10-21T04:40:52.941Z","avatar_url":"https://github.com/SHTOOLS.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"SHTOOLS LOGO\" src=\"misc/logo.png\" width=\"100%\"\u003e\n    \u003ca href=\"https://shtools.github.io/SHTOOLS/\"\u003e\u003cimg alt=\"Documentation\" src=\"https://img.shields.io/badge/documentation-shtools.github.io%2FSHTOOLS%2F-yellow.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://doi.org/10.5281/zenodo.592762\"\u003e\u003cimg alt=\"DOI\" src=\"https://zenodo.org/badge/doi/10.5281/zenodo.592762.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://doi.org/10.1029/2018GC007529\"\u003e\u003cimg alt=\"Paper\" src=\"https://img.shields.io/badge/paper-10.1029/2018GC007529-orange.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://mybinder.org/v2/gh/SHTOOLS/SHTOOLS/master?filepath=examples%2Fnotebooks%2F\"\u003e\u003cimg alt=\"Binder\" src=\"https://mybinder.org/badge_logo.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://matrix.to/#/%23pyshtools:matrix.org\"\u003e\u003cimg alt=\"Chat on matrix\" src=\"https://img.shields.io/badge/chat-on_[matrix]-4bb596.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://app.gitter.im/#/room/#pyshtools:matrix.org\"\u003e\u003cimg alt=\"Chat at gitter\" src=\"https://badges.gitter.im/SHTOOLS/SHTOOLS.svg\"\u003e\u003c/a\u003e\n    \u003cimg alt=\"License\" src=\"https://img.shields.io/badge/License-BSD_3--Clause-brightgreen.svg\"\u003e\n    \u003ca href=\"https://fosstodon.org/@shtools\"\u003e\u003cimg alt=\"Mastodon Follow\" src=\"https://img.shields.io/mastodon/follow/108112567255227248?domain=https%3A%2F%2Ffosstodon.org\u0026style=social\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nSHTOOLS/pyshtools is a Fortran-95/Python library that can be used for spherical harmonic transforms, multitaper spectral analyses, expansions of gridded data into Slepian basis functions, standard operations on global gravitational and magnetic field data.\n\n### TABLE OF CONTENTS\n\u003c!-- toc --\u003e\n\n- [FEATURES](#features)\n- [HOW TO USE](#how-to-use)\n- [INSTALLATION](#installation)\n  - [pyshtools (for Python)](#pyshtools-for-python)\n    - [Install using `conda`](#install-using-conda)\n    - [Install using `pip`](#install-using-pip)\n    - [For Developers](#for-developers)\n  - [SHTOOLS (for Fortran 95)](#shtools-for-fortran-95)\n    - [Install using the `brew` package manager (MacOS, Linux, Windows)](#install-using-the-brew-package-manager-macos-linux-windows)\n    - [Install using the `macports` package manager (MacOS)](#install-using-the-macports-package-manager-macos)\n    - [Install from source](#install-from-source)\n- [CONTRIBUTING](#contributing)\n- [MAINTAINERS AND CONTRIBUTORS](#maintainers-and-contributors)\n- [LICENSE](#license)\n- [REFERENCES](#references)\n\n\u003c!-- tocstop --\u003e\n\n### FEATURES\n\n* Supports all standard normalizations and phase conventions of the spherical harmonic functions.\n\n* Effortless conversion between real and complex harmonics, and between different normalization and phase conventions.\n\n* Use of both regularly sampled geographic grids and grids appropriate for Gauss-Legendre quadrature.\n\n* Spherical harmonic transforms proven to be accurate up to about degree 2800 for the native Fortran 95 backend and beyond using the [DUCC0](https://gitlab.mpcdf.mpg.de/mtr/ducc) backend.\n\n* Perform localized multitaper spectral analyses, or expand gridded data in terms of localized Slepian basis functions.\n\n* Support for standard data and file formats, including *xarray* and *netcdf*.\n\n* Import research-grade gravity, topography, and magnetic field datasets with a single command.\n\n* Creation of publication quality maps using [Cartopy](https://scitools.org.uk/cartopy) and [PyGMT](https://scitools.org.uk/cartopy/docs/latest).\n\n* Support multithreaded programming using the [OpenMP](https://www.openmp.org) API.\n\n### HOW TO USE\n\nA variety of Python tutorials and guides are available to explain the main library features. To get started, click on the following Python tutorials and run them interactively in Binder:\n\n* [Spherical harmonic coefficients and grids](https://nbviewer.jupyter.org/github/SHTOOLS/SHTOOLS/blob/master/examples/notebooks/grids-and-coefficients.ipynb)\n* [Localization windows and spectral analysis](https://nbviewer.jupyter.org/github/SHTOOLS/SHTOOLS/blob/master/examples/notebooks/localized-spectral-analysis.ipynb)\n* [Gravity and magnetic fields](https://nbviewer.jupyter.org/github/SHTOOLS/SHTOOLS/blob/master/examples/notebooks/gravity-and-magnetic-fields.ipynb)\n* [Plotting maps](https://nbviewer.jupyter.org/github/SHTOOLS/SHTOOLS/blob/master/examples/notebooks/plotting-maps.ipynb)\n\n### INSTALLATION\n\nSHTOOLS can be invoked in any Fortran 95 or Python program. The core software is written in Fortran 95, and Python wrappers and dedicated classes allow simple access to the fortran-compiled routines. To install it, run these commands below:\n\n#### pyshtools (for Python)\n\n##### Install using `conda`:\n```bash\nconda install -c conda-forge pyshtools\nconda update -c conda-forge pyshtools  # to upgrade a pre-existing installation\n```\n\n##### Install using `pip`:\n```bash\npip install pyshtools\npip install --upgrade pyshtools  # to upgrade a pre-existing installation\npip install pyshtools --no-binary pyshtools  # build from source\npip install git+https://github.com/SHTOOLS/SHTOOLS@develop  # install the develop branch from source\n```\n\n##### For developers:\nInstall the system level build requirements:\n```bash\nsudo apt-get install build-essential cmake gfortran  # Debian, Ubuntu and derivatives\nsudo dnf group install \"C Development Tools and Libraries\" \"Development Tools\"  # Fedora, Centos, RHEL and derivatives\nsudo dnf install cmake gcc-fortran  # Fedora, Centos, RHEL and derivatives\nxcode-select --install  # macOS\n```\n\nThen clone the shtools repo, install the other dependencies, and install manually in a conda environment:\n```bash\ngit clone https://github.com/SHTOOLS/SHTOOLS.git\ncd shtools\nconda create -n your_env_name python=3.xx  # create a new conda environment, if desired\nconda env update -n your_env_name -f environment.yml\nconda activate your_env_name  # activate the new conda environment\npip install --no-build-isolation -e .  # install into the shtools folder and link to the active python environment\n```\n\n#### SHTOOLS (for Fortran 95)\n\n##### Install using the [brew](http://brew.sh/) package manager (MacOS, Linux, Windows):\n```bash\nbrew install shtools\n```\n\n##### Install using the [macports](https://www.macports.org/) package manager (MacOS):\n```bash\nsudo port install shtools\n```\n\n##### Install from source:\nClone or download the this repo, and then execute one (or both) of the following commands in the `shtools` directory:\n```bash\nmake fortran\nmake fortran-mp  # for OpenMP Fortran routines\n```\n\nFurther installation instructions and options can be found in the [web documentation](https://shtools.github.io/SHTOOLS/).\n\n### CONTRIBUTING\n\nWe work on the `develop` branch and only push releases to `master`. Please base all pull requests on `develop`.\n\n### CONTRIBUTORS\n\nFor the full list of contributors, see the [AUTHORS](./AUTHORS.md) file.\n\n### LICENSE\nThis project uses the BSD 3-Clause license, as found in the [LICENSE](./LICENSE.txt) file.\n\n### REFERENCES\n- Mark A. Wieczorek and Matthias Meschede (2018). SHTools --- Tools for working with spherical harmonics, *Geochemistry, Geophysics, Geosystems*, 19, 2574-2592, doi:[10.1029/2018GC007529](https://doi.org/10.1029/2018GC007529).\n- Mark Wieczorek, *et al*. (2019). SHTOOLS/SHTOOLS. Zenodo, doi:[10.5281/zenodo.3457861](https://doi.org/10.5281/zenodo.3457861)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshtools%2Fshtools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshtools%2Fshtools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshtools%2Fshtools/lists"}