MANUAL PYGMT – GMT

REQUERIMIENTOS DE INSTALACIÓN PYGMT

PyGMT es compatible con versiones de Python desde 3.7.

PyGMT require de las siguientes librerias:

 Numpy (>= 1.18)
 Pandas
 Xarray
 NetCDF4
 Packaging

INSTALACIÓN PYGMT
GMT está disponible en Windows, macOS, Linux y FreeBSD. Para su instalación
es necesario ingresar al siguiente link y descargar el instalador según el sistema
operativo correspondiente:
https://github.com/GenericMappingTools/gmt/releases/tag/6.3.0

Instalación Linux – UBUNTU:

Para instalar GMT en Ubuntu (Linux) se deben ejecutar los siguientes comandos
en la terminal:

sudo apt-get update

sudo apt-get install gmt
Instalación Windows y MacOS:
Para saber la versión que tenemos, debemos buscar y abrir el Prompt de
Anaconda en Windows, como se muestra a continuación.

Posteriormente, se debe ejecutar el siguiente comando y se mostrará la versión de

Python que tenemos asociada a Anaconda.
python
y después se ejecuta:
quit()
Para realizar la instalación de PyGMT es necesario configurar conda para la
obtención de paquetes, así:
conda config --prepend channels conda-forge

Ahora, para crear un ambiente conda e instalar todas las dependencias necesarias
se debe ejecutar el siguiente comando.
conda create --name pygmt python=3.9 numpy pandas xarray netcdf4 packaging
gmt
Nota: Si aparece alguna solicitud como la que se muestra a continuación, se debe
escribir y o s dependiendo del idioma en que se encuentre configurado nuestro
computador.
Finalmente, para acceder al ambiente se debe ejecutar el siguiente comando:
conda activate pygmt

Nos dirijimos a Anaconda -> Environments y activamos el ambiente de PyGMT

instalado, dando click en el icóno de play.

Ya finalizó el proceso de instalación. Sin embargo, el siguiente link proporciona

más detalles sobre ella: https://www.pygmt.org/dev/install.html
Para verificar que se haya instalado correctamente, podemos abrir Spyder o
Jupyter NoteBook en Anaconda y probar el siguiente código:
import pygmt
pygmt.show_versions()

fig = pygmt.Figure()
fig.coast(region="g", frame=True, shorelines=1)
fig.show()

Y se debe obtener el siguiente resultado:

USO DE PYGMT
Siempre debemos importar la librería PyGMT de Python de la siguiente manera
para poder hacer uso de sus funciones:
import pygmt

En PyGMT, cada mapa o producto debe comenzar con la creación de la

pygmt.Figure, por lo tanto, es necesario agregar la siguiente línea al iniciar nuestro
código:
fig = pygmt.Figure()

Posteriormente, dependiendo de lo que se desee plotear se utilizan las

funcionalidades de PyGMT. Todas las funcionalidades se encuentran descritas en
su sitio web y pueden ser consultadas en cualquier momento.
https://www.pygmt.org/latest/
Finalmente, PyGMT necesita un comando especial de cierre para mostrar el plot
realizado. El cuál es el siguiente:
fig.show()

o en tal caso que deseemos ver el plot en un visor PDF (Ejm Adobe Acrobat
Reader) se puede agregar el método external así:
fig.show(method='external')

FUNCIONALIDADES
A continuación, veremos algunas de las funcionalidades más importantes:
1. PYGMT.FIGURE.COAST
Plotea continentes, costas, ríos y fronteras en mapas.
https://www.pygmt.org/latest/api/generated/
pygmt.Figure.coast.html#pygmt.Figure.coast
Cada funcionalidad contiene una plantilla que permite ajustar sus parametros (en
letras naranjas), aunque cabe resaltar que no todos son necesarios para utilizar la
función, se ilustra esto a través de los siguientes ejemplos:

Figure.coast(region=None, projection=None,
area_thresh=None, lakes=None, frame=None, resolution=None, dcw=None, ri
vers=None, map_scale=None, borders=None, shorelines=None, land=None, 
water=None, timestamp=None, verbose=None, xshift=None, yshift=None, pa
nel=None, perspective=None, transparency=None, **kwargs)
import pygmt
# Se importa la librería para utilizar sus funciones

fig = pygmt.Figure() #Linea necesaria para inicializar el mapa

# Funcionalidad fig.coast
fig.coast(
region=[-180, 180, -60, 60],
# Coordenadas con el formato X1, X2, Y1, Y2
projection="M25c",
# Utiliza proyección UTM, la zona corresponde a 52R. 12c es el ancho del
mapa
land="#666666",
# Color de la parte continental (En este caso verde)
water="skyblue",
 # Color cuerpos de agua (En este caso azul)
shorelines= ["1/1p,black", "2/0.5p,blue"],
# Grosor y colores de las líneas de costa en el mapa
# Las lineas de costa son divididas en 4 niveles
# 1. coastline
# 2. lakeshore
# 3. island-in-lake shore
# 4. lake-in-island-in-lake shore
# 1/1p,black -> Nivel/grosor/color
frame=["afg", '+t"Mapa de prueba 2"'],
# Configura el estilo del mapa
# f = Agrega el marco por defecto
# a = Agrega el marco y sus etiquetas
# g = Agrega una grilla al marco
# Para agregar titulo se debe escribir 't"_Nombre_titulo"' o si es de
# una palabra se puede utilizar el mismo formato ó "+tIceland"

)
fig.show()

Mapa obtenido: