GRASS logo

NAME

g.mlist - Lists available GRASS data base files of the user-specified data type to standard output.

KEYWORDS

general, map management, list

SYNOPSIS

g.mlist
g.mlist help
g.mlist [-retmpf] type=datatype[,datatype,...] [pattern=string] [exclude=string] [mapset=name] [fs=character] [--verbose] [--quiet]

Flags:

-r
Use basic regular expressions instead of wildcards
-e
Use extended regular expressions instead of wildcards
-t
Print data types
-m
Print mapset names
-p
Pretty printing in human readable format
-f
Verbose listing (also list map titles)
--verbose
Verbose module output
--quiet
Quiet module output

Parameters:

type=datatype[,datatype,...]
Data type(s)
Options: rast,rast3d,vect,oldvect,asciivect,icon,labels,sites,region,region3d,group,view3d,all
rast: raster map(s)
rast3d: 3D raster map(s)
vect: vector map(s)
oldvect: old (GRASS 5.0) vector map(s)
asciivect: ASCII vector map(s)
icon: paint icon file(s)
labels: paint label file(s)
sites: site list file(s)
region: region definition(s)
region3d: 3D region definition(s)
group: imagery group(s)
view3d: 3D view parameter(s)
all: all types
pattern=string
Map name search pattern (default: all)
exclude=string
Map name exclusion pattern (default: none)
mapset=name
Name of mapset to list (default: current search path)
'.' for current mapset
fs=character
Field separator
Special characters: newline, space, comma, tab
Default: newline

DESCRIPTION

g.mlist searches for data files matching a pattern given by wildcards or POSIX Extended Regular Expressions.

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

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:

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 separator=, pattern='^tmp[0-9]$'
This may be useful for other programs' parameter input (e.g. r.series).

SEE ALSO

g.list

Regular expressions (aka regex) - from Wikipedia, the free encyclopedia

AUTHOR

Huidae Cho
grass4u@gmail.com

Last changed: $Date: 2008-06-28 04:37:22 -0500 (Sat, 28 Jun 2008) $


Main index - general index - Full index

© 2003-2011 GRASS Development Team