shapeinfo

Information about shapefile

Syntax

info = shapeinfo(filename)

Description

info = shapeinfo(filename) returns a structure, info, whose fields contain information about the contents of a file in shapefile format. filename can be the base name or the full name of any one of the component files. shapeinfo reads all three files as long as they exist in the same folder and the unit of length or angle is not specified. If the main file (with extension .SHP) is missing, shapeinfo returns an error. If either of the other files is missing, shapeinfo returns a warning.

Examples

Get CRS Information from Shapefile

Get projected or geographic CRS information from a shapefile by using the shapeinfo function.

First, return information about a shapefile as a structure. For this example, specify a shapefile that uses projected coordinates. Then, get information about the coordinate reference system by querying the CoordinateReferenceSystem field of the structure.

S = shapeinfo('boston_placenames.shp');
S.CoordinateReferenceSystem

ans = 
  projcrs with properties:

                    Name: "NAD83 / Massachusetts Mainland"
           GeographicCRS: [1×1 geocrs]
        ProjectionMethod: "Lambert Conic Conformal (2SP)"
              LengthUnit: "meter"
    ProjectionParameters: [1×1 map.crs.ProjectionParameters]

Note that the value of the CoordinateReferenceSystem field is a projcrs object because the shapefile uses projected coordinates.

Input Arguments

filename — File name

string scalar | character vector

File name of the shapefile, specified as a string scalar or character vector. filename can be the base name or the full name of any one of the component files.

Output Arguments

info — Information about shapefile contents

structure

Information about shapefile contents, returned as a structure contains the following fields.

Filename	Char array containing the names of the files that were read
ShapeType	Character vector containing the shape type
BoundingBox	Numerical array of size 2-by-N that specifies the minimum (row 1) and maximum (row 2) values for each dimension of the spatial data in the shapefile
Attributes	Structure array of size 1-by-numAttributes that describes the attributes of the data. The structure contains these fields: Name — Character vector containing the attribute name as given in the xBASE table Type — Character vector specifying the MATLAB® class of the attribute data returned by shaperead. The following attribute (xBASE) types are supported: Numeric, Floating, Character, and Date
NumFeatures	The number of spatial features in the shapefile
CoordinateReferenceSystem	Coordinate reference system (CRS), returned as a geocrs or projcrs object. The value of CoordinateReferenceSystem depends on the data contained in the file: If the data is referenced to a geographic coordinate system, then CoordinateReferenceSystem is a geocrs object. If the data is referenced to a projected coordinate system, then CoordinateReferenceSystem is a projcrs object. If the file does not contain valid coordinate reference system information, then CoordinateReferenceSystem is empty.

More About

Shapefile format

Data files in the shapefile format store vector data using multiple files: a main file (.shp), an index file (.shx), and an attribute file (.dbf). All the files have the same base name, for example, myfile.shp, myfile.shx, and myfile.dbf.

Version History

Introduced before R2006a