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
  • Method Details

    • 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: