Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
OGRTINDEX(1)			      GDAL			    OGRTINDEX(1)

NAME
     ogrtindex - Creates a tileindex.

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
     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 ac-
     cess to layers using the OGR connection type.

     TIP:
	Equivalent in new "gdal" command line interface:

	See gdal vector index.

     --help
	    Show this help message and exit

     --help-general
	    Gives a brief usage message for the generic GDAL commandline options
	    and exit.

     -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  co-
	    ordinate  reference  system.  Using this option generates files that
	    are not compatible with MapServer < 7.2. Default creates simple rec-
	    tangular polygons in the same coordinate reference system as the in-
	    put vector layers.

     -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.

     -src_srs_format {AUTO|WKT|EPSG|PROJ}
	    The format in which the SRS of each tile must be written.  Available
	    formats are: AUTO, WKT, EPSG, PROJ.

     -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  incom-
	    patible with MapServer!

     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.

RETURN STATUS CODE
     The  program returns status code 0 in case of success, and non-zero in case
     of error (non-blocking errors emitted as warnings are considered as a  suc-
     cessful execution).

EXAMPLES
   Example 1
     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

AUTHOR
     Frank Warmerdam <warmerdam@pobox.com>, Silke Reimer <silke@intevation.de>

COPYRIGHT
     1998-2026

				  Jun 05, 2026			    OGRTINDEX(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ogrtindex&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help