Deep Learning Model To Ecd (Image Analyst)

Available with Spatial Analyst license.

Available with Image Analyst license.

Summary

Converts a deep learning model to an Esri classifier definition file (.ecd).

Legacy:

This is a deprecated tool. This functionality has been replaced by the Export Training Data For Deep Learning tool that creates classification information for use in the deep learning model.

This tool adds missing class information to the model. Deep learning binary model files generated by Google TensorFlow, Microsoft CNTK, or similar applications are supported.

To utilize the deep learning .ecd file, the deep learning framework must be installed on your computer. The .ecd output file will only work as input to the Esri Python Classify or Detect adaptor function. The class information JSON file allows you to add useful information to the .ecd file not included in the deep learning binary model such as class names, class colors for rendering the classified output, and other standard information. See the JSON file example below for details.

Usage

  • The following is an example of a Input Esri Extra Info File:

    This is an example of an in_extra_info_json file.

    {  
       "ImportDeepLearningModelToEsriExtraInfo":0,
       "Version":1,
       "Classifier":"CNTK",
       "NumberRasterBands":4,
       "MiniBatchSize":16,
       "Classes":[  
          {  
             "Value":100,
             "Name":"Impervious",
             "Color":[204, 204, 204]
          },
          {  
             "Value":200,
             "Name":" Other (Pervious)",
             "Color":[56, 168, 0]
          }
       ]
    }

Syntax

DeepLearningModelToEcd(in_deep_learning_model, in_classification_info_json, out_classifier_definition)
ParameterExplanationData Type
in_deep_learning_model

The binary model file generated by a deep learning package such as Google TensorFlow, Microsoft CNTK, or similar application.

File
in_classification_info_json

The class information JSON file. See the JSON file example above.

File
out_classifier_definition

The .ecd file that can be used in the Classify function and Classify Raster tool.

The .ecd output file only works as input to the Esri Python Classify or Detect adaptor function.

File

Code sample

DeepLearningModelToEcd example 1 (Python window)

This example creates an .edc file from deep learning.

from arcpy.ia import *

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

DeepLearningModelToEcd("c:/test/cntk.model", "c:/test/classInfo.json",
                       "c:/test/deeplearningtoecd.ecd")
DeepLearningModelToEcd example 2 (stand-alone script)

This example creates an .edc file from deep learning.

# Import system modules and check out ArcGIS Image Analyst extension license
import arcpy
arcpy.CheckOutExtension("ImageAnalyst")
from arcpy.ia import *

# Set local variables
in_deep_learning_model = "c:/test/cntk.model"
in_classification_info_json = "c:/test/classInfo.json"
out_classifier_definition = "c:/test/deeplearningtoecd.ecd"

# Execute 
DeepLearningModelToEcd(in_deep_learning_model, in_classification_info_json, 
                      out_classifier_definition)

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Requires Image Analyst or Spatial Analyst
  • Standard: Requires Image Analyst or Spatial Analyst
  • Advanced: Requires Image Analyst or Spatial Analyst