.TH d.path 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBd.path\fR\fR  - Finds shortest path for selected starting and ending node.
.SH KEYWORDS
display, networking
.SH SYNOPSIS
\fBd.path\fR
.br
\fBd.path help\fR
.br
\fBd.path\fR [\-\fBgb\fR] \fBmap\fR=\fIname\fR  [\fBtype\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBcoor\fR=\fIx1,y1,x2,y2\fR]   [\fBalayer\fR=\fIinteger\fR]   [\fBnlayer\fR=\fIinteger\fR]   [\fBafcol\fR=\fIstring\fR]   [\fBabcol\fR=\fIstring\fR]   [\fBncol\fR=\fIstring\fR]   [\fBcolor\fR=\fIstring\fR]   [\fBhcolor\fR=\fIstring\fR]   [\fBbgcolor\fR=\fIstring\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-g\fR" 4m
.br
Use geodesic calculation for longitude-latitude locations
.IP "\fB\-b\fR" 4m
.br
Render bold lines
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBmap\fR=\fIname\fR" 4m
.br
Name of input vector map
.IP "\fBtype\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Arc type
.br
Options: \fIline,boundary\fR
.br
Default: \fIline,boundary\fR
.IP "\fBcoor\fR=\fIx1,y1,x2,y2\fR" 4m
.br
Starting and ending coordinates
.IP "\fBalayer\fR=\fIinteger\fR" 4m
.br
Layer number
.br
Arc layer
.br
Default: \fI1\fR
.IP "\fBnlayer\fR=\fIinteger\fR" 4m
.br
Layer number
.br
Node layer
.br
Default: \fI2\fR
.IP "\fBafcol\fR=\fIstring\fR" 4m
.br
Arc forward/both direction(s) cost column
.IP "\fBabcol\fR=\fIstring\fR" 4m
.br
Arc backward direction cost column
.IP "\fBncol\fR=\fIstring\fR" 4m
.br
Node cost column
.IP "\fBcolor\fR=\fIstring\fR" 4m
.br
Original line color
.br
Default: \fIblack\fR
.IP "\fBhcolor\fR=\fIstring\fR" 4m
.br
Highlight color
.br
Default: \fIred\fR
.IP "\fBbgcolor\fR=\fIstring\fR" 4m
.br
Background color
.br
Default: \fIwhite\fR
.PP
.SH DESCRIPTION
\fId.path\fR enables shortest path vector networking.
Costs may be either line lengths, or attributes saved in a database table.
Supported are cost assignments for both arcs and nodes, and also different
in both directions of a vector line. For areas cost will be calculated along
boundary lines. 
.SH NOTE
The user needs to display a vector map before using d.path. The 'from' and 'to'
points are entered by mouse into the map displayed in the GRASS monitor, or
if the \fBcoor\fR option is used they can be specified non-interactively.
The actions bound to the mouse buttons are described in the terminal
window when running the command.
.PP
To calculate shortest path non-interactively and save the path to a new vector
map, use the \fIv.net.path\fR module.
.SH EXAMPLE
Interactive shortest path routing on road network (Spearfish region):
\fC
.DS
.br
g.region vector=roads
.br
d.mon x0
.br
d.vect roads
.br
d.path roads
.br
.DE
\fR
Non-interactive shortest path routing on road network (Spearfish region):
\fC
.DS
.br
d.path \-b roads coor=601653.5,4922869.2,593330.8,4924096.6
.br
.DE
\fR
.SH SEE ALSO
\fI
v.net.path
\fR
.SH AUTHOR
Radim Blazek, ITC-Irst, Trento, Italy
.PP
\fILast changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team