# AGU 2024 GMT/PyGMT workshop

https://agu.confex.com/agu/agu24/prelim.cgi/ModuleMeetingInfo/scientificworkshop

## Title

Mastering Geospatial Visualizations with GMT/PyGMT

## Description (less than 500 words)

This workshop aims to provide a detailed technical demonstration of GMT/PyGMT's capabilities in creating maps and visualizations of geospatial, geophysical, and planetary data across a wide range of applications. PyGMT, a Python library built on top of the Generic Mapping Tools (GMT), offers an intuitive and accessible interface for generating high-quality figures suitable for publication. Suitable for both beginner and advanced Python users, this workshop will cover advanced techniques for manipulating geospatial and geophysical data, widely utilized in the Earth, Ocean and Planetary Science communities, providing participants with the necessary skills to extract meaningful insights and effectively communicate their findings through clear and informative maps and visualizations. By exploring GMT/PyGMT's functionalities, participants will have the opportunity to learn how to create customized maps and data visualizations tailored to the specific needs of their research areas.

## Learning outcomes

By the end of this workshop, students should be able to:

- Create basic geographic maps using different projection systems
- Add various map elements such as colorbars and legends to maps, and be able arrange subplot panels
- Handle the plotting of PyData data structures (numpy/pandas/geopandas/xarray) in PyGMT maps
- Be comfortable with using GMT/PyGMT for illustrating Earth and Planetary science data!

## Agenda & Engagement Plan

> Similar concept to the EGU short course, to cover different levels of expertises.
An short introduction part at the beginning?
Around four Jupyter notebooks people can work with on their own?

The 7 hour long workshop will be based on content adapted from https://github.com/GenericMappingTools/gmt-for-geodesy and https://github.com/GenericMappingTools/egu22pygmt. Each of the 30-45 min tutorials will involve a short (~10 min) walkthrough by the presenter, followed by a more hands-on session where workshop participants do a deep-dive on the topic (using interactive Jupyter notebooks) in a guided environment with a number of instructors on hand to answer questions.

We invite students and researchers from the Earth, Ocean, and Planetary sciences community to join. The focus of this workshop is to develop skills on using free and open source software, coding, data manipulation and visualization. Learn to produce publication-ready figures, especially geographic maps, using PyGMT including the integration with the PyData ecosystem.

Outline:

1. Introduction to Generic Mapping Tools
2. Symbols and Lines
3. Grids and Images
4. Subplots and map elements
5. PyGMT wrapper
6. Geophysics
7. Planetary science
8. Mini mapping project

## Learning Focus

**Technical Skills for Science**: Focuses on specific technical skills (software, coding, hardware, or other tools to advance science). Can be for either discipline specific audiences or broader audiences.

## Knowledge & Career Level

Level of knowledge

Who are you targeting and what level of career stage would most benefit from your workshop proposal? Check all that apply.

- [x] Beginner
- [x] Intermediate
- [ ] Advanced

Career Stage

- [x] Student/Early Career
- [x] Mid-Career
- [ ] Advanced

## Target Audience

Does the proposal apply to general audiences or specific AGU sections? If so, please select "General", the appropriate AGU section(s), or check "Other" from the list below to identify alternative audiences, disciplines, or communities.

- [ ] Air-Sea Interactions
- [ ] Biodiversity
- [ ] Biogeochemistry and Nutrients
- [ ] Chemical Tracers, Organic Matter and Trace Elements
- [ ] Coastal Dynamics
- [x] Early Career
- [ ] Ecology and Physical Interactions
- [ ] Ecology and Social Interactions
- [x] Education
- [ ] Education, Outreach and Policy
- [ ] Estuarine Processes
- [ ] Fisheries
- [x] General
- [ ] High Latitude Environments
- [ ] Marine Ecosystems
- [ ] Marine Geology and Sedimentology
- [ ] Microbiology and Molecular Ecology
- [ ] Ocean Change: Acidification and Hypoxia
- [ ] Ocean Data Management
- [ ] Ocean Modeling
- [ ] Ocean Observatories, Instrumentation and Sensing Technologies
- [X] Past, Present and Future Climate
- [X] Physical Oceanography: Mesoscale and Larger
- [ ] Physical Oceanography: Mesoscale and Smaller
- [ ] Physical Oceanography: Other
- [ ] Regional Studies
- [x] Science Communication
- [x] Students
- [X] Other: Planetary Science

## Participants

- Include the proposal submitter, organizer, and onsite contact if different.

| Name | Affiliation | ORCID |
| --- | --- | --- |
| Wei Ji Leong | Development Seed, USA | https://orcid.org/0000-0003-2354-1988
| Andre Belem | Fluminense Federal University, Brazil | https://orcid.org/0000-0002-8865-6180
| Yvonne Fröhlich | Karlsruhe Institute of Technology, Germany | https://orcid.org/0000-0002-8566-0619 |
| Max Jones | University of Hawaiʻi at Mānoa |https://orcid.org/0000-0003-0180-8928 |

## Comments (optional)

> - Please provide any general comments and/or notes to the program committee and review team.
> - Please include any collaboration across departments or with members or meeting attendees.
> - Please include any specific dates or times to be avoided during AGU24. Please note, requests cannot be guaranteed.

This workshop will be supported by the GMT sustainability funds from the University of Hawaii at Manoa. We anticipate that there will be additional presenters/helpers that are able to contribute to this workshop once it is accepted as it will unlock some additional funding for external contributors from the GMT/PyGMT community to attend the AGU conference on-site.