rcoins

Identify continuous lines in a spatial network.

4
contributors
Get started
174 commitsLast commit ≈ 2 weeks ago2 stars0 forks

Cite this software

Description

rcoins

R-CMD-check DOI

Identify continuous lines in a network using an approach based on the Continuity in Street Network (COINS) method1.

rcoins is a R (re)implementation of the COINS algorithm, which is also available in Python as a module of the momepy library or in its original version: PratyushTripathy/COINS.

Installation

You can install the released version of rcoins from CRAN with:

install.packages("rcoins")

You can install the development version of rcoins from the R terminal like so:

# install.packages("devtools")
devtools::install_github("CityRiverSpaces/rcoins")

Alternative installation using conda

An environment including rcoins and all its dependencies can be created using Conda (or its faster implementation Mamba).

Conda can be installed using the Miniforge scripts provided here (download one of the Mambaforge scripts in order to install Mamba as well).

First clone this repository and access it:

git clone https://github.com/CityRiverSpaces/rcoins.git
cd rcoins/

Run conda (or mamba, if using Mambaforge) to create an environment with all the required dependencies:

conda env create -f environment.yml
conda activate rcoins

Install the development version of rcoins (include dependencies = TRUE to install the example datasets):

Rscript -e 'devtools::install(dependencies = TRUE)'

Example

Given the street network of the city of Bucharest (data source: OpenStreetMap)

library(rcoins)
bucharest <- get_example_data()
streets <- bucharest$streets

Plot streets:

Determine continuous lines in the network as:

continuous_streets <- stroke(streets)

Plot continuous streets:

Contributing

We look very much forward to contributions to the package. See the Contributing Guide for further details.

This package is released with a Contributor Code of Conduct. By contributing to this project you agree to abide by its terms.

Development

When modifying the R source code, load the library as:

devtools::load_all()

Run tests locally:

devtools::test()

Run the linter locally:

lintr::lint_package()

Footnotes

  1. Tripathy, P., Rao, P., Balakrishnan, K., & Malladi, T. (2021). An open-source tool to extract natural continuity and hierarchy of urban street networks. Environment and Planning B: Urban Analytics and City Science, 48(8), 2188-2205. DOI: 10.1177/2399808320967680

Keywords
Programming languages
  • R 97%
  • Python 3%
License
</>Source code

Participating organisations

Netherlands eScience Center
Delft University of Technology

Contributors

Related projects

CRiSp

City River Spaces, a tool for automated and scalable delineation of urban river spaces with spatial-temporal big data

Updated 1 week ago
Finished

Related software

rcrisp

RC

rcrisp provides tools to automate the morphological delineation of riverside urban areas.

Updated 1 week ago
4