qualmap v0.1.1

0

Monthly downloads

0th

Percentile

Opinionated Approach for Digitizing Semi-Structured Qualitative GIS Data

Provides a set of functions for taking qualitative GIS data, hand drawn on a map, and converting it to a simple features object. These tools are focused on data that are drawn on a map that contains some type of polygon features. For each area identified on the map, the id numbers of these polygons can be entered as vectors and transformed using qualmap.

Readme

qualmap

lifecycle Travis-CI Build
Status AppVeyor Build
Status Coverage
Status DOI CRAN\_status\_badge

The goal of qualmap is to make it easy to enter data from qualitative maps. qualmap provides a set of functions for taking qualitative GIS data, hand drawn on a map, and converting it to a simple features object. These tools are focused on data that are drawn on a map that contains some type of polygon features. For each area identified on the map, the id numbers of these polygons can be entered as vectors and transformed using qualmap.

Motivation and Approach

Qualitative GIS outputs are notoriously difficult to work with because individuals’ conceptions of space can vary greatly from each other and from the realities of physical geography themselves. qualmap builds on a semi-structured approach to qualitative GIS data collection. Respondents use a specially designed basemap that allows them free reign to identify geographic features of interest and makes it easy to convert their annotations into digital map features. This is facilitated by including on the basemap a series of polygons, such as neighborhood boundaries or census geography, along with an identification number that can be used by qualmap. A circle drawn on the map can therefore be easily associated with the features that it touches or contains.

qualmap provides a suite of functions for entering, validating, and creating sf objects based on these hand drawn clusters and their associated identification numbers. Once the clusters have been created, they can be summarized and analyzed either within R or using another tool.

This approach provides an alternative to either unstructured qualitative GIS data, which are difficult to work with empirically, and to digitizing respondents’ annotations as rasters, which require a sophisticated workflow. This semi-structured approach makes integrating qualitative GIS with existing census and administrative data simple and straightforward, which in turn allows these data to be used as measures in spatial statistical models.

Installation

Installing Dependencies

You should check the sf package website for the latest details on installing dependencies for that package. Instructions vary significantly by operating system. For best results, have sf installed before you install qualmap. Other dependencies, like dplyr and leaflet, will be installed automatically with qualmap if they are not already present.

Installing qualmap

The easiest way to get qualmap is to install it from CRAN:

install.packages("qualmap")

You can install the development version of qualmap from Github with the remotes package:

# install.packages("remotes")
remotes::install_github("slu-openGIS/qualmap")

Usage

qualmap implements six verbs for working with mental map data:

  1. qm_define() - create a vector of feature id numbers that constitute a single “cluster”
  2. qm_validate() - check feature id numbers against a reference data set to ensure that the values are valid
  3. qm_preview() - plot cluster on an interactive map to ensure the feature ids have been entered correctly (the preview should match the map used as a data collection instrument)
  4. qm_create() - create a single cluster object once the data have been validated and visually inspected
  5. qm_combine() - combine multiple cluster objects together into a single tibble data object
  6. qm_summarize() - summarize the combined data object based on a single qualitative construct to prepare for mapping

The primary vignette contains an overview of the workflow for implementing these functions.

Contributor Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Functions in qualmap

Name Description
qm_preview Preview Input
qm_create Create cluster object
qm_combine Combine objects
qm_validate Validate input vector
qm_summarize Summarize Clusters
qualmap qualmap: Opinionated Approach for Digitizing Semi-structured Qualitative GIS Data
stLouis St. Louis Census Tracts, 2016
qm_is_cluster Validate cluster object
qm_define Define input values
No Results!

Vignettes of qualmap

Name
exampleMap.png
previewMap.png
qualmap.Rmd
No Results!

Last month downloads

Details

Type Package
License GPL-3
URL https://github.com/slu-openGIS/qualmap
BugReports https://github.com/slu-openGIS/qualmap/issues
Encoding UTF-8
LazyData true
RoxygenNote 6.1.0
VignetteBuilder knitr
NeedsCompilation no
Packaged 2018-09-03 17:57:21 UTC; chris
Repository CRAN
Date/Publication 2018-09-12 15:10:14 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/qualmap)](http://www.rdocumentation.org/packages/qualmap)