README.Rmd

---
output: github_document
---

ipdw
======

[![CRAN\_Status\_Badge](https://www.r-pkg.org/badges/version/ipdw)](https://cran.r-project.org/package=ipdw) [![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) ![ipdw Downloads](https://cranlogs.r-pkg.org/badges/ipdw) [![R-CMD-check](https://github.com/jsta/ipdw/actions/workflows/R-CMD-check.yml/badge.svg)](https://github.com/jsta/ipdw/actions/workflows/R-CMD-check.yml)

The `R` package [ipdw](https://jsta.rbind.io/pdf/stachmadden2015am.pdf)  provides the functionality to perform interpolation of georeferenced point data using inverse path distance weighting. Interpolation is accomplished in two steps. First, path distances are calculated from each georeferenced (measurement) point to each prediction point. Path distances, which honor barriers in the landscape, are calculated based on cell-to-cell movement through an underlying `Raster` object that represents movement cost. These path distances are subsequently used as interpolation weights. The two-step routine follows the order of operations described in Suominen et al. (2010) substituting the ESRI path distance algorithm with the `gdistance` wrapped version of the `igraph` adjacency algorithm.    

The ipdw package was developed with coastal marine applications in mind where path distances (as the fish swims) rather than Euclidean (as the crow flies) distances more accurately represent spatial connectivity. Interpolation of sparse grids in coastal areas otherwise end up bleeding through land areas.

## Installation
### Stable version from CRAN

```{r, eval=FALSE}
install.packages("ipdw")
```

### or development version from GitHub
```{r, eval=FALSE}
install.packages("devtools")  # package devtools needed
devtools::install_github("jsta/ipdw")
```

## Examples
**see** [vignette](http://jsta.github.io/ipdw/articles/)

## References
**J. Stachelek and Christopher J. Madden (2015)**. Application of Inverse Path Distance weighting for high density spatial mapping of coastal water quality patterns.
*International Journal of Geographical Information Science*
[preprint](https://jsta.rbind.io/pdf/stachmadden2015am.pdf) | [journal](https://doi.org/10.1080/13658816.2015.1018833)

**Tapio Suominen, Harri Tolvanen, and Risto Kalliola (2010)**. Surface layer salinity gradients and flow patterns in the archipelago coast of SW Finland, northern Baltic Sea.
*Marine Environmental Research*
[journal](https://dx.doi.org/10.1016/j.marenvres.2009.10.009)