Installing

There are different ways to install Harmonica:

pip

Using the pip package manager:

pip install harmonica

conda/mamba

Using the conda package manager (or mamba) that comes with the Anaconda/Miniconda distribution:

conda install harmonica --channel conda-forge

Development version

You can use pip to install the latest unreleased version from GitHub (not recommended in most situations):

python -m pip install --upgrade git+https://github.com/fatiando/harmonica

Note

The commands above should be executed in a terminal. On Windows, use the cmd.exe or the “Anaconda Prompt” app if you’re using Anaconda.

Which Python?

You’ll need Python 3.9 or greater. See Supported Python versions if you require support for older versions.

Dependencies

The required dependencies should be installed automatically when you install Harmonica using conda or pip. Optional dependencies have to be installed manually.

Note

See Supported dependency versions for the our policy of oldest supported versions of each dependency.

Required:

• numpy

• pandas

• numba

• scipy

• xarray

• scikit-learn

• pooch

• verde

• xrft

Optional:

• pyvista and vtk (>= 9): for 3D visualizations. See harmonica.prism_to_pyvista.

• numba_progress for printing a progress bar on some forward modelling computations. See harmonica.prism_gravity.

The examples in the Gallery also use:

• boule

• ensaio for downloading sample datasets

• pygmt for plotting maps

• pyproj for cartographic projections