README.Rmd

---
output: github_document
resource_files:
  vignettes/bib/mapspamc.bib
bibliography: vignettes/bib/mapspamc.bib

---

<!-- README.md is generated from README.Rmd. Please edit that file -->

```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```
# mapspamc


<!-- badges: start -->
[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)
[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
<!-- [![R-CMD-check](https://github.com/michielvandijk/mapspamc/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/michielvandijk/mapspamc/actions/workflows/R-CMD-check.yaml) -->
<!-- badges: end -->

The aim of the [`mapspamc` R package](https://github.com/michielvandijk/mapspamc) is to facilitate the creation of country level crop distribution maps. The model builds on the global version of the [Spatial Production Allocation model (SPAM)](www.mapspam.info) [@You2006; @You2009; @You2014a; @Yu2020], which uses a cross-entropy optimization approach to 'pixelate' national and subnational crop statistics on a spatial grid at a resolution of 5 arc minutes (~ 10 x 10 km). `mapspamc` provides the necessary infrastructure to run SPAM at the country level and makes it possible to incorporate national sources of information and potentially create maps at a higher resolution of 30 arc seconds (~ 1 x 1 km) [@VanDijk2022b]. More information can be found on the [package website](https://michielvandijk.github.io/mapspamc/).


## Installation

To install `mapspamc`:

``` r
install.packages("remotes")
remotes::install_github("michielvandijk/mapspamc")
```


## References