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
    • 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>

Disclaimer