Connecting an additional Sacramento model
The catchment name is e.g. 'SC02' or 'E_70'. This name should match the name of the folder and should always have precisely four characters. In this example we use [SC02], any other catchment can be used for this. Copy the example of SC02 first before changing anything. Any file names in bold font or parts of files in bold font need to be changed inside the copied files and folders for an additional catchment.
Config
moduleConfigFiles
Add Forecast moduleInstance, e.g. Samo_SUB02_Forecast 1.00 default.xml
and add Historical moduleInstance e.g. Samo_SUB02_Historical 1.00 default.xml.
Change in the new files all references to file locations to the right catchment folder (search+replace).
Add any new moduleInstances to the regionConfigFiles/moduleInstanceDescriptors.
Difference between Forecast and Historical, also check the ModuleInstanceId's under which you save TimeSeriesSets.
Type of MI |
End time |
Imports |
Forecast |
7, endOverrulable=true |
TimeSeriesSet (simulated forecasting) |
Historical |
0, endOverrulable=false |
State and TimeSeriesSet (simulated historical) |
IdMaps
Add your catchment to these files with inside and outside reference.
IdSamo_Export 1.00 default.xml
IdSamo_Import_Forecast 1.00 default.xml
IdSamo_Import_Historical 1.00 default.xml
(for Calibration catchment add to Id_Samo_Export_Calibration and IdSamo_Import_Calibration 1.00 default.xml)
WorkflowFiles
Add your new moduleInstances to the workflows Flow_Forecast and Flow_Historical.
SystemConfigFiles
Add your output to DisplayGroups.xml.
RegionConfigFiles
Add your output to Filters.xml.
Coldstates
Add cold state for your new catchment by copying and renaming Samo_SUB02_Historical Default.zip. Inside are three files: samlnd.nxt, samlnd.uhc, samrt.rst. No need to change these files.
Restart FEWS after you have done this
Modules
Copy inside the modules. For operational catchment models it is Sacramento, for calibration catchment (daily time step) is is SacramentoCalib.
o Sacramento
- bin
- 4 DLL's, do not change these
- SamLnd_day.exe --> daily calculation, do not change
- SamLnd_hour.exe --> hourly calculation, do not change
- Samo.bat --> calls one of the executables, in Mun case SamLnd_hour.exe, do not change
- Samo_SC02pre.bat --> preprocessor for SC02, change the reference to the catchment folder inside this file
- Samo_SC02post.bat -->post processor for SC02, change the reference to the catchment folder inside this file
- diagnostics, contains only output
- Work, is work directory, no need to change, will be purged by FEWS
- SC02
- Config --> see below
- SacramentoPreAdapterConfigCatch_SC02.xml
- SacramentoPostAdapterConfigCatch_SC02.xml
- samlnd.par , change reference to catchment (click here to go to the definition of this file)
- Config --> see below
-
- Export, no need to change, will be purged by FEWS
- Import, no need to change, will be purged by FEWS
- Log, no need to change, will be purged by FEWS
- State, no need to change
SacramentoPreAdapterConfigCatch_<SC02>.xml
<?xml version="1.0" encoding="UTF-8"?> <sacramentoModel xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews [http://fews.wldelft.nl/schemas/version1.0/sacramentoModel.xsd]"> <general> <workDir>Work</workDir> <importDir>SC02\Import</importDir> <exportDir>SC02\Export</exportDir> <stateFile>..\State\Samo_state.xml</stateFile> <diagnosticFile>..\Log\Diagnostics.xml</diagnosticFile> <missingValue>-999.999</missingValue> </general> <activities> <preAdapterActivities> <dateFormat>yyyy MM dd HH</dateFormat> <input>Samo_input.xml</input> <output>SC02.dat</output> <mapping> <parameterId>Evaporation</parameterId> <locationId>67220</locationId> <column>1</column> </mapping> <mapping> <parameterId>Precipitation</parameterId> <locationId>SC02</locationId> <column>2</column> </mapping> </preAdapterActivities> </activities> </sacramentoModel>
SacramentoPostAdapterConfigCatch_<SC02>.xml
<?xml version="1.0" encoding="UTF-8"?> <sacramentoModel xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews [http://fews.wldelft.nl/schemas/version1.0/sacramentoModel.xsd]"> <general> <workDir>work</workDir> <importDir>SC02\Import</importDir> <exportDir>SC02\Export</exportDir> <stateFile>..\State\Samo_state.xml</stateFile> <diagnosticFile>..\Log\Diagnostics.xml</diagnosticFile> <missingValue>-999.999</missingValue> </general> <activities> <postAdapterActivities> <dateFormat>yyyy MM dd HH</dateFormat> <input>SC02.rnf</input> <output>sacramento_results.xml</output> <mapping> <parameterId>Discharge</parameterId> <locationId>SC02</locationId> <column>1</column> </mapping> </postAdapterActivities> </activities> </sacramentoModel>