j3d.org Code

org.j3d.loaders.dem
Class DEMTypeARecord

java.lang.Object
  extended by org.j3d.loaders.dem.DEMRecord
      extended by 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()
           
 
Method Summary
 
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()

j3d.org Code

Latest Info from http://code.j3d.org/
Copyright © 2001 - j3d.org