g.remove(1)

NAME
g.remove - Removes data base element files from the user’s current mapset using the search pattern.

KEYWORDS
general, map management, remove

SYNOPSIS
g.remove
g.remove --help
g.remove [-irefb] type=datatype[,datatype,...] [name=string[,string,...]] [ignore=string[,string,...]] [pattern=string] [exclude=string] [--help] [--verbose] [--quiet] [--ui]

  Flags:

-i
    Ignore case

-r
    Use basic regular expressions instead of wildcards

-e
    Use extended regular expressions instead of wildcards

-f
    Force removal (required for actual deletion of files)

-b
    Remove base raster maps

--help
    Print usage summary

--verbose
    Verbose module output

--quiet
    Quiet module output

--ui
    Force launching GUI dialog

  Parameters:

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

name=string[,string,...]
    Name of file(s) to remove

ignore=string[,string,...]
    Name of file(s) to ignore (default: none)

pattern=string
    File name search pattern

exclude=string
    File name exclusion pattern (default: none)

DESCRIPTION
g.remove removes data files matching a pattern given by wildcards or POSIX Extended Regular Expressions. If the -f force flag is not given then nothing is removed, instead the list of selected file names is printed to stdout as a preview of the files to be deleted.

EXAMPLES
Delete map1 and map2 raster maps in the current mapset:

g.remove -f type=raster name=tmp1,tmp2

Delete all raster and vector maps starting with "tmp_" in the current mapset:

# show matching raster and vector maps but do not delete yet (as verification)
g.remove type=raster,vector pattern="tmp_*"
# actually delete the matching raster and vector maps
g.remove -f type=raster,vector pattern="tmp_*"

Delete all vector maps starting with "stream_" in the current mapset, but exclude those ending with "_final":

g.remove -f type=vector pattern="stream_*" exclude="*_final"

AUTHOR
Huidae Cho
grass4u@gmail.com

SOURCE CODE

Available at: g.remove source code (history)

Latest change: Thursday May 08 14:35:40 2025 in commit: 9528b1e38ba37992c1597a979dc3efbb07b74ec5

Main index | General index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual