DESCRIPTION

g.mlist searches for data files matching a pattern given by wildcards or POSIX Extended Regular Expressions. It is is an extended version of g.list. g.mlist will only print map names and an optional separator, without extraneous output. In addition, map search is also available.

See also the g.list help page for discussion of some module options.

NOTES

The output of g.mlist may be useful for other programs' parameter input (e.g. time series for r.series) when used with separator=comma.

EXAMPLES

List all available GRASS data base files:

g.mlist type=all

List all raster and vector maps:

g.mlist type=rast,vect

Wildcards:

List all vector maps starting with letter "r":

g.mlist type=vect pattern="r*"

List certain raster maps with one variable character/number:

g.mlist type=rast pattern="N45E00?.meters"

Use of exclude parameter:

# without exclude:
  g.mlist rast pat="r*" mapset=PERMANENT
  railroads
  roads
  rstrct.areas
  rushmore

# exclude only complete word(s):
  g.mlist rast pat="r*" exclude=roads mapset=PERMANENT
  railroads
  rstrct.areas
  rushmore

# exclude with wildcard:
  g.mlist rast pat="r*" exclude="*roads*" mapset=PERMANENT
  rstrct.areas
  rushmore

Regular expressions:

List all soil maps starting with "soils" in their name:

g.mlist -r type=rast pattern='^soils'

List "tmp" if "tmp" raster map exists:

g.mlist -r pattern='^tmp$'

List "tmp0" ..."tmp9" if corresponding vector map exists (each map name linewise):

g.mlist -r type=vect pattern='^tmp[0-9]$'

List "tmp0" ..."tmp9" if corresponding vector map exists (each map name comma separated):

g.mlist -r type=vect sep=comma pattern='^tmp[0-9]$'

Extended regular expressions:

List all precipitation maps for the years 1997-2012, comma separated:

g.mlist -e type=rast sep=comma pattern="precip_total.(199[7-9]|200[0-9]|201[0-2]).sum"

AUTHOR

Huidae Cho
grass4u@gmail.com

Last changed: $Date$