
# pkmapr: Pakistan Spatial Data Toolkit

<!-- badges: start -->

[![R-CMD-check](https://github.com/abdullahumer1101/pkmapr/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/abdullahumer1101/pkmapr/actions/workflows/R-CMD-check.yaml)<br>
[![Codecov test
coverage](https://codecov.io/gh/abdullahumer1101/pkmapr/graph/badge.svg)](https://app.codecov.io/gh/abdullahumer1101/pkmapr)<br>
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19769542.svg)](https://doi.org/10.5281/zenodo.19769542)<br>
[![Version](https://img.shields.io/github/v/release/abdullahumer1101/pkmapr)](https://github.com/abdullahumer1101/pkmapr/releases)<br>
[![License: GPL
v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)<br>
<!-- badges: end -->

**pkmapr** (pronounced *P-K-Mapper*) provides a clean, tidy interface to
Pakistan’s official administrative boundary data from
[OCHA/HDX](https://data.humdata.org/dataset/cod-ab-pak). It includes
geometries at country, province, district, and tehsil level as `sf`
objects compatible with the tidyverse and geospatial ecosystem, and
includes utilities for geographic dictionary lookup, spatial
measurement, and neighbour structure construction for use with `spdep`,
`ggplot2`, `leaflet`, and related packages.

## Installation

``` r
# GitHub
remotes::install_github("abdullahumer1101/pkmapr")

# R-Universe
install.packages("pkmapr", repos = "https://abdullahumer1101.r-universe.dev")
```

## Citation

``` r
citation("pkmapr")
```

Or cite directly:

> Umer, A. (2026). pkmapr: Pakistan Spatial Data Toolkit.
> <https://doi.org/10.5281/zenodo.19769542>
