AgCreateAndRasterizeCropLocationGrid Task

This task estimates the crop count from a raster and a grid derived from three input points, and it creates a classification raster with their locations. See the Create Crop Location Grid topic for more information on how this tool works.

This task requires a separate license for the ENVI Crop Science Module; contact your sales representative for more information.

Example

; Start the application

e = ENVI()

; Open an input file

File = Filepath('CitrusOrthophoto.dat', $

Subdir=['data','crop_science'], $

Root_Dir=e.Root_Dir)

Raster = e.OpenRaster(File)

; Define a spatial subset that encompasses

; the crops of interest while removing the edges

Subset = ENVISubsetRaster(Raster, SUB_RECT=[12,17,653,626])

; Get the task from the catalog of ENVITasks

Task = ENVITask('AgCreateAndRasterizeCropLocationGrid')

; Define inputs

Task.INPUT_RASTER = Subset

Task.POINT1 = [202.8, 613.4]

Task.POINT2 = [19.4, 611.3]

Task.POINT3 = [20.0, 306.4]

Task.SPACE1 = 12

Task.SPACE2 = 12

; Run the task

Task.Execute

; Display the result

View = e.GetView()

Layer = View.CreateLayer(Subset)

Layer2 = View.CreateLayer(Task.OUTPUT_RASTER)

Syntax

Result = ENVITask('AgCreateAndRasterizeCropLocationGrid')

Input parameters (Set, Get): CROP_DIAMETER, FIELD_ROI, FILLED, INPUT_RASTER, OUTPUT_CROPS_URI, OUTPUT_RASTER_URI, POINT1, POINT2, POINT3, SPACE1, SPACE2

Output parameters (Get only): OUTPUT_CROPS, OUTPUT_NCROPS, OUTPUT_RASTER

Parameters marked as "Set" are those that you can set to specific values. You can also retrieve their current values any time. Parameters marked as "Get" are those whose values you can retrieve but not set.

Input Parameters

CROP_DIAMETER (optional)

Specify the diameter of each crop in meters (or pixels if the input raster is not georeferenced).

FIELD_ROI (optional)

Specify an ENVIROI that outlines a field of crops.

FILLED (optional)

Set this parameter to true to create filled circles in the output crops classification raster.

INPUT_RASTER (required)

Specify an input raster.

OUTPUT_CROPS_URI (optional)

Specify a string with the fully-qualified path and filename for OUTPUT_CROPS.

OUTPUT_RASTER_URI (optional)

Specify a string with the fully qualified filename and path of the associated OUTPUT_RASTER.

If you do not specify this parameter, or set it to an exclamation symbol (!), ENVI creates a temporary file.
If you set it to the hash symbol (#), ENVI creates a file in the temporary directory, but this file will not be deleted when ENVI closes.

POINT1 (required)

Specify an array with the x and y file locations for the center of a crop. This point should be in a vertical or horizontal position relative to point 2.

POINT2 (required)

Specify an array with the x and y file locations for the center of a crop. This is the connecting point between points 1 and 3.

POINT3 (required)

Specify an array with the x and y file locations for the center of a crop. This point should be in a vertical or horizontal position relative to point 2.