1gdal_polygonize(1) General Commands Manual gdal_polygonize(1)
2
3
4
6 gdal_polygonizeProduces a polygon feature layer from a raster.
7
9 gdal_polygonize.py [-8] [-nomask] [-mask filename] raster_file [-b band]
10 [-q] [-f ogr_format] out_file [layer] [fieldname]
11
13 This utility creates vector polygons for all connected regions of
14 pixels in the raster sharing a common pixel value. Each polygon is
15 created with an attribute indicating the pixel value of that polygon. A
16 raster mask may also be provided to determine which pixels are eligible
17 for processing.
18
19 The utility will create the output vector datasource if it does not
20 already exist, defaulting to GML format.
21
22 The utility is based on the GDALPolygonize() function which has
23 additional details on the algorithm.
24
25 -8:
26 (GDAL >= 1.10) Use 8 connectedness. Default is 4 connectedness.
27
28 -nomask:
29 Do not use the default validity mask for the input band (such as
30 nodata, or alpha masks).
31
32 -mask filename:
33 Use the first band of the specified file as a validity mask (zero
34 is invalid, non-zero is valid). If not specified, the default
35 validity mask for the input band (such as nodata, or alpha masks)
36 will be used (unless -nomask is specified)
37
38 raster_file
39 The source raster file from which polygons are derived.
40
41 -b band:
42 The band on raster_file to build the polygons from. Starting with
43 GDAL 2.2, the value can also be set to 'mask', to indicate that the
44 mask band of the first band must be used (or 'mask,band_number' for
45 the mask of a specified band)
46
47 -f ogr_format
48 Select the output format. Starting with GDAL 2.3, if not specified,
49 the format is guessed from the extension (previously was GML). Use
50 the short format name
51
52 out_file
53 The destination vector file to which the polygons will be written.
54
55 layer
56 The name of the layer created to hold the polygon features.
57
58 fieldname
59 The name of the field to create (defaults to 'DN').
60
61 -q:
62 The script runs in quiet mode. The progress monitor is suppressed
63 and routine messages are not displayed.
64
66 Frank Warmerdam warmerdam@pobox.com
67
68
69
70GDAL Tue Mar 3 2020 gdal_polygonize(1)