SIC2 5.29

Simulation and Integration of Control for Canals (or Channels)

French translation: 

FAQ: Frequently Asked Questions

Field of interest: Open Channel Hydraulics

Specific application: Irrigation – Rivers - Water Management – Automatic control of open channels

General Overview:

Function: Simulation of the hydraulic behaviour of irrigation canals and rivers. Simulation of their control (manual or automatic)

Hardware: Micro-computer

Operating System: Windows 98 or higher (NT, 2000, XP, Vista, 7)

Memory: 2 GB minimum, 4 GB better - Hard disk: 400 MB minimum

Distribution: 1 USB key or CD ROM or web downloading

Plotter: Yes (AutoCad format for some outputs in steady flow calculations for version 4)

Time step: From 0.01 to 999.99 minutes (Default value: 10 minutes)

Language: English, French (and Spanish for interfaces but not for documentation)

Friendly user: Yes (menus, on-line help, graphical editor...)

Documentation:

  • Mainly CHM (compiled HTML) files and some HLP files
  • Adobe PDF files for equations of the theoretical guide

Protection: Electronic Dongle for the Topographical Unit only (Actikey dongle on the parallel port or USB port)

Programming Language: FORTRAN 90 and 2003 for computation, Windev for interfaces

Units: International System units. Some extensions with other units (Imperial, Australian)

Description of the model functions:

The SIC2 (Simulation and Integration of Control for Canals) software is a mathematical model which can simulate the hydraulic behaviour of most of the irrigation canals or rivers, under steady and unsteady flow conditions. This name has been given to the version 5 of the SIC software, emphasizing the fact that automatic control is a major component of this software, and that not only irrigation canals are concerned but also rivers, sewage systems, etc. The main purposes of the model are:

1) To provide a research tool to gain an in-depth knowledge of the hydraulic behaviour of the main and secondary canals of an irrigation open-surface network, or of rivers.

2) To identify, through the model, appropriate operational practices at regulating structures with a view to improving the present canal or river operations.

3) To evaluate the influence of possible modifications to some design parameters with a view to improving and maintaining the capacity of the canal or river to satisfy the discharge and water elevation targets.

4) To test automatic operational procedures and evaluate their efficiency (Such procedures will have to be selected among existing algorithms or written by advanced model users in Fortran, Scilab, WDLanguage or MatLab language).

Steady flow and unsteady flow computations can be performed on any type of hydraulic networks (linear, looped or branched). Any reach can be composed of a minor, a medium and a major bed. Storage pools can also be modelled. Only subcritical flows can be modelled in unsteady flow, except at cross devices (gates, weirs). A simplified modelling option allows local supercritical flows in the reaches but should be used carefully. Supercritical flows can be handled in steady flow calculations. In this case the precise supercritical backwater curve is not calculated but the critical depth is indicated instead, which is an upper bound for the real supercritical backwater curve. For precise calculation of supercritical flows and hydraulic jumps in steady flow and simple geometry you should use another software from Irstea: Canal9.

The model is built around three main computer programs (TALWEG, FLUVIA and SIRENE) that respectively carry out the topography and geometry generation, the steady flow computation and the unsteady flow computation.

The SIC2 model is therefore divided into three main units that can be run independently or in sequence.

Unit I is used to create the topography and geometry files to be further used by the computational programs of Unit II and III. Unit I allows to input and verify data obtained from a topographical survey of the canal or from design documents.

Unit II is used to carry out steady flow computations. It allows analyzing the water profile for any combination of discharges or settings at offtakes and cross structures. Unit II allows also to compute the required settings at offtakes and adjustable cross structures in order to satisfy a given distribution plan and maintaining full supply depth targets upstream of cross structures.

Unit III is used to carry out unsteady flow computations. It allows to test various distribution plans at offtakes, and operations of main sluices and cross structures (manual or automatic). Starting from an initial steady flow regime, it will be possible to select the best way to achieve a new distribution plan among several options. The efficiency of the operations can be assessed through several indicators computed at offtakes.

The SIC2 model is an efficient tool allowing canal managers, engineers and researchers to quickly simulate a large number of hydraulic conditions at the design or management level. The software is menu driven in order to facilitate its use. On line help is available at any moment.

Latest released version Series 5: Version 5.29d, 29 May 2013 (validated)

Latest released version Series 4: Version 4.32c, 28 April 2011 (validated)

Previous 5.* versions:

Check our web site for information on versions above 5.24a, or the readme.txt file provided with SIC

Version 5.24a, 01 February 2012 (validated)

Version 5.23a, 16 January 2012 (validated)

Version 5.22d, 24 October 2011 (validated)

Version 5.22c, 25 July 2011 (validated)

Version 5.22b, 21 July 2011 (validated)

Version 5.22a, 6 July 2011 (validated)

Version 5.21f, 5 July 2011 (validated)

Version 5.21e, 9 June 2011 (validated)

Version 5.21d, 26 April 2011 (partially validated)

Version 5.21c, 16 February 2011 (partially validated)

Version 5.21b, 14 February 2011 (partially validated)

Version 5.21a, 08 February 2011 (partially validated)

Version 5.20i, 10 December 2010 (partially validated)

Version 5.20h, 10 November 2010 (partially validated)

Version 5.20a, 28 July 2010 (partially validated)

Version 5.12j, 11 June 2010 (partially validated)

Version 5.12i, 19 May 2010 (partially validated)

Version 5.12h, 11 March 2010 (partially validated)

Version 5.12g, 04 March 2010 (partially validated)

Version 5.12f, 10 February 2010 (partially validated)

Version 5.12e, 05 February 2010 (partially validated)

Version 5.12d, 22 January 2010 (partially validated)

Version 5.12c, 18 January 2010 (partially validated)

Version 5.12b, 15 January 2010 (partially validated)

Version 5.11m, 04 January 2010 (partially validated)

Version 5.08i, 26 June 2009 (validated)

Version 5.08h, 29 May 2009 (validated)

Version 5.08c, 23 March 2009 (validated)

Version 5.08b, 2 March 2009 (validated)

Version 5.08a, 27 January 2009 (beta test)

Version 5.07b, 21 January 2009 (beta test)

Version 5.07a, 15 January 2009 (beta test)

Version 5.06c, 19 December 2008 (beta test)

Previous 4.* versions:

Version 4.33a, 19 August 2010 (validated) (under Linux, and Palm, not released outside Cemagref=

Version 4.32c, 28 April 2011 (validated)

Version 4.32b, 22 March 2010 (validated)

Version 4.32a, 25 September 2009 (validated)

Version 4.31b, 7 September 2009 (validated)

Version 4.31a, 19 June 2009 (validated)

Version 4.30e, 23 March 2009 (validated)

Version 4.30d, 8 January 2009 (validated)

Version 4.30c, 17 December 2008 (validated)

Version 4.30b, 8 October 2008 (validated)

FAQ: Canari web site at www.canari.free.fr

See "Known limitations" and "Detected bugs" at the end of this file.

See http://sic.g-eau.net/mantis/ for bug fixes and versions descriptions

See http://sic.g-eau.net for documentation and other resources

On going developments (for versions 5):

- Edital, Ediflu, Edisir, Edireg, Edised: completely new input interfaces with many new functions and improvements.

- Restal, Resflu, Resir: completely new output interfaces with many new functions and improvements.

- Ediflu, Fluvia, Resflu, Edisir, Resir, Sirene: programming of Begmann gates, Baffle Modules and Mixte gates.

- Ouvrage (Fluvia, Sirene): programming of devices equations in Matlab or Scilab routines (DDE link), open Fortran interface, or Windev language so that users can program their own routines if wanted (such as for regulation modules).

- Sirene: improvement of the SCADA and DIGEST regulation modules with new features (automatic adjustment on field data, multiple SCADA modules in parallel, etc.). Project to offer a standard OPC interface to SCADA systems.

- Sirene: supercritical calculation.

- Sirene: development of a quality modelling module (transport-diffusion equation).

- Sirene: OpenMI interface.

- Sediment transport (Fluvia, Sirene): improvement of the modules.

- All Fortran programs: optional compilation of all Fortran programs in simple or double precision. By default we compile all Fortran programs in simple precision. We can also, if you wish, compile your version in double precision. We validated both versions on the same data sets, though our classical quality approach procedure. There is no significant difference between the two versions, which proves the quality and the robustness of the numerical algorithms used in SIC.

For versions above 5.21 see http://sic.g-eau.net/mantis/ for description of changes

5.21 (Beta Test):

- Many corrections of bugs

- Management of ponds at nodes

5.20 (Beta Test):

- Unsteady flow integrated in the new Edisic interface

5.12 (Beta Test):

- Known bugs :

* bug when exporting the longitudinal graph picture (right click). Soft freezed. Impossible to exit without killing the process: this means you will loose your data if not saved.

- Sic: possible to select old versions 4 for Edital, Talweg, Fluvia and Sirene (risky, limited to advanced users). this is available in the option menu/version for exe and dll

- Correction of bugs in Edisic (no more lost of scenario data when cancelling in geometry mode on a reach)

- New algorithm for devices in "Regulation mode" (steady flow calculation), more robust to non-monotony cases

- New Edital interface version 5.08

- Upgrade towards Windev 15 for all programs and libraries (>=5.12h)

- Correction of a bug for not handling non monotonous equations at devices

- In blind mode (without interface), if the .MAC macro file does not exist, the program asks to switch into Macro mode (recording a macro) or otherwise it switches into Normal mode (with normal interfaces)

- Update of the Ithea driver for USB dongle (1.1.6.4 to 1.1.7.2). You have to re-install this new driver using the setup_ithea.exe driver installation program. Otherwise the dongle will not be detected. This drivers works for Windows 2000, XP, Vista and 7.

- Management of the .par file for parametered variables "X*="

- Management of "Options" ("Variantes" in French) inside "Scenarios"

- Calculation of time delays (pure delay and average delay) for any canal section

- Calculation of volumes in reaches

- Results are included into the new interface (Water levels, Discharges, Volumes). More detailed results are still to be seen with Resflu program

- Correction of interface bugs (copy/paste for devices, etc)

- Correction of bug for the small space step

- Correction of bugs for Mixte gates calculation

- Change of the .SIR format to manage high discharge and long abscissa modes

- Name of a section is automatically created (or changed) if no name was given (or if a same name was already used)

- A data cross section can be automatically generated downstream of a singular section (and warning is given in case it was not defined)

5.11 (Beta Test):

- Integration of Edital, Talweg, Ediflu and Fluvia into the new interfaces

5.08 (Beta Test):

- All programs:

- Change of the format of the Director.dat and Project.ini files. (from 5.08h)

- Windev 14 upgrade. (from 5.08h)

- Ediflu (n03): better management of invalid data errors when reading a .flu file.

- Ediflu (m22, n03), Resflu (m21, n04), Edisir (m18, n03), Resir (m15, n03), Ouv (m11, n06): character " is now allowed in section names (display bug in table corrected).

- Sirene (m38, n13, n14): Trajectories tracking is managed in the ATVPID module. A bug explained that this was managed only for the first PID controller. It is now managed for all PID modules of a ATVPID module. This was not a serious bug since usually the ATVPID modules are not used with trajectories tracking in order to be able to get oscillation cycles around a nominal initial water state.

- Sirene (m38, n13, n14): ATV and ATVPID cycles start even when the initial error is nil.

- Correction of minor bugs and updates.

5.07 (Beta Test):

- Edital: completely new interfaces (In Windev instead of C++).

- Talweg: reads and writes the xml files.

- Sirene: correction of bugs (compared to 5.06 version but not 4.30) in the option "equality of heads at nodes", major bed, and lateral discharges.

5.06 (Beta Test):

- Ediflu: protection of the reading of the .flu file in case of format error.

- Edisir: better management of errors when reading the .sir file.

- Sirene: New unsteady flow calculation with non-linear calculation even for Saint-Venant equations.

- Sirene: Equality of heads is allowed at nodes, individually, as for steady-flow calculation.

4.33:

- All programs:

  - Compilation with lattest Fortran Intel compiler 11.1.067

  - Integrated in the coupling Palm platform (Cerfacs)

  - Linux version available (limited access for specific collaborations)

- Sic: possible to select old versions 4 for Edital, Talweg, Fluvia and Sirene (risky, limited to advanced users). this is available in the option menu/version for exe and dll

- Sirene: Upgrade of the POMPES regulation module

4.32:

- All programs:

  - Windev 15 upgrade for all programs and libraries (4.32b)

  - Windev 14 upgrade except for Ediflu, Resflu, Edisir and Resir since there is a bug in the graphical functions in Windev 14. For those programs we keep Windev 12. (4.32a)

- Fluvia: correction of a bug for looped system when small step is activated (4.32c)

- Fluvia: change of write format for debug mode (4.32c)

4.31:

- All programs :

  - Change of the format of the Director.dat and Project.ini files. (from 4.31a)

  - Windev 14 upgrade. (from 4.31a)

4.30:

- Restal: correction of the format when generating the file at the .tal format (in order to be able to import it into Edital). This format was changed on May 2008, not in a very satisfactory way, and is corrected again.

- Ediflu, Fluvia: equality of heads is allowed instead of equality of water levels, independently for each node. It was allowed in previous versions but the option was global for all nodes.

- Fluvia: correction of a bug when automatically interpolating small space steps in some rare cases.

- Edisir: better management of errors when reading the .sir file.

- Sirene: better management of the directory for the MatLab DDE link when the directory name contains blank characters.

- Improvement of the SCADA and DIGEST regulation modules. Updating of the corresponding documentation (in French).

- Resir: correction of a bug when displaying results at offtakes. The indicators where not displayed for indexes above 999. The format has been extended.

4.29:

- Resflu: volumes in reaches are written on the .lst file.

- Sirene: creation of DDE link with Scilab (for the version compiled with the Intel Fortran Compiler).

- Sirene: the relay in the ATVPID method can be individualized for each control action variable U. The different values must be provided in a ATVPID.TXT file (one value per line, if the value is not provided the default value of the .reg file is kept).

- Fluvia and Sirene: the minimum gate opening of the AMIL, AVIS, AVIO and mixte gates is set, by default, to 0.01 m instead of 0.001 m in previous versions. This parameter can be modified in the fluvia.ini and sirene.ini files. The reason for that is that these gates always have small leaks. For the moment this parameter is global for all such gates. If the .ini files do not exist they will be created with the default values. If they already exist you should write WMINGEC=0.01 or any new value you want.

- Fluvia: improvement of the calculation at cross devices when a gate is almost fully closed.

- Edireg: the new regulation module called WDLang is available.

- Sirene: a new regulation module called WDLang is available. The algorithms can be written in Windev WD Language with no additional third party software. An example is given under DAT/WDLANG, equivalent to the DAT/EX4 example using the MatLab DDE link.

- Sirene: protection of the calculation at an offtake in case the offtake mode is not compatible with the one of the variation law at the same offtake.

- Data can be exported in xls files.

- Upgrade of Windev libraries (from Version 11 to 12) and Fortran Compiler (from Digital 6.6 to Intel 10.1.011).

- Restal provides S.R^(2/3) on the .lst file.

4.28:

- A warning is given in Talweg when a section is shifted using the Offset parameter.

- Improvements of Fluvia and Resflu when some reaches cannot be calculated.

4.27:

- Edital: zoom is allowed.

- SIC general: management of USB version of the protection key. The search of the USB key takes longer than the parallel key. If you select the "auto" mode in the dongle option of the options menu, the parallel key will be looked for first, and then, if not found, the USB key will be looked for. This can take up to around 10 s especially if the network parallel option has been selected previously. The best is therefore to select the option corresponding to your key (parallel or USB).

Main improvements between Version 4.25 and Version 4.26 (validated September 20th, 2007):

  • Fluvia: improvement of the calculation of the discharge at an offtake at a node (in some rare cases the fixed-point algorithm did not converge. The warning message was correctly managed. It has been improved with a combination with a bisection algorithm).
  • Resflu: the reading of the .SRF steady flow result file is better protected in case the calculation is not complete and that therefore the file is not complete.
  • Sirene: the CPU time is indicated in the interface windows.
  • Edireg: the abscissa of an interpolated section was not correct for the section downstream of a singular section. It has been corrected.
  • Sirene: lateral discharge is better managed in case a mistake is made in the .SIR file by putting a 1 in the corresponding field on a I line in the last section of a reach. Documentation is improved about the way the lateral discharge is managed.
  • All programs: the maximum number of branches is increased from 20 to 50.
  • Edital: correction of a bug when displaying the sections on the reach.
  • Talweg: management of the homothetic coefficients in width and depth for the cross sections. This allows rapid change of section size in case of a design or rehabilitation project. French documentation is updated.
  • Talweg: correction of a bug preventing the use of all cross section types for major bed. Now all formats are allowed also for the major beds (rectangular, trapezium, circular, width elevation, etc) as for the minor and medium cross sections.

Main improvements between Version 4.24 and Version 4.25 (validated January 15th, 2007):

  • Ediflu, Fluvia: sill elevations can also be regulated instead of openings at cross regulators (gates or weirs).
  • Upgrade of Windev libraries version 11.

Main improvements between Version 4.23 and Version 4.24 (validated October 10th, 2006):

  • Sirene: add 2 parameters to the Scada interface regulation module (in addition to the previously existing ISYN parameter allowing to synchronize the hydraulic model with the data read on the data.txt files we add IWRCSG allowing to prevent writing the calculated U variables on the csg.txt for example to test a module without acting on the canal, and IWARMUP allowing to speed up the process of synchronization by not deleting the data.txt file during a certain number of iterations up to 9999). Beware to update your .reg files using the Scada regulation module since the upward compatibility is not EXCEPTIONNALY provided with this change. Indeed by default the second parameter IWRCSG will be 0 on old files whereas it must be 1 to do the same action as before (i.e. write the calculated U variables on the csg.txt file) on the new files.
  • Sirene: correction of a bug in case of a Q command at a gate of a cross regulator in a regulation module (stops the program due to a test with a negative index - Bug introduced in the 4.16 version with the new pumping station mode, with no further consequences).
  • Upgrade of Windev libraries and Fortran Compiler.

Main improvements between Version 4.22 and Version 4.23 (validated August 3rd, 2006):

  • Talweg: improvement of the algorithm removing unnecessary points of a cross section, so as to keep always the first lowest point.
  • Ediflu: a bug is corrected at the interface when describing the weir elevation at a weir of a cross regulator when there is an error indicating this elevation is less than the bed level. Similar problems have been corrected at other locations. This is due to the update from Windev 9 to Windev 10.
  • Ediflu: "off" mode is not allowed at upstream nodes. Documentation updated.
  • Fluvia: correction of a bug in the management of the high discharge mode.
  • Edisir, Resir: improvement of the format used for time fields.
  • Edisir: correction of a bug when drawing the discharge variation law at a node in ramp mode (the points were shifted wrongly with a DT offset).
  • Edisir: a warning message is indicated if a Z(t) law is found in a .SIR file at a node which is not a downstream node.
  • Edisir: a bug has been corrected when creating a hot start .SIR file with a Gec-Alsthom gate, the current gate opening was taken instead of the maximum gate opening, which was wrong in the classical calculation modes 1 (GOU93) and 2 (CEM02).
  • Sirene: a warning message is indicated if some U, Z or Y data are missing for some regulation modules when these data are compulsory (see documentation for these required variables).
  • Sirene: "Teta" of the Preissmann scheme can be changed in the sirene.ini file (0.6 by default).
  • Sirene: improvement of the DIGEST and SCADA real-time interface.
  • Sediment transport module incorporated into Fluvia and Sirene has been improved.

Main improvements between Version 4.21 and Version 4.22 (validated March 6th, 2006):

  • Correction of a bug in the calculator tool in Ediflu for the calculation of the normal and critical depths (the cross section area was calculated as S=(B+m)*Y instead of S=(B+mY)*Y). This bug had no implication on the quality of the calculation of SIC since this tool was just a help to provide a downstream rating curve from yn or yc.
  • Correction of a bug when opening the on-line help file, the language was not correctly used to open the correct chm file (in French for the French and Spanish interfaces or in English for the English interface).
  • Improvement of the ATV and therefore also the ATVPID regulation modules. The first cycle is better detected and the calculation of the KU coefficient from Z instead of U had an error (wrong sign).
  • Fluvia and Resflu: before version 4.22, when an overtopping was detected at a section, this section was displayed in red along with all upstream sections of the same reach. Now only the section with overtopping is displayed in red. Beware that at a closed section (where we use the Preissmann slot) overtopping is not possible, and this warning message corresponds then to in charge flow (not open flow).
  • Increase of the number of files allowed in the working directory (from 200 to 500).
  • Migration of all interfaces from Windev 9 to Windev 10.
  • Sirene: upgrade of the DDE link from MatLab 6 to MatLab 7. We now provide upward compatibility of the DDE link. This means that the 4.22 version of SIC is allowing DDE link with MatLab 7 and previous versions such as MatLab 6. It may also work with MatLab 5 but we did not check this. In case you install the new version of SIC over an old one in the same directory, you must delete the Libut.dll, Libmx.dll, Libeng.dll and Libmat.dll files in the SIC/EXE directory. You can either do this manually, or by selecting the "default" option of the "DDE link" option of the "Options" menu of SIC. The previous DDE compatibility problem was coming from the fact that we were giving and installing these dll files, whereas they should be found under the MatLab\Bin\Win32 directory. In the "DDE link" option we also allow to force these dll files to some given MatLab version, but beware that this may generate problems (you may get the message "cannot open MatLab") in case they do not correspond to the MatLab version installed on your computer. When installing SIC, we provide the 3 MatLab library files Libeng.lib, Libmx.lib and Libmat.lib in the SIC/PROG directory useful to compile. From SIC version 4.22 they correspond to MatLab version 7.1 (release 14 SP3). In case you want to compile Sirene with another version of the DDE link you have to use the corresponding version of these library as provided by MatLab.

Main improvements between Version 4.20 and Version 4.21 (validated January 18th, 2006):

  • Edireg: improvement of the selection of the location in correction mode.
  • Sirene: improvement of the STOP regulation module (previous time step is stored).

Main improvements between Version 4.19 and Version 4.20 (validated October 20th, 2005):

  • SIC: the license details are available through the options/license menu. The full parameterization of SIC is given there (maximum dimensions of all internal SIC structures).
  • SIC: a SmartRun mode managing "intelligent sequences" of programs is developed. If activated (in the interface options) the calculation and results programs will be automatically run after editing the corresponding data files. This can be combined with the "interfaces except File opening", so that the correct file is opened automatically.
  • Ediflu, Fluvia, Sirene: new equations are available at cross structures (gates and weirs) including MatLab and Fortran interfaces.
  • Ediflu: better management of the removal of the calibration mode.
  • Resflu: allows to display information even at sections where calculation had some errors.

Main improvements between Version 4.18 and Version 4.19 (validated September 20th, 2005):

  • Ediflu: improvement of the display of the picture at a cross regulator or at an offtake.
  • Fluvia: improvement of the algorithm calculating the gate position of an adjustable gate at a cross regulator when the gate height is given and therefore when overtopping can occur. In some cases the bounds for the bisection algorithm were not correctly set and the algorithm did not converge. The warning and error messages on screen and on the .lst file are more detailed.
  • Resflu: improvement of results when the long distance and/or high discharge mode is activated (ex.: for the Amazon river). The results are directly converted into the correct values.

Main improvements between Version 4.17 and Version 4.18 (validated August 20th, 2005):

  • Resflu: displays water depth, head and beta coefficients in the .lot file.
  • Ediflu: improvement of the drawing of the downstream Q(Z) (allows z<0).
  • Fluvia: improvement of the precision of the calculation of the water elevation from the hydraulic head at a cross section (convergence test increased from 1e-3 to 1e-4, maximum number of iterations increased from 20 to 100).
  • Fluvia and Sirene: improves the filter for Gec Alsthom gates.

Main improvements between Version 4.16 and Version 4.17 (validated July 20th, 2005):

  • Resir: seconds are displayed in tabular results. This improves the precision of the graphs in the case the calculation time step is not a multiple of 1 minute.
  • Sirene: seconds are displayed during calculation.
  • Fluvia: increase the maximum number of iterations for the bisection algorithm for the calculation of discharge at cross structures (50 to 100 in QPN and QPN1, 20 to 100 in FLU611 and FLU613).
  • Sirene: introduction of a filter for AMIL, AVIS and AVIO gates. [still to fully validate]
  • Fluvia, Sirene : possibility to move the water intake for AMIL, AVIS and AVIO gates. [not fully finished for Fluvia]
  • Ediflu : calculation of the volume and dimensions of the downstream basin of tranquilisation for AVIS and AVIO gates.

Main improvements between Version 4.15 and Version 4.16 (validated April 6th, 2005):

  • Edireg: for ATV and ATVPID regulation modules, the suggested phase margin for the corresponding option (method 8) is 0.7 * the maximum value (43 degrees for 10 dB).
  • Ediflu: improvement of interface and documentation for Gec-Alsthom gates.
  • Edital: default data directory is the SIC one (before it was the latest one).
  • Edisir, Sirene, Resir and doc: correction of a bug switching XX and WW for indicator performance calculation.
  • Edireg and Sirene: new regulation module (POMPES) for pumping stations.
  • Ediflu: Correction of a bug on the interface of Q(z) type offtake (due to Windev 9 some fields were not displayed).
  • Sirene: DUMAX (resp. UMAX) is initialized to 99.99 (resp. 9999.) by default instead of 1.
  • Sirene: correction of bugs in the regulation modules in the way saturations are taken into account for the antiwindup features (DYMAX, UMIN, UMAX, DUMAX).
  • Edireg and Sirene: new ATV method to calculate PI coefficients with Gain and Phase margins.
  • Ediflu, Fluvia, Resflu, Edisir, Sirene, Resir, Edireg: start modelling of Gec-Alsthom mixte gates.
  • Sirene: Correction of a bug preventing the display of warnings or errors when using the MatLab regulation module, in case of a problem in the .m file.
  • Documentation: update of the docs for the format of the .SIR files with the Gec-Alsthom gates.
  • Sirene: improvement of the STOP regulation module, with additional displays (next time in hh:mm:ss).
  • Ediflu: correction of the calculation of the maximum discharge for an AMIL gate + indication of the limit between free flow and submerged conditions.
  • Edireg and Sirene: Gec-Alsthom gates can be controlled through a regulation module (maximum opening or real forced opening, depending on the equation selected in Ediflu).
  • SCADA regulation module is added. It allows an interface with a SCADA system to control an irrigation canal in real-time. This is used by Cemagref on the Gignac Canal in the context of the Scientific Project.
  • DIGEST regulation module is added. It allows to simulate the "Digesteur" functions as developed by DSA on the Gignac Canal in the context of the Scientific Project.
  • Edital: correction of the bug in the concatenation of 2 reaches and in the insertion of a new node.
  • ATV and ATVPID regulation modules have 2 new options (number of cycles and calculation from Z instead of U to get saturations into account). Beware to update previous regulation modules using these ATV or ATVPID modules, since the upward compatibility is exceptionally not managed in this modification.
  • Sirene: we increase from 15 to 20 the number of parameters of regulation modules (PARA array). We write all of them (on 2 lines) on the .LST regulation output file.
  • Ediflu: it is possible to skip warning messages.
  • Correction of a small bug in Ediflu in the warning message (error in the name of the downstream node if Q<0 in the warning message. This bug was introduced from version 4.09).
  • Correction of a small bug in Edisir in the management of maximum values at gate movements (a warning was given in some cases when it should not).

Main improvements between Version 4.14 and Version 4.15 (validated February 7th, 2005):

  • DData and DModel variable length are increased from 100 to 250 (to allow longer directory names).
  • Sorting of data before drawing (Resflu, Resir).
  • Migration of all interfaces from Windev 8 to Windev 9.

Main improvements between Version 4.13 and Version 4.14 (validated January 15th, 2005):

  • Correction of a bug in the generation of Q(z) using the Yc or Yn calculator in Ediflu (generated 21 values instead of 20) + warning when the last value is deleted when inserting a new value.

Main improvements between Version 4.12 and Version 4.13 (validated December 7th, 2004):

  • Modification of message 13 in Resflu (cf Resflu.ans).
  • Better management of character % in message 15 in Resflu (cf Resflu.ans).
  • Correction of a bug in the management of new mode IFU(2)=4 (cf. version 4.12).
  • Protection of nil index in structures in Edisir (FORTRAN compiler bug).
  • Images can be stored locally under DATA\IMAGE or globally under LIB\IMAGE.

Main improvements between Version 4.11 and Version 4.12 (validated July 27th, 2004):

  • Regulation module, Edireg and Sirene: new mode (IFU(2)=4) for the regulation at a cross device. In this case the regulation is in discharge mode and it is working as a pump (the discharge is imposed at the device such as for a pump whereas with other modes the gate opening or weir position was calculated to provide the discharge).

Main improvements between Version 4.10 and Version 4.11 (validated July 9th, 2004):

  • In Ediflu a calculator option computes Yn or Yc for a given trapezoidal cross section to help to enter downstream boundary conditions.
  • In Sirene improvement of the algorithm computing the discharge at an offtake with a downstream condition (weir or Q(z)type). Before, at some offtakes, the algorithm didn't converge, generating a flag=-8 error in the .PRS file.
  • Regulation module: new PID options are proposed (cf. ATV and ATVPID methods). Options 2, 3 and 4 are new. Previous methods 2, 3, 4 shifted to 5, 6, 7. Beware to update your .REG file is you use such method.
  • Regulation module: antiwindup (option) has been programmed in the PID (and ATVPID) method. Edireg detects the change in number of parameters and propose to correct the line (i.e. adding the new antiwindup option set to 0, i.e. not activated, to be consistent to the old .REG file).
  • Regulation module: deadband zone has been programmed in the PID regulation module. It uses the DYMax parameter entered in the .REG file. If Abs(E=Y-YT)<DYMax then E=0. The DYMax values have been stored in a P4 common provided in the Sirvid.for file for the USER regulation modules, if required.
  • In Edisir (unsteady flow data editor) the number of value changes at nodes, ponds or cross devices is indicated so that quickly it can be seen which structure is moved.
  • In Edisir improvement of the algorithm shifting the values at laws at nodes, in case there were initial differences between the .SRF and the .SIR files (it was not correctly done for weir type offtakes in some cases such as in Off mode in the .SRF file).
  • Help files updated. The chm help file is called directly from the help buttons of the interface at the proper page. This is true when the interface is switched in French or in English. Since the help chm files do not exist in Spanish, the local help information is still displayed (in Spanish) + the chm help file is displayed (in its French version).
  • In Resflu, you can get dx/(v+c) in the lot file. These values gives you the time step (in second) you need at each section to get a Courant number = 1. It can help for the selection of the time step for a further unsteady flow calculation (with the Preissmann implicit scheme there is not constraint for stability but the courant number should generally be around 1 to 10).

Main improvements between Version 4.07 and Version 4.10 (validated June 15th, 2004):

  • Bug corrected for the BOMAT regulation module + interpolation option added.
  • Bug corrected in Talweg when the last data section of a model was a singular section and when the downstream section was not given by the user, the Strickler could not been defined at this section in Ediflu (detected 08/06/04, corrected 10/06/04).
  • Maximum sizes have been increased in the professional version (number of nodes : 300 -> 350, number of display sections 2000 -> 2500, number of cross sections and number of points).
  • The interface of the STOP regulation module has been improved.
  • Most windows with tabular results can be put full size + data can be sorted (but the graphics may look strange in this case since they are displayed from the new data order) + data can be searched from the name of the section.
  • Interfaces (Sic.exe and Edireg.exe) have been moved from Windev 7.5 to Windev 8.0. All interfaces of Fortran programs have been moved from Windev 5.5 to Windev 8.0.
  • In a global macro (sic.mac) it is possible to change the data directory to run SIC on several projects in a row using the macro mode.
  • Weirs at cross structures can be moved manually or through a regulation module.
  • The picture of the main screen of SIC can be changed. This can be done in the [INTERFACES] section of the SIC.INI file. Check the documentation for more details.
  • The documentation in French and English has been completely updated into a new .chm format (compiled html format). The old .hlp format does not exist anymore. We still provide the .pdf format for the equations of the theoretical guide.

Main improvements between Version 4.0 and Version 4.07 (validated August 25th, 2003):

  • Weirs at cross regulators can be moved in unsteady flow, either manually or through a regulation module. The .sir file format has been slightly changed but upward compatibility is managed (old .sir files can be read by new Edisir and Sirene programs version 4.07).
  • The DDE link between Sirene and MatLab programs is working again with version 6.5 (release 13) of MatLab. Since MatLab does not guarantee the upward compatibility of this DDE link, the Sic 4.07 version and above work only with the 6.5 version of MatLab. An option is added in the MatLab regulation module not to close MatLab at the end of the unsteady flow simulation.
  • Indication of saturation activation in the .lst file when a regulation module is used (DUMin, DUMax, Umin, Umax).
  • Indication of Froude number in the .prs file when the subcritical option is activated and when the Froude number becomes > 0.6
  • In the Sic.mac macro file it is possible to change the data subdirectory to run macros in several data directories in series.
  • More information is written in the macro files (Talweg.mac, Sirene.mac, etc) so that they can be more easily understood and edited manually if required.
  • Better detection of errors in the definition of minor-medium bed elevation (Edital and Talweg programs). This elevation cannot be below the bed level nor above the bank level.

Main improvements between Version 3.8 and Version 4.0:

  • The SIC 4.00 version is a complete 32-bit version. Sic.exe has been rewritten from Turbo Pascal 16-bit to Windev 7.0. Edital.exe has been upgraded from Visual c++ 16-bit (version 1.52) to Visual c++ 32-bit (version 6.0). All Fortran programs have been upgraded from Fortran Powerstation 6.0 (32-bit) to Visual Fortran (Compaq-Digital 32-bit). Interfaces have been upgraded from Windev 5.5 to Windev 7.0.
  • The installation procedure is completely new, and improved. An uninstall procedure can be provided. By default we do not provide it since the SIC software is installed into a separate directory and does not "pollute" other directories. To remove SIC you can just delete the directory. You can also move SIC from one directory to another one. In this case you just have to update the sic.ini file with any file editor (notepad for example).
  • A new dongle system is used (Actikey instead of MicroPhar-Rainbow). This dongle can be used on the local parallel port or on the network.
  • A macro mode for SIC has been developed. It allows to run in sequence several sub-programs of SIC. Before this macro mode already existed but only for the sub-programs (Ediflu, Fluvia, Resflu, etc.).
  • Edital manages minor, medium and major beds (before only the minor and medium beds were managed). Cross sections are displayed on the sketch (in option).
  • Images are managed at the devices in Ediflu.
  • AMIL, AVIS and AVIO gates are modelled both in steady and unsteady flow conditions. Before they were just modelled in unsteady flow with a simplified modelization.
  • Edireg.exe, an editor for the regulation files (.reg) has been developed. It can read the previous .reg files (ascending compatibility) and save the new .reg files in a slightly different format. The previous 3.9 version can read the new format (downward compatibility).
  • The non-linear system in unsteady flow conditions is solved either with the fixed-point method (the only method in version 3.88 and below), with the Newton-Raphson method (or Quasi-Newton-Raphson if desired) or with a combination of both.
  • The non-linear Saint-Venant equations can be solved, instead of their linearized version at each time step, although this option has to be improved in the future.
  • Two different discretizations of the Saint-Venant equations can be used for the unsteady flow computation. The previous classical one can still be used. A new one can be used, that gives the same results as in the steady flow computation.
  • The MatLab DDE link is activated again (it was removed in versions 3.5 to 3.9). It allows to write a regulation module in a .m MatLab file, which is called at each time step by the unsteady flow calculation program (Sirene.exe).
  • Sediment transport module is activated and improved in steady flow and unsteady flow calculations (Fluvia.exe and Sirene.exe programs). But the data file .sed is still not interfaced.
  • Several improvements of the interfaces have been implemented.

Main improvements between Version 3.7 and Version 3.8:

  • Major bed.
  • Modification of the graphical outputs (no more use of GKS drivers, everything in Windev interfaces).
  • New regulation modules (DSS, LP, BOMAT, STEP, ATVPID).
  • New algorithm for the resolution of the loop in unsteady flow module.

Main improvements between Version 3.2 and Version 3.7:

  • New Interfaces
  • Minor and Medium Bed.
  • Sediment transport module.
  • 32 bits applications. This means this version will run on Windows 95/98/NT but no more on Windows 3.1/3.11.
  • Many modifications of the interfaces, new visualizations in Ediflu (downstream rating curves, spline interpolation), Resflu (node discharges, Froudes, velocities, etc.), Edisir (pool spline interpolation) and Resir (Min Max, values at desired time).
  • Unsteady flow results can be stored and displayed only at display sections (default) or at all computational sections (option in Edital, for each reach).
  • New devices: triangular weirs, trapezoidal gates, Gec Alsthom gates, etc.
  • New installation procedure.

Main improvements between Version 3.1 and Version 3.2:

  • Better detection of the maximum duration of the simulation, when the second line is nil in a function of time (Edisir).
  • Real translation of the functions of time in case of an initial difference, after validation from the user (Edisir).
  • Better management of the writing of the functions of time on the .sir file, when the second line is nil (Edisir).
  • Management of the functions of time either as ramps or as steps (Edisir).
  • Better management of the bisection algorithm during the computation of the cross device or offtake gate position, in case of a non monotonous discharge function (Fluvia and Sirene).
  • Better management of the file list when creating the director.dat file, when exceeding the maximum file number (200) (Sic).
  • Correction of a bug in the automatic calibration module (Fluvia) when the automatic small space step was used.
  • Graphical display of the water elevation instead of the water depth (to be consistent with the other programs) in the unsteady flow graphical display program (Visir).
  • Correction of a bug in Vistal : a singular section was automatically displayed at the head of the canal. Initialization of the average bed elevation percentage to 0 % and not to 50 %. In this case the displayed bed elevation is the minimum elevation.
  • Correction of a bug in Fluvia at the cross device computation, when the water depth is greater than 10 m.
  • Modification of the regulation modules for the AMIL, AVIS and AVIO gates.
  • Choice of the resolution mode for the equations at cross structures : non-linear (default option) or linear (new option allowing a faster computation, interesting for soft operations).
  • Z(t) option at downstream nodes (Edisir and Sirene).
  • Bugs in Edital and Talweg : .TAL files from versions 3.1 and 3.2 were ignored.
  • Remark: the 3.0 and 3.1 versions existed under DOS and Windows. The 3.2 version exists only under Windows.
  • New option in Resir: min and max hydraulic variables during a selected period (Q canal, Z canal, Q offtakes).

Main improvements between Version 3.0 and Version 3.1:

  • Unsteady flow computation from a previous unsteady flow computation ("hot start").
  • Choice of the cross structure and offtake equation from several options (2 for the moment).
  • Verification of the compatibility of initial values of the unsteady flow data file [.sir].
  • Automatic generation of a small space step in case of a steep water profile (Fluvia).
  • Extension of the regulation library (AMIL, AVIS, AVIO, ATV, etc.).

Main improvements between Version 2.1 and Version 3.0:

  • Unsteady flow computation is now allowed in looped systems (The 2.1 version could run on any time of systems in steady flow: linear, looped and branched, but only on linear and branched systems in unsteady flow).
  • Non linear computation at cross structures, and null or negative discharges allowed at cross structures.
  • Improvement of the looped computation algorithm in steady flow (converges now in cases where it did not in the version 2.1).
  • Automatic head losses at expansions.
  • Under Windows. Very large systems can be handled in the Windows version (200 reaches, 1800 cross sections, etc.).
  • New interface for the input of the topology and geometry data in the Windows version (completely rewritten in C++).
  • Language can be selected at any time by the user (English, French and Spanish).
  • Improvement of the regulation interface, with a library of usual algorithms (PID, Bival, etc.). Interface with the commercial package MatLab with the possibility to write regulation modules directly as a MatLab function, and allowing to use any MatLab function (included graphical functions).
  • Creation of DXF files (AutoCad Format).
  • Creation of a "macro" mode allowing to run a program in batch mode.
  • Many interface improvements, and bug corrections.

Commercial information:

Company: Irstea (Previously named Cemagref)

Department: UMR G-eau (Previously named Irrigation Research Unit)

Project leaders: J.P. BAUME, P.O. MALATERRE & D. DORCHIES

Address: 361, Rue Jean-François BRETON

BP 5095 - 34196 Montpellier Cedex 5 - France

Tel: (33) 467 04 63 53 or (33) 467 04 63 56

Fax: (33) 467 16 64 40

Email:

Price: 14000 Euros (Professional version) or 1000 Euros (Research & Educational version)

First Version: 1.0 by 1990 - Latest Version: 5.29d in May, 2013

Next Version: 5.30 by June 2013

Date of this information: May 29th, 2013

Maintenance: 1 year free of charge (corrective and upgrading maintenance))

Training: 3 days for the professional version; none for the other versions except under specific contracts

Reference of users:

BCEOM (France),

BRLi (France),

Cemagref (France),

Centre of Excellence in Water Resources Engineering (Pakistan),

Cnearc Engineering School (France),

Colegio de Montecillo (México),

Colorado Institute for Irrigation Management - Colorado University - Fort Collins (USA),

Comisión Nacional del Agua (México),

Compagnie d'Aménagement des Coteaux de Gascogne (CACG, France),

Direction Départementale de l'Agriculture de la Loire (France),

Domaine du Merle (France),

Engref Engineering School (France),

Enit Engineering School (France),

Ecole des Mines de Douai (France),

Eléments (France),

Ensam Agronomy Engineering School (France),

Enseeiht Engineering School (France),

GIS Gignac (France),

Hydraulic Research Wallingford (England),

IFAPA (Cordoba, Spain),

IHE Delft & Ministry of Public Works (Indonesia),

IHE Delft (Netherlands),

Institute for Land and Water Management (Leuven, Belgium),

Instituto Mexicano de Tecnología del Agua (México),

Institut de Recherche pour le Développement (IRD, France, Brésil),

Institut National de Recherche Agronomique (France),

International Water Management Institute (Sri Lanka, Pakistan, Burkina Faso),

Irrigation Authority (Mauritius Island),

Jordan Valley Authority (Jordan),

Laymeyer International (Germany),

Mahaweli Authority (Sri Lanka) through an USAID Project,

Office du Niger (Mali) through a World Bank Project,

SAED (Senegal),

SCET Tunisie,

Service de Navigation de la Seine (France),

Société du Canal de Provence (France),

Sogreah (France),

SpiInfra (France),

University of California, Berkeley (USA),

University of Castilla la Mancha (Spain),

University of Cagliari (Italy),

University Central South (China),

University of Cordoba (Spain),

University of Evora (Portugal),

University of Lahore (Pakistan),

Universitat Politècnica de Catalunya (Barcelona, Spain),

University of Melbourne (Australia),

University of Metz (France),

University of Valladolid (Spain),

Other Research Institutes, Engineering Schools, Universities, etc.

Bibliographical references:

Malaterre P.-O., Rogers D.-C., 2008."Teaching canal hydraulics and control using a computer game or a scale model canal". XIIIth World Water Congress, Montpellier 1-4 september 2008, Global Changes and Water Resources.

Malaterre P.-O., Litrico X., Kobry A., 2008. "Les outils opérationnels de gestion et de régulation des canaux dans le Tadla". Atelier régional des projets Aquastress et Sirma sous le thème "Vers de nouvelles approches d'ingénierie et de gestion durable de l'eau en agriculture" - June 10-11, 2008 – Fquih Ben Salah, Maroc.

Litrico Xavier, Malaterre Pierre-Olivier, Baume Jean-Pierre, Vion Pierre-Yves, Ribot-Bruno José, 2007. "Automatic tuning of PI controllers for an irrigation canal pool". ASCE Journal of Irrigation and Drainage Engineering, Jan./Feb. 2007, Vol. 133, n°1, p. 27-37, ISSN 0733-9437.

Malaterre Pierre-Olivier, Château Christophe, 2007. "SCADA interface of the SIC software for easy real time application of advanced regulation algorithms". Second Conference on SCADA and Related Technologies for Irrigation System Modernization - A USCID Water Management Conference - June 6-9, 2007 - Denver, Colorado.

Litrico Xavier, Malaterre Pierre-Olivier, 2007. "Test of auto-tuned automatic downstream controllers on Gignac Canal". Second Conference on SCADA and Related Technologies for Irrigation System Modernization - A USCID Water Management Conference - June 6-9, 2007 - Denver, Colorado.

Sart Caroline, Baume Jean-Pierre, Malaterre Pierre-Olivier, Guinot Vincent, 2006. "An adaptation of Preissmann's scheme for transcritical flows". The 7th International Conference on Hydroinformatics, Nice, September 4-7 2006.

Baume Jean-Pierre, Malaterre Pierre-Olivier, Belaud Gilles, Le Guennec Benoit. "SIC: a 1D Hydrodynamic Model for River and Irrigation Canal Modeling and Regulation", in Métodos Numéricos em Recursos Hidricos 7, ABRH (Associacao Brasileira de Recursos Hidricos), Coppetec Fundacao, Editor Rui Carlos Vieira da Silva, pp 1-81, ISBN 85-88686-14-7, 2005.

Malaterre P.-O., 2002. "Les problématiques de gestion des systèmes hydrauliques à surface libre", dans "Automatique pour la gestion des ressources en eau", Traité IC2, série Systèmes Automatisés, Hermès sciences publications, ISBN 2-7462-0527-0, 279 p, pp. 17-43.

Malaterre P.-O., Baume J.-P., 1997. "SIC 3.0, a simulation model for canal automation design". International Workshop on the Regulation of Irrigation Canals: State of the Art of Research and Applications, RIC97, Marrakech (Morocco), April 22-24, 1997.

Malaterre P.-O., 2011. Flyer SIC (in French).

On line documentation provided with the software in French and in English in chm format (compiled html format).

More references at www.canari.free.fr/publi.htm

Pierre-Olivier Malaterre home page | CANARI server