Spatial Prediction Based on Spatial Stratified Heterogeneity

Spatial prediction is a common practice in social and environmental science. This package enables the implementation of SSH-based spatial prediction proposed by Wang et al. (2013) . It provides functions to (1) evaluate stratification schemes, (2) interpolate sampling data over user-defined reporting units, (3) assess prediction uncertainties, and (4) evaluate overall accuracy using the k-fold cross-validation estimate.

sandwichr: Spatial prediction based on spatial stratified heterogeneity

sandwichr is an R package for spatial prediction based on the spatial stratified heterogeneity (SSH) theory, which enables users to:

Interpolate the sampling attribute over the reporting units that does not rely on spatial autocorrelation;
Assess the prediction uncertainties through standard errors and confidence intervals;
Evaluate the overall accuracy using a diagnostic statistic called the k-fold cross validation estimate.

You may also find this package on CRAN: https://cran.r-project.org/web/packages/sandwichr/.

Getting setup with R

Using the sandwichr package requires a recent version of R to be installed on your computer. The easiest way is to install it through CRAN , which stands for the Comprehensive R Archive Network.

For Windows, visit https://cran.r-project.org/bin/windows/base/.
For macOS, visit https://cran.r-project.org/bin/macosx/.
For Linux, visit https://cran.r-project.org/doc/manuals/r-release/R-admin.html.

Once R is installed, you can proceed to install the RStudio Integrated Development Environment (IDE) to have a much improved environment to work with R. Here is detailed description of RStudio. It is free to download on https://posit.co/download/rstudio-desktop/#download/.

Installing the package

Now you have the base R and a nice IDE installed on your computer, you can navigate to the console window (in RStudio, the bottom left panel) and install the sandwichr package by executing the following lines of code:

install.packages("sandwichr")

Tutorial

Once you install the package, we strongly recommend you going through a tutorial of this package to explore it in different scenarios of use. You can find it using the argument:

browseVignettes("sandwichr")

Citation

Please cite the following reference if you use the code. We are also working on an article about this particular software.

@article{Wang+Haining+Liu+Li+Jiang:2013,
    author = {Jin-Feng Wang and Robert Haining and Tie-Jun Liu and Lian-Fa Li and Cheng-Sheng Jiang},
    title ={Sandwich Estimation for Multi-Unit Reporting on a Stratified Heterogeneous Surface},
    journal = {Environment and Planning A: Economy and Space},
    volume = {45},
    number = {10},
    pages = {2515-2534},
    year = {2013},
    doi = {10.1068/a44710}
}

Contacts

If there are any questions or suggestions (or anything else you want to talk about concerning this project), please feel free to let us know! If you have found a bug, you can also file an issue.

Email: [email protected] (Ms Yue Lin), [email protected] (Dr Chengdong Xu), [email protected] (Dr Jinfeng Wang*)

State Key Laboratory of Resources and Environmental Information System
Institute of Geographic Sciences and Natural Resources Research
Chinese Academy of Sciences
Beijing, 100101, China