OGRTINDEX(1)
β¨ NAME β¨
ogrtindex β she creates a tileindex, bestie π
This is the ogrtindex(1) page from the GDAL manual, and we're gonna get you fully caught up. No cap.
πΈ SYNOPSIS πΈ
Usage: ogrtindex [--help] [--long-usage] [--help-general]
[-lnum <n>]... [-lname <name>]... [-of <output_format>]
[-tileindex <tileindex>] [-write_absolute_path]
[-skip_different_projection] [-t_srs <srs_def>]
[-src_srs_name <field_name>]
[-src_srs_format {AUTO|WKT|EPSG|PROJ}]
[-accept_different_schemas]
<output_dataset> <src_dataset>...
π¦ DESCRIPTION π¦
Okay so ogrtindex is that girl fr β she makes a tileindex, which is literally just a file holding a list of the identities of a bunch of other files, plus their spatial extents. Iconic. πΊοΈβ¨
Her main character purpose? Being used with MapServer for tiled access to layers through the OGR connection type. Periodt.
π‘ TIP: There's an equivalent in the newgdalcommand line interface β go look atgdal vector index. Slay.
β¨ OPTIONS β¨
--helpβ shows you this help message and dips out. Bye! π--help-generalβ gives you the brief usage message for the generic GDAL commandline options and exits.-lnum <n>β adds layer number n from every source file into the tile index. (You can pass this more than once, note the...in the synopsis π)-lname <name>β adds the layer named name from every source file into the tile index. Also stackable β¨-f <output_format>β picks your output format name. If you say nothing, default is to make a shapefile. π-tileindex <field_name>β the name to use for the dataset name. Defaults toLOCATION.-write_absolute_pathβ filenames get written with absolute paths. No relativeness here, she's being direct π-skip_different_projectionβ only layers whose projection ref matches the layers already inserted in the tileindex will get inserted. Projection mismatch? Not today. π«-t_srs <target_srs>β the extents of input files get transformed into the target coordinate reference system you want. Heads up though: using this option generates files that are not compatible with MapServer < 7.2 π The default instead makes simple rectangular polygons in the same coordinate reference system as the input vector layers.-src_srs_name <field_name>β the name of the field that stores the SRS of each tile. You can use this field name as the value of theTILESRSkeyword in MapServer >= 7.2. Cute and functional β¨-src_srs_format {AUTO|WKT|EPSG|PROJ}β the format the SRS of each tile must be written in. The available formats are:AUTO,WKT,EPSG,PROJ.-accept_different_schemasβ by defaultogrtindexchecks that all the layers inserted into the index have the same attribute schemas. Specify this and that test gets disabled. But be aware, bestie: the resulting index may be incompatible with MapServer! π
If you don't pass any -lnum or -lname arguments, it's assumed that all layers in the source datasets should be added to the tile index as independent records. Every single one, go off π
And if the tile index already exists? She appends to it. If it doesn't? She creates it. Simple as that π«Ά
π RETURN STATUS CODE π
- Returns status code
0when it's a success story π - Returns non-zero when there's an error. (Quick note: non-blocking errors that get emitted as warnings still count as a successful execution, so don't panic π)
π EXAMPLES π
Example 1
This one creates a shapefile (tindex.shp) holding a tile index of the BL2000_LINK layers in all the NTF files inside the wrk directory:
ogrtindex tindex.shp wrk/*.NTF
Ate. No crumbs. π₯
π AUTHOR π
Frank Warmerdam <warmerdam@pobox.com>, Silke Reimer <silke@intevation.de>
π COPYRIGHT π
1998-2026
And that's the whole page, bestie π§ It's from GDAL, dated Aug 18, 2026 β OGRTINDEX(1), iykyk. Go index some tiles and be the main character of your own geospatial pipeline. Byeeee π
β¨π¦
periodt.
π¦ where this page comes from
- alpine 3.24: gdal-doc 3.13.3-r0 Β· MIT
- arch rolling: gdal 3.13.3-6 Β· MIT
- ubuntu stonking: gdal-bin 3.13.3+dfsg-1ubuntu4 Β· MIT
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms