Detect Change Using Change Analysis Raster (Image Analyst)

Available with Image Analyst license.

Summary

Generates a raster containing pixel change information using the output change analysis raster from the Analyze Changes Using CCDC tool or the Analyze Changes Using LandTrendr tool.

Usage

  • This tool uses a change analysis raster generated from the Analyze Changes Using CCDC tool or the Analyze Changes Using LandTrendr tool to generate a raster containing point of change information.

    Change analysis rasters contain model information about how each pixel has changed over time. This tool analyzes that information.

  • The Change Type parameter indicates the information that will be generated. Information is extracted from the change analysis raster.

    When running this tool on the output from the Analyze Changes Using CCDC tool, you can choose from the following options:

    • Time of latest change—The most recent date and time at which a pixel was flagged as being changed.
    • Time of earliest change—The earliest date and time at which a pixel was flagged as being changed.
    • Time of largest change—The date and time at which the calculated change was the most significant for a pixel.
    • Number of changes—The total number of times the pixel changed.

    For more information, see How Analyze Changes Using CCDC works.

    When running this tool on the output from the Analyze Changes Using LandTrendr tool, the following additional options are available:

    • Time of longest change—The date at which a pixel was flagged as being changed, at the beginning or end of the longest period of change.
    • Time of shortest change—The date at which a pixel was flagged as being changed, at the beginning or end of the shortest period of change.
    • Time of fastest change—The date at which a pixel was flagged as being changed, at the beginning or end of the fastest period of change.
    • Time of slowest change—The date at which a pixel was flagged as being changed, at the beginning or end of the slowest period of change.
    • Filter by Start Value—Filter results by start value so that only the changes of a given start value are included in the output.
    • Filter by End Value—Filter results by end value so that only the changes of a given end value are included in the output.

  • The Filter by Start Value and Filter by End Value parameters use the fitted values of surface reflectance from the change analysis raster containing the model coefficients. The fitted values indicate when change has occurred by a break in the fitted value line segment when plotted in a temporal profile chart.

    For more information, see How Analyze Changes Using LandTrendr works.

  • The output is a multiband raster in which each band contains change information depending on the change type selected and the maximum number of changes specified. For example, if the Change Type parameter is set to Time of earliest change and the Maximum Number of Changes parameter is set to 2, the tool calculates the two earliest dates when change occurred throughout the time series for every pixel. The result is a raster in which the first band contains the dates of the earliest change per pixel, and the second band contains the dates of the second-earliest change per pixel.

  • When running this tool on the output from the Analyze Changes Using LandTrendr tool, you can extract the date that marks the beginning of a change or the end of a change using the Segment Date parameter. For example, to understand how the most recent change in the time series started, set the Change Type parameter to Time of latest change and the Segment Date parameter to Beginning of segment.

  • Use the following filtering parameters to extract more specific dates of change from the change analysis raster:

    • Filter by year—Identify changes that occurred within a specific time period, for example, changes that occurred in a landscape during five years of drought.
    • Filter by duration—Identify changes that occurred over a given range of years, for example, abrupt changes that took place over one or twp years. You can calculate the duration using the formula end year - start year +1. Gaps in the time series will be included.
    • Filter by magnitude—Identify changes of a given magnitude, for example, large changes in the vegetation index NDVI. Magnitude is an absolute value, so the minimum and maximum values cannot be negative. To specify directional change, use the Change Direction parameter.

Parameters

LabelExplanationData Type
Input Change Analysis Raster

The change analysis raster generated from the Analyze Changes Using CCDCtool or the Analyze Changes Using LandTrendr tool.

Raster Dataset; Raster Layer; Image Service
Change Type
(Optional)

Specifies the change information that will be calculated for each pixel.

  • Time of latest changeEach pixel will contain the date of its most recent change in the time series. This is the default.
  • Time of earliest changeEach pixel will contain the date of its earliest change in the time series.
  • Time of largest changeEach pixel will contain the date of its most significant change in the time series.
  • Number of changesEach pixel will contain the total number of times it changed in the time series.
  • Time of longest changeEach pixel will contain the date of change at the beginning or end of the longest transition segment in the time series.
  • Time of shortest changeEach pixel will contain the date of change at the beginning or end of the shortest transition segment in the time series.
  • Time of fastest changeEach pixel will contain the date of change at the beginning or end of the transition that occurred most quickly.
  • Time of slowest changeEach pixel will contain the date of change at the beginning or end of the transition that occurred most slowly.
String
Maximum Number of Changes
(Optional)

The maximum number of changes per pixel that will be calculated. This number corresponds to the number of bands in the output raster. The default is 1, meaning only one change date will be calculated, and the output raster will contain only one band.

This parameter is not active when the Change Type parameter is set to Number of changes.

Long
Segment Date
(Optional)

Specifies whether the date at the beginning of a change segment will be extracted or at the end.

This parameter is available only when the input change analysis raster is the output from the Analyze Changes Using LandTrendr tool.

  • Beginning of segmentThe date at the beginning of a change segment will be extracted. This is the default.
  • End of segmentThe date at the end of a change segment will be extracted.
String
Change Direction
(Optional)

Specifies the direction of change that will be included in the analysis.

This parameter is available only when the input change analysis raster is the output from the Analyze Changes Using LandTrendr tool.

  • All directionsAll change directions will be included in the output. This is the default.
  • IncreasingOnly change in the positive or increasing direction will be included in the output.
  • DecreasingOnly change in the negative or decreasing direction will be included in the output.
String
Filter by Year
(Optional)

Specifies whether the output will be filtered by a range of years.

  • Checked—Results will be filtered so that only changes that occurred within a specific range of years will be included in the output.
  • Unchecked—Results will not be filtered by year. This is the default.

Boolean
Minimum Value
(Optional)

The earliest year that will be used to filter results. This parameter is required if the Filter by Year parameter is checked.

Long
Maximum Value
(Optional)

The latest year that will be used to filter results.

This parameter is required if the Filter by Year parameter is checked.

Long
Filter by Duration
(Optional)

Specifies whether results will be filtered by the change duration.

This parameter is active only when the input change analysis raster is the output from the Analyze Changes Using LandTrendr tool.

  • Checked—Results will be filtered by duration so that only the changes that lasted a given amount of time will be included in the output.
  • Unchecked—Results will not be filtered by duration. This is the default.

Boolean
Minimum Duration (in years)
(Optional)

The minimum number of consecutive years that will be included in the results.

This parameter is required if the Filter by Duration parameter is checked.

Double
Maximum Duration (in years)
(Optional)

The maximum number of consecutive years that will be included in the results.

This parameter is required if the Filter by Duration parameter is checked.

Double
Filter by Magnitude
(Optional)

Specifies whether results will be filtered by change magnitude.

  • Checked—Results will be filtered by magnitude so that only the changes of a given magnitude will be included in the output.
  • Unchecked—Results will not be filtered by magnitude. This is the default.

Specifies whether results will be filtered by change magnitude.

  • FILTER_BY_MAGNITUDEResults will be filtered by magnitude so that only the changes of a given magnitude will be included in the output.
  • NO_FILTER_BY_MAGNITUDEResults will not be filtered by magnitude. This is the default.
Boolean
Minimum Magnitude
(Optional)

The minimum magnitude that will be included in the results.

This parameter is required if the Filter by Magnitude parameter is checked.

Double
Maximum Magnitude
(Optional)

The maximum magnitude that will be included in the results.

This parameter is required if the Filter by Duration parameter is checked.

Double
Filter by Start Value
(Optional)

Specifies whether results will be filtered by start value.

This parameter is active only when the input change analysis raster is the output from the Analyze Changes Using LandTrendr tool.

  • Checked—Results will be filtered by start value so that only the changes of a given start value will be included in the output.
  • Unchecked—Results will not be filtered by start value. This is the default.

Boolean
Minimum Start Value
(Optional)

The minimum start value that will be included in the results.

This parameter is required if the Filter by Start Value parameter is checked.

Double
Maximum Start Value
(Optional)

The maximum start value that will be included in the results.

This parameter is required if the Filter by Start Value parameter is checked.

Double
Filter by End Value
(Optional)

Specifies whether results will be filtered by end value.

This parameter is active only when the input change analysis raster is the output from the Analyze Changes Using LandTrendr tool.

  • Checked—Results will be filtered by end value so that only the changes of a given end value will be included in the output.
  • Unchecked—Results will not be filtered by end value. This is the default.

Boolean
Minimum End Value
(Optional)

The minimum end value that will be included in the results.

This parameter is required if the Filter by End Value parameter is checked.

Double
Maximum End Value
(Optional)

The maximum end value that will be included in the results.

This parameter is required if the Filter by End Value parameter is checked.

Double

Return Value

LabelExplanationData Type
Output Raster

The output raster containing the detected change information.

Raster

DetectChangeUsingChangeAnalysisRaster(in_change_analysis_raster, {change_type}, {max_number_changes}, {segment_date}, {change_direction}, {filter_by_year}, {min_year}, {max_year}, {filter_by_duration}, {min_duration}, {max_duration}, {filter_by_magnitude}, {min_magnitude}, {max_magnitude}, {filter_by_start_value}, {min_start_value}, {max_start_value}, {filter_by_end_value}, {min_end_value}, {max_end_value})
NameExplanationData Type
in_change_analysis_raster

The change analysis raster generated from the Analyze Changes Using CCDCtool or the Analyze Changes Using LandTrendr tool.

Raster Dataset; Raster Layer; Image Service
change_type
(Optional)

Specifies the change information that will be calculated for each pixel.

  • TIME_OF_LATEST_CHANGEEach pixel will contain the date of its most recent change in the time series. This is the default.
  • TIME_OF_EARLIEST_CHANGEEach pixel will contain the date of its earliest change in the time series.
  • TIME_OF_LARGEST_CHANGEEach pixel will contain the date of its most significant change in the time series.
  • NUM_OF_CHANGESEach pixel will contain the total number of times it changed in the time series.
  • TIME_OF_LONGEST_CHANGEEach pixel will contain the date of change at the beginning or end of the longest transition segment in the time series.
  • TIME_OF_SHORTEST_CHANGEEach pixel will contain the date of change at the beginning or end of the shortest transition segment in the time series.
  • TIME_OF_FASTEST_CHANGEEach pixel will contain the date of change at the beginning or end of the transition that occurred most quickly.
  • TIME_OF_SLOWEST_CHANGEEach pixel will contain the date of change at the beginning or end of the transition that occurred most slowly.
String
max_number_changes
(Optional)

The maximum number of changes per pixel that will be calculated. This number corresponds to the number of bands in the output raster. The default is 1, meaning only one change date will be calculated, and the output raster will contain only one band.

This parameter is not enabled when the change_type parameter is set to NUM_OF_CHANGES.

Long
segment_date
(Optional)

Specifies whether the date at the beginning of a change segment will be extracted or at the end.

This parameter is available only when the input change analysis raster is the output from the Analyze Changes Using LandTrendr tool.

  • BEGINNING_OF_SEGMENTThe date at the beginning of a change segment will be extracted. This is the default.
  • END_OF_SEGMENTThe date at the end of a change segment will be extracted.
String
change_direction
(Optional)

Specifies the direction of change that will be included in the analysis.

This parameter is available only when the input change analysis raster is the output from the Analyze Changes Using LandTrendr tool.

  • ALLAll change directions will be included in the output. This is the default.
  • INCREASEOnly change in the positive or increasing direction will be included in the output.
  • DECREASEOnly change in the negative or decreasing direction will be included in the output.
String
filter_by_year
(Optional)

Specifies whether the output will be filtered by a range of years.

  • FILTER_BY_YEARResults will be filtered so that only changes that occurred within a specific range of years will be included in the output.
  • NO_FILTER_BY_YEARResults will not be filtered by year. This is the default.
Boolean
min_year
(Optional)

The earliest year that will be used to filter results. This parameter is required if the filter_by_year parameter is set to FILTER_BY_YEAR.

Long
max_year
(Optional)

The latest year that will be used to filter results.

This parameter is required if the filter_by_year parameter is set to FILTER_BY_YEAR.

Long
filter_by_duration
(Optional)

Specifies whether results will be filtered by the change duration.

This parameter is enabled only when the input change analysis raster is the output from the Analyze Changes Using LandTrendr tool.

  • FILTER_BY_DURATIONResults will be filtered by duration so that only the changes that lasted a given amount of time will be included in the output.
  • NO_FILTER_BY_DURATIONResults will not be filtered by duration. This is the default.
Boolean
min_duration
(Optional)

The minimum number of consecutive years that will be included in the results.

This parameter is required if the filter_by_duration parameter is set to FILTER_BY_DURATION.

Double
max_duration
(Optional)

The maximum number of consecutive years that will be included in the results.

This parameter is required if the filter_by_duration parameter is set to FILTER_BY_DURATION.

Double
filter_by_magnitude
(Optional)

Specifies whether results will be filtered by change magnitude.

  • Checked—Results will be filtered by magnitude so that only the changes of a given magnitude will be included in the output.
  • Unchecked—Results will not be filtered by magnitude. This is the default.

Specifies whether results will be filtered by change magnitude.

  • FILTER_BY_MAGNITUDEResults will be filtered by magnitude so that only the changes of a given magnitude will be included in the output.
  • NO_FILTER_BY_MAGNITUDEResults will not be filtered by magnitude. This is the default.
Boolean
min_magnitude
(Optional)

The minimum magnitude that will be included in the results.

This parameter is required if the filter_by_magnitude parameter is set to FILTER_BY_MAGNITUDE.

Double
max_magnitude
(Optional)

The maximum magnitude that will be included in the results.

This parameter is required if the filter_by_magnitude parameter is set to FILTER_BY_MAGNITUDE.

Double
filter_by_start_value
(Optional)

Specifies whether results will be filtered by start value.

This parameter is enabled only when the input change analysis raster is the output from the Analyze Changes Using LandTrendr tool.

  • FILTER_BY_START_VALUEResults will be filtered by start value so that only the changes of a given start value will be included in the output.
  • NO_FILTER_BY_START_VALUEResults will not be filtered by start value. This is the default.
Boolean
min_start_value
(Optional)

The minimum start value that will be included in the results.

This parameter is required if the filter_by_start_value parameter is set to FILTER_BY_START_VALUE.

Double
max_start_value
(Optional)

The maximum start value that will be included in the results.

This parameter is required if the filter_by_start_value parameter is set to FILTER_BY_START_VALUE.

Double
filter_by_end_value
(Optional)

Specifies whether results will be filtered by end value.

This parameter is enabled only when the input change analysis raster is the output from the Analyze Changes Using LandTrendr tool.

  • FILTER_BY_END_VALUEResults will be filtered by end value so that only the changes of a given end value will be included in the output.
  • NO_FILTER_BY_END_VALUEResults will not be filtered by end value. This is the default.
Boolean
min_end_value
(Optional)

The minimum end value that will be included in the results.

This parameter is required if the filter_by_end_value parameter is set to FILTER_BY_END_VALUE.

Double
max_end_value
(Optional)

The maximum end value that will be included in the results.

This parameter is required if the filter_by_end_value parameter is set to FILTER_BY_END_VALUE.

Double

Return Value

NameExplanationData Type
out_raster

The output raster containing the detected change information.

Raster

Code sample

DetectChangeUsingChangeAnalysisRaster example 1 (Python window)

This example returns the end date of the longest period of NDVI recovery (increasing values) in which the change was a magnitude between 0.25 and 2.

# Import system modules
import arcpy
from arcpy.ia import *

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

# Execute
dateOfLatestChange = arcpy.ia.DetectChangeUsingChangeAnalysis(
	"Monthly_NDVI_Change_Analysis.crf", "TIME_OF_LATEST_CHANGE", 1)

# Save output
dateOfLatestChange.save(r"C:\data\NDVI_LatestChanges.crf")
DetectChangeUsingChangeAnalysisRaster example 2 (stand-alone script)

This example returns the total number of times the pixels changed in a Landsat time series.

# Import system modules
import arcpy
from arcpy.ia import *

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

# Define input parameters
in_change_analysis = r"C:\data\Landsat_ChangeAnalysis.crf"
change_type = "NUM_OF_CHANGES"

# Execute
number_of_changes = arcpy.ia.DetectChangeUsingChangeAnalysis(
	in_change_analysis, change_type)

# Save output
number_of_changes.save("C:/data/NumberOfChanges_Landsat.crf")