Raster Function Editor

The Function Editor is a visual programming language for building imagery and raster analysis workflows. An analysis workflow can be saved as a raster function template (RFT) that can be used to automate processes or for rendering. You create and modify RFTs in the Function Editor pane. The Function Editor represents a function chain as a diagram that chains together function sequences using the output of one or more functions as the input to another function.

You can use various techniques to model a process that results in an RFT. For example, you can open the Function Editor pane and insert a raster variable and any functions. In this mode, no input data is connected to the chain so certain capabilities, such as previewing the result of a section of the processing chain, are disabled. Once data is connected to the processing chain, you can preview the results. You can save the raster function chain (now the RFT) and share and run it with different input datasets.

You can apply a raster function on a raster layer in the map using the Raster Functions pane, which creates a temporary raster layer in the map. You can also apply additional raster functions on the output layer. When you are finished applying functions, right-click the final output and click Save Function Chain or Edit Function Chain. The layer with the final function applied to it contains all of the previous functions with their parameter settings. Saving a layer's function chain removes the original input data and inserts raster variables that can be made public so the template can be used again with different data.

Note:

The function or raster function chain must have a final and single output to be valid.

Capabilities

You can do the following using the Function Editor pane:

  • Visualize a workflow sequence as a diagram.
  • Build an RFT by adding raster functions, raster variables, scalars, raster layers, datasets, and other data types to the diagram and connecting them to perform an analysis. The analysis can be performed on the current display extent or in a distributed manner using raster analysis on Portal for ArcGIS.
  • Iteratively check parameters on a function raster layer's function chain. To interact with the display and the settings in the function chain, right-click the function raster layer in the Contents pane and click Edit Function Chain. When you make changes to parameters, click the Apply button Apply on the Function Editor toolbar to refresh the layer to reflect the changes.
  • Save a function raster layer's function chain as an RFT.
  • Make an RFT usable to others by renaming functions, raster variables, and function variables.

Tools in the Function Editor

The Function Editor provides a set of tools available on the toolbar at the top of the Function Editor window.

Tools in the Function Editor

IconNameDescription
PanPan

Move around the diagram.

Fixed Zoom InFixed Zoom In

Zoom in by a fixed factor.

Fixed Zoom OutFixed Zoom Out

Zoom out by a fixed factor.

Auto LayoutAuto Layout

Automatically arrange the elements in the diagram.

Fit To WindowFit to Window

Fit the entire diagram within the visible view of the window.

ScriptInsert Python Raster Function

Insert a Python raster function by importing a script file (.py).

Add RasterAdd Raster

Add an input raster dataset to the diagram.

VariableAdd Constant

Add an input constant value representing a constant raster.

Add Raster VariableAdd Raster Variable

Add a raster variable, which is a default value that can be changed.

DeleteDelete

Delete the selected elements in the diagram.

SaveSave

Save the raster function template to the Project category or Custom category section of the Raster Functions pane.

Save EditsSave As

Save the raster function template with a new name and location.

PropertiesEdit Properties

Edit the properties of the current raster function template.

Raster FunctionsRaster Functions

Open the Raster Functions pane.

RFT example

The RFT below demonstrates a methodology for describing burn severity and the health of vegetation recovery using prefire and postfire imagery.

RFT example

This example RFT is composed of the following raster functions:

  • Apparent Reflectance—Express the input imagery as albedo, which is the percentage of the available energy reflected by the planetary surface. It is commonly used by scientific users for complex modeling and technical remote sensing applications.
  • Band Arithmetic—Perform a normalized burn ratio (NBR) index for prefire and postfire data from the output of albedo data.
  • Minus—Create the change (or delta) in the NBR from the prefire NBR and postfire NBR.
  • Remap—Define class break values for severity and vegetation health from the difference of the NBR.
  • Attribute Table—Assign attributes and colors to the integer values created from each class defined in the Remap function.

Access the Function Editor

To build an RFT using the Function Editor, open a new editor window. Click the Function Editor button Function Editor in the Raster group on the Analysis tab. Then select and drag raster functions from the Raster Functions pane into the Function Editor pane.