1ogrinfo(1) General Commands Manual ogrinfo(1)
2
6 ogrinfoLists information about an OGR supported data source.
7
9 ogrinfo [--help-general] [-ro] [-q] [-where restricted_where|@filename]
10 [-spat xmin ymin xmax ymax] [-geomfield field] [-fid fid]
11 [-sql statement|@filename] [-dialect dialect] [-al] [-rl] [-so] [-fields={YES/NO}]
12 [-geom={YES/NO/SUMMARY/WKT/ISO_WKT}] [--formats] [[-oo NAME=VALUE] ...]
13 [-nomd] [-listmdd] [-mdd domain|`all`]*
14 [-nocount] [-noextent]
15 datasource_name [layer [layer ...]].fi
16
18 The ogrinfo program lists various information about an OGR supported
19 data source to stdout (the terminal).
20 -ro:
22 Open the data source in read-only mode.
23 -al:
25 List all features of all layers (used instead of having to give
26 layer names as arguments).
27 -rl:
29 (Available in GDAL 2.2) Enable random layer reading mode, i.e.
30 iterate over features in the order they are found in the dataset,
31 and not layer per layer. This can be significantly faster for some
32 formats (for example OSM, GMLAS).
33 -so:
35 Summary Only: suppress listing of features, show only the summary
36 information like projection, schema, feature count and extents.
37 -q:
39 Quiet verbose reporting of various information, including
40 coordinate system, layer schema, extents, and feature count.
41 -where restricted_where:
43 An attribute query in a restricted form of the queries used in the
44 SQL WHERE statement. Only features matching the attribute query
45 will be reported. Starting with GDAL 2.1, the \filename syntax can
46 be used to indicate that the content is in the pointed filename.
47 -sql statement:
49 Execute the indicated SQL statement and return the result. Starting
50 with GDAL 2.1, the @filename syntax can be used to indicate that
51 the content is in the pointed filename.
52 -dialect dialect:
54 SQL dialect. In some cases can be used to use (unoptimized) OGR SQL
55 instead of the native SQL of an RDBMS by passing OGRSQL. Starting
56 with GDAL 1.10, the 'SQLITE' dialect can also be used with any
57 datasource.
58 -spat xmin ymin xmax ymax:
60 The area of interest. Only features within the rectangle will be
61 reported.
62 -geomfield field:
64 (OGR >= 1.11) Name of the geometry field on which the spatial
65 filter operates on.
66 -fid fid:
68 If provided, only the feature with this feature id will be
69 reported. Operates exclusive of the spatial or attribute queries.
70 Note: if you want to select several features based on their feature
71 id, you can also use the fact the 'fid' is a special field
72 recognized by OGR SQL. So, '-where 'fid in (1,3,5)'' would select
73 features 1, 3 and 5.
74 -fields={YES/NO}:
76 (starting with GDAL 1.6.0) If set to NO, the feature dump will not
77 display field values. Default value is YES.
78 -geom={YES/NO/SUMMARY/WKT/ISO_WKT}:
80 (starting with GDAL 1.6.0) If set to NO, the feature dump will not
81 display the geometry. If set to SUMMARY, only a summary of the
82 geometry will be displayed. If set to YES or ISO_WKT, the geometry
83 will be reported in full OGC WKT format. If set to WKT the geometry
84 will be reported in legacy WKT. Default value is YES. (WKT and
85 ISO_WKT are available starting with GDAL 2.1, which also changes
86 the default to ISO_WKT)
87 -oo NAME=VALUE:
89 (starting with GDAL 2.0) Dataset open option (format specific)
90 -nomd
92 (starting with GDAL 2.0) Suppress metadata printing. Some datasets
93 may contain a lot of metadata strings.
94 -listmdd
96 (starting with GDAL 2.0) List all metadata domains available for
97 the dataset.
98 -mdd domain
100 (starting with GDAL 2.0) Report metadata for the specified domain.
101 'all' can be used to report metadata in all domains
102 -nocount
104 (starting with GDAL 2.0) Suppress feature count printing.
105 -noextent
107 (starting with GDAL 2.0) Suppress spatial extent printing.
108 --formats:
110 List the format drivers that are enabled.
111 datasource_name:
113 The data source to open. May be a filename, directory or other
114 virtual name. See the OGR Vector Formats list for supported
115 datasources.
116 layer:
118 One or more layer names may be reported.
119 If no layer names are passed then ogrinfo will report a list of
121 available layers (and their layer wide geometry type). If layer name(s)
122 are given then their extents, coordinate system, feature count,
123 geometry type, schema and all features matching query parameters will
124 be reported to the terminal. If no query parameters are provided, all
125 features are reported.
126 Geometries are reported in OGC WKT format.
128
130 Example reporting all layers in an NTF file:
131 % ogrinfo wrk/SHETLAND_ISLANDS.NTF
133 INFO: Open of `wrk/SHETLAND_ISLANDS.NTF'
134 using driver `UK .NTF' successful.
135 1: BL2000_LINK (Line String)
136 2: BL2000_POLY (None)
137 3: BL2000_COLLECTIONS (None)
138 4: FEATURE_CLASSES (None)
139 Example using an attribute query is used to restrict the output of the
142 features in a layer:
143 % ogrinfo -ro -where 'GLOBAL_LINK_ID=185878' wrk/SHETLAND_ISLANDS.NTF BL2000_LINK
145 INFO: Open of `wrk/SHETLAND_ISLANDS.NTF'
146 using driver `UK .NTF' successful.
147 Layer name: BL2000_LINK
149 Geometry: Line String
150 Feature Count: 1
151 Extent: (419794.100000, 1069031.000000) - (419927.900000, 1069153.500000)
152 Layer SRS WKT:
153 PROJCS["OSGB 1936 / British National Grid",
154 GEOGCS["OSGB 1936",
155 DATUM["OSGB_1936",
156 SPHEROID["Airy 1830",6377563.396,299.3249646]],
157 PRIMEM["Greenwich",0],
158 UNIT["degree",0.0174532925199433]],
159 PROJECTION["Transverse_Mercator"],
160 PARAMETER["latitude_of_origin",49],
161 PARAMETER["central_meridian",-2],
162 PARAMETER["scale_factor",0.999601272],
163 PARAMETER["false_easting",400000],
164 PARAMETER["false_northing",-100000],
165 UNIT["metre",1]]
166 LINE_ID: Integer (6.0)
167 GEOM_ID: Integer (6.0)
168 FEAT_CODE: String (4.0)
169 GLOBAL_LINK_ID: Integer (10.0)
170 TILE_REF: String (10.0)
171 OGRFeature(BL2000_LINK):2
172 LINE_ID (Integer) = 2
173 GEOM_ID (Integer) = 2
174 FEAT_CODE (String) = (null)
175 GLOBAL_LINK_ID (Integer) = 185878
176 TILE_REF (String) = SHETLAND I
177 LINESTRING (419832.100 1069046.300,419820.100 1069043.800,419808.300
178 1069048.800,419805.100 1069046.000,419805.000 1069040.600,419809.400
179 1069037.400,419827.400 1069035.600,419842 1069031,419859.000
180 1069032.800,419879.500 1069049.500,419886.700 1069061.400,419890.100
181 1069070.500,419890.900 1069081.800,419896.500 1069086.800,419898.400
182 1069092.900,419896.700 1069094.800,419892.500 1069094.300,419878.100
183 1069085.600,419875.400 1069087.300,419875.100 1069091.100,419872.200
184 1069094.600,419890.400 1069106.400,419907.600 1069112.800,419924.600
185 1069133.800,419927.900 1069146.300,419927.600 1069152.400,419922.600
186 1069153.500,419917.100 1069153.500,419911.500 1069153.000,419908.700
187 1069152.500,419903.400 1069150.800,419898.800 1069149.400,419894.800
188 1069149.300,419890.700 1069149.400,419890.600 1069149.400,419880.800
189 1069149.800,419876.900 1069148.900,419873.100 1069147.500,419870.200
190 1069146.400,419862.100 1069143.000,419860 1069142,419854.900
191 1069138.600,419850 1069135,419848.800 1069134.100,419843
192 1069130,419836.200 1069127.600,419824.600 1069123.800,419820.200
193 1069126.900,419815.500 1069126.900,419808.200 1069116.500,419798.700
194 1069117.600,419794.100 1069115.100,419796.300 1069109.100,419801.800
195 1069106.800,419805.000 1069107.300)
196
199 Frank Warmerdam warmerdam@pobox.com, Silke Reimer silke@intevation.de
200GDAL Mon Feb 11 2019 ogrinfo(1)