GRASS GIS: g.mlist

NAME

g.mlist - Apply regular expressions and wildcards to g.list

KEYWORDS

general, map management

SYNOPSIS

g.mlist
g.mlist help
g.mlist [-rm] type=string[,string,...] [mapset=string[,string,...]] [sep=string] [pattern=string] [--verbose] [--quiet]

Flags:

-r: Use regular expression instead of wildcard
-m: Print mapset name
--verbose: Verbose module output
--quiet: Quiet module output

Parameters:

type=string[,string,...]: Data type; Options: rast,rast3d,oldvect,vect,asciivect,icon,labels,sites,region,region3d,group,3dview,all; Default: rast
mapset=string[,string,...]: Mapset(s) to list (default: current mapset search path)
sep=string: Output separator (default: newline)
pattern=string: Map name search pattern (default: all); Default: *

DESCRIPTION

g.mlist is an extended version of g.list which provides regular-expression and wildcard support. g.mlist will only print map names and an optional separator, without extraneous output. In addition, map search is also available.

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"

Regular expressions:

Print out all soils map with "soils" in their name:
g.mlist -r type=rast pattern='^soils'

Print out "tmp" if "tmp" raster map exists:
g.mlist -r pattern='^tmp$'

Print out "tmp0" ..."tmp9" if corresponding vector map exists (each map name linewise):
g.mlist -r type=vect pattern='^tmp[0-9]$'

Print out "tmp0" ..."tmp9" if corresponding vector map exists (each map name comma separated):
g.mlist -r type=vect sep=, pattern='^tmp[0-9]$'

This may be useful for other programs' parameter input (e.g. r.series).

AUTHOR

Huidae Cho

Last changed: $Date: 2007-02-12 06:44:57 -0800 (Mon, 12 Feb 2007) $

Main index - general index - Full index