SIC^2: Simulation and Integration of Control for Canals
The PRINT method
This method does not calculate U-commands to apply to some devices, but prints the selected U, Y, YT, and Z variables into a LST text file.
The frequency of writing the selected data into the LST file can be chosen. For example if you choose 10, in this case one writes one time step out of 10.
We can choose to have the data written into a different file than the standard Project_Program_Scenario_Variant_LST files. In this case the name of the file will be REGULPRINTn.LST, where n is an index number in the file name. This is useful in the case we have several PRINT regulators, in order to have separate files. This is also useful when different regulators write different information into the LST file, to have a more readable file.
It is possible finally to choose whether or not to have the headers in the first column U :, Y: YT: or Z:. If you want to import these files into an external software (eg Matlab), it is probably better not to have these headers in order to have only numerical data.
In the LST file, the first column indicates the time T-DT, the second column the time T, and the subsequent columns indicate the requested values. The regulators of the active control module are calculated before the hydraulic calculation. Thus, in general, the values written at the instant T, available in memory, are in fact derived from the hydraulic calculation carried out previously, and therefore corresponding to the time T-DT. In some cases, the results of other controllers of the active control module can be requested in the Z variables. Therefore, if this PRINT regulator is located (in the order of the regulators) before the regulator targeted by the Z of the PRINT, the corresponding value will be that of the instant T-DT, and if not T (because the U will have been calculated just before the PRINT call). For this reason, the 2 times T-DT and T are indicated so that you can use the one you are interested in.
The number of variables that can be written to a PRINT file is limited to 100. If you want more, use multiple PRINT modules.
