geotiffinfo

Информация о файле GeoTIFF

Описание

пример

info = geotiffinfo(filename) возвращает структуру, поля которой содержат свойства изображения и картографическую информацию о файле GeoTIFF.

info = geotiffinfo(url) считывает изображение GeoTIFF с URL-адреса.

Примеры

свернуть все

Возврат информации о файле GeoTIFF в качестве структуры при помощи geotiffinfo функция.

info = geotiffinfo('boston.tif')
info = struct with fields:
             Filename: '/tmp/BR2021ad_1640230_185635/mlx_to_docbook11/tp28204d66/map-ex98657947/boston.tif'
          FileModDate: '13-May-2011 22:28:45'
             FileSize: 38729900
               Format: 'tif'
        FormatVersion: []
               Height: 2881
                Width: 4481
             BitDepth: 8
            ColorType: 'truecolor'
            ModelType: 'ModelTypeProjected'
                  PCS: 'NAD83 / Massachusetts Mainland'
           Projection: 'SPCS83 Massachusetts Mainland zone (meters)'
               MapSys: 'STATE_PLANE_83'
                 Zone: 2001
         CTProjection: 'CT_LambertConfConic_2SP'
             ProjParm: [7x1 double]
           ProjParmId: {7x1 cell}
                  GCS: 'NAD83'
                Datum: 'North American Datum 1983'
            Ellipsoid: 'GRS 1980'
            SemiMajor: 6378137
            SemiMinor: 6.3568e+06
                   PM: 'Greenwich'
    PMLongToGreenwich: 0
            UOMLength: 'US survey foot'
    UOMLengthInMeters: 0.3048
             UOMAngle: 'degree'
    UOMAngleInDegrees: 1
            TiePoints: [1x1 struct]
           PixelScale: [3x1 double]
           SpatialRef: [1x1 map.rasterref.MapCellsReference]
            RefMatrix: [3x2 double]
          BoundingBox: [2x2 double]
         CornerCoords: [1x1 struct]
         GeoTIFFCodes: [1x1 struct]
          GeoTIFFTags: [1x1 struct]
     ImageDescription: '"GeoEye"'

Входные параметры

свернуть все

Имя файла GeoTIFF в виде вектора символов. Включите имя папки в filename или поместите файл в текущую папку или в папку на MATLAB® путь. Если именованный файл включает расширение .TIF или .TIFF (либо верхний, либо нижний регистр), можно опустить внутренний номер из filename.

Если именованный файл содержит несколько изображений GeoTIFF, info является массивом структур с одним элементом для каждого изображения в файле. Для примера, info(3) содержит информацию о третьем изображении в файле. Если в файле существует несколько изображений, предполагается, что каждое изображение имеет одинаковую картографическую информацию и ширину и высоту изображения.

URL-адрес Интернета, заданный как вектор символов. URL-адрес должен содержать тип протокола (например, «http ://»).

Выходные аргументы

свернуть все

Свойства изображений и картографическая информация о файле GeoTIFF, возвращенные как структура, содержащая следующие поля.

ОбластьОписание
Filename

Имя файла или URL-адрес

FileModDate

Дата изменения файла

FileSize

Целое число, указывающее размер файла в байтах.

Format

Формат файла (всегда 'tiff')

FormatVersion

Версия формата файла

Height

Целое число, указывающее высоту изображения в пикселях

Width

Целое число, указывающее ширину изображения в пикселях

BitDepth

Целое число, указывающее количество бит на пиксель

ColorType

Тип изображения: 'truecolor' для изображения истинного цвета (RGB), 'grayscale' для полутонового изображения или 'indexed' для индексированного изображения.

ModelType

Тип системы координат, используемой для определения координат изображения: 'ModelTypeProjected', 'ModelTypeGeographic', 'ModelTypeGeocentric', или ''.

PCS

Проективная система координат

Projection

Идентификатор EPSG для базового метода проекции

MapSys

Картографическая система, если применимо: 'STATE_PLANE_27', 'STATE_PLANE_83', 'UTM_NORTH', 'UTM_SOUTH', или ''

Zone

double номер зоны UTM или State Plane, пустой ([]) если не применимо или неизвестно

CTProjection

Идентификатор GeoTIFF для базового метода проекции

ProjParm

N-by-1 double вектор, содержащий значения параметров проекции. Тождества каждого элемента задаются соответствующим элементом ProjParmId. Длины указаны в метрах, углы в десятичных степенях.

ProjParmId

N-by-1 массива ячеек с указанием идентификатора параметра проекции для каждого соответствующего числового элемента ProjParm:

  • 'ProjNatOriginLatGeoKey'

  • 'ProjNatOriginLongGeoKey'

  • 'ProjFalseEastingGeoKey'

  • 'ProjFalseNorthingGeoKey'

  • 'ProjFalseOriginLatGeoKey'

  • 'ProjFalseOriginLongGeoKey'

  • 'ProjCenterLatGeoKey'

  • 'ProjCenterLongGeoKey'

  • 'ProjAzimuthAngleGeoKey'

  • 'ProjRectifiedGridAngleGeoKey'

  • 'ProjScaleAtNatOriginGeoKey'

  • 'ProjStdParallel1GeoKey'

  • 'ProjStdParallel2GeoKey'

GCS

Географическая система координат

Datum

Тип данной величины, например 'North American Datum 1927' или 'North American Datum 1983'

Ellipsoid

Имя эллипсоида, определяемое ellipsoid.csv Файл EPSG

SemiMajor

double длина большой полуоси эллипсоида, в метрах

SemiMinor

double длина малой полуоси эллипсоида, в метрах

PM

Расположение первичного меридиана, например 'Greenwich' или 'Paris'

PmLongToGreenwich

double указание десятичных степеней долготы между этим простым меридианом и Гринвичем. Простые меридианы к западу от Гринвича отрицательны.

UOMLength

Модули измерения длины, используемые в проективной системе координат

UOMLengthInMeters

double определение UOMLength модуль измерения в метрах.

UOMAngle

Угловые единицы, используемые для географических координат

UOMAngleInDegrees

double определение UOMAngle модуль измерения в степенях.

TiePoints

Структура, содержащая опорные точки изображения. Структура содержит следующие поля:

Имя поляОписание
ImagePoints

Структура, содержащая координаты строк и столбцов каждой опорная точка изображения. The ImagePoints структура содержит следующие поля:

  • Rowdouble массив размера 1-by-N

  • Coldouble массив размера 1-by-N

WorldPoints

Структура, содержащая координаты x и y мира опорных точек. The WorldPoints структура содержит следующие поля:

  • Xdouble массив размера 1-by-N

  • Ydouble массив размера 1-by-N

PixelScale

3 на 1 double массив, который задает значения шкалы X, Y, Z пикселей.

SpatialRef

Значение зависит от значения ModelType поле:

  • 'ModelTypeProjected'SpatialRef является map- объекта растровой привязки.

  • 'ModelTypeGeographic'SpatialRef является географическим объектом растровой привязки, если геометрическое преобразование не аффинно, в этом случае это '' (пустой).

  • 'ModelTypeGeocentric'SpatialRef является '' (пустой).

  • '' (пустой) - geotiffinfo выдает предупреждение и SpatialRef является map- объекта растровой привязки.

Если пространственная ссылка неоднозначно задана файлом GeoTIFF, то SpatialRef является '' (пустой).

RefMatrix

3 на 2 double матрица привязки, которая должна быть однозначно определена файлом GeoTIFF. В противном случае он пуст ([]).

BoundingBox

2 на 2 double массив, который задает минимальное (строка 1) и максимальное (строка 2) значения для каждой размерности данных изображения в файле GeoTIFF.

CornerCoords

Структура с шестью полями, содержащими координаты внешних углов изображения GeoTIFF. Каждое поле имеет вид 1 на 4 double массив, или пустой ([]) если неизвестно. Массивы содержат координаты внешних углов угловых пикселей, начиная с (1,1) угол и движение по часовой стрелке:

ОбластьОписание
XВосточные координаты в проективной системе координат. X равен Lon (ниже) если ModelType является 'ModelTypeGeographic'
YКоординаты северного положения в проективной системе координат. Y равен Lat (ниже) если ModelType является 'ModelTypeGeographic'
RowКоординаты строка угла.
ColКоординаты столбца угла.
LatШироты угла.
LonДолготы угла.

GeoTIFFCodes

Структура, содержащая необработанные числовые значения для тех полей GeoTIFF, которые численно закодированы в файле. Эти необработанные значения, преобразованные в векторы символов в другом месте info структура, предоставлены здесь для ссылки.

  • Model

  • PCS

  • GCS

  • UOMLength

  • UOMAngle

  • Datum

  • PM

  • Ellipsoid

  • ProjCode

  • Projection

  • CTProjection

  • ProjParmId

  • MapSys

Каждый из них скаляр, кроме ProjParmId, который является вектором-столбцом.

GeoTIFFTags

Структура, содержащая имена полей, совпадающие с тегами GeoTIFF в файле. В файле должен присутствовать по крайней мере один тег GeoTIFF или выдана ошибка. Могут быть включены следующие поля:

ОбластьЗначение
ModelPixelScaleTag1 на 3 double
ModelTiepointTag1 на 6 double
ModelTransformationTag1 на 16 double
GeoKeyDirectoryTagскалярная структура
GeoAsciiParamsTagвектор символов
GeoDoubleParamsTag1-by-N double
RPCCoefficientTagскалярные RPCCoefficientTag

The GeoKeyDirectoryTag содержит имена полей, которые совпадают с именами «GeoKeys». Для получения дополнительной информации о «GeoKeys» см. спецификацию GeoTIFF.

The RPCCoefficientTag содержит свойства с именами, соответствующими элементам тега, перечисленным в RPCs in GeoTIFF технической заметке по адресу: http://geotiff.maptools.org/rpc_prop.html

ImageDescription

Описание изображения. Если описание не включено в файл, поле опускается.

Совет

Получите дополнительную информацию о системе координат для файла GeoTIFF при помощи georasterinfo функция.

Представлено до R2006a