Scripting: Difference between revisions

From GRASS-Wiki
Jump to navigation Jump to search
(updated)
Line 3: Line 3:
=== General ===
=== General ===


* See the [http://grass.ibiblio.org/grass63/manuals/html63_user/g.parser.html g.parser] module help page. It's an easy way to make your script look and act like a GRASS module, including creating a GUI and help page template for it automatically.
* See the {{cmd|g.parser}} module help page. It's an easy way to make your script look and act like a GRASS module, including creating a GUI and help page template for it automatically.


* There are a number of [http://grass.ibiblio.org/grass63/manuals/html63_user/general.html other] g.* modules which are specifically useful for scripting use.
* There are a number of other:{{cmd|general}} g.* modules which are specifically useful for scripting use.


==== Verbosity level ====
==== Verbosity level ====


Use the "--quiet" (alias --q) and "--verbose" (alias --v) command line arguments to make the script produce more or less messages and info like percent done. This works for almost all modules. The big exception to that is r.mapcalc which doesn't use the standard parser.
Use the "--quiet" (alias --q) and "--verbose" (alias --v) command line arguments to make the script produce more or less messages and info like percent done. This works for almost all modules. The big exception to that is {{cmd|r.mapcalc}} which doesn't use the standard parser in GRASS 6 (in GRASS 7 it does).


For r.mapcalc, or if you want to set a blanket --quiet directive for the whole script, you can set the GRASS_VERBOSE environmental variable. Python's os module has a putenv() function to do that.  
In GRASS 6, for r.mapcalc, or if you want to set a blanket --quiet directive for the whole script, you can set the GRASS_VERBOSE environmental variable. Python's os module has a putenv() function to do that.  


These are the levels you can use:
These are the levels you can use:
Line 34: Line 34:




Another nice thing about using the enviro variable method is that it is
Another nice thing about using the environmental variable method is that it is silently ignored for earlier versions of GRASS. For earlier versions (<6.2.x) of GRASS an error happens when "--quiet" isn't recognized as a valid command line option.
silently ignored for earlier versions of GRASS. For earlier versions of GRASS
an error happens when "--quiet" isn't recognized as a valid command line
option. (the new 6.2.3 knows to ignore it)




Line 49: Line 46:
=== Shell scripts ===
=== Shell scripts ===


See the [http://grass.itc.it/grass63/source/snapshot/SUBMITTING_SCRIPTS SUBMITTING_SCRIPTS] file for some tips.
See the [http://grass.osgeo.org/grass64/source/snapshot/SUBMITTING_SCRIPTS SUBMITTING_SCRIPTS] file for some tips.


See the existing GRASS scripts in the scripts/ directory for examples of using tempfiles, etc.
See the existing GRASS scripts in the scripts/ directory for examples of using tempfiles, etc.
Line 60: Line 57:
=== Tcl/Tk ===
=== Tcl/Tk ===


See the [http://grass.itc.it/grass63/source/snapshot/SUBMITTING_TCLTK SUBMITTING_TCLTK] file for some tips.
See the [http://grass.osgeo.org/grass64/source/snapshot/SUBMITTING_TCLTK SUBMITTING_TCLTK] file for some tips.


=== Python ===
=== Python ===

Revision as of 13:00, 6 August 2012

Scripting

General

  • See the g.parser module help page. It's an easy way to make your script look and act like a GRASS module, including creating a GUI and help page template for it automatically.
  • There are a number of other:general g.* modules which are specifically useful for scripting use.

Verbosity level

Use the "--quiet" (alias --q) and "--verbose" (alias --v) command line arguments to make the script produce more or less messages and info like percent done. This works for almost all modules. The big exception to that is r.mapcalc which doesn't use the standard parser in GRASS 6 (in GRASS 7 it does).

In GRASS 6, for r.mapcalc, or if you want to set a blanket --quiet directive for the whole script, you can set the GRASS_VERBOSE environmental variable. Python's os module has a putenv() function to do that.

These are the levels you can use:

 (from lib/gis/verbose.c)
0 - module should print nothing but errors and warnings (G_fatal_error,
     G_warning)  Triggered by "--q" or "--quiet".
1 - module will print progress information (G_percent)
2 - module will print all messages (G_message)  [default level]
3 - module will be very verbose. Triggered by "--v" or "--verbose".

"--quiet" will set the level to 0.


shell script example

# for everything that follows
GRASS_VERBOSE=1
export GRASS_VEBOSE
# override for just one module
GRASS_VERBOSE=0 \
  r.mapcalc "only_set = for_this_process"


Another nice thing about using the environmental variable method is that it is silently ignored for earlier versions of GRASS. For earlier versions (<6.2.x) of GRASS an error happens when "--quiet" isn't recognized as a valid command line option.


see "Verbosity levels" on the Development_Specs page.


The advantage of these methods versus sending all stderr to /dev/null is that warning and error messages are not lost, making prototyping and debugging a whole lot easier.

Shell scripts

See the SUBMITTING_SCRIPTS file for some tips.

See the existing GRASS scripts in the scripts/ directory for examples of using tempfiles, etc.

Newer versions of Ubuntu use Dash as the default /bin/sh, so don't assume that sh will handle Bashisms.

Tcl/Tk

See the SUBMITTING_TCLTK file for some tips.

Python