mapview

Interactive viewing of spatial data in R

https://github.com/r-spatial/mapview

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    2 of 33 committers (6.1%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.7%) to scientific vocabulary

Keywords

gis leaflet maps r spatial visualization web-mapping

Keywords from Contributors

geos gdal geography book geospatial-data simple-features rspatial mapping-tools proj geocompx
Last synced: 6 months ago · JSON representation

Repository

Interactive viewing of spatial data in R

Basic Info
Statistics
  • Stars: 535
  • Watchers: 38
  • Forks: 93
  • Open Issues: 97
  • Releases: 1
Topics
gis leaflet maps r spatial visualization web-mapping
Created over 10 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog License

README.Rmd

---
output: github_document
---

```{r setup, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  eval = FALSE,
  comment = "#>",
  out.width = "100%"
)
```

# mapview


[![R-CMD-check](https://github.com/r-spatial/mapview/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/r-spatial/mapview/actions/workflows/R-CMD-check.yaml)
[![cran checks](https://badges.cranchecks.info/worst/mapview.svg)](https://cran.r-project.org/web/checks/check_results_mapview.html)
![monthly](https://cranlogs.r-pkg.org/badges/mapview)
![total](https://cranlogs.r-pkg.org/badges/grand-total/mapview)
[![CRAN](https://www.r-pkg.org/badges/version/mapview?color=009999)](https://cran.r-project.org/package=mapview)
[![License](https://img.shields.io/badge/license-GPL%20%28%3E=%203%29-lightgrey.svg?style=flat)](https://www.gnu.org/licenses/gpl-3.0.html)


### Interactive viewing of spatial data in R



**mapview** provides functions to very quickly and conveniently create interactive visualisations of spatial data. It's main goal is to fill the gap of quick (not presentation grade) interactive plotting to examine and visually investigate both aspects of spatial data, the geometries and their attributes. It can also be considered a data-driven API for the [**leaflet**](https://cran.r-project.org/package=leaflet) package as it will automatically render correct map types, depending on the type of the data (points, lines, polygons, raster). In addition, it makes use of some advanced rendering functionality that will enable viewing of much larger data than is possible with **leaflet**. Furthermore, if you're a fan of [**mapdeck**](https://cran.r-project.org/package=mapdeck) (which you should!), you can choose to use it as the rendering platform instead of **leaflet** by setting `mapviewOptions(platform = "mapdeck")`.

The main user relevant functions are:

* `mapview` - view (multiple) spatial objects on a set of background maps
* `viewExtent` - view extent / bounding box of spatial objects
* `viewRGB` - view RGB true- or false-color images of raster objects
* `mapshot` - easily save maps (including leaflet maps) as `html` and/or `png` 
(or other image formats)

Functions that have been deprecated/deleted recently:

* `addHomeButton`  - deprecated, use package [leafem](https://CRAN.R-project.org/package=leafem) instead.
* `addLogo`  - deprecated, use package [leafem](https://CRAN.R-project.org/package=leafem) instead.
* `addFeatures`  - deprecated, use package [leafem](https://CRAN.R-project.org/package=leafem) instead.
* `addMouseCoordinates`  - deprecated, use package [leafem](https://CRAN.R-project.org/package=leafem) instead.
* `addExtent`  - deprecated, use package [leafem](https://CRAN.R-project.org/package=leafem) instead.
* `addImageQuery`  - deprecated, use package [leafem](https://CRAN.R-project.org/package=leafem) instead.
* `latticeView` & `sync` - deprecated, use package [leafsync](https://CRAN.R-project.org/package=leafsync) instead.
* `slideView` - deprecated, use package [slideview](https://CRAN.R-project.org/package=slideview) instead.
* `cubeView` - deprecated, use package [cubeview](https://CRAN.R-project.org/package=cubeview) instead.
* `plainview` - deprecated, use package [plainview](https://CRAN.R-project.org/package=plainview) instead.
* `popupTable`, `popupGraph` & `popupImage` - deprecated, use package [leafpop](https://CRAN.R-project.org/package=leafpop) instead.
* `addLargeFeatures` - use [leafgl](https://CRAN.R-project.org/package=leafgl)`::addGL*` functions instead.

Objects of the following spatial classes are supported:

* [sf](https://cran.r-project.org/package=sf)
* [raster](https://cran.r-project.org/package=raster) (Layer, Stack, Brick and SpatialPixels* / SpatialGridDataFrame)
* [stars](https://cran.r-project.org/package=stars)
* [sp](https://cran.r-project.org/package=sp) (Points, Polygons, Lines and their DataFrame version)
* [satellite](https://cran.r-project.org/package=satellite)


## Installation

For CRAN release version of **mapview** use


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


To install the development version you can install the [remotes](https://cran.r-project.org/package=remotes) package.

**NOTE:** As of version 2.9.1 development will happen on the `master` branch. Please consider the `develop` branch obsolete.

```{r, eval=FALSE}
remotes::install_github("r-spatial/mapview")
```


## Usage

The most basic call

```{r, eval=FALSE}
mapview(breweries)
```

will produce a web map visualisation of the breweries data with the following components:

![](man/figures/basic_small.png)

## Contact

Please file bug reports and feature requests at https://github.com/r-spatial/mapview/issues

Owner

  • Name: r-spatial
  • Login: r-spatial
  • Kind: organization

For packages raster, terra, dismo & geosphere visit the rspatial github organisation (mind the missing '-')

GitHub Events

Total
  • Issues event: 21
  • Watch event: 17
  • Delete event: 1
  • Issue comment event: 49
  • Push event: 16
  • Pull request review event: 1
  • Pull request event: 6
  • Fork event: 1
  • Create event: 3
Last Year
  • Issues event: 21
  • Watch event: 17
  • Delete event: 1
  • Issue comment event: 49
  • Push event: 16
  • Pull request review event: 1
  • Pull request event: 6
  • Fork event: 1
  • Create event: 3

Committers

Last synced: over 1 year ago

All Time
  • Total Commits: 1,705
  • Total Committers: 33
  • Avg Commits per committer: 51.667
  • Development Distribution Score (DDS): 0.241
Past Year
  • Commits: 20
  • Committers: 3
  • Avg Commits per committer: 6.667
  • Development Distribution Score (DDS): 0.1
Top Committers
Name Email Commits
tim-salabim t****s@g****m 1,294
gisma g****k@g****g 125
fdetsch f****h@s****e 60
pat-s p****z@g****m 56
swoellauer s****r 37
Florian Detsch f****h@p****5 22
fdetsch f****h@w****e 18
Tim Appelhans t****s@a****o 18
Appelhans T****s@g****m 14
tim.appelhans t****s@m****m 9
lbusett l****t@g****m 7
timelyportfolio k****l@t****m 6
dogbert s****a@y****e 5
gisma g****a@g****g 4
Michael Sumner m****r@g****m 3
Edzer Pebesma e****a@u****e 3
Sebastian Gatscha g****a@t****u 2
Luigi Ranghetti g****a@g****m 2
Jakub Nowosad t****i@g****m 2
Tim Appelhans t****s@g****m 2
Miles McBain m****n@g****m 2
MEDIALAB\sam.c s****m@h****z 2
Christoph Stepper c****r@g****m 2
Ahmadou Dicko m****l@a****m 1
olivroy 5****y 1
joshualerickson j****n@g****m 1
Pierre Roudier p****r@g****m 1
Joseph Stachelek j****a 1
Andy Teucher a****r@g****a 1
David Kretch d****h@s****s 1
and 3 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 149
  • Total pull requests: 17
  • Average time to close issues: 3 months
  • Average time to close pull requests: 3 months
  • Total issue authors: 123
  • Total pull request authors: 8
  • Average comments per issue: 4.51
  • Average comments per pull request: 1.53
  • Merged pull requests: 10
  • Bot issues: 0
  • Bot pull requests: 2
Past Year
  • Issues: 15
  • Pull requests: 7
  • Average time to close issues: 8 days
  • Average time to close pull requests: about 1 month
  • Issue authors: 15
  • Pull request authors: 3
  • Average comments per issue: 1.67
  • Average comments per pull request: 1.14
  • Merged pull requests: 3
  • Bot issues: 0
  • Bot pull requests: 2
Top Authors
Issue Authors
  • agronomofiorentini (6)
  • FelipeCarrillo (4)
  • tim-salabim (4)
  • duccioa (2)
  • qdread (2)
  • Agucha1986 (2)
  • fdetsch (2)
  • AMBarbosa (2)
  • Sckende (2)
  • mhweber (2)
  • michaeldgarber (2)
  • FloFranz (2)
  • rsbivand (2)
  • nekronaut (2)
  • hyapici (2)
Pull Request Authors
  • olivroy (5)
  • Nowosad (3)
  • atsyplenkov (2)
  • MilesMcBain (2)
  • dependabot[bot] (2)
  • gden173 (1)
  • tim-salabim (1)
  • joshualerickson (1)
Top Labels
Issue Labels
enhancement (2) rspatial-dev-day (1)
Pull Request Labels
dependencies (2)

Packages

  • Total packages: 3
  • Total downloads:
    • cran 21,802 last-month
  • Total docker downloads: 1,019,681
  • Total dependent packages: 58
    (may contain duplicates)
  • Total dependent repositories: 159
    (may contain duplicates)
  • Total versions: 27
  • Total maintainers: 1
cran.r-project.org: mapview

Interactive Viewing of Spatial Data in R

  • Versions: 20
  • Dependent Packages: 55
  • Dependent Repositories: 158
  • Downloads: 21,802 Last month
  • Docker Downloads: 1,019,681
Rankings
Forks count: 0.7%
Stargazers count: 0.7%
Dependent repos count: 1.5%
Dependent packages count: 1.6%
Downloads: 3.0%
Average: 4.2%
Docker downloads count: 17.6%
Maintainers (1)
Last synced: 6 months ago
proxy.golang.org: github.com/r-spatial/mapview
  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 6 months ago
conda-forge.org: r-mapview
  • Versions: 6
  • Dependent Packages: 3
  • Dependent Repositories: 1
Rankings
Dependent packages count: 15.6%
Stargazers count: 18.2%
Forks count: 19.0%
Average: 19.3%
Dependent repos count: 24.4%
Last synced: 6 months ago

Dependencies

DESCRIPTION cran
  • R >= 3.6.0 depends
  • methods * depends
  • base64enc * imports
  • htmltools * imports
  • htmlwidgets * imports
  • lattice * imports
  • leafem * imports
  • leaflet >= 2.0.0 imports
  • leafpop * imports
  • png * imports
  • raster * imports
  • satellite * imports
  • scales >= 0.2.5 imports
  • servr * imports
  • sf * imports
  • sp * imports
  • webshot * imports
  • covr * suggests
  • knitr * suggests
  • later * suggests
  • leaflet.extras2 * suggests
  • leafsync * suggests
  • lwgeom * suggests
  • mapdeck * suggests
  • plainview * suggests
  • poorman * suggests
  • rgdal * suggests
  • rmarkdown * suggests
  • rstudioapi * suggests
  • s2 * suggests
  • stars * suggests
  • tinytest * suggests
vignettes/popup_graphs/tmp_1_files/leaflet-binding-2.0.0.9000/lib/leaflet-omnivore/package.json npm
  • browserify 13.0.1 development
  • jshint 2.9.2 development
  • mapbox.js 2.4.0 development
  • mocha ~2.5.3 development
  • phantomjs-prebuilt 2.1.7 development
  • st 1.1.0 development
  • tape 4.5.1 development
  • uglify-js ^2.6.2 development
  • zuul ~3.10.1 development
  • brfs 1.4.3
  • corslite 0.0.7
  • csv2geojson ~5.0.0
  • polyline 0.2.0
  • togeojson 0.13.0
  • topojson 1.6.26
  • wellknown 0.4.2
vignettes/popup_graphs/tmp_1_files/leaflet-binding-2.0.0.9000/lib/leaflet-providers/package.json npm
  • chai ^4.1.2 development
  • eslint ^3.16.1 development
  • eslint-plugin-html ^2.0.1 development
  • mocha ^3.2.0 development
  • mocha-phantomjs-core ^2.1.1 development
  • mversion ^1.10.1 development
  • phantomjs-prebuilt ^2.1.16 development
  • uglify-js ^2.4.15 development
vignettes/popup_graphs/tmp_1_files/leaflet-binding-2.0.0.9000/plugins/Leaflet.markercluster/package.json npm
  • jake ~0.5.16 development
  • jshint ~2.1.3 development
  • karma ~0.8.5 development
  • leaflet ~1.0.3 development
  • magic-string ^0.7.0 development
  • mocha ~1.10.0 development
  • uglify-js ~2.6.0 development
vignettes/popup_graphs/tmp_1_files/leaflet-providers-1.1.17/package.json npm
  • chai ^4.1.2 development
  • eslint ^3.16.1 development
  • eslint-plugin-html ^2.0.1 development
  • mocha ^3.2.0 development
  • mocha-phantomjs-core ^2.1.1 development
  • mversion ^1.10.1 development
  • phantomjs-prebuilt ^2.1.16 development
  • uglify-js ^2.4.15 development
.github/workflows/tic.yml actions
  • actions/checkout v2.3.1 composite
  • actions/upload-artifact v2.1.1 composite
  • pat-s/always-upload-cache v2.1.0 composite
  • r-lib/actions/setup-pandoc v2 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-tinytex v2 composite