Main Content

sdtsinfo

(To be removed) Information about SDTS data set

The sdtsinfo function will be removed in a future release. In most cases, use the georasterinfo function instead. For more information about replacement functionality, see Version History.

Syntax

info = sdtsinfo(filename)

Description

info = sdtsinfo(filename) returns a structure whose fields contain information about the contents of a SDTS data set.

filename is a string scalar or character vector that specifies the name of the SDTS catalog directory file, such as 7783CATD.DDF. The file name can also include the directory name. If filename does not include the directory, then it must be in the current directory or in a directory on the MATLAB® path. If sdtsinfo cannot find the SDTS catalog file, it returns an error.

If any of the other files in the data set as specified by the catalog file is missing, a warning message is returned. Subsequent calls to read data from the file might also fail.

Field Descriptions

The info structure contains the following fields:

Filename

Name of the catalog directory file of the SDTS transfer set, specified as a character vector.

Title

Name of the data set, specified as a character vector.

ProfileID

Profile Identifier, e.g., 'SRPE: SDTS RASTER PROFILE and EXTENSIONS', specified as a character vector.

ProfileVersion

Profile Version Identifier, e.g., 'VER 1.1 1998 01', specified as a character vector.

MapDate

Date associated with the cartographic information contained in the data set, specified as a character vector.

DataCreationDate

Creation date of the data set, specified as a character vector.

HorizontalDatum

Horizontal datum to which the data is referenced, specified as a character vector.

MapRefSystem

Projection and reference system used, specified as one of the following values: 'GEO', 'SPCS', 'UTM', 'UPS', or ''.

ZoneNumber

Scalar value representing the zone number

XResolution

Scalar value representing the X component of the horizontal coordinate resolution

YResolution

Scalar value representing the Y component of the horizontal coordinate resolution

NumberOfRows

Scalar value representing the number of rows of the DEM

NumberOfCols

Scalar value representing the number of columns of the DEM

HorizontalUnits

Units used for the horizontal coordinate values, specified as a character vector.

VerticalUnits

Units used for the vertical coordinate values, specified as a character vector.

MinElevation

Scalar value of the minimum elevation value for the data set

MaxElevation

Scalar value of the maximum elevation value for the data set

Version History

Introduced before R2006a

collapse all

R2023b: To be removed

The sdtsinfo function runs without warning, but will be removed in a future release. In most cases, you can replace the field values in the structure returned by the sdtsinfo function with property values stored in the RasterInfo object returned by the georasterinfo function.

This table shows how to update your code.

FieldTo Be RemovedRecommended Replacement
Filename
info = sdtsinfo(filename);
info.Filename
info = georasterinfo(filename);
info.Filename
Title
info = sdtsinfo(filename);
info.Title
info = georasterinfo(filename);
info.Metadata.TITLE
ProfileID
info = sdtsinfo(filename);
info.ProfileID
No replacement.
ProfileVersion
info = sdtsinfo(filename);
info.ProfileVersion
No replacement.
MapDate
info = sdtsinfo(filename);
info.MapDate
No replacement.
DataCreationDate
info = sdtsinfo(filename);
info.DataCreationDate
info = georasterinfo(filename);
info.Metadata.DATASET_CREATION_DATE 
HorizontalDatum
info = sdtsinfo(filename);
info.HorizontalDatum
info = georasterinfo(filename);
info.CoordinateReferenceSystem.GeographicCRS.Datum
MapRefSystem
info = sdtsinfo(filename);
info.MapRefSystem

The well-known text (WKT) string representation of the coordinate reference system contains information about the projection and coordinate reference system.

info = georasterinfo(filename);
crs = info.CoordinateReferenceSystem;
wktstring(crs)

ZoneNumber
info = sdtsinfo(filename);
info.ZoneNumber

If applicable, the WKT string representation of the coordinate reference system contains information about the zone number.

info = georasterinfo(filename);
crs = info.CoordinateReferenceSystem;
wktstring(crs)

XResolution
info = sdtsinfo(filename);
info.XResolution
info = georasterinfo(filename);
info.RasterReference.CellExtentInWorldX 
YResolution
info = sdtsinfo(filename);
info.YResolution
info = georasterinfo(filename);
info.RasterReference.CellExtentInWorldY 
NumberOfRows
info = sdtsinfo(filename);
info.NumberOfRows
info = georasterinfo(filename);
info.RasterSize(1) 
NumberOfCols
info = sdtsinfo(filename);
info.NumberOfCols
info = georasterinfo(filename);
info.RasterSize(2) 
HorizontalUnits
info = sdtsinfo(filename);
info.HorizontalUnits
info = georasterinfo(filename);
info.CoordinateReferenceSystem.LengthUnit 
VerticalUnits
info = sdtsinfo(filename);
info.VerticalUnits
info = georasterinfo(filename);
info.CoordinateReferenceSystem.LengthUnit 
MinElevation
info = sdtsinfo(filename);
info.MinElevation
[Z,R] = readgeoraster(filename,"OutputType","double");
info = georasterinfo(filename);
m = info.MissingDataIndicator;
Z = standardizeMissing(Z,m);
min(Z,[],"all")
MaxElevation
info = sdtsinfo(filename);
info.MaxElevation
[Z,R] = readgeoraster(filename,"OutputType","double");
info = georasterinfo(filename);
m = info.MissingDataIndicator;
Z = standardizeMissing(Z,m);
max(Z,[],"all")