Skip to content

StateDMI / Command / ReadCropPatternTSFromStateCU

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:

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

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 Also