StateDMI / Command / ReadCropPatternTSFromStateCU

Overview
Command Editor
Command Syntax
Examples
Troubleshooting
See Also

Overview

The ReadCropPatternTSFromStateCU command (for StateCU) reads crop pattern time series data from a StateCU crop pattern time series file and defines crop patterns in memory. The crop pattern time series can then be manipulated and output with other commands. This command can be used to:

read an existing crop pattern time series file to manipulate the data
read a crop pattern time series file to set the total acreage in the irrigation practice time series file (see the SetIrrigationPracticeTSTotalAcreageToCropPatternTSTotalAcreage command).

Warning: when writing the crop pattern time series, the total acreage and the fractions corresponding to each crop (three digits) are written. The acreage for each crop is also now written but was not included in older versions of files. When reading the file with this command, the default is to read the individual crop acreages and the total and fractions are computed based on the individual crop acreages. Because the fraction is only three digits, crop areas computed from the total and fraction may differ from the raw crop acreages. Consequently, comparing old and new files may result in differences.

Command Editor

The following dialog is used to edit the command and illustrates the command syntax.

ReadCropPatternTSFromStateCU Command Editor (see also the full-size image)

Command Syntax

The command syntax is as follows:

ReadCropPatternTSFromStateCU(Parameter="Value",...)

Command Parameters

Parameter	Description	Default
`InputFile`	The name of the input file to read.	None – must be specified.
`Version`	A StateCU version, to allow backward compatibility with files from an older software version. Refer to StateCU documentation for a description of older file formats.	Use the file format for the most current StateCU version.
`ReadDataFrom`	Indicate how to read crop values, one of: `CropArea` – read the detailed crop acreage values from the file (may not be available in very old files) `TotalAreaAndCropFraction` – read the total area and crop fractions and compute the crop area from this information. Because fractions are only 3 digits, the crop areas will only be accurate to three digits (and may therefore not agree with HydroBase or other input data).	`CropArea`
`Tolerance`	The tolerance used when comparing crop pattern time series and irrigation practice time series total area.	`1.0`

Examples

See the automated tests.

Troubleshooting

See the main troubleshooting documentation