Skip to content

r.unpack

Imports a GRASS specific raster archive file (packed with r.pack) as a raster map

r.unpack [-op] input=name.pack [output=name] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

r.unpack input=name.pack

grass.script.run_command("r.unpack", input, output=None, flags=None, overwrite=None, verbose=None, quiet=None, superquiet=None)

Example:

gs.run_command("r.unpack", input="name.pack")

grass.tools.Tools.r_unpack(input, output=None, flags=None, overwrite=None, verbose=None, quiet=None, superquiet=None)

Example:

tools = Tools()
tools.r_unpack(input="name.pack")

This grass.tools API is experimental in version 8.5 and expected to be stable in version 8.6.

Parameters

input=name.pack [required]
    Name of input pack file
output=name
    Name for output raster map (default: taken from input file internals)
-o
    Override projection check (use current projects's CRS)
    Assume that the dataset has same coordinate reference system as the current project
-p
    Print projection information of input pack file and exit

--overwrite
    Allow output files to overwrite existing files
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

input : str, required
    Name of input pack file
    Used as: input, file, name.pack
output : str, optional
    Name for output raster map (default: taken from input file internals)
    Used as: output, raster, name
flags : str, optional
    Allowed values: o, p
    o
        Override projection check (use current projects's CRS)
        Assume that the dataset has same coordinate reference system as the current project
    p
        Print projection information of input pack file and exit

overwrite: bool, optional
    Allow output files to overwrite existing files
    Default: None
verbose: bool, optional
    Verbose module output
    Default: None
quiet: bool, optional
    Quiet module output
    Default: None
superquiet: bool, optional
    Very quiet module output
    Default: None

input : str, required
    Name of input pack file
    Used as: input, file, name.pack
output : str, optional
    Name for output raster map (default: taken from input file internals)
    Used as: output, raster, name
flags : str, optional
    Allowed values: o, p
    o
        Override projection check (use current projects's CRS)
        Assume that the dataset has same coordinate reference system as the current project
    p
        Print projection information of input pack file and exit

overwrite: bool, optional
    Allow output files to overwrite existing files
    Default: None
verbose: bool, optional
    Verbose module output
    Default: None
quiet: bool, optional
    Quiet module output
    Default: None
superquiet: bool, optional
    Very quiet module output
    Default: None

DESCRIPTION

r.unpack allows unpacking raster maps packed by r.pack.

NOTES

Name of the raster map is determined by default from pack file internals. Optionally the name can be given by output parameter. Currently only 2D raster maps are supported.

EXAMPLE

Pack up raster map aspect into aspect.pack file.

r.pack input=aspect

the raster map can be afterwards unpacked by

r.unpack input=aspect.pack

SEE ALSO

r.pack, r.in.gdal, v.pack

AUTHORS

Original Bash script written by Hamish Bowman, Otago University, New Zealand as GRASS AddOns
Converted to Python and updated for GRASS 7 by Martin Landa, CTU in Prague, Czech Republic

SOURCE CODE

Available at: r.unpack source code (history)
Latest change: Friday Aug 08 09:39:19 2025 in commit ed72c71