Label | Explanation | Data 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 change—Each pixel will contain the date of its most recent change in the time series. This is the default.
- Time of earliest change—Each pixel will contain the date of its earliest change in the time series.
- Time of largest change—Each pixel will contain the date of its most significant change in the time series.
- Number of changes—Each pixel will contain the total number of times it changed in the time series.
- Time of longest change—Each pixel will contain the date of change at the beginning or end of the longest transition segment in the time series.
- Time of shortest change—Each pixel will contain the date of change at the beginning or end of the shortest transition segment in the time series.
- Time of fastest change—Each pixel will contain the date of change at the beginning or end of the transition that occurred most quickly.
- Time of slowest change—Each 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 segment—The date at the beginning of a change segment will be extracted. This is the default.
- End of segment—The 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 directions—All change directions will be included in the output. This is the default.
- Increasing—Only change in the positive or increasing direction will be included in the output.
- Decreasing—Only 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_MAGNITUDE—Results will be filtered by magnitude so that only the changes of a given magnitude will be included in the output.
- NO_FILTER_BY_MAGNITUDE—Results 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 |
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})
Name | Explanation | Data 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_CHANGE—Each pixel will contain the date of its most recent change in the time series. This is the default.
- TIME_OF_EARLIEST_CHANGE—Each pixel will contain the date of its earliest change in the time series.
- TIME_OF_LARGEST_CHANGE—Each pixel will contain the date of its most significant change in the time series.
- NUM_OF_CHANGES—Each pixel will contain the total number of times it changed in the time series.
- TIME_OF_LONGEST_CHANGE—Each pixel will contain the date of change at the beginning or end of the longest transition segment in the time series.
- TIME_OF_SHORTEST_CHANGE—Each pixel will contain the date of change at the beginning or end of the shortest transition segment in the time series.
- TIME_OF_FASTEST_CHANGE—Each pixel will contain the date of change at the beginning or end of the transition that occurred most quickly.
- TIME_OF_SLOWEST_CHANGE—Each 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_SEGMENT—The date at the beginning of a change segment will be extracted. This is the default.
- END_OF_SEGMENT—The 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—All change directions will be included in the output. This is the default.
- INCREASE—Only change in the positive or increasing direction will be included in the output.
- DECREASE—Only 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_YEAR—Results will be filtered so that only changes that occurred within a specific range of years will be included in the output.
- NO_FILTER_BY_YEAR—Results 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_DURATION—Results 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_DURATION—Results 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_MAGNITUDE—Results will be filtered by magnitude so that only the changes of a given magnitude will be included in the output.
- NO_FILTER_BY_MAGNITUDE—Results 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_VALUE—Results 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_VALUE—Results 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_VALUE—Results 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_VALUE—Results 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 |
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")