g.list.1grass - Man Page

-i

Ignore case

-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)

--overwrite

Allow output files to overwrite existing files

--help

Print usage summary

--verbose

Verbose module output

--quiet

Quiet module output

--ui

Force launching GUI dialog

type=datatype[,datatype,...] [required]

Data type(s)
Options: raster, raster_3d, vector, label, region, group, all
raster: raster map(s)
raster_3d: 3D raster map(s)
vector: vector map(s)
label: paint label file(s)
region: region definition(s)
group: imagery group(s)
all: all types

pattern=string

Map name search pattern (default: all)

exclude=string

Map name exclusion pattern (default: none)

mapset=name[,name,...]

Name of mapset to list (default: current search path)
’.’ for current mapset; ’*’ for all mapsets in location

separator=character

Field separator
Special characters: pipe, comma, space, tab, newline
Default: newline

region=name

Name of saved region for map search (default: not restricted)
’.’ for current region; ’*’ for default region

output=name

Name for output file
If not given or ’-’ then standard output

If mapset is not specified, then g.list searches for data files in the mapsets that are included in the search path (defined by g.mapsets). See g.mapsets -p.

g.list rast -p
raster map(s) available in mapset <user1>:
dmt
...
raster map(s) available in mapset <PERMANENT>:
aspect
...

Option mapset=. (one dot) lists only data files from the current mapset:

g.list rast mapset=.
...

Similarly, mapset=* (one asterisk) prints data files from all available mapsets also including those that are not listed in the current search path (see g.mapsets -l).

g.list rast mapset=* -p
raster map(s) available in mapset <landsat>:
lsat5_1987_10
...
raster map(s) available in mapset <user1>:
dmt
...
raster map(s) available in mapset <PERMANENT>:
aspect
...

List all vector maps starting with letter "r":

g.list type=vector pattern="r*"

List all vector maps starting with letter "r" or "a":

g.list type=vector pattern="[ra]*"

List all raster maps starting with "soil_" or "landuse_":

g.list type=raster pattern="{soil,landuse}_*"

List certain raster maps with one variable character/number:

g.list type=raster pattern="N45E00?.meters"

Use of exclude parameter:

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

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

g.list -r type=raster pattern=’^soils’

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

g.list -r type=raster pattern=’^tmp$’

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

g.list -r type=vector pattern=’^tmp[0-9]$’

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

g.list -r type=vector separator=comma pattern=’^tmp[0-9]$’

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

g.list -e type=raster separator=comma pattern="precip_total.(199[7-9]|200[0-9]|201[0-2]).sum"

List all raster maps starting with "tmp_" whose region overlaps with the region of "test" raster map:

g.region raster=test save=test_region
g.list type=raster pattern=’tmp_*’ region=test_region

List "tmp0"..."tmp9" vector maps whose region overlaps with the current region:

g.list -r type=vector pattern=’^tmp[0-9]$’ region=.

List all raster and vector maps whose region overlaps with the default region of the PERMANENT mapset in the current project (DEFAULT_WIND):

g.list type=rast,vect region=*

Note that, without region=*, g.list type=rast,vect simply lists all available raster and vector maps from the current search path regardless of their region.