.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "SAGA_CMD 1"
.TH SAGA_CMD 1 "2019-01-03" "2.3.1" " "
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
saga_cmd \- command\-line interface to the System for Automated Geoscientific Analyses
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBsaga_cmd\fR [\fB\-d, \-\-docs\fR]
.PP
\&\fBsaga_cmd\fR [\fB\-b, \-\-batch\fR]
.PP
\&\fBsaga_cmd\fR [\fB\-h, \-\-help\fR]
.PP
\&\fBsaga_cmd\fR [\fB\-f, \-\-flags\fR][=qrsilpxo][\-s, \-\-story][=#][\-c, \-\-cores][=#] \fI\s-1LIBRARY\s0\fR [\fI\s-1MODULE\s0\fR] <module specific options...>
.PP
\&\fBsaga_cmd\fR [\fB\-f, \-\-flags\fR][=qrsilpxo][\-s, \-\-story][=#][\-c, \-\-cores][=#] \fI\s-1SCRIPT\s0\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\s-1SAGA GIS\s0 (System for Automated Geoscientific Analysis) is a free and open source geographic information system used for editing and analysing spatial data. It includes a large number of modules for the analysis of vector, table, grid and image data.
.PP
The \s-1SAGA\s0 command line interpreter is particularly useful for the processing
of complex work flows by defining a series of subsequent tool calls in a
script file. Calling saga_cmd with the option '\fB\-b\fR' or '\fB\-\-batch\fR' will
create an example of a \s-1DOS\s0 batch script file, which might be a good starting
point for the implementation of your own specific work flows.
.PP
When run without arguments, the module libraries in the current module library are listed. By default this is the directory which was set at installtion (/usr/lib/saga). This can be overwritten by setting the environment variable \fI\s-1SAGA_MLB\s0\fR.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "[\fI\s-1SAGA_MLB\s0\fR=dirname]" 8
.IX Item "[SAGA_MLB=dirname]"
Module libraries are expected to be located in the directory that is specified by the environment variable '\s-1SAGA_MLB\s0'. If this is not found the module installation directory (/usr/lib/saga) will be searched for instead.
.IP "\fI\s-1LIBRARY\s0\fR [\fI\s-1MODULE\s0\fR] [\fI\s-1MODULE OPTIONS\s0\fR]" 8
.IX Item "LIBRARY [MODULE] [MODULE OPTIONS]"
Specify the library (ie ta_morphometry) and the module (number or name). If no module is specified the different modules of a library are listed.
.IP "\fB\-h, \-\-help\fR" 8
.IX Item "-h, --help"
Display help and exit
.IP "\fB\-d, \-\-docs\fR" 8
.IX Item "-d, --docs"
Create tool documentation in the current working directory
.IP "\fB\-b, \-\-batch\fR" 8
.IX Item "-b, --batch"
Create batch file examples in the current working directory
.IP "\fB\-c, \-\-cores\fR" 8
.IX Item "-c, --cores"
Number of physical processors to use for computation
.IP "\fB\-f, \-\-flags\fR" 8
.IX Item "-f, --flags"
Various flags for general usage [qrsilpxo]
.RS 8
.IP "\fBq\fR No progress report" 9
.IX Item "q No progress report"
.PD 0
.IP "\fBr\fR No messages report" 9
.IX Item "r No messages report"
.IP "\fBs\fR Silent mode (no progress and no messages report)" 9
.IX Item "s Silent mode (no progress and no messages report)"
.IP "\fBi\fR Allow user interaction" 9
.IX Item "i Allow user interaction"
.IP "\fBl\fR Load translation dictionary" 9
.IX Item "l Load translation dictionary"
.IP "\fBp\fR Load projections dictionary" 9
.IX Item "p Load projections dictionary"
.IP "\fBx\fR Use \s-1XML\s0 markups for synopses and messages" 9
.IX Item "x Use XML markups for synopses and messages"
.IP "\fBo\fR Load old style naming" 9
.IX Item "o Load old style naming"
.RE
.RS 8
.RE
.PD
.SH "EXAMPLE"
.IX Header "EXAMPLE"
export SAGA_MLB=/usr/lib/saga
.PP
\&\fBsaga_cmd\fR ta_morphometry \*(L"Local Morphometry\*(R" \-ELEVATION dem.sgrd \-SLOPE slope.sgrd \-ASPECT aspect.sgrd \-METHOD 1
.PP
Multiple input files can be specified by separating them by a semicolon (;).
.PP
\&\fBsaga_cmd\fR libgrid_tools Merging \-GRIDS test1.sgrd\e;test2.sgrd \-GRID_TARGET merged.sgrd
.SH "BUGS"
.IX Header "BUGS"
On the website of \fIhttp://www.saga\-gis.org\fR, a list of known bugs can be found and new bug reports can be submitted.
.SH "AUTHORS"
.IX Header "AUTHORS"
\&\fB\s-1SAGA\s0\fR was written by Olaf Conrad with help from a large number of contributors. This manual page was written by Johan Van de Wauw.
Both are released under the \s-1GNU\s0 General Public License v2.
.PP
More info  \fIhttp://www.saga\-gis.org\fR
.PP
Please provide the following reference in your work if you are using \s-1SAGA:\s0
.PP
Conrad, O., Bechtel, B., Bock, M., Dietrich, H., Fischer, E., Gerlitz, L.,
Wehberg, J., Wichmann, V., and Boehner, J. (2015):
System for Automated Geoscientific Analyses (\s-1SAGA\s0) v. 2.1.4.
Geosci. Model Dev., 8, 1991\-2007, doi:10.5194/gmd\-8\-1991\-2015.
.PP
\&\fIhttp://www.geosci\-model\-dev.net/8/1991/2015/gmd\-8\-1991\-2015.html\fR