1gdaltindex(1)               General Commands Manual              gdaltindex(1)
2
3
4

NAME

6       gdaltindexBuilds a shapefile as a raster tileindex.
7

SYNOPSIS

9       gdaltindex [-f format] [-tileindex field_name] [-write_absolute_path]
10                  [-skip_different_projection] [-t_srs target_srs]
11                  [-src_srs_name field_name] [-src_srs_format [AUTO|WKT|EPSG|PROJ]
12                  [-lyr_name name] index_file [gdal_file]*
13

DESCRIPTION

15       This program builds a shapefile with a record for each input raster
16       file, an attribute containing the filename, and a polygon geometry
17       outlining the raster. This output is suitable for use with MapServer as
18       a raster tileindex.
19
20       -f format:
21           (GDAL >= 1.11)
22
23       The OGR format of the output tile index file. Starting with GDAL 2.3,
24       if not specified, the format is guessed from the extension (previously
25       was ESRI Shapefile).
26
27       -tileindex field_name:
28
29       The output field name to hold the file path/location to the indexed
30       rasters. The default tile index field name is location.
31
32       -write_absolute_path:
33
34       The absolute path to the raster files is stored in the tile index file.
35       By default the raster filenames will be put in the file exactly as they
36       are specified on the command line.
37
38       -skip_different_projection:
39
40       Only files with same projection as files already inserted in the
41       tileindex will be inserted (unless -t_srs is specified). Default does
42       not check projection and accepts all inputs.
43
44       -t_srs target_srs:
45
46       Geometries of input files will be transformed to the desired target
47       coordinate reference system. Using this option generates files that are
48       not compatible with MapServer < 6.4. Default creates simple rectangular
49       polygons in the same coordinate reference system as the input rasters.
50
51       -src_srs_name field_name:
52           (GDAL >= 1.11)
53
54       The name of the field to store the SRS of each tile. This field name
55       can be used as the value of the TILESRS keyword in MapServer >= 6.4.
56
57       -src_srs_format type:
58           (GDAL >= 1.11)
59
60       The format in which the SRS of each tile must be written. Types can be
61       AUTO, WKT, EPSG, PROJ.
62
63       -lyr_name name:
64
65       Layer name to create/append to in the output tile index file.
66
67       index_file:
68
69       The name of the output file to create/append to. The default shapefile
70       will be created if it doesn't already exist, otherwise it will append
71       to the existing file.
72
73       gdal_file:
74
75       The input GDAL raster files, can be multiple files separated by spaces.
76       Wildcards my also be used. Stores the file locations in the same style
77       as specified here, unless -write_absolute_path option is also used.
78

EXAMPLES

80       Produce a shapefile (doq_index.shp) with a record for every image that
81       the utility found in the doq folder. Each record holds information that
82       points to the location of the image and also a bounding rectangle shape
83       showing the bounds of the image:
84
85       gdaltindex doq_index.shp doq/*.tif
86
87       The -t_srs option can also be used to transform all input rasters into
88       the same output projection:
89
90       gdaltindex -t_srs EPSG:4326 -src_srs_name src_srs tile_index_mixed_srs.shp *.tif
91

AUTHOR

93       Frank Warmerdam warmerdam@pobox.com
94

See also

96       General Command Line Switches for other command-line options, and in
97       particular the --optfile switch that can be used to specify a list of
98       input datasets.
99
100
101
102GDAL                            Tue Mar 3 2020                   gdaltindex(1)
Impressum