v.hull - GRASS manual
Author: GRASS Development Team
Description: v.hull: Produces a 2D/3D convex hull for a given vector map.
Keywords: vector, geometry, 3D

## NAME

v.hull - Produces a 2D/3D convex hull for a given vector map.

## KEYWORDS

vector, geometry, 3D

## SYNOPSIS

v.hull
v.hull --help
v.hull [-rf] input=name [layer=string] output=name [cats=range] [where=sql_query] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

### Flags:

-r
  Limit to current region
-f
  Create a 'flat' 2D hull even if the input is 3D points
--overwrite
  Allow output files to overwrite existing files
--help
  Print usage summary
--verbose
  Verbose module output
--quiet
  Quiet module output
--ui
  Force launching GUI dialog

### Parameters:

input=name [required]
  Name of input vector map
  Or data source for direct OGR access
layer=string
  Layer number or name ('-1' for all layers)
  A single vector map can be connected to multiple database tables. This number determines which table to use. When used with direct OGR access this is the layer name.
  Default: -1
output=name [required]
  Name for output vector map
cats=range
  Category values
  Example: 1,3,7-9,13
where=sql_query
  WHERE conditions of SQL statement without 'where' keyword
  Example: income < 1000 and population >= 10000

## DESCRIPTION

v.hull computes the convex hull of a vector map and outputs the convex hull polygon as a vector area map. The convex hull, or convex envelope, for an object or a set of objects is the minimal convex set containing the given objects. This module creates a vector polygon containing all vector points or lines of the input map.

In the case of 3D input points, the hull will be a 3D hull as well, unless the user specifies the -f flag. The 3D hull will be composed of triangular faces.

Fig: Convex hull polygon created with v.hull

## NOTES

In order to use the where option the layer option must be set to a positive number (the default is '-1' for 'all layers'), otherwise all points from all layers will be used and the cats and where options will be ignored.

## EXAMPLE

Example of v.hull 3D output (using two random 3D point clouds, North Carolina sample data set):

    g.region rural_1m -p
    r.mapcalc "zero = 0"
    v.random -z output=random3d_a n=10 zmin=0 zmax=200
    v.random -z output=random3d_b n=15 zmin=400 zmax=600
    v.hull input=random3d_a output=random3d_a_hull
    v.hull input=random3d_b output=random3d_b_hull

    d.mon wx0
    d.vect random3d_a_hull
    d.vect random3d_a color=red

    d.vect random3d_b_hull
    d.vect random3d_b color=red

    # 3D view in wxGUI (g.gui)

Fig: Convex hull in 3D from 3D points created with v.hull

## REFERENCES

- M. de Berg, M. van Kreveld, M. Overmars, O. Schwarzkopf, (2000). Computational geometry, chapter 1.1, 2-8.
- J. O'Rourke, (1998). Computational Geometry in C (Second Edition), chapter 4.

## SEE ALSO

v.delaunay

## AUTHORS

Andrea Aime, Modena, Italy
Markus Neteler, ITC-irst (update to 5.7)
Benjamin Ducke, CAU Kiel (3D hull support)
Martin Landa, CTU in Prague, Czech Republic (vector lines support)

## SOURCE CODE

Available at: v.hull source code (history)

Latest change: Friday Aug 08 09:39:19 2025 in commit: ed72c71d8580e872cd6fd345c84a15c324764465

Main index | Vector index | Topics index | Keywords index | Graphical index | Full index

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