Update the title for the images/EPS on maps gallery example
"""
-Images or EPS files on maps
----------------------------
-The :meth:`pygmt.Figure.image` method can be used to read and
-place a raster image file or an Encapsulated PostScript file
-on a map. We must specify the file as *str* via the ``imagefile``
-parameter or simply use the filename as the first argument. You can
-also use a full URL pointing to your desired image. The ``position``
-parameter allows us to set a reference point on the map for the image.
-
+Images on figures
+-----------------
+The :meth:`pygmt.Figure.image` method can be used to read and place an image
+file in many formats (e.g., png, jpg, eps, pdf) on a figure. We must specify
+the filename via the ``imagefile`` parameter or simply use the filename as
+the first argument. You can also use a full URL pointing to your desired image.
+The ``position`` parameter allows us to set a reference point on the map for
+the image.
"""
import os
import pygmt
fig = pygmt.Figure()
-
-fig.basemap(region=[0, 2, 0, 2], projection="X6c", frame=True)
+fig.basemap(region=[0, 2, 0, 2], projection="X10c", frame=True)
# place and center the GMT logo from the GMT website to the position 1/1
-# on a basemap and draw a rectangular border around the image
+# on a basemap, scaled up to be 3 cm wide and draw a rectangular border
+# around the image
fig.image(
imagefile="https://www.generic-mapping-tools.org/_static/gmt-logo.png",
position="g1/1+w3c+jCM",
