geotiffinfo

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

Синтаксис

info = geotiffinfo(filename)
info = geotiffinfo(url)

Описание

пример

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

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

Примеры

свернуть все

info = geotiffinfo('boston.tif')
info = struct with fields:
             Filename: '/mathworks/devel/bat/BR2019ad/build/matlab/toolbox/map/mapdata/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 или Плоский Зональный номер состояния, пустой ([]), если не применимый или неизвестный

CTProjection

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

ProjParm

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

ProjParmId

Массив ячеек N-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

Имя эллипсоида, как задано файлом EPSG ellipsoid.csv

SemiMajor

double, указывающий на длину полуглавной оси эллипсоида, в метрах

SemiMinor

double, указывающий на длину полунезначительной оси эллипсоида, в метрах

PM

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

PmLongToGreenwich

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

UOMLength

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

UOMLengthInMeters

double, задающий модуль UOMLength в метрах.

UOMAngle

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

UOMAngleInDegrees

double, задающий модуль UOMAngle в градусах.

TiePoints

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

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

Структура, содержащая координаты строки и столбца каждого изображения tiepoint. Структура ImagePoints содержит эти поля:

  • Row — массив double размера 1 на n

  • Col — массив double размера 1 на n

WorldPoints

Структура, содержащая мировые координаты X и Y tiepoints. Структура WorldPoints содержит эти поля:

  • X массив double размера 1 на n

  • Y массив double размера 1 на n

PixelScale

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

SpatialRef

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

  • 'ModelTypeProjected'SpatialRef является растровым объектом ссылки карты.

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

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

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

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

RefMatrix

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

BoundingBox

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

CornerCoords

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

Поле Описание
XДвижение на восток координирует в спроектированной системе координат. X равняется Lon (ниже), если ModelType является 'ModelTypeGeographic'
YNorthing координирует в спроектированной системе координат. 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символьный вектор
GeoDoubleParamsTagdouble 1 на n
RPCCoefficientTagскалярный RPCCoefficientTag

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

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

ImageDescription

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

Смотрите также

| | | |

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