sdtsinfo

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

expand all

R2024b: Errors on Linux platforms

On Linux^® platforms, the sdtsinfo function has been removed. 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.

Field	Removed	Recommended 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")

R2024b: Warns on Windows and Mac platforms

On Windows^® and Mac platforms, the sdtsinfo function issues a warning that it 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.

Field	To Be Removed	Recommended 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")

R2023b: To be removed

The sdtsinfo function runs without warning but will be removed in a future release.