org.j3d.loaders.dem
Class DEMTypeARecord

java.lang.Object
  org.j3d.loaders.dem.DEMRecord
      org.j3d.loaders.dem.DEMTypeARecord

public class DEMTypeARecord

extends DEMRecord

Representation of the DEM File format Type A record.

The DEM format uses X and Y as the coordinates of the ground plane and Z as the height, which is not your traditional 3D graphics reference system. Values stored in this record will follow the spec, although the heights in other records will follow the normal 3D conventions.

All arrays will be pre-allocated to the correct length, with the exception of the map projection parameters.

The definition of the file format can be found at: http://edcwww.cr.usgs.gov/glis/hyper/guide/1_dgr_dem

Version:

$Revision: 1.1 $

Author:

Justin Couch

Field Summary

static int	AREA_SUSPECT Suspect areas in the data
static int	AREA_SUSPECT_AND_VOID Suspect and void areas in the data
static int	AREA_SUSPECT_NONE No suspect or void areas in the data
static int	AREA_VOID Void areas in the data
int	dataEdition Data edition as specified by the generator (element 28).
int	dataValidated Flag indicating the type of validate that has been performed on the data (element 24).
static int	DEFAULT_DATA_EDITION Default data edition in use.
static int	DEFAULT_PATTERN Default pattern code for element 4
static int	DEFAULT_POLY_SIDES Default number of sides in the polygon of element 10
static float	DEFAULT_REF_SYSTEM_ANGLE Default angle offset between the two reference systems (element 13).
static int	DEM_1 Values for Data Element 3
static int	DEM_2
static int	DEM_3
static int	DEM_4
float[]	eastEdge Location of the SE corner, east edge.
int	edgeMatching Edge match status flag (element 30).
boolean	elevationPattern The elevation points are random (false) or regular (true)(element 4)
int	elevationUnitOfMeasure The type of unit of measure used for elevation values (element 9).
java.lang.String	filename Name of the file (element 1).
java.lang.String	freeFormatText Some free-format text (element 1).
static int	G_REF_GEOGRAPHIC Codes defining the ground reference system for element 5.
static int	G_REF_STATEPLANE
static int	G_REF_UTM
int	groundReferenceSystem Code defining the ground reference system (element 5).
int	groundUnitOfMeasure The type of unit of measure used for X,Y values (element 8).
int	groundZoneSystem Code defining zone in the ground plane reference system (element 6).
boolean	hasAccuracy Flag to say if accuracy of the elevation is known (element 14).
static int	HORIZONTAL_DATUM_NAD27 North American Datum 1927 (NAD 27) horizontal datum
static int	HORIZONTAL_DATUM_NAD83 North American Datum 1983 (NAD 83) horizontal datum
static int	HORIZONTAL_DATUM_OLDHAWAII Old Hawaii Datum horizontal datum
static int	HORIZONTAL_DATUM_PUERTORICO Puerto Rico Datum horizontal datum
static int	HORIZONTAL_DATUM_WGS72 World Geodetic System 1972 (WGS 72) horizontal datum
static int	HORIZONTAL_DATUM_WGS84 World Geodetic System 1984 (WGS 83) horizontal datum
int	horizontalDatum The horizontal datum in use (element 27)
boolean	inspected True if the level 3 quality control process has been followed (element 23).
static int	INTERVAL_UNIT_ARCSEC
static int	INTERVAL_UNIT_FEET
static int	INTERVAL_UNIT_METERS
static int	INTERVAL_UNIT_RADIANS
int	largestContourInterval The largest primary contour interval (element 17).
int	largestIntervalUnits The units for the largest interval (element 18).
int	levelType The DEM level used (element 3).
float[]	mapProjectionParams Extra map projection parameters used when not using UTM, Geo or State-plane (element 7).
double	maxHeight The maximum elevation of the DEM (element 12).
double	minHeight The minimum elevation of the DEM (element 12).
double[]	NECornerCoords Coordinates of the north-east corner (element 11).
int	numColumns The number of rows of profiles in the DEM (element 16).
int	numPolygonSides The number of sides of the polygon that the DEM covers (element 10).
int	numRows The number of rows of profiles in the DEM (element 16).
double[]	NWCornerCoords Coordinates of the north-west corner (element 11).
java.lang.String	originCode Mapping origin code (Element 2).
int	percentageVoid If element 25 indicates a void, this field contains the percentage of nodes in the file set to void (element 29).
static int	PROCESS_CTOG
static int	PROCESS_DCASS
static int	PROCESS_DLG_CPS3
static int	PROCESS_DLG_LINETRACE
static int	PROCESS_ELECTRONIC
static int	PROCESS_GRIDEM
static int	PROCESS_RESAMPLE Values for data element 1 - Process code.
int	processCode Code indicating the process used to create values (element 1)
double	referenceOrientation Counterclockwise angle in radians from the primary axis of the reference system to the local reference system (element 13).
int	revisionDate The year the data was last revised or checked (element 22).
double[]	SECornerCoords Coordibates if the south-west corner (element 11).
java.lang.String	sectionIndicator The section of the area this file represent in 30 & 15 minute DEMs.
int	smallestContourInterval The smallest primary contour interval (element 19).
int	smallestIntervalUnits The units for the smallest interval (element 20).
int	sourceDate The year the data was created, as an int (element 21).
float[]	southEdge Location of the SE corner, south edge.
float[]	spatialResolution Amount of resolution for each axis (element 15).
int	suspectAreas Flag indicating the state of the data (Element 25)
double[]	SWCornerCoords Coordinates of the south-west corner (element 11).
static int	VALIDATE_BATCH Batch process water body edit and RMSE computed from test points.
static int	VALIDATE_L1_REVIEW Level 1 DEM's reviewed and edited.
static int	VALIDATE_L2_VERIFIED Level 2 and 3 DEM's reviewed and edited.
static int	VALIDATE_NONE No data validation performed
static int	VALIDATE_RMSE RMSE computed from test points (record C added), no quantitative test, no interactive DEM editing or review.
static int	VALIDATE_WATER Review and edit, including water edit.
static int	VERTICAL_DATUM_MSL Local mean sea level vertical datum
static int	VERTICAL_DATUM_NAVD North American Vertical Datum 1988 (NAVD 88)vertical datum
static int	VERTICAL_DATUM_NGVD National Geodetic Vertical Datum 1929 (NGVD 29) vertical datum
int	verticalDatum The veritcal datum in use (element 26)
float	verticalDatumShift Vertical datum shift (element 31).

Fields inherited from class org.j3d.loaders.dem.DEMRecord

ARC_SECONDS, EASTING, FEET, METERS, NORTHING, RADIANS, X, Y, Z

Constructor Summary

DEMTypeARecord()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEM_1

public static final int DEM_1

Values for Data Element 3

See Also:

Constant Field Values

DEM_2

public static final int DEM_2

See Also:

Constant Field Values

DEM_3

public static final int DEM_3

See Also:

Constant Field Values

DEM_4

public static final int DEM_4

See Also:

Constant Field Values

PROCESS_RESAMPLE

public static final int PROCESS_RESAMPLE

Values for data element 1 - Process code.

See Also:

Constant Field Values

PROCESS_GRIDEM

public static final int PROCESS_GRIDEM

See Also:

Constant Field Values

PROCESS_CTOG

public static final int PROCESS_CTOG

See Also:

Constant Field Values

PROCESS_DCASS

public static final int PROCESS_DCASS

See Also:

Constant Field Values

PROCESS_DLG_LINETRACE

public static final int PROCESS_DLG_LINETRACE

See Also:

Constant Field Values

PROCESS_DLG_CPS3

public static final int PROCESS_DLG_CPS3

See Also:

Constant Field Values

PROCESS_ELECTRONIC

public static final int PROCESS_ELECTRONIC

See Also:

Constant Field Values

G_REF_GEOGRAPHIC

public static final int G_REF_GEOGRAPHIC

Codes defining the ground reference system for element 5. Values taken from Appendix 2-G.

See Also:

Constant Field Values

G_REF_UTM

public static final int G_REF_UTM

See Also:

Constant Field Values

G_REF_STATEPLANE

public static final int G_REF_STATEPLANE

See Also:

Constant Field Values

INTERVAL_UNIT_RADIANS

public static final int INTERVAL_UNIT_RADIANS

See Also:

Constant Field Values

INTERVAL_UNIT_METERS

public static final int INTERVAL_UNIT_METERS

See Also:

Constant Field Values

INTERVAL_UNIT_FEET

public static final int INTERVAL_UNIT_FEET

See Also:

Constant Field Values

INTERVAL_UNIT_ARCSEC

public static final int INTERVAL_UNIT_ARCSEC

See Also:

Constant Field Values

VALIDATE_NONE

public static final int VALIDATE_NONE

No data validation performed

See Also:

Constant Field Values

VALIDATE_RMSE

public static final int VALIDATE_RMSE

RMSE computed from test points (record C added), no quantitative test, no interactive DEM editing or review.

See Also:

Constant Field Values

VALIDATE_BATCH

public static final int VALIDATE_BATCH

Batch process water body edit and RMSE computed from test points.

See Also:

Constant Field Values

VALIDATE_WATER

public static final int VALIDATE_WATER

Review and edit, including water edit. No RMSE computed from test points.

See Also:

Constant Field Values

VALIDATE_L1_REVIEW

public static final int VALIDATE_L1_REVIEW

Level 1 DEM's reviewed and edited. Includes water body editing. RMSE computed from test points.

See Also:

Constant Field Values

VALIDATE_L2_VERIFIED

public static final int VALIDATE_L2_VERIFIED

Level 2 and 3 DEM's reviewed and edited. Includes water body editing and verification or vertical integration of planimetric categories (other than hypsography or hydrography if authorized). RMSE computed from test points.

See Also:

Constant Field Values

AREA_SUSPECT_NONE

public static final int AREA_SUSPECT_NONE

No suspect or void areas in the data

See Also:

Constant Field Values

AREA_SUSPECT

public static final int AREA_SUSPECT

Suspect areas in the data

See Also:

Constant Field Values

AREA_VOID

public static final int AREA_VOID

Void areas in the data

See Also:

Constant Field Values

AREA_SUSPECT_AND_VOID

public static final int AREA_SUSPECT_AND_VOID

Suspect and void areas in the data

See Also:

Constant Field Values

VERTICAL_DATUM_MSL

public static final int VERTICAL_DATUM_MSL

Local mean sea level vertical datum

See Also:

Constant Field Values

VERTICAL_DATUM_NGVD

public static final int VERTICAL_DATUM_NGVD

National Geodetic Vertical Datum 1929 (NGVD 29) vertical datum

See Also:

Constant Field Values

VERTICAL_DATUM_NAVD

public static final int VERTICAL_DATUM_NAVD

North American Vertical Datum 1988 (NAVD 88)vertical datum

See Also:

Constant Field Values

HORIZONTAL_DATUM_NAD27

public static final int HORIZONTAL_DATUM_NAD27

North American Datum 1927 (NAD 27) horizontal datum

See Also:

Constant Field Values

HORIZONTAL_DATUM_WGS72

public static final int HORIZONTAL_DATUM_WGS72

World Geodetic System 1972 (WGS 72) horizontal datum

See Also:

Constant Field Values

HORIZONTAL_DATUM_WGS84

public static final int HORIZONTAL_DATUM_WGS84

World Geodetic System 1984 (WGS 83) horizontal datum

See Also:

Constant Field Values

HORIZONTAL_DATUM_NAD83

public static final int HORIZONTAL_DATUM_NAD83

North American Datum 1983 (NAD 83) horizontal datum

See Also:

Constant Field Values

HORIZONTAL_DATUM_OLDHAWAII

public static final int HORIZONTAL_DATUM_OLDHAWAII

Old Hawaii Datum horizontal datum

See Also:

Constant Field Values

HORIZONTAL_DATUM_PUERTORICO

public static final int HORIZONTAL_DATUM_PUERTORICO

Puerto Rico Datum horizontal datum

See Also:

Constant Field Values

DEFAULT_PATTERN

public static final int DEFAULT_PATTERN

Default pattern code for element 4

See Also:

Constant Field Values

DEFAULT_POLY_SIDES

public static final int DEFAULT_POLY_SIDES

Default number of sides in the polygon of element 10

See Also:

Constant Field Values

DEFAULT_REF_SYSTEM_ANGLE

public static final float DEFAULT_REF_SYSTEM_ANGLE

Default angle offset between the two reference systems (element 13).

See Also:

Constant Field Values

DEFAULT_DATA_EDITION

public static final int DEFAULT_DATA_EDITION

Default data edition in use. Assumes USGS.

See Also:

Constant Field Values

filename

public java.lang.String filename

Name of the file (element 1). Maximum length of 40 chars.

freeFormatText

public java.lang.String freeFormatText

Some free-format text (element 1). Maximum length of 40 chars.

southEdge

public float[] southEdge

Location of the SE corner, south edge. Northing & easting values represented with separate degrees. minutes & seconds.

eastEdge

public float[] eastEdge

Location of the SE corner, east edge. Northing & easting values represented with separate degrees. minutes & seconds.

processCode

public int processCode

Code indicating the process used to create values (element 1)

sectionIndicator

public java.lang.String sectionIndicator

The section of the area this file represent in 30 & 15 minute DEMs.

originCode

public java.lang.String originCode

Mapping origin code (Element 2). Free-format 4-chars.

levelType

public int levelType

The DEM level used (element 3).

elevationPattern

public boolean elevationPattern

The elevation points are random (false) or regular (true)(element 4)

groundReferenceSystem

public int groundReferenceSystem

Code defining the ground reference system (element 5).

groundZoneSystem

public int groundZoneSystem

Code defining zone in the ground plane reference system (element 6). This code is specific to the projection system used (eg UTM or state plane). Values defined in Appendix 2-E and 2-F.

mapProjectionParams

public float[] mapProjectionParams

Extra map projection parameters used when not using UTM, Geo or State-plane (element 7). If the projection params are not needed, this is null rather than filling it with 15 zeros as per the file format.

groundUnitOfMeasure

public int groundUnitOfMeasure

The type of unit of measure used for X,Y values (element 8).

elevationUnitOfMeasure

public int elevationUnitOfMeasure

The type of unit of measure used for elevation values (element 9).

numPolygonSides

public int numPolygonSides

The number of sides of the polygon that the DEM covers (element 10).

SWCornerCoords

public double[] SWCornerCoords

Coordinates of the south-west corner (element 11).

NWCornerCoords

public double[] NWCornerCoords

Coordinates of the north-west corner (element 11).

NECornerCoords

public double[] NECornerCoords

Coordinates of the north-east corner (element 11).

SECornerCoords

public double[] SECornerCoords

Coordibates if the south-west corner (element 11).

minHeight

public double minHeight

The minimum elevation of the DEM (element 12).

maxHeight

public double maxHeight

The maximum elevation of the DEM (element 12).

referenceOrientation

public double referenceOrientation

Counterclockwise angle in radians from the primary axis of the reference system to the local reference system (element 13).

hasAccuracy

public boolean hasAccuracy

Flag to say if accuracy of the elevation is known (element 14). If false, then no information is known. If true then a DEMTypeCRecord Record C is available to give extra information.

spatialResolution

public float[] spatialResolution

Amount of resolution for each axis (element 15). For X and Y axes, the values are required to be integer values, although that cannot be forced by this record.

numRows

public int numRows

The number of rows of profiles in the DEM (element 16).

numColumns

public int numColumns

The number of rows of profiles in the DEM (element 16).

largestContourInterval

public int largestContourInterval

The largest primary contour interval (element 17). Only set if there are two or more primary intervals (DEM LEvel 2 only)

largestIntervalUnits

public int largestIntervalUnits

The units for the largest interval (element 18).

smallestContourInterval

public int smallestContourInterval

The smallest primary contour interval (element 19). Only set if there are two or more primary intervals (DEM LEvel 2 only)

smallestIntervalUnits

public int smallestIntervalUnits

The units for the smallest interval (element 20).

sourceDate

public int sourceDate

The year the data was created, as an int (element 21).

revisionDate

public int revisionDate

The year the data was last revised or checked (element 22).

inspected

public boolean inspected

True if the level 3 quality control process has been followed (element 23).

dataValidated

public int dataValidated

Flag indicating the type of validate that has been performed on the data (element 24).

suspectAreas

public int suspectAreas

Flag indicating the state of the data (Element 25)

verticalDatum

public int verticalDatum

The veritcal datum in use (element 26)

horizontalDatum

public int horizontalDatum

The horizontal datum in use (element 27)

dataEdition

public int dataEdition

Data edition as specified by the generator (element 28). A value between 1 and 99 inclusive. For USGS use this will be set to 1.

percentageVoid

public int percentageVoid

If element 25 indicates a void, this field contains the percentage of nodes in the file set to void (element 29).

edgeMatching

public int edgeMatching

Edge match status flag (element 30).

verticalDatumShift

public float verticalDatumShift

Vertical datum shift (element 31). Value is the average shift value for the four quadrangle corners obtained from program VERTCON. Always add this value to convert to NAVD88.

Constructor Detail

DEMTypeARecord

public DEMTypeARecord()