v.unpack

Imports a GRASS specific vector archive file (packed with v.pack) as a vector map

Command linePython (grass.script)Python (grass.tools)

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

Example:

v.unpack input=name.pack

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

Example:

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

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

Example:

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

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

Parameters

Command linePython (grass.script)Python (grass.tools)

input=name.pack [required]
    Name of input pack file
output=name
    Name for output vector 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 vector map
    Default: taken from input file internals
    Used as: output, vector, 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 vector map
    Default: taken from input file internals
    Used as: output, vector, 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

Returns:

result : grass.tools.support.ToolResult | None
If the tool produces text as standard output, a ToolResult object will be returned. Otherwise, None will be returned.

Raises:

grass.tools.ToolError: When the tool ended with an error.

DESCRIPTION

v.unpack allows unpacking vector maps packed by v.pack.

NOTES

Name of the vector map is determined by default from pack file internals. Optionally the name can be given by output parameter.

EXAMPLE

Pack up vector map random_point into random_point.pack file.

v.pack input=random_point

the vector map can be afterwards unpacked by

v.unpack input=random_point.pack

SEE ALSO

v.pack, v.in.ogr, r.pack

AUTHOR

Luca Delucchi, Fondazione E. Mach (Italy), based on the r.unpack code

SOURCE CODE

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