1GDAL_CREATE(1) GDAL GDAL_CREATE(1)
2
3
4
6 gdal_create - Create a raster file (without source dataset)
7
9 gdal_create [--help-general]
10 [-of format]
11 [-outsize xsize ysize]
12 [-bands count]
13 [-burn value]*
14 [-ot {Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/
15 CInt16/CInt32/CFloat32/CFloat64}] [-strict]
16 [-a_srs srs_def] [-a_ullr ulx uly lrx lry] [-a_nodata value]
17 [-mo "META-TAG=VALUE"]* [-q]
18 [-co "NAME=VALUE"]*
19 out_dataset
20
22 The gdal_create utility can be used to initialize a new raster file,
23 from its dimensions, band count and set various parameters, such as
24 CRS, geotransform, nodata value, metadata. It can be used also in spe‐
25 cial cases, like creating a PDF file from a XML composition file.
26
27 -ot <type>
28 Force the output image bands to have a specific data type sup‐
29 ported by the driver, which may be one of the following: Byte,
30 UInt16, Int16, UInt32, Int32, Float32, Float64, CInt16, CInt32,
31 CFloat32 or CFloat64.
32
33 -of <format>
34 Select the output format. Starting with GDAL 2.3, if not speci‐
35 fied, the format is guessed from the extension (previously was
36 GTiff). Use the short format name.
37
38 -outsize <xsize> <ysize>
39 Set the size of the output file in pixels. First figure is
40 width. Second one is height.
41
42 -bands <count>
43 Number of bands. Defaults to 1 if -outsize is specified, or 0
44 otherwise.
45
46 -burn <value>
47 A fixed value to burn into a band for all objects. A list of
48 -burn options can be supplied, one per band being written to.
49
50 -a_srs <srs_def>
51 Override the projection for the output file. The<srs_def> may
52 be any of the usual GDAL/OGR forms, complete WKT, PROJ.4, EPSG:n
53 or a file containing the WKT. No reprojection is done.
54
55 -a_ullr <ulx> <uly> <lrx> <lry>
56 Assign the georeferenced bounds of the output file.
57
58 -a_nodata <value>
59 Assign a specified nodata value to output bands.
60
61 -mo META-TAG=VALUE
62 Passes a metadata key and value to set on the output dataset if
63 possible.
64
65 -co <NAME=VALUE>
66 Many formats have one or more optional creation options that can
67 be used to control particulars about the file created. For in‐
68 stance, the GeoTIFF driver supports creation options to control
69 compression, and whether the file should be tiled.
70
71 The creation options available vary by format driver, and some
72 simple formats have no creation options at all. A list of op‐
73 tions supported for a format can be listed with the --formats
74 command line option but the documentation for the format is the
75 definitive source of information on driver creation options.
76 See raster_drivers format specific documentation for legal cre‐
77 ation options for each format.
78
79 -q Suppress progress monitor and other non-error output.
80
81 <out_dataset>
82 The destination file name.
83
85 • Initialize a new GeoTIFF file with a uniform value of 10
86
87 gdal_create -outsize 20 20 -a_srs EPSG:4326 -a_ullr 2 50 3 49 -burn 10 out.tif
88
89 • Create a PDF file from a XML composition file:
90
91 gdal_create -co COMPOSITION_FILE=composition.xml out.pdf
92
94 Even Rouault <even.rouault@spatialys.com>
95
97 1998-2021
98
99
100
101
102 Mar 24, 2021 GDAL_CREATE(1)