NAME¶
g.mlist - Lists available GRASS data base files of the
user-specified data type optionally using the search pattern.
KEYWORDS¶
general, map management
SYNOPSIS¶
g.mlist
g.mlist help
g.mlist [-
retmpf]
type=
datatype[,
datatype,...] [
pattern=
string] [
exclude=
string]
[
separator=
string] [
mapset=
string]
[--
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 fully-qualified map names (including mapsets)
- -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
Options:
rast,rast3d,vect,oldvect,asciivect,icon,labels,sites,region,region3d,group,3dview,all
Default: rast
- pattern=string
-
Map name search pattern (default: all)
- exclude=string
-
Map name exclusion pattern (default: none)
- separator=string
-
One-character output separator, newline, comma, space, or tab
Default: newline
- mapset=string
-
Mapset to list (default: current search path)
DESCRIPTION¶
g.mlist searches for data files matching a pattern given by wildcards or
POSIX Extended Regular Expressions.
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 expression (from Wikipedia, the free encyclopedia)
AUTHOR¶
Huidae Cho
grass4u@gmail.com
Last changed: $Date: 2011-06-03 18:42:11 +0200 (Fri, 03 Jun 2011) $
Full index
© 2003-2014 GRASS Development Team