
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:
List all raster and vector maps:
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