edges: Interactive Edge Edit

In secrlinear: Spatially Explicit Capture-Recapture for Linear Habitats

Interactive Edge Edit

Description

A ‘skip’ is defined here as a graph edge between two input lines. Many skips are legitimate, but some ‘shortcut’ skips are artefacts of the simple algorithm used by asgraph to construct the graph topology. These are better removed. These functions allow skips in a linearmask to be visualised and edited.

addedges may be used to bridge artefactual gaps in a network, or to correct editing mistakes. The edge weight of a new edge is its Euclidean length.

Usage

showedges(mask, plt = TRUE, add = FALSE, type = c('all', 'noskips', 'skips'), 
                       lengths = c(0,Inf), ...)

replot(mask, xlim = NULL, ylim = NULL, ...)

addedges(mask, replot = TRUE, ...)

deleteedges(mask, replot = TRUE, ...)

cleanskips(mask)

Arguments

mask	linearmask object with 'graph' attribute
lengths	numeric vector of minimum and maximum edge length (weight)
plt	logical; if TRUE the edges are plotted
add	logical; if TRUE the edges will be added to an existing plot
type	character value for subset of edges to show
xlim	vector of min and max x-values for new plot
ylim	vector of min and max y-values for new plot
replot	logical; if TRUE the plot will be re-done using replot
...	other arguments (see details)

Details

showedges is a general-purpose function for displaying or extracting edge information from the graph attribute of a linear mask.

cleanskips removes any between-line ‘skips’ that are longer than the shortest ‘skip’.

Other functions here are used to manually edit a mask graph.

replot is used to zoom in on part of a linear mask (often to inspect ‘skips’).

The dots argument ... is passed by replot to plot.linearmask and by addedges and deleteedges to showedges (if replot = TRUE).

Value

showedges returns a dataframe with one row for each edge, and columns –

start	index of start vertex
finish	index of finish vertex
line1	line number of start
line2	line number of finish
x1	geographic coordinates of start
y1	geographic coordinates of start
x2	geographic coordinates of finish
y2	geographic coordinates of finish
weight	"weight" attribute of edge (its length in metres)

The dataframe is returned invisibly if plt = TRUE.

cleanskips returns a linearmask object.

replot returns NULL.

addedges and deleteedges invisibly returns a linear mask object with updated graph attribute.

See Also

linearmask, getLineID

Examples

## Not run: 
inputdir <- system.file("extdata", package = "secrlinear")
tempmask <- read.linearmask(file = paste0(inputdir, "/silverstream.shp", spacing = 50)

## show all edges
plot(tempmask, linecol = 'white')
tmp <- showedges(tempmask, add = TRUE)

## select a rectangular area to zoom in
replot(tempmask)

## click on the vertices of one or more edges to delete or add
tempmask <- deleteedges(tempmask)
tempmask <- addedges(tempmask)


## End(Not run)

secrlinear documentation built on Oct. 17, 2023, 9:07 a.m.