i.group
Creates, edits, and lists groups of imagery data.
i.group [-rlsg] group=name [subgroup=name] [input=name [,name,...]] [file=name] [--verbose] [--quiet] [--qq] [--ui]
Example:
i.group group=name
grass.script.parse_command("i.group", group, subgroup=None, input=None, file=None, flags=None, verbose=False, quiet=False, superquiet=False)
Example:
gs.parse_command("i.group", group="name")
Parameters
group=name [required]
Name of imagery group
subgroup=name
Name of imagery subgroup
input=name [,name,...]
Name of raster map(s) to include in group
file=name
Input file with one raster map name per line
-r
Remove selected files from specified group or subgroup
-l
List files from specified (sub)group
-s
List subgroups from specified group
-g
Print in shell script style
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--qq
Very quiet module output
--ui
Force launching GUI dialog
group : str, required
Name of imagery group
Used as: input, group, name
subgroup : str, optional
Name of imagery subgroup
Used as: input, subgroup, name
input : str | list[str], optional
Name of raster map(s) to include in group
Used as: input, raster, name
file : str, optional
Input file with one raster map name per line
Used as: input, file, name
flags : str, optional
Allowed values: r, l, s, g
r
Remove selected files from specified group or subgroup
l
List files from specified (sub)group
s
List subgroups from specified group
g
Print in shell script style
verbose: bool, optional
Verbose module output
Default: False
quiet: bool, optional
Quiet module output
Default: False
superquiet: bool, optional
Very quiet module output
Default: False
DESCRIPTION
i.group allows the user to collect raster map layers in an imagery group by assigning them to user-named subgroups or other groups. This enables the user to run analyses on any combination of the raster map layers in a group. The user creates the groups and subgroups and selects the raster map layers that are to reside in them. Imagery analysis programs like g.gui.gcp, i.rectify, i.ortho.photo and others ask the user for the name of an imagery group whose data are to be analyzed. Imagery analysis programs like i.cluster and i.maxlik ask the user for the imagery group and imagery subgroup whose data are to be analyzed.
NOTES
The i.group options are only available for imagery map layers in the current LOCATION_NAME.
Subgroup names may not contain more than 12 characters.
EXAMPLE
This example runs in the "landsat" mapset of the North Carolina sample dataset. The following command creates a group and subgroup containing only the visible light bands of Landsat-7:
i.group group=vis_bands subgroup=vis_bands input=lsat7_2000_10,lsat7_2000_20,lsat7_2000_30
SEE ALSO
The GRASS 4 Image Processing manual
g.gui.gcp, i.cluster, i.maxlik, i.rectify, i.ortho.photo
AUTHORS
Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
Parser support: Bob Covill (Tekmap, Canada)
SOURCE CODE
Available at: i.group source code
(history)
Latest change: Wednesday Mar 19 14:27:15 2025 in commit a56e76f