ogrinfo

Выводит информацию об источнике данных, поддерживаемом OGR. С операторами SQL также возможно редактировать данные.

Синопсис

ogrinfo [--help-general] [-ro] [-q] [-where restricted_where|@filename]
        [-spat xmin ymin xmax ymax] [-geomfield field] [-fid fid]
        [-sql statement|@filename] [-dialect dialect] [-al] [-rl] [-so] [-fields={YES/NO}]
        [-geom={YES/NO/SUMMARY/WKT/ISO_WKT}] [--formats] [[-oo NAME=VALUE] ...]
        [-nomd] [-listmdd] [-mdd domain|`all`]*
        [-nocount] [-noextent] [-nogeomtype] [-wkt_format WKT1|WKT2|...]
        [-fielddomain name]
        <datasource_name> [<layer> [<layer> ...]]

Описание

Программа ogrinfo выводит различную информацию об источнике данных, поддерживаемом OGR, на стандартный вывод (терминал). Выполняя операторы SQL, также можно редактировать данные.

-ро
Откройте источник данных в режиме только для чтения.

-al
Перечислите все функции всех слоев (используется вместо того, чтобы указывать имена слоев в качестве аргументов).

-rl
Новое в версии 2.2.
Включить режим случайного чтения слоев, т. е. перебирать объекты в том порядке, в котором они находятся в наборе данных, а не слой за слоем. Это может быть значительно быстрее для некоторых форматов (например, OSM, GMLAS).

-so
Только сводка: скрыть список отдельных объектов и показать только сводную информацию, такую как проекция, схема, количество объектов и экстенты.

-q
Тихий подробный отчет различной информации, включая систему координат, схему слоя, экстенты и количество объектов.

-where <ограниченное_где>
Запрос атрибутов в ограниченной форме запросов, используемых в операторе SQL WHERE. Будут представлены только объекты, соответствующие атрибутивному запросу. Начиная с GDAL 2.1 \filename синтаксис можно использовать для указания того, что содержимое находится в указанном имени файла.

-sql <инструкция>
Выполните указанный оператор SQL и верните результат. Начиная с GDAL 2.1 @filename синтаксис можно использовать для указания того, что содержимое находится в указанном имени файла. Данные также можно редактировать с помощью SQL INSERT, UPDATE, DELETE, DROP TABLE, ALTER TABLE и т. д. Возможности редактирования зависят от выбранного файла dialect.

-dialect <диалект>
диалект SQL. В некоторых случаях можно использовать (неоптимизированный) SQL диалект OGR вместо собственного SQL RDBMS, передав OGRSQLзначение диалекта. Диалект SQL SQLite можно выбрать с помощью значений SQLITE и INDIRECT_SQLITE диалекта, и это можно использовать с любым источником данных.

-spat <xmin> <ymin> <xmax> <ymax>
Область интересов. Будут представлены только объекты внутри прямоугольника.

-geomfield <поле>
Имя поля геометрии, на котором работает пространственный фильтр.

-fid <fid>
Если указано, будет сообщено только о функции с этим идентификатором функции. Работает без учета пространственных или атрибутивных запросов. Примечание: если вы хотите выбрать несколько функций на основе их идентификаторов функций, вы также можете использовать тот факт, что «fid» — это специальное поле, распознаваемое OGR SQL. Таким образом, -where «fid in (1,3,5)» выберет функции 1, 3 и 5.

-fields YES|NO:
Если установлено значение NO, дамп функции не будет отображать значения полей. Значение по умолчанию YES.

-fielddomain <имя_домена>
Новое в версии 3.3.
Отображение сведений о домене поля.

geom YES|NO|SUMMARY|WKT|ISO_WKT
Если установлено значение NO, дамп объекта не будет отображать геометрию. Если установлено значение SUMMARY, будет отображаться только сводка геометрии. Если установлено значение YES или ISO_WKT, геометрия будет представлена в полном формате OGC WKT. Если установлено, WKT геометрия будет сообщена в устаревшем формате WKT. Значение по умолчанию YES. (WKT и ISO_WKTдоступны, начиная с GDAL 2.1, который также изменяет значение по умолчанию на ISO_WKT)

-oo ИМЯ=ЗНАЧЕНИЕ
Опция открытия набора данных (зависит от формата)

-nomd
Подавить печать метаданных. Некоторые наборы данных могут содержать много строк метаданных.

-listmdd
Перечислите все домены метаданных, доступные для набора данных.

-mdd <домен>
Метаданные отчета для указанного домена. all может использоваться для сообщения метаданных во всех доменах.

-nocount
Подавить печать подсчета функций.

-noextent
Подавить печать пространственных экстентов.

-nogeomtype
Новое в версии 3.1.
Подавить печать типа геометрии слоя.

–formats
Перечислите драйверы формата, которые включены.

-wkt_format <формат>
Новое в версии 3.0.0.
Формат WKT, используемый для отображения SRS. В настоящее время поддерживаются следующие значения format:

WKT1
WKT2 (последняя версия WKT, на данный момент WKT2_2018)
WKT2_2015
WKT2_2018

<имя источника_данных>
Источник данных для открытия. Может быть именем файла, каталога или другого виртуального имени. См. список векторных форматов OGR для поддерживаемых источников данных.

<слой>
Может быть указано одно или несколько имен слоев. Если имена слоев не переданы, тогда oginfo сообщит список доступных слоев (и тип их геометрии для всего слоя). Если указаны имена слоев, то их экстенты, система координат, количество объектов, тип геометрии, схема и все объекты, соответствующие параметрам запроса, будут переданы на терминал. Если параметры запроса не указаны, сообщаются все функции.

Геометрия сообщается в формате OGC WKT.

Примеры

Пример сообщения имен слоев в файле NTF:

ogrinfo wrk/SHETLAND_ISLANDS.NTF

# INFO: Open of `wrk/SHETLAND_ISLANDS.NTF'
# using driver `UK .NTF' successful.
# 1: BL2000_LINK (Line String)
# 2: BL2000_POLY (None)
# 3: BL2000_COLLECTIONS (None)
# 4: FEATURE_CLASSES (None)

Пример получения сводки (-so) слоя без отображения сведений о каждом отдельном объекте:

ogrinfo \
  -so \
  natural_earth_vector.gpkg \
  ne_10m_admin_0_antarctic_claim_limit_lines

  # INFO: Open of `natural_earth_vector.gpkg'
  #      using driver `GPKG' successful.

  # Layer name: ne_10m_admin_0_antarctic_claim_limit_lines
  # Geometry: Line String
  # Feature Count: 23
  # Extent: (-150.000000, -90.000000) - (160.100000, -60.000000)
  # Layer SRS WKT:
  # GEOGCS["WGS 84",
  #     DATUM["WGS_1984",
  #         SPHEROID["WGS 84",6378137,298.257223563,
  #             AUTHORITY["EPSG","7030"]],
  #         AUTHORITY["EPSG","6326"]],
  #     PRIMEM["Greenwich",0,
  #         AUTHORITY["EPSG","8901"]],
  #     UNIT["degree",0.0174532925199433,
  #         AUTHORITY["EPSG","9122"]],
  #     AUTHORITY["EPSG","4326"]]
  # FID Column = fid
  # Geometry Column = geom
  # type: String (15.0)
  # scalerank: Integer (0.0)
  # featurecla: String (50.0)

Пример использования атрибутивного запроса для ограничения вывода объектов в слое:

ogrinfo -ro \
    -where 'GLOBAL_LINK_ID=185878' \
    wrk/SHETLAND_ISLANDS.NTF BL2000_LINK

# INFO: Open of `wrk/SHETLAND_ISLANDS.NTF'
# using driver `UK .NTF' successful.
#
# Layer name: BL2000_LINK
# Geometry: Line String
# Feature Count: 1
# Extent: (419794.100000, 1069031.000000) - (419927.900000, 1069153.500000)
# Layer SRS WKT:
# PROJCS["OSGB 1936 / British National Grid",
# GEOGCS["OSGB 1936",
# DATUM["OSGB_1936",
# SPHEROID["Airy 1830",6377563.396,299.3249646]],
# PRIMEM["Greenwich",0],
# UNIT["degree",0.0174532925199433]],
# PROJECTION["Transverse_Mercator"],
# PARAMETER["latitude_of_origin",49],
# PARAMETER["central_meridian",-2],
# PARAMETER["scale_factor",0.999601272],
# PARAMETER["false_easting",400000],
# PARAMETER["false_northing",-100000],
# UNIT["metre",1]]
# LINE_ID: Integer (6.0)
# GEOM_ID: Integer (6.0)
# FEAT_CODE: String (4.0)
# GLOBAL_LINK_ID: Integer (10.0)
# TILE_REF: String (10.0)
# OGRFeature(BL2000_LINK):2
# LINE_ID (Integer) = 2
# GEOM_ID (Integer) = 2
# FEAT_CODE (String) = (null)
# GLOBAL_LINK_ID (Integer) = 185878
# TILE_REF (String) = SHETLAND I
# LINESTRING (419832.100 1069046.300,419820.100 1069043.800,419808.300
# 1069048.800,419805.100 1069046.000,419805.000 1069040.600,419809.400
# 1069037.400,419827.400 1069035.600,419842 1069031,419859.000
# 1069032.800,419879.500 1069049.500,419886.700 1069061.400,419890.100
# 1069070.500,419890.900 1069081.800,419896.500 1069086.800,419898.400
# 1069092.900,419896.700 1069094.800,419892.500 1069094.300,419878.100
# 1069085.600,419875.400 1069087.300,419875.100 1069091.100,419872.200
# 1069094.600,419890.400 1069106.400,419907.600 1069112.800,419924.600
# 1069133.800,419927.900 1069146.300,419927.600 1069152.400,419922.600
# 1069153.500,419917.100 1069153.500,419911.500 1069153.000,419908.700
# 1069152.500,419903.400 1069150.800,419898.800 1069149.400,419894.800
# 1069149.300,419890.700 1069149.400,419890.600 1069149.400,419880.800
# 1069149.800,419876.900 1069148.900,419873.100 1069147.500,419870.200
# 1069146.400,419862.100 1069143.000,419860 1069142,419854.900
# 1069138.600,419850 1069135,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)

Пример обновления значения атрибута в шейп-файле с помощью SQL с использованием диалекта SQLite:

ogrinfo test.shp -dialect sqlite -sql "update test set attr='bar' where attr='foo'"