ShapefileReader

Description

Reads data from files in Shapefile format.

API Overview

ShapefileReader is the only object you instantiate.

Internally, it builds the three following objects, depending on the available auxiliary files:

• SHPReader to read the shapes, ie the list of points
• DBFReader to read the data records associated with the shapes
• SHXReader to read the indices of the shapes, thus allowing direct access

Most usages of ShapefileReader will remain like:

guard let sr = ShapefileReader(path: "g1g15.shp") else { assertionFailure() }

// iterate over both shapes and records
for (shape, record) in sr.shapeAndRecordGenerator() {
    // record is [AnyObject]

    for points in shape.partPointsGenerator() {
        // draw polygon with [CLLocationCoordinate2D]
    }
}

DBF API

// if dbf file exists
if let dbf = sr.dbf {
    // number of records
    let n = dbf.numberOfRecords
    
    // fields description
    print(dbf.fields)
    
    // iterate over records
    for r in dbf.recordGenerator() {
        // ...
    }
    
    // access a record by index
    print(dbf[1847])
}

[[DeletionFlag, C, 1, 0], [GMDNR, N, 9, 0], [GMDNAME, C, 50, 0], [BZNR, N, 9, 0], [KTNR, N, 9, 0], [GRNR, N, 9, 0], [AREA_HA, N, 9, 0], [X_MIN, N, 9, 0], [X_MAX, N, 9, 0], [Y_MIN, N, 9, 0], [Y_MAX, N, 9, 0], [X_CNTR, N, 9, 0], [Y_CNTR, N, 9, 0], [Z_MIN, N, 9, 0], [Z_MAX, N, 9, 0], [Z_AVG, N, 9, 0], [Z_MED, N, 9, 0], [Z_CNTR, N, 9, 0]]  
[5586, Lausanne, 2225, 22, 1, 4138, 534438, 544978, 150655, 161554, 538200, 152400, 371, 930, 670, 666, 585]

SHX API

// if index file exists
if let shx = sr.shx {
    // access a shape by index
    if let offset = shx.shapeOffsetAtIndex(2) {
    	if let (nextIndex, shape) = shp.shapeAtOffset(offset) {
	        // use shape   	
    	}
    }
}

// or more simply
let shape = sr[2]

Implementation Details

• shape points are CLLocationCoordinate2D arrays
• record are arrays of Int, Double, Bool or String (no NSDate, no optionals)
• random access in files and enumerators are used each time it is possible
• most of time, code will crash when files do not match the specs, feel free to open an issue an join the offending files

Linting

Linting is done with SwiftLint at build time. See .swiftlint for details.