com.luciad.formats.dted

Class DtedModelDecoder

java.lang.Object

com.luciad.formats.dted.DtedModelDecoder

public final class DtedModelDecoder
extends Object

This class can be used to create an IRasterModel implementation that can read DTED (Digital Terrain Elevation Data).

See DtedModelDecoder#decode for more details.

Since:

2023.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DtedModelDecoder.Options Options for decoding DTED.

Method Summary

Modifier and Type	Method and Description
static IRasterModel	decode(String source) This method decodes:
static IRasterModel	decode(String source, DtedModelDecoder.Options options) This method decodes:

Methods inherited from class java.lang.Object

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

Method Detail

decode

@NotNull
public static IRasterModel decode(@NotNull
                                           String source,
                                           @NotNull
                                           DtedModelDecoder.Options options)
                                    throws IOException

This method decodes:

• individual DTED (Digital Terrain Elevation Data) files.
• directories containing DTED files.
• DMED (Digital Mean Elevation Data) files and any available corresponding DTED files.

Input files

When decoding individual DTED files:

File	Entry point	Description
*.dt[012]	x	DTED file corresponding to a single cell of 1 degree by 1 degree.

When decoding directories containing DTED files:

File	Entry point	Description
dted/[we]???/[sn]??.dt[012]	x	DTED directory containing DTED files.

When decoding DMED files and any available corresponding DTED files.

File	Entry point	Description
dmed	x	DMED file referring to DTED files.
dted/[we]???/[sn]??.dt[012]	x	DTED directory containing DTED files.

Model reference

• All models returned by this model decoder have a geodetic reference system.
• The geodetic datum of this reference is WGS72 or WGS84.

Supported versions and specifications

MIL-D-89020B, Digital Terrain Elevation Data (DTED), NIMA, 23 May 2000

Limitations

• The geoid datum EGM96 is not currently supported. When visualized, elevation data are interpreted as ellipsoidal heights.
• DMED files are only used to retrieve the MBR (minimum bounding rectangle) encompassing the DTED cells contained in the DTED directory. No DMED raster is produced by decoding DMED files.

Example usage:

    var source = "Alps/dted/e008/n43.dt0";
    try {
      IRasterModel model = DtedModelDecoder.decode(source);

      // ...

    } catch (IOException exception) {
      Log.w("DTED", "Failed to decode source '" + source + "': " + exception.getMessage());
    }

Parameters:

source - The absolute path to the file or directory.

options - Options for decoding DTED.

Returns:

the decoded model for the source.

Throws:

IOException - when decoding the source file fails.

decode

@NotNull
public static IRasterModel decode(@NotNull
                                           String source)
                                    throws IOException

This method decodes:

• individual DTED (Digital Terrain Elevation Data) files.
• directories containing DTED files.
• DMED (Digital Mean Elevation Data) files and any available corresponding DTED files.

Parameters:

source - The absolute path to the file or directory.

Returns:

the decoded model for the source.

Throws:

IOException - when decoding the source file fails.

See Also:

decode(const std#string&, const Options&)