A class that holds spatial coordinates for river networks, as well as network topology and attributes.
Created by line2network from an input line shapefile. Contains all information for network distance calculation, plotting, etc. in the 'riverdist' package.
Plotting methods are described in plot.rivernetwork.
sp
:Object of class "SpatialLinesDataFrame"
from package 'sp'; see SpatialLinesDataFrame-class. This is the original object as read by readOGR, and is preserved to maintain plotting capability.
lines
:Object of class "list"
. Each list element is a matrix of XY coordinates of the vertices of a single river segment.
connections
:Object of class "matrix"
, with "numeric"
elements. Defined as a square matrix, with elements describing the type of connection detected between line segments.
A value of 1 in element [i,j]
indicates that the beginning of segment i
is connected to the beginning of segment j
.
A value of 2 in element [i,j]
indicates that the beginning of segment i
is connected to the end of segment j
.
A value of 3 in element [i,j]
indicates that the end of segment i
is connected to the beginning of segment j
.
A value of 4 in element [i,j]
indicates that the end of segment i
is connected to the end of segment j
.
A value of 5 in element [i,j]
indicates that segments i
and j
are connected at both beginning and end.
A value of 6 in element [i,j]
indicates that the beginning of segment i
is connected to the end of segment j
, and the end of segment i
is connected to the beginning of segment j
.
A value of NA in element [i,j]
indicates that segments i
and j
are not connected.
lengths
:Vector of class "numeric"
. Defined as the calculated total lengths of each river segment.
names
:Vector of class "character"
. Defined as the names of each river segment.
mouth
:Object of class "list"
, with two elements. Element mouth.seg
gives the segment number of the mouth (lowest point) of the river network, and mouth.vert
gives the vertex number.
sequenced
:"logical"
: has value of TRUE if line vertices have been stored in upstream sequence using sequenceverts.
tolerance
:"numeric"
: the spatial tolerance that was used in determining river segment endpoint connectivity; see line2network, splitsegments.
units
:"character"
: the spatial units detected from the input shapefile.
lineID
:Object of class "data.frame"
establishing the relationship between river segments as stored in the sp
and lines
elements, and is used for updating the sp
element during river network editing in dissolve, splitsegments, sequenceverts, trimriver, and trimtopoints.
rivID
gives the list element number of each river segment in lines
. This is the same number that is used for segment numbering in river locations.
sp_line
gives the corresponding list element in sp@lines
.
sp_seg
gives the corresponding list element in sp@lines[[]]@Lines
.
braided
:"logical"
: Has value of TRUE
if checkbraidedTF has detected braiding, FALSE
if no braiding has been detected, and NA
if braiding has not yet been checked.
cumuldist
:List of class "numeric"
: Each element is a vector of cumulative distances along each river segment, beginning with 0.
segroutes
:Object of class "list"
, with each element defined as a vector of class "numeric"
, describing the route from the mouth segment to the specific segment. This element only exists if buildsegroutes has been run, and can greatly speed up route and distance calculation.
distlookup
:List of three matrices, of class "numeric"
or "logical"
. Element [i,j]
of each matrix corresponds to
the route between segment i
and j
. The
distlookup$middist
matrix gives the total distance of the "middle"
of each route (between the starting and ending segments"), and the
distlookup$starttop
and distlookup$endtop
matrices have value
TRUE
, FALSE
, or NA
if the segments at the beginning or
end of the route are connected to the rest of the route at the top of the
coordinate matrix, bottom of the coordinate matrix, or if the route is
contained to just one segment, respectively.