AutoCal

MIKEBYDHI2009AUTOCALAutoCalibrationToolUserGuide2AutoCal3PleaseNoteCopyrightThisdocumentreferstoproprietarycomputersoftwarewhichisprotectedbycopyright.Allrightsarereserved.CopyingorotherreproductionofthismanualortherelatedprogramsisprohibitedwithoutpriorwrittenconsentofDHI.Fordetailspleaserefertoyour'DHISoftwareLicenceAgreement'.LimitedLiabilityTheliabilityofDHIislimitedasspecifiedinSectionIIIofyour'DHISoftwareLicenceAgreement':'INNOEVENTSHALLDHIORITSREPRESENTATIVES(AGENTSANDSUPPLIERS)BELIABLEFORANYDAMAGESWHATSO-EVERINCLUDING,WITHOUTLIMITATION,SPECIAL,INDIRECT,INCIDENTALORCONSEQUENTIALDAMAGESORDAMAGESFORLOSSOFBUSINESSPROFITSORSAVINGS,BUSINESSINTERRUPTION,LOSSOFBUSINESSINFORMATIONOROTHERPECUNIARYLOSSARISINGOUTOFTHEUSEOFORTHEINA-BILITYTOUSETHISDHISOFTWAREPRODUCT,EVENIFDHIHASBEENADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGES.THISLIMITATIONSHALLAPPLYTOCLAIMSOFPERSONALINJURYTOTHEEXTENTPERMITTEDBYLAW.SOMECOUN-TRIESORSTATESDONOTALLOWTHEEXCLUSIONORLIMITA-TIONOFLIABILITYFORCONSEQUENTIAL,SPECIAL,INDIRECT,INCIDENTALDAMAGESAND,ACCORDINGLY,SOMEPORTIONSOFTHESELIMITATIONSMAYNOTAPPLYTOYOU.BYYOUROPENINGOFTHISSEALEDPACKAGEORINSTALLINGORUSINGTHESOFTWARE,YOUHAVEACCEPTEDTHATTHEABOVELIMITATIONSORTHEMAXIMUMLEGALLYAPPLICA-BLESUBSETOFTHESELIMITATIONSAPPLYTOYOURPUR-CHASEOFTHISSOFTWARE.'PrintingHistoryJune2005April2006October2007January20094AutoCal5CONTENTS6AutoCal1AUTOCALIBRATIONTOOL..............................71.1NewAUTOCALDialog..............................91.2SimulationSpecifications...........................101.2.1Modelsimulationsequence.....................101.2.2Modelparameterfiles.........................121.2.3Simulationoption...........................141.2.4Simulationtitle.............................151.3ModelParameters...............................151.4ObjectiveFunctions...............................181.4.1Outputmeasures...........................191.4.2Objectivefunctions..........................211.4.3Evaluationperiod...........................221.4.4Aggregationofobjectivefunctions.................221.5ScenarioRuns..................................241.5.1Scenariotype.............................241.5.2Parameters...............................241.6SensitivityAnalysis...............................251.6.1Sensitivityanalysismethod.....................251.6.2Localsensitivityanalysis.......................251.7ParameterOptimisation............................271.7.1Optimisationmethod.........................281.7.2ShuffledComplexEvolutionmethod................281.7.3PopulationSimplexEvolutionmethod...............321.8SaveOutputFiles................................341.9OfficeGrid....................................351.10StartAUTOCALSimulation..........................371.11Output......................................371.11.1Generaloutputfiles..........................371.11.2Sensitivityanalysisoutput......................381.11.3Optimisationoutput..........................391.12Errorhandling..................................39Index..............................................4171AUTOCALIBRATIONTOOLAUTOCALisagenerictoolforperformingautomaticcalibration,param-eteroptimisation,sensitivityanalysisandscenariomanagementofthenumericalmodellingenginesunderMIKEZero.Itinterfacesthemodel-lingenginesusingtheMIKEZeroPFS(parameterfilessystem)formatformodelinputandtheDFS(datafilesystem)formatformodeloutput.AUTOCALcanalsobelinkedtoothermodellingenginesbyinterfacingASCIImodelinputfilesandcreatingabridgebetweenthemodeloutputandtheDFSfileformat.ThecoreoftheAUTOCALtoolconsistsofthefollowingsteps:1Provisionofasetofmodelparametervaluestothenumericalmodeltobeusedinaspecificmodelrun.2Executionofthesimulationmodelusingthespecifiedsetofmodelparametervalues.3Calculationofstatisticalperformancemeasuresofthemodeloutput.Themodelparameterinterfaceismadeviaaso-calledtemplatefile.Thisfileissimplyareplicaofthemodelinputfileinwhichparameteridentifi-cationtagsareplacedatthelocationswherethenumericalvaluesofthemodelparametersaregiven.Thus,whenAUTOCALhastoprovideanewsetofmodelparameterstothemodel,theparameteridentificationtagsinthetemplatefilearesubstitutedbythenumericalvaluesandsavedinthemodelinputfiletobeusedwhenrunningthemodel.Itispossibletomanipulatemodelparametersindifferentmodelinputfiles.Foreachmodelinputfileacorrespondingtemplatefileisdefined.AUTOCALallowsparameterstobedefinedasfunctionsofotherparame-tersthataremanipulatedintheAUTOCALrun.Inthiscasegeneralequa-tionscanbespecifiedthatdefinestherelationsbetweenthedependentmodelparameterandtheotherparameters.AUTOCALprovidesthesetofindependentparametervaluesandthedependentparametersarethencal-culatedautomaticallyfromthesevaluesusingthedefinedequations.Bothdependentandindependentparametervaluesarethensubstitutingtheircorrespondingparameteridentificationtagsinthetemplatefiles.Besidesthestandardarithmeticoperators,theequationtoolincludesalargenumberofmathematicalfunctions.Aparametermayalsobedefinedasaconstant.InthiscasetheconstantvaluedefinedinAUTOCALissubstitutingthecorrespondingparameteridentificationtaginthetemp