Skip to content

v.multi2singlepart

Split multi-part polygons into single-part polygons.

v.multi2singlepart input=name output=name [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

v.multi2singlepart input=name output=name

grass.script.run_command("v.multi2singlepart", input, output, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("v.multi2singlepart", input="name", output="name")

Parameters

input=name [required]
    Name of input vector map
    Input vector layer
output=name [required]
    Output vector layer
--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 vector map
    Input vector layer
    Used as: input, vector, name
output : str, required
    Output vector layer
    Used as: output, vector, name
overwrite: bool, optional
    Allow output files to overwrite existing files
    Default: False
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

v.multi2singlepart creates a vector layer containing singlepart polygon features generated by separating the multipart features of the input vector layer. The attributes of the input layer will be maintained in the output vector layer. Singlepart features will not be affected.

image-alt
From multipart to singlepart polygons.

NOTES

To go from singlepart to multipart features, use the v.dissolve function (see example below).

EXAMPLES

The example uses the layer boundary_municp from the North Carolina dataset. You can download the sample data set from the GRASS GIS website

v.dissolve input=boundary_municp column=MB_NAME output=bnd_municp_dis
v.multi2singlepart input=bnd_municp_dis output=bnd_municp_split

SEE ALSO

v.dissolve

AUTHOR

Paulo van Breugel, paulo at ecodiv.earth

SOURCE CODE

Available at: v.multi2singlepart source code (history)
Latest change: Thursday Feb 20 13:02:26 2025 in commit 53de819