OGRTINDEX(1)

🌸 NAME 🌸

ogrtindex — creates a tileindex ✨

hiii bestie, welcome to the OGRTINDEX(1) page — it’s the GDAL manual for ogrtindex, and we’re gonna make a tileindex together 💅

✨ SYNOPSIS ✨

          ogrtindex [-lnum n]... [-lname name]... [-f output_format]
                    [-write_absolute_path] [-skip_different_projection]
                    [-t_srs target_srs]
                    [-src_srs_name field_name] [-src_srs_format [AUTO|WKT|EPSG|PROJ]
                    [-accept_different_schemas]
                    <output_dataset> <src_dataset>...

💅 DESCRIPTION 💅

okay so the ogrtindex program can be used to create a tileindex — a file containing a list of the identities of a bunch of other files along with their spatial extents. This is primarily intended to be used with MapServer for tiled access to layers using the OGR connection type. 🗺️✨

here’s the option rundown, no cap:

• -lnum <n> — add layer number n from each source file in the tile index. 🧚
• -lname <name> — add the layer named name from each source file in the tile index. 🌸
• -f <output_format> — select an output format name. The default is to create a shapefile. 🎀
• -tileindex <field_name> — the name to use for the dataset name. Defaults to LOCATION. 🫶
• -write_absolute_path — filenames are written with absolute paths. 💖
• -skip_different_projection — only layers with same projection ref as layers already inserted in the tileindex will be inserted. 🦋
• -t_srs <target_srs> — extent of input files will be transformed to the desired target coordinate reference system. Using this option generates files that are not compatible with MapServer < 7.2. Default creates simple rectangular polygons in the same coordinate reference system as the input vector layers.

New in version 2.2.0. 🆕

• -src_srs_name <field_name> — the name of the field to store the SRS of each tile. This field name can be used as the value of the TILESRS keyword in MapServer >= 7.2.

New in version 2.2.0. 🆕

• -src_srs_format <format> — the format in which the SRS of each tile must be written. Available formats are: AUTO, WKT, EPSG, PROJ.

New in version 2.2.0. 🆕

• -accept_different_schemas — by default ogrtindex checks that all layers inserted into the index have the same attribute schemas. If you specify this option, this test will be disabled. Be aware that resulting index may be incompatible with MapServer! 💀

⚠️ bestie, that -accept_different_schemas warning is real: the resulting index may be incompatible with MapServer — do not ignore it.

if no -lnum or -lname arguments are given it is assumed that all layers in source datasets should be added to the tile index as independent records. 🫶

if the tile index already exists it will be appended to, otherwise it will be created. 💖

🎀 EXAMPLE 🎀

this example would create a shapefile (tindex.shp) containing a tile index of the BL2000_LINK layers in all the NTF files in the wrk directory:

          ogrtindex tindex.shp wrk/*.NTF 1069148.900,419873.100 1069147.500,419870.200
            1069146.400,419862.100 1069143.000,419860 1069142,419854.900
            1069138.600,419850 1069135.400,419848.800 1069134.100,419843
            1069130,419836.200 1069127.600,419824.600 1069123.800,419820.200
            1069126.900,419815.500 1069126.900,419808.200 1069116.500,419798.700
            1069117.600,419794.100 1069115.100,419796.300 1069109.100,419801.800
            1069106.800,419805.000  1069107.300)

🫶 AUTHOR 🫶

the icons behind this: Frank Warmerdam <warmerdam@pobox.com>, Silke Reimer <silke@intevation.de> 👑

📜 COPYRIGHT 📜

1998-2026 — periodt, that’s the copyright range 💜

---

okay that’s the whole OGRTINDEX(1) page, GDAL edition — signing off on Jan 08, 2026 🫶💖✨