GRASS GIS manual: g.xlist

NAME

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

KEYWORDS

general, map management

SYNOPSIS

g.xlist
g.xlist help
g.xlist [-rtmpf] type=datatype[,datatype,...] [pattern=string] [separator=string] [mapset=string] [--verbose] [--quiet]

Flags:

-r: 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; Options: rast,rast3d,vect,oldvect,asciivect,icon,labels,sites,region,region3d,group,3dview,all; Default: rast
pattern=string: Map name search pattern (default: all); Default: *
separator=string: One-character output separator, newline, space, or tab; Default: newline
mapset=string: Mapset to list (default: current search path)

DESCRIPTION

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

EXAMPLES

List all available GRASS data base files:

  g.xlist type=all

List all raster and vector maps:

  g.xlist type=rast,vect

Wildcards:

List all vector maps starting with letter "r":

  g.xlist type=vect pattern="r*"

List certain raster maps with one variable character/number:

  g.xlist type=rast pattern="N45E00?.meters"

Regular expressions:

Print out all soils map with "soils" in their name:

  g.xlist -r type=rast pattern='^soils'

Print out "tmp" if "tmp" raster map exists:

  g.xlist -r pattern='^tmp$'

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

  g.xlist -r type=vect pattern='^tmp[0-9]$'

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

  g.xlist -r type=vect separator=, pattern='^tmp[0-9]$'

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

AUTHOR

Huidae Cho
grass4u@gmail.com

Last changed: $Date$

Main index - general index - Full index