AcadGIS: A Single-Import Python Package for Reproducible, Publication-Ready Academic Maps

Jul 16, 2026

Upload by Noah

Academic and project maps are often produced through fragmented, manual workflows, creating accessibility barriers for non-GIS users and reproducibility gaps when data sources, styling, and edits are not captured in executable form. AcadGIS is a free and open-source Python package that generates publication-oriented research maps from high-level commands in a single namespace import acadgis as agis. It automates boundaries, locator layouts, thematic cartography, raster/vector layers, Earth-observation products, and PNG/PDF/SVG exports with version-pinned, inspectable figure specifications, demonstrated via representative use cases.

LanguageEnglish

CategoryResearch & Report

FormatPDF

Pages19

Reading Time48 min

Abstract

Introduction

Motivation and problem gaps

Existing tools and their limitations

Research question and AcadGIS approach

Contributions

arXiv :2607 . 10017v1 [ cs .MS] 10 Jul 2026 AcadGIS: A Single-Import Python Package for Reproducible, Publication-Ready Academic Maps Ripon Chandra Malo 1 , Shatabdi Roy2 , and Tong Qiu 1 1 University of Utah, USA 2 Jagannath University, Bangladesh July 2026 Abstract Academic and project maps are often produced through a fragmented workflow: researchers locate boundaries, manage shapefiles, join tabular data, assemble locator insets, add cartographic decorations, and export figures through desktop GIS or multi-package Python scripts. This creates an accessibility barrier for non-GIS users and a reproducibility problem when data sources, styling choices, and manual edits are not captured in executable form. We present AcadGIS, a free and open-source Python package that creates publication-oriented research maps from high-level commands under one namespace, import acadgis as agis. AcadGIS provides place-name boundary access, automated study-area locator layouts, thematic cartography, raster and vector layers, curated Earth-observation products, terrain and hydrology context, and configurable PNG, PDF, and SVG export without requiring desktop GIS expertise or hand-managed shapefiles. Its design combines one-import access to the scientific-Python stack, publication-oriented defaults with progressive control, local caching, source attribution, and figure specifications based on code, named data, and a pinned package version. Through three representative use cases, we demonstrate how common paper, thesis, and project maps can be expressed as compact, inspectable scripts. Source code: [https://github.com/riponcm/AcadGIS](https://github.com/riponcm/AcadGIS). Keywords: academic mapping, publication-ready maps, reproducible cartography, geospatial Python, study-area maps, thematic cartography, Earth observation 1 Introduction Maps are common components of scientific argument. A study-area figure tells the reader where fieldwork or project activity occurs; a choropleth turns a table into spatial evidence; terrain, landcover, satellite, river, and road layers place local observations in geographic context. These figures appear throughout the earth, environmental, health, agricultural, engineering, and social sciences. For many students and researchers, however, producing a clear study-area or research map is a practical obstacle rather than a scientific task. They may know the place name and the data they want to show, but not how to obtain administrative boundaries, manage shapefiles, use desktop GIS, choose cartographic decorations, or combine multiple Python geospatial packages into a figure suitable for publication. The difficulty is not a lack of map-making tools. Web map services can generate a quick location map, and desktop GIS systems such as QGIS [1] and ArcGIS Pro [2] provide mature cartographic environments. These tools are powerful, but they are not always aligned with the needs of a non-GIS specialist who simply needs a reproducible study map for a paper, thesis, project report, or proposal. A publication map commonly requires administrative boundaries from one source, imagery or elevation from another, tabular measurements from a spreadsheet, and final composition through a graphical interface or custom code layered over Matplotlib [3], GeoPandas [4], Rasterio, Contextily, PySAL, and other libraries. Each component is useful, but the combined workflow requires GIS knowledge, shapefile handling, package coordination, and manual styling decisions. This creates two related gaps. The first is an accessibility gap: many researchers need publicationoriented maps but do not need, and may not have time to learn, a full GIS workflow. The second is a reproducibility gap: when a figure is assembled through downloads, point-and-click editing, and one-off scripts, the finished image often preserves the visual result but not the exact recipe. In an audit of published maps, Koukouraki and Kray [5] found that only

FAQs

What problem does AcadGIS address in academic map production?

AcadGIS targets two gaps: an accessibility gap for non-GIS users who need publication-ready figures, and a reproducibility gap where manual or one-off workflows fail to record the exact recipe behind a map.

How does AcadGIS help with reproducibility?

AcadGIS generates maps from high-level Python commands that specify sources, styling, and figure settings in code. It uses local caching, source attribution, and pinned package versions so results can be inspected and rerun.

What kinds of maps and outputs can AcadGIS produce?

AcadGIS supports publication-oriented research maps, including study-area locator layouts and thematic cartography, with raster and vector layers plus contextual Earth-observation, terrain, and hydrology. Exports include PNG, PDF, and SVG formats.

Jul 16, 2026

Upload by Noah