Skip to content

Commit

Permalink
Add a 'Common installation issues' section to the install guides (#2868)
Browse files Browse the repository at this point in the history
  • Loading branch information
seisman authored Dec 14, 2023
1 parent b18cc59 commit 314d3df
Showing 1 changed file with 9 additions and 4 deletions.
13 changes: 9 additions & 4 deletions doc/install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -248,9 +248,14 @@ following in your Python interpreter::

If you see a global map with shorelines, then you're all set.

Common installation issues
--------------------------

Finding the GMT shared library
------------------------------
If you have any issues with the installation, please check out the following
common problems and solutions.

"Error loading GMT shared library at ..."
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Sometimes, PyGMT will be unable to find the correct version of the GMT shared
library (``libgmt``).
Expand All @@ -272,8 +277,8 @@ and set its value to a path like::

C:\Users\USERNAME\Miniforge3\envs\pygmt\Library\bin\

Notes for Jupyter users
-----------------------
``ModuleNotFoundError`` in Jupyter notebook environment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If you can successfully import pygmt in a Python interpreter or IPython, but
get a ``ModuleNotFoundError`` when importing pygmt in Jupyter, you may need to
Expand Down

0 comments on commit 314d3df

Please sign in to comment.