Mathematica Import/Export Format

CDED

Canadian digital elevation data.
Standard format for the distribution of terrain elevation data for the United States.
Canadian Centre for Topographic Information (CTI) standard.
ASCII format.
Typically distributed as a ZIP compressed file.
The .dem file extension is often omitted.
Stores elevation data as a 1201×1201 raster.
CDED is available in 1:50,000 and 1:250,000 scales.
The longitudinal grid spacing varies with the latitude of the geographic area.
1:50,000 CDED uses a grid spacing of 0.75×0.75 arc second, 0.75×1.5 arc second, or 0.75×3 arc second.
1:250,000 CDED uses a grid spacing of 3×3 arc second, 3×6 arc second, or 3×12 arc second.
Elevations are expressed in meters relative to mean sea level.

Import supports the CDED Level 1 standard.

IMPORT

Import["dir/"] imports a CDED directory and renders it as a topographic map.

Import["file.zip"] imports from a CDED archive file.

Import["dir/"] renders CDED topographic data file using ReliefPlot.

Import["dir/", elem] imports the specified element from CDED.

Import["dir/", {elem, sub_a, sub_b, ...}] imports a subelement.

Import["dir/", {{elem₁, elem₂, ...}}] imports multiple elements.

The import format can be specified with Import["file", "CDED"] or Import["file", {"CDED", elem, ...}].

When importing CDED topographic data, Mathematica reads information from multiple files contained in the CDED directory or archive file.

See the reference pages for full general information on Import.

ImportString supports the CDED format.

ELEMENTS

General Import elements:

	"Elements"	list of elements and options available in this file
	"Rules"	full list of rules for each element and option
	"Options"	list of rules for options, properties and settings

Import elements:

	"Data"	array of terrain elevation values
	"Graphics"	CDED data rendered as ReliefPlot

Import by default uses "Graphics" for the CDED format.

Metadata elements:

	"Dimensions"	size of the elevation data array
	"ElevationRange"	range of elevation coordinates, given in meters
	"ElevationResolution"	resolution of elevation values, given in meters
	"SpatialRange"	range of geographic coordinates, given in decimal degrees
	"SpatialResolution"	grid spacing in arc seconds

Import["file.zip", "ElevationRange"]gives the range {z_min, z_max}of elevation values in units of meters.

Import["file.zip", "SpatialRange"]gives the bounding coordinates of the geographic region covered by the file as an expression of the form {{lat_min, lat_max}, {long_min, long_max}}.

Elements representing the geodetic datum and reference ellipsoid used in the file:

	"CoordinateSystem"	name of the coordinate system used in the file
	"Datum"	geodetic datum
	"SemiMajorAxis"	semimajor axis of the reference ellipsoid in meters
	"SemiMinorAxis"	semiminor axis of the reference ellipsoid in meters
	"InverseFlattening"	inverse flattening of the ellipsoid
	"LinearUnits"	coordinate system units

Elements specifying the cartographic projection and its parameters:

	"Projection"	projection name and parameters
	"Centering"	latitude and longitude defining the origin of the projection
	"StandardParallels"	standard parallels
	"CentralScaleFactor"	scale factor at the central meridian or center of projection
	"GridOrigin"	grid coordinates {n, e} of the central parallel and meridian
	"ProjectionName"	Mathematica standard name of the projection used
	"ReferenceModel"	what reference sphere or ellipsoid to use

Accessing low-level metainformation from the file:

"CoordinateSystemInformation"

raw parameters of the coordinate system as stored in the file

See the reference page for GeoProjectionData for full information on cartographic projections.

OPTIONS

General Import options:

BoxRatios	Automatic	effective 3D bounding box ratios
ColorFunction	"Topographic"	how to determine the color of surfaces
DataRange	Automatic	the range of latitude and longitude values to assume for the data
DataReversed	False	whether to reverse the order of rows
ImageSize	Automatic	the overall size of the image
LightingAngle	Automatic	the effective angle from which simulated illumination is taken to come

Advanced option:

"DownsamplingFactor"

integer factor by which the number of latitudinal and longitudinal data points is reduced when importing