OpenMI compliant - Bundesanstalt für Wasserbau
Contents
1. E E Description Description of this ElementSet Vapour pressure y water elevation W water elevation 2 m ElementSet viewer Fig 8 ElementSet properties on the right side the button for viewing the ElementSet is active now Page 14 Bundesanstalt fur Wasserbau EAW Federal Waterways Engineering and Research Institute 3 2 Adding a GEIWrapper model to access BAW data The LinkableComponent GEIWrapper enables the user to access proprietary BAW data It is a wrap around the Generic Engine Interface GEI which uses a generic approach to read data Files with different formats are called with the same methods at least on the top level Prerequisites are explained in 1 3 3 2 1 Master Definition File mdf Furthermore you have to generate a master definition file mdf for the GEI This can be done in a text editor The following mdf has been created for accessing synoptic open boundary datasets Version 1 2 of 07 07 05 BEGINDATA io_ dataset Language 1 Description 2D_Daten_im_BDF_Format synoptisch File READ D data Delft KanalFlow x flow 100000 Ez bin BDF File READ D data Delft KanalFlow flow 100000 Ez bin BDF ENDDATA ENDFILE After the keyword BEGINDATA follows the data type e g io_dataset Possible values are h_grid p_grid and I_grid for horizontal grids profile grids or single locations For loading De2. M v total discharge N A Location00001 xyPtfla PAWN X PolpLine Open_ E Dimensions O v WasserSt al 00003 O v total discharge t ees 1 v Vapour pressure P1 water elevation lt IM Use ElementT ype filter Use Dimension filter AmountOfSubstance The amount of substance in mole Tools ElementSet viewer Fig 14 Adding a link by clicking on Exchangeltems and the Apply button In the model properties dialog you can view the properties for any Quantity ElementSet or data operation by clicking on it The properties are shown in the box on the right You can remove any connection by clicking on it in the Links box and clicking on Remove Remember to save the composition after adding links 4 1 3 Adding a trigger Each composition needs a trigger to start the process running This is added as follows 1 From the Composition menu select Add Trigger Alternative right mouse click A blue trigger box is added to the composition this can be moved to a suitable position 2 Add a connection from the model that is to be run first to the trigger Fig 15 3 Add exactly one link to the trigger connection Fig 16 The composition is now complete and ready to be run Page 25 Bundesanstalt f r Wasserbau Federal Waterways Engineering and Research Institute BAV a f 5 OmiEd File Composition Options Help Fig 15 Adding a trigger Connection properties Connection D3D_flow T01 m
3. OmiEd_cmd exe 1 3 Prerequisites for the GEIWrapper environment variables optional BAWZONE UTC recommended for most cases CFGDIR themis2 system akprog cfg at BAW and configuration files phydef dat COMPSHORT nt on Windows PCs DICDIR themis2 system akprog dic at BAW and dictionary file gei_dico dat PATH themis2 system akprog bin nt at BAW and Unix like commands Page 1 Bundesanstalt fur Wasserbau Federal Waterways Engineering and Research Institute the following files on BAW PCs in directory D Delft shared older versions in D Delft shared_old Generic Engine Interface gei nt dll BAW OpenMI GEIDotNet dll BAW OpenMI GEIWrapper dll netcdf dll 1 4 Prerequisites for the WLDelft Wrapper a valid license for Delft3D Flow Java Runtime Environment JRE environment variables JAVA_HOME themis2 system akprog bin nt at BAW the following files on BAW PCs in directory D Delft shared older versions in D Delft shared_old DFORMDD DLL Delft3D FLOW dIl Delft3D FLOW _main dll DelftOnline dil DelftOnlineJNI dll GnuGetopt dll GnuRegexp 1 1 4 dll IKVM GNU Classpath dll IKVM Runtime dll JLine dil JavaLaunch dil MSVCRTD DLL NDelftOnline dll WLDelft OpenMI DLLAccess dll WLDelft OpenMI DOLAccess dll WLDelft OpenMI Data dll WLDelft OpenMI DelftFlowDLL dll WLDelft OpenMI SobekDLL dll WLDelft OpenMI Support dll WLDelft
4. 1 Check your rights to write files of type sdr and trc 2 Open a DOS shell and give in rm If rm is not Found extend your PATH e g with PROGHOME bin nt that UNIX like DOS commands as rm can be found bei BAW OpenMI GEIDotNet GEIDotNetAccess ExceptionCode in D CS2005 BAW OpenMI BAW OpenMI GEIDotNet GEIDotNetAccess cs Zeile 84 bei BAW OpenMI GEIDotNet GEIDotNetAccess CreateAndThrowException in D CS2005 BAW OpenMIBAW OpenMI GEIDotNet GEIDotNet ccess cs Zeile 1500 bei BAW OpenMI GEIDotNet GEIDotNetAccess Initialize String compld String mdfId Int32 Iprn Int32 Itre in D CS2005 BAW OpenMI BAW OpenMI GEIDotNet GEIDotNetAccess cs Zeile 126 bei BAW OpenMI GEI Wrapper GEILinkableComponent Initialize I4rgument properties in D CS520051BAW OpenMI BAW OpenMI GEIWrapper GEILinkableComponent cs Zeile 362 bei org OpenMlI Tools GUI Core UIModel ReadOMIFile String relativeDirectory String filename in D src OpenMI Source OpenM1 1 3 0 DotNet OpenMI Tools GUI Core UIModel cs Zeile 285 bei org OpenMI Tools GUI Core CompositionManager AddModel String directory String omiFilename in D src OpenMI Source OpenMI 1 3 0 DotNet OpenMI Tools GUI Core CompositionManager cs Zeile 317 bei org OpenMI Tools GUI ConfigurationEditor MainForm AddModel String FullPath OK Fig 9 Exception The fortran error code is not available Fig 9 displays an exception from this rule The error happens so e
5. gt lt Argument Key Schematization ReadOnly true Value TO1 mdf gt lt Argument Key Process ReadOnly true Value false gt lt Argument Key Directory ReadOnly true Value gt lt Argument Key AcceptProvided ReadOnly true Value true gt lt Arguments gt lt LinkableComponent gt 3 3 3 Omi file for WLDelft Wrapper and domain decomposition In case of a domain decomposition the Delft3D file for domain decomposition boundaries ddb is defined under Schematization The Directory value points to the ddb s directory lt xml version 1 0 gt lt LinkableComponent Type WLDelft OpenMI Wrapper WLLinkableComponent Assembly D Delft shared WLDelft OpenMI Wrapper dll xmlns http www openmi org LinkableComponent xsd gt lt Arguments gt lt Argument Key Model Value D3D_flow gt lt Argument Key Schematization Value dd_hel_F4_gro_F4 ddb gt lt Argument Key Directory Value gt lt Argument Key AcceptProvided Value true gt lt Argument Key DOLServerUrl Value dol url gt lt Argument Key DOLServerStartLocal Value true gt lt Argument Key DOLServerDebug Value false gt lt Arguments gt lt LinkableComponent gt The Delft3D mdf files of each domain are referenced in the ddb file Supposed the ddb file contains the following line hel grd 659 51 659 86 gro grd 1 11 1 46 Then the ddb file directory hast to contain hel mdf and gro mdf and all related fil
6. A 11 11 15 15 16 17 17 18 18 18 20 21 22 23 23 23 23 Page III Bundesanstalt fur Wasserbau OpenMI compliant Import of Initial and Boundary Data into Delft3D 4 1 3 Adding a trigger 4 1 4 Running a composition 4 1 5 Running Compositions as a batch job with OmiEd_cmd 4 2 Building a composition to import boundary and initial data into Delft3D 4 2 1 Linking initial data 4 2 2 Linking open boundary data 4 2 3 Linking free surface boundary data 4 2 4 Linking Sources and Sinks Discharges 4 2 5 Selection of ElementSets 4 2 6 Interpretation of positive and negative values 4 2 7 Mixing OpenMI compliant and traditional import 4 2 8 Comparing results of simulations 4 2 9 Dis Advantages of OpenMI for Delft3D users 5 Troubleshooting 5 1 Exceptions while adding a GEIWrapper model 5 1 1 Fortran Error Code is available 5 1 2 Fortran Error Code is not available 5 2 Exceptions while adding a WLDelft Wrapper model 5 3 Exceptions during the simulation run 5 3 1 listed in the composition log file 5 3 2 not listed in the composition log file 25 27 29 29 30 31 32 33 33 35 36 38 39 40 40 40 41 42 42 42 43 Page IV Bundesanstalt fur Wasserbau BAW OpenMI compliant Import of Initial and Boundary Data into Delft3D List of pictures Page Fig 1 OpenMI configuration editor with a network where data gets imported l Fig 2 How OpenMI terms describes dat
7. BAW OpenMI GEIWrapper GEILinkableComponent Initialize I4rgument properties in D C52005 BAW OpenMI BAW OpenMI GEIWrapper GEILinkableComponent cs Zeile 331 bei org OpenMI Tools GUI Core UIModel ReadOMIFile String relativeDirectory String filename in D src OpenMlI Source OpenMI 1 3 0 DotNet OpenMI Tools GUI Core UIModel cs Zeile 285 bei org OpenMI Tools GUI Core CompositionManager AddModel String directory String omiFilename in D src OpenMI Source OpenMl 1 3 0 DotNet OpenMI Tools GUI Core CompositionManager cs Zeile 317 bei org OpenMlI Tools GUI Configuration amp ditor MainForm AddModel String FullPath in D isrcl OpenMI Source OpenMI 1 3 0 DotNet OpenMI Tools GUI ConfigurationEditor MainForm cs Zeile 365 OK Fig 26 Fortran Error Code 1000 The Fortran Error Code which is unique has the value 1000 The traditional BAW error message indicates the file D data Delft KanalWl lg 3 pts dat is missing The user has proba bly forgotten to copy this geometry file into the directory of the BDF files A look at the mdf s printerfile named lt mdf gt gei sdr might be helpful This file contains a history of exceptions thrown in gei nt dll Page 40 Bundesanstalt flr Wasserbau BAW Federal Waterways Engineering and Research Institute S 5 1 2 Fortran Error Code is not available If a problem occurs during the initialisation of the GEIWrapper the error handling will not be initialised either Ne
8. OpenMI Wrapper dll delft3d flow_3dmor_trafrm dll dformd dll dforrt dll dforrtd dll libifcoremd dll Page 2 Bundesanstalt fur Wasserbau BAU Federal Waterways Engineering and Research Institute libifcoremdd dll libifportmd dll libmmd dll libmmdd dll msvert dll pthreadvce dll md ver exe trisim exe DelftOnline jar gnu regexp 1 1 4 jar gnu getopt jar jline jar Page 3 Bundesanstalt fur Wasserbau BAU Federal Waterways Engineering and Research Institute 2 OpenMi This chapter can only give a short survey of OpenMI The OpenMI Document Series Part B Guidelines is recommended for readers who want to learn more about this technology Most of the following paragraphs have been taken from that publication 2 1 Basic ideas OpenMI stands for Open Modelling Interface and Environment and is based on the idea that different numerical models speak the same language and can therefore be easily linked together to an integrated modelling system A hydrodynamic model can e g be linked to a morphodynamic model The last one needs velocity data from the hydrodynamic one for its simulation The data gets imported during runtime of both models without any output on files The data exchange happens for each time step on the fly so to speak The way how the models communicate is prescribed in the OpenMI standard Gijsbers P J A ed 2005 The OpenMI Docu
9. Wind e Description of this ElementSet id lt provided gt Ta 3 a a ElementSet viewer Fig 20 ElementSets and Types offered by WLDelft Wrapper IDBased has four sub categories IDBased lt name gt refers to a Delft3D location which is defined by its m and n grid indices The ElementCount is always one The location can be 2 or 3 dimensional dependent from its definition in Delft3D GUI Global is used for quantities which have a fixed value both geographically as in time lt provided gt in case of area Quantities as waterlevel salinity or wind lt provided gt means that the imported ElementSets with coordinates etc gets trans formed into Delft3D Flow where a spatial interpolation to the vertices of the Delft3D grid takes place Fig 21 shows red vertices of the coarse grid with measured wind Their values get linear interpolated to the blue vertices of Delft3D s computational grid lt provided gt in cases of sources and sinks means that new discharge locations are generated Fig 22 The ElementSet lt provided gt for the Quantity flux discharge is of fered in OmiEd for each Delft3D simulation Enabling discharges in the Delft3D GUI is not necessary Then the user has to establish a link from XYPoint to lt provided gt This will generate new sources and sinks in the Delft3D grid The x and y coordinates of XYPoint define which grid cell becomes a new discharge Page 34 Bundesanstalt f r Wasserbau
10. the time was shifted from MEZ to UTC Solution You have to set your environment variable to BAWZONE UTC though all values in the real world are in MEZ But it is more important that they all have the same timezone name UTC 3 2 5 Setting environment variables It is recommended to set OpenMI specific environment variables in the Windows environ ment Arguments in the omi file can override this setting 3 2 2 Omi file for GEIWrapper The priority with 1 for the highest priority is as follows Argument in the omi file Windows environment User defined variables Windows environment System variables default defined in the source code FON gt These are the defaults exedir lt LinkableComponentDirectory gt bawdir lt LinkableComponentDirectory gt CFGDIR lt LinkableComponentDirectory gt config DICDIR lt LinkableComponentDirectory gt dic COMPSHORT nt BAWZONE UTC Defaults and arguments have not been tested by BAW 3 3 Adding a WLDelft Wrapper model to initialize Delft3D Flow At first you have to prepare Delft3D Flow as if you would start the traditional way without OpenMI From now on this way is called import by Delft3D GUl The other possibility is called OpenMI compliant import or import by OpenMI 3 3 1 Traditional Delft3D files for cases without domain decomposition The user has to generate the traditional Delft3D files Only Quantities and ElementSets that have been def
11. 7 time dependent positive downwards bathymetry m Bottom Roughness roughness U Chezy BodRChe Val 00992 m s Manning BodRMaSt 00994 s m BodRNik 01 168 m White Colebrook BodRCoWh 01443 m Bottom Roughness roughness V Chezy BodRChe Val 00992 m s Manning BodRMaSt 00994 s m 9 BodRNik 01 168 m White Colebrook BodRCoWh 01443 m Critical Bed Shear sediment_ lt name gt krSpDep Val 01444 N m Only for cohesive Stress for tcrdep constituents only Sedimentation one fraction Critical Bed Shear sediment_ lt name gt krSpEro Val 01445 N m Only for cohesive Stress for tcrero constituents only Erosion one fraction Erosion Parameter sediment_ lt name gt EroParam Val 01446 kg m s Only for cohesive eropar constituents only one fraction Initial Layer Thick sediment_ lt name gt SedMass Val 01447 kg m In the GUI defined ness m bodsed as thickness m but OpenMI import with mass kg m Delft3D computes internally masses Tab 1 Linking initial data Page 30 Bundesanstalt fur Wasserbau Federal Waterways Engineering and Research Institute Example A cohesive sediment fraction with the name MedSilt has the Delft3D Quantities sediment_medsilt tcrdep sediment_medsilt tcrero etc 4 2 2 Linking open boundary data Data accepting WLDelft Wrapper Data providing Unit A
12. BAW Federal Waterways Engineering and Research Institute gt fax BUNDESANSTALT FUR WASSERBAU 6 Karlsruhe Hamburg IImenau OpenMI compliant Import of Initial and Boundary Data into Delft3D User Manual v 1 0 2007 08 29 Bundesanstalt f r Wasserbau BAW OpenMI compliant Import of Initial and Boundary Data into Delft3D gt ud Summary Are you a modeller and are you asking yourself how to import data into a numerical engine Converting the data into the appropriate format before runtime would be the traditional way This manual explains a more generic approach using OpenMI The data gets converted at runtime e Itis directly imported from the proprietary files without output in the format of the nu merical engine e Generic approach means that the numerical engine can easily be replaced by an other one and that the data reader can be replaced as well e Inthe concrete case the numerical engine is Delft3D Flow and its initial and boundary data can be read from proprietary BAW file formats Already existing files which have been generated for import into other numerical engines can be re used e The user can steer the import and the simulation itself with the OpenMI configuration editor Connections between components can be established by mouse click B Omid Fig 1 OpenMI configuration editor with a network where data gets imported e Fig 1 shows a network in the OpenMI configuration editor The two compo
13. Federal Waterways Engineering and Research Institute BAV v ex a3 re ia ae mm ow Delft3D grid with generated Sources and Sinks X Y Fig 22 A link to an ElementSet lt provided gt generates new sources and sinks 4 2 6 Interpretation of positive and negative values The OpenMI Document Series Part B Guidelines For the OpenMI 1 0 Chapter 2 2 4 3 Choosing an ElementType explains how to interprete the algebraic sign of a value Page 35 Bundesanstalt f r Wasserbau BAW Federal Waterways Engineering and Research Institute gt Total Discharge perpendicular to an open boundary PolyLine is an example for a flux per pendicular to a PolyLine The Guidelines explains the right hand rule The right hand rule applies for fluxes perpendicular to a line or polyline Put your hand flat vertical along the line in the positive direction and turn your wrist clockwise When passing the horizontal plane the thumb will point in the positive direction perpendicular to the line or polyline Visualisation Area Xx 3588575 5 Y 5922293 5 m Z 3 00 m M 614 N 24 sthachtBound No boundary pointed View Open Boundary VA 2 01 13 Fig 23 Flux depending on the direction of the open boundary The open boundary GeesthachtBound runs from south to north in the direction of increasing n indices Then according to the right hand rule positive Total Discharge values let the wate
14. I Environment includes OmiEd a visual tool for building and running OpenMI systems The details of the system are stored as a composition The stages in building an OpenMI system include e Start the configuration editor e Add models to the composition e Establish connections between the models e Configure the connections by adding links e Add a trigger e Run the composition The following chapters give a brief introduction to the editor and its use 2 4 The OpenMI Configuration Editor OmiEd OmiEd is central tool to add models and to run simulations OmiEd calls e g Delft3D Flow and it is not the other way round cb OmiEd To run the application on BAW PCs the user has to doubleclick on the OmiEd icon which is located on the Desktop The user can alternatively execute D Delft shared OmiEd exe On other than BAW PCs the OmiEd application is installed in the Program Files directory using the standard Windows installation program The OpenMI Guidelines recommend to switch to the Windows Start menu and to select Program Files gt OpenMI gt OpenMi Configuration Editor The OmiEd window is displayed Fig 4 Page 9 Bundesanstalt flr Wasserbau BAW Federal Waterways Engineering and Research Institute N 3 OmiEd Fig 4 OmiEd display The editor has four menus The File menu has options to create anew composition reload a composition losing any changes made since the last save open an existing com
15. a exchange between models 5 Fig 3 Example for a link connecting a data providing LinkableComponent with an accepting one Pairs of Quantities and ElementSets are connected as well They can have different names 7 Fig 4 OmiEd display 10 Fig 5 Two models a database on the left and Delft3D Flow have been added to OmiEd 11 Fig 6 Model properties popup displaying the ModellD on top the Output and Input Exchangeltems on the left and the properties of the selected model on the right 12 Fig 7 Quantity properties of an Delft3D InputExchangeltem 13 Fig 8 ElementSet properties on the right side the button for viewing the ElementSet is active now 14 Fig 9 Exception The fortran error code is not available 17 Fig 10 Delft3D Visualisation Area displaying a TotalDischarge Boundary named Open_IN red 19 Fig 11 Delft3D GUI displaying the properties of the TotalDischarge Boundary Open_IN 20 Fig 12 Adding a connection between models 23 Fig 13 Connection properties directly after the window has popped up 24 Fig 14 Adding a link by clicking on Exchangeltems and the Apply button 25 Fig 15 Adding a trigger 26 Fig 16 Adding a link to the trigger connection from Dummy Quantity to TriggerQuantity 26 Fig 17 Run properties 27 Fig 18 Simulation progress with event table 28 Fig 19 Reload 28 Fig 20 ElementSets and Types offered by WLDelft Wrapper 34 Fig 21 Wind vertices red and computational grid blue 35 Fig 22 A
16. ame in D src OpenMI Source OpenM1 1 3 0 DotNet OpenMI Tools GUI Core CompositionManager cs Zeile 317 bei org OpenMI Tools GUI ConfigurationEditor MainForm AddModel String FullPath OK Fig 27 Fortran Error Code is not available This exception can have some causes e The user does not have write permission in the mdf directory e g on remote ma chines Solution Change permissions or copy the mdf into a directory with write permission Adjust the omi file The printerfile lt mdf gt dat gei sdr already exists and can not be overwritten e The user does not have write permission for the file e Another OpenMI process is writing the file Then all other OpenMI processes can not write in that file as long as the OmiEd of the first process remains opened Solution Generate a second mdf file with the same content and an omi file referencing this new mdf e The PATH variable does not include the directory with Unix like commands as rm exe Solution Extend PATH e g with PROGHOME bin nt Page 41 Bundesanstalt flr Wasserbau BAW Federal Waterways Engineering and Research Institute I 5 2 Exceptions while adding a WLDelft Wrapper model Error occured while adding the model OMI filename D autotest Delft3D cases 03_omi_boundary bO1_waterleveliworkiw3S21B01 omi Exception System Exception For more information use OmiEd_cmd exe r lt case gt opr bei WLDelft OpenMI DelFtFlowDLL WLAccess CheckResult Int32 resu
17. arly that the sdr file can not be written Supposed all steps mentioned before have been run through correctly Then three possibilities remain e The user does not have write permission in the mdf directory e g on remote ma chines Solution Change permissions or copy the mdf into a directory with write permission Adjust the omi file The printerfile lt mdf gt dat gei sdr already exists and can not be overwritten e The user does not have write permission for the file e Another OpenMI process is writing the file Then all other OpenMI processes can not write in that file as long as the OmiEd of the first process remains opened Solution Generate a second mdf file with the same content and an omi file referencing this new mdf 3 2 4 A word about time zones You have to be careful with timezones in BAW use cases Neither OpenMI nor Delft3D sup port time zones but the GEIWrapper does The BAW environment variable BAWZONE sets the timezone for the proprietary BAW data The default value is MEZ which is UTC 1h Page 17 Bundesanstalt fur Wasserbau Federal Waterways Engineering and Research Institute BAW The GEIWrapper converts all times to UTC before they are passed through the interface to the WLDelft Wrapper This can lead to an unwanted behaviour You can find out what hap pens by looking at the TimeHorizontStart in the model properties dialogue Fig 6 If you expect e g 04 05 2002 00 00 but the value is 04 05 2002 01 00
18. ation This determines what data are output data where they are located and how they are presented Page 23 Bundesanstalt f r Wasserbau BAW Federal Waterways Engineering and Research Institute p gt 3 In the Input Exchange Items box expand the required input quantity and click on the ElementSet that is to receive the data Fig 14 4 Click on the Apply button The new link is added to the list at the bottom of the dialog Click on the link to redisplay its exchange items 5 Click on Close Connection properties Connection D AARAA alleen Flow_100000 dat gt D3D_flow T01 mdf Output Exchange Items Input Exchange Items 7 Po properties D1 v EinVolfValj 01058 lt provided gt Ov WasserSt all 00003 Air temperature Ambient temperature Back radiation Cloud cover depth Dry bulb temperature Use ElementT ype filter L L Use Dimension fiter a a AmountOfSubst 0 Lurrencs AmountOfSubstance The amount of substance in mole Fig 13 Connection properties directly after the window has popped up Page 24 Bundesanstalt flr Wasserbau BAW Federal Waterways Engineering and Research Institute N Connection properties Connection D data Delft KanalFlow mdf_Flow_100000 dat gt D3D_flow T01 mdf Output Exchange Items Input Exchange Items i Quantity properties Mv Einvollal 01058 0 v Solar irradiation a ez 4 OH AllLocations xpPt lg wl
19. ch Institute in Fig 2 shows two ElementSets Wind values are available at the red vertices of a coarse grid They are interpolated to the blue vertices of the finer grid of a numerical engine Interpolation in time is also done by the application 2 3 6 Link A link is the data path connecting two linkable components It is uniquely identified by an ID It connects one and only one source component with one and only one target component Furthermore exactly one Quantity is exchanged in one direction As quantities on the provid ing and on the accepting side may be named differently the link specifies both the Source Quantity and the TargetQuantity Fig 3 Example for a link connecting a data providing LinkableComponent with an accepting one Pairs of Quantities and ElementSets are connected as well They can have different names The OpenMI specification does not imply any compatibility and logical checks on the linked Exchangeltems This means that the user has to select the Quantities and ElementSets out of the ones exposed by the LinkableComponent In most cases he has to know beforehand what they stand for Page 7 Bundesanstalt fur Wasserbau BAU Federal Waterways Engineering and Research Institute WLDelft Wrapper exposes InputExchangeltems with an ElementSet named provided This is an exception from the mentioned issues because an ElementSet with its coordinates is trans ferred from the providing to the accep
20. ction name Initial conditions Open_IN Boundaries Mi fi N1 2 Boundaries Flow Conditions M2 i N2 E Table low conditions Boundary Open_IN Type of open boundary quantity Total discharge Quantity Total discharge Reflection parameter alpha jo s Forcing type Time series Forcing type Time series gt Time Discharge dd mm yyyy hh mm ss m3 s Edit flow conditions 04 05 2006 00 0000 0 04 05 2006 02 00 00 jo Fig 11 Delft3D GUI displaying the properties of the TotalDischarge Boundary Open_IN After generating all necessary files the simulation should be started without OpenMI A simu lation that does not work now will not run with OpenMI neither 3 3 2 Omi file for WLDelft Wrapper and a single domain Then you have to generate an omi file that refers to the LinkableComponent WLDelft Wrapper All other files relevant to this wrapper should be in the same directory In case of a single domain the Delft3D mdf file is defined under Schematization The Directory value points to the mdf s directory Page 20 Bundesanstalt flr Wasserbau Federal Waterways Engineering and Research Institute Z lt xml version 1 0 gt lt LinkableComponent Type WLDelft OpenMI Wrapper WLLinkableComponent Assembly D Delft shared WLDelft OpenMI Wrapper dll xmIns http www openmi org LinkableComponent xsd gt lt Arguments gt lt Argument Key Model ReadOnly true Value D3D_flow
21. df gt org OpenMI_Tools GUIL Trigger F ae Exchange Items Input Exchange Items F Quantity properties v dummy quantity v TriggerQuantitylD k Pn A AJ id DBased dummy eleme id TriggerElementlD D1v Waterlevel A Dimensions AmountOfSubste 0 Currency Fer nen The amount of substance in mole I I I I I I I I I I I I I I I I I I Use ElementT ype filter __ Use Dimension filter Tools Elementet BPE viewer Fig 16 Adding a link to the trigger connection from Dummy Quantity to TriggerQuan tity Page 26 Bundesanstalt fur Wasserbau Federal Waterways Engineering and Research Institute 4 1 4 Running a composition To run the composition 1 From the Composition menu select Run The Run properties dialog pops up amp Run properties Events listened during calculation Informative Source after GetValues call Warning Source before GetValues return Time step progress Target after GetYaluesf return Global progress Target before GetYaluesf call Value out of range Other Data changed Set all Clear all Run properties Invoke trigger at 04 05 2006 02 00 00 Latest overlapping 7 Loatofle Show events in list box Don t use separate thread RUN I Fig 17 Run properties 2 On top you can set what types of event do you want to liste
22. diment3 initial Sediment4 initial Temperature initial water elevation Precipitation Pressure Rain temperature roughness U roughness Y x lt lt eeccccceccece dl gt YPoint 2 6 BOUND_OUT end a XYPoint BOUND_OUT endb y Salinity lt Fig 25 Import at a source or sink is possible at three different ElementSets IDbased lt name gt and XYPoint lt name gt refer to an existing location lt provided gt can generate a source at the same location All three should deliver identical results Common combinations have been checked Nevertheless the same kind e g lt provided gt should be used in all simulations that are going to be compared with each other Using identical links can easily be done by saving an opr file for the reference simulation The necessary changes can be made in a text editor and a comparison run can be started with the new opr Page 38 Bundesanstalt fur Wasserbau BAY Federal Waterways Engineering and Research Institute 4 2 9 Dis Advantages of OpenMI for Delft3D users Editing mdf and omi files needs some practice Troubleshooting can be complicated o The user can select for each Quantity between OpenMI compliant and traditional import Data conversion on the fly saves disk space Boundary data is read just at runtime That means that for a computational timestep only one or two boundary timesteps are read This enables Delf
23. e XYLine line segment connecting two vertices nodes in the horizontal plane XYPolyLine polyline connecting two or more vertices in the horizontal plane XYZPoint point in 3 dimensional space XYZ The values of the quantity are stored at the elements which can be points but also lines polylines etc Lists of connectivity or neighboured cells are not part of the OpenMI Standard 2 3 3 Exchangeltem Quantities are typically exchanged for certain locations i e the ElementSet and the combi nation forms an Exchangeltem Such an Exchangeltem can either act as an input for a model or as an output The InputExchangeltem differs in that point from the Output Exchangeltem 2 3 4 Time When the values apply is indicated by the time either expressed as an instantaneous mo ment in time a timestep or over a period of time a time span GEIWrapper and WLDelft Wrapper only use timesteps Different timezones are not supported 2 3 5 Data Operations In many situations data transformations will be needed to map the available data of the source component to the request format of the target component Data transformations might address spatial aspects temporal aspects or other aspects Spatial interpolations between ElementSets on the data providing side and ElementSets on the accepting side are automatically done by the application during runtime The Where plot Page 6 Bundesanstalt flr Wasserbau Federal Waterways Engineering and Resear
24. es Page 21 Bundesanstalt fur Wasserbau ERW Federal Waterways Engineering and Research Institute 3 3 4 Files for cleaning the working directory It is recommended to clean the working directory which contains the Delft3D mdf files before the simulation starts In case of a single domain the directory has to contain Delft3D FLOW_init bat Editing the file is not necessary In case of domain decomposition the user has to edit clean cmd The file has to call Delft3D FLOW_init bat for each domain with its domain IDs e g call Delft3D FLOW _init bat hel call Delft3D FLOW _init bat gro Page 22 Bundesanstalt flr Wasserbau Federal Waterways Engineering and Research Institute Z 4 Building a Composition with OmiEd 4 1 General 4 1 1 Establishing connections between the models The models are linked together by adding connections between them 1 From the Composition menu select Add Connection Alternative right mouse click 2 Drag the pointer from one model to another A connection is added between the models 3 Repeat for any further connections Fig 12 Adding a connection between models 4 1 2 Configuring the connections The connection properties must be set for each link 1 Doubleclick on the arrow in the middle of the connection The properties dialog is displayed Fig 13 2 In the Output Exchange Items box expand the required output Quantity and ElementSet Click on the required data oper
25. fore Then the users establishes links between OutputExchangeltems of GEIWrapper and the Input Exchangeltems of WLDelft Wrapper The user has free choice which Exchangeltems to select The following tables recommend Quantity combinations The Quantity IDs ofthe second and third column can be found in the Connection Properties window The user can click at the Quantities and select the preferred ElementSets Fig 14 If an expected Delft3D Quantity is not available you will have to enable the Quantity in the Delft3D GUI first column of tables Complete test cases are listed in OpenMI Delft3D Test Cases The test cases are available on BAW PCs with a Delft3D license Page 29 Bundesanstalt fur Wasserbau Federal Waterways Engineering and Research Institute 4 2 1 Linking initial data Data accepting WLDelft Wrapper Data providing Unit Annotations GEIWrapper Quantity in Quantity ID Quantity ID published Delft3D GUI published In OmiEd in OmiEd Water level initial water eleva WasserStd Val 00003 m positive upwards tion Salinity initial salinity SalzGeh Val 00005 110 Temperature initial temperature Temp Val 00005 degr cent Sediments initial lt sediment01 gt SchwStGh Val 00007 kg m GEIWrapper pub 01 01 lt sediment01 gt lishes 10 fractions ee PER as maximum initial lt sedimentnn gt SchwStGh Val 00007 10 01 lt sediment10 gt Bathymetry depth ZVarTopo Val 0061
26. ge 12 Bundesanstalt flr Wasserbau Federal Waterways Engineering and Research Institute Model properties Y dummy quantity l y Waterlevel AmountOfSubstance Currency ElectricCurrent Length LumimnousIntensity Mass Temperature Input Exchange Items Tine ine v re E General veo Humidity Description y initial water elevation D v Precipitation ValueT ype Scalar v Pressure E Unit v Rain temperature v roughness U m E E total discharge ConversionFactorT oS OffSetT oS InitDescription UnitID y total discharge f ats olyLine Open_IN Description Hy total discharge t Description of this Quantity v Vapour pressure water elevation J W water elevation 2 mm S e i T ElementSet viewer Fig 7 Quantity properties of an Delft3D InputExchangeltem Page 13 Bundesanstalt flr Wasserbau Federal Waterways Engineering and Research Institute Model properties Model D3D_flow TO1 mdf Output Exchange Items vo dummy quantity v Waterlevel as ey E General Description ElementCount ElementT ype lt YPolyLine ID YPolpLine Open_IN SpatialReferencelD Input Exchange Items Version v Evaporation v Humidity y initial water elevation v Precipitation y Pressure v Rain temperature yv roughness U v roughness Ce EE
27. he model and selecting Model Properties The properties dialog provides details of the model s Exchangeltems The top box on the lefthand side lists the output quantities the bottom box lists the input quantities Page 11 Bundesanstalt flr Wasserbau BAWI Federal Waterways Engineering and Research Institute S The lists can be expanded to show the element sets that are available for each item the element sets can be expanded to show the data operations that are available Clicking on any item displays the corresponding properties on the right Fig 6 Fig 7 Fig 8 You can view the properties for any other model by selecting it from the dropdown list at the bottom of the dialog Save the composition after adding the models Model properties ode D3D_flow T01 mdf inkableComponent properties y dummy quantity esz A Z Z y Waterlevel General Input Exchange Items Evaporation Humidity initial water elevation Precipitation Pressure Rain temperature roughness U roughness Solar irradiation total discharge A XYPolyLine Open_IN ComponentDescription total discharge t Description of this component Vapour pressure water elevation water elevation 2 Hit Vv Vv Vv v v v v v v cccec Fig 6 Model properties popup displaying the ModellD on top the Output and Input Exchangeltems on the left and the properties of the selected model on the right Pa
28. ined in these files will be published as a model s Exchangeltems in OmiEd Page 18 Bundesanstalt flr Wasserbau BAW Federal Waterways Engineering and Research Institute N If you link one of these Exchangeltems later in OmiEd the values from the Delft3D files will be overwritten with the values imported from the GEIWrapper This means that the traditional values are dummies and that only few timesteps are needed Visualisation Area aeg X 20886 109 Y 9267 9844 m Z 10 00 m M 12 N 11 View Open Boundary YA 2 01 13 Fig 10 Delft3D Visualisation Area displaying a TotalDischarge Boundary named Open_IN red The example of a TotalDischarge Boundary condition is displayed in Fig 10 The red bound ary has been added in the external Delft3D GUI Visualisation Area Fig 11 shows the boundary properties in the GUI s Boundary menu Edit flow conditions allows you to do what its name promises Two timesteps with the default value 0 m 3 s are enough Start and end time can differ from the ones which are OpenMI compliant imported But compared to Delft3D GUI gt Time Frame gt Simulation Start Time the imported start time has to be earlier or equal Page 19 Bundesanstalt flr Wasserbau Federal Waterways Engineering and Research Institute a Delft3D FLOW D autotestWelft3D cases 99_training t01_scratch work w32 T01 mdf_ File Table View Help Description Boundaries Add Open Save Delete EEE Se
29. is responsible for damage arising from action based upon information in this document Page Il Bundesanstalt fur Wasserbau OpenMI compliant Import of Initial and Boundary Data into Delft3D Table of contents 1 Prerequisites 1 1 System prerequisites 1 1 1 System prerequisites on PCs with WindowsXP 1 2 OpenMI prerequisites 1 3 Prerequisites for the GEIWrapper 1 4 Prerequisites for the WLDelft Wrapper 2 OpenMI 2 1 Basic ideas 2 2 LinkableComponent 2 3 Terms describing the exchange between LinkableComponents 2 3 1 Quantity 2 3 2 ElementSet 2 3 3 Exchangeltem 2 3 4 Time 2 3 5 Data Operations 2 3 6 Link 2 3 7 Composition 2 4 The OpenMI Configuration Editor OmiEd 3 Adding Models with OmiEd 3 1 General 3 2 Adding a GEIWrapper model to access BAW data 3 2 1 Master Definition File mdf 3 2 2 Omi file for GEIWrapper 3 2 3 Adding GEIWrapper 3 2 4 A word about time zones 3 2 5 Setting environment variables 3 3 Adding a WLDelft Wrapper model to initialize Delft3D Flow 3 3 1 Traditional Delft3D files for cases without domain decomposition 3 3 2 Omi file for WLDelft Wrapper and a single domain 3 3 3 Omi file for WLDelft Wrapper and domain decomposition 3 3 4 Files for cleaning the working directory 4 Building a Composition with OmiEd 4 1 General 4 1 1 Establishing connections between the models 4 1 2 Configuring the connections po a OMAN DW OWO A a HR
30. ither Fortran Error Code nor printerfile will be available Error occured while adding the model OMI filename D autotest Delft3D cases 99_training t01_scratch work w32 Flow_100000 omi Exception BAW OpenMI GEIDotNet GEIException 4n exception has occured in Fortran gei nt dll The fortran error code is not available 1 Check your rights to write files of type sdr and trc 2 Open a DOS shell and give in rm If rm is not Found extend your PATH e g with PROGHOME bin nt that UNIX like DOS commands as rm can be found bei BAW OpenMI GEIDotNet GEIDotNetAccess ExceptionCade in D CS2005 BAW OpenMI BAW OpenMI GEIDotNet GEIDotNetAccess cs Zeile 84 bei BAW OpenMI GEIDotNet GEIDotNetAccess CreateAndThrowException in D C520051BAW OpenMI BAW OpenMI GEIDotNet GEIDotNet ccess cs Zeile 1500 bei BAW OpenMI GEIDotNet GEIDotNetAccess Initialize String compld String mdfId Int32 Iprn Int32 Itrc in D CS2005 BAW OpenMIBAW OpenMI GEIDotNetiGEIDotNet ccess cs Zeile 126 bei BAW OpenMI GEI Wrapper GEILinkableComponent Initialize I4rgument properties in D CS20051BAW OpenMIBAW OpenMI GEIWrapper GEILinkableComponent cs Zeile 362 bei org OpenMI Tools GUI Core UIModel ReadOMIFile String relativeDirectory String Filename in D src OpenMI Source OpenMI 1 3 0 DotNet OpenMI Tools GUI Core UIModel cs Zeile 285 bei org OpenMI Tools GUI Core CompositionManager AddModel String directory String omiFilen
31. lft3D input data these types are important io_dataset synoptic datasets io_ipds initial datasets flow 100000 Ez bin contains synoptic flow data and x flow 100000 Ez bin corresponding water level data The pathnames have to be absolute The values have been generated with the BAW pre processor utrrnd http www baw de vip en departments department_k publications pkb utrrnd utrrnd rn html Te u tv Remember that the BDF files need a file with connectivity list and depth values of the underlying geometry In this example the grid file D data Delft KanalFlow lg wl 100000 dat is necessary If you use an already existing mdf file check whether you have write permission in the mdf s directory Page 15 Bundesanstalt fur Wasserbau BAW Federal Waterways Engineering and Research Institute gt todo FKB mdf dat 3 2 2 Omi file for GEIWrapper Secondly you have to generate an omi file that refers to the mdf file and to the LinkableCom ponent GEIWrapper lt xml version 1 0 gt lt LinkableComponent Type BAW OpenMI GEIWrapper GEILinkableComponent Assembly D Delft shared BAW OpenMI GEIWrapper dil xmins http www openmi org LinkableComponent xsd gt lt Arguments gt lt Argument Key MDFile ReadOnly true value D data Delft KanalFlow mdf_Flow_100000 dat gt lt Argument Key Component ReadOnly true Value io_dataset gt lt Arguments gt lt LinkableComponent gt The following Arguments are op
32. link to an ElementSet lt provided gt generates new sources and sinks 35 Fig 23 Flux depending on the direction of the open boundary 36 Fig 24 Different kinds of import for Quantities of one ElementSet 37 Fig 25 Import at a source or sink is possible at three different ElementSets 38 Fig 26 Fortran Error Code 1000 40 Fig 27 Fortran Error Code is not available 41 Fig 28 Exception while adding a WLDelft Wrapper model 42 List of tables Page Tab 1 Linking initial data 30 Tab 2 Linking open boundary data 31 Tab 3 Linking free surface boundary data 32 Tab 4 Linking Sources and Sinks 33 Page V Bundesanstalt fur Wasserbau OpenMI compliant Import of Initial and Boundary Data into Delft3D Page VI Bundesanstalt fur Wasserbau Federal Waterways Engineering and Research Institute 1 Prerequisites 1 1 System prerequisites 1 1 1 System prerequisites on PCs with WindowsXP NET framework version 2 0 50727 e g in C WINDOWS Microsoft NET Framework v2 0 50727 1 2 OpenMI prerequisites the following files on BAW PCs in directory D Delft shared older versions in D Delft shared_old the OpenMI environment version 1 4 or higher for NET 2 0 org OpenMI Backbone dll org OpenMI DevelopmentSupport dll org OpenMI Standard dll org OpenMI Tools GUI Controls dll org OpenMI Tools GUI Core dll org OpenMI Utilities Buffer dll org OpenMI Utilities Spatial dll org OpenMI Utilities Wrapper dll OmiEd exe
33. ltOfCall in D code openmi wrapper trunkisrcl ccessiDelftFlow ccess wL Access cs Zeile 1109 bei WLDelFt OpenMI DelFtFlowDLL WLAccess SE_INITIALIZE String modelID String schemID in D code openmi wrapperitrunkisre AccessiDelftFlow ccessiwLAccess cs Zeile 194 bei WLDelft OpenMI Wrapper WLEngine InitializeModel in D codeopenmi wrapper trunkisrc Wrapper WLEngine cs Zeile 1245 bei WLDelft OpenMI Wrapper WLEngine Initialize Hashtable properties in D code openmi wrapper trunk src Wrapper WLEngine cs Zeile 235 bei org OpenMI Utilities Wrapper LinkableRunEngine Initialize I4rgument properties in D src OpenMI Source OpenMI 1 3 0 DotNet OpenMI Utilities wWrapper LinkableRunEngine cs Zeile 376 bei org OpenMI Tools GUI Core UIModel ReadOMIFile String relativeDirectory String Filename in D src OpenMI Source OpenMI 1 3 0 DotNet OpenMI Tools GUI Core UIModel cs Zeile 285 bei org OpenMI Tools GUI Core CompositionManager AddModel String directory String omiFilename in D src OpenMI Source OpenMI 1 3 0 DotNet OpenMI Tools GUI Core CompositionManager cs Zeile 317 bei org OpenMI Tools GUI ConfigurationEditor MainForm AddModeltString FullPath in D src OpenMI Source OpenM1 1 3 0 DotNet OpenMI Tools GUI ConfigurationEditor MainForm cs Zeile 365 OK Fig 28 Exception while adding a WLDelft Wrapper model The third line bei WLDelft OpenMi DelftFlowDLL in the exception window indicates
34. ment Series Part C The org OpenMi Standard interface specification v 1 0 0 OpenMI was developed as part of the HarmonlT research project cofunded by the European Comission Contract EVK1CT200100090 The HarmonIT consortium has the vision that OpenMI becomes a widely accepted standard for model linkage in the water and possibly in the environmental domain Its web site http www openmi org offers more information OpenMI regards a model as an entity which can provide or accept data Therefore it is not restricted to numerical engines A data base can be a model as well as a postprocessor An OpenMI compliant postprocessor e g a visualization software would have access to all OpenMI compliant models 2 2 LinkableComponent A model in OpenMI context that implements the interface defined in the standard becomes a LinkableComponent The OpenMI compliant import into Delft3D described in this manual needs at least two LinkableComponents e One component that reads the initial and boundary data stored in proprietary BAW files It is called GEIWrapper and has been developed by the BAW Page 4 Bundesanstalt fur Wasserbau BAWI Federal Waterways Engineering and Research Institute gt e One component named WLDelft Wrapper which contains the numerical engine Delft3D Flow as the heart of the application This part has been developed by WL Delft Hydraulics 2 3 Terms describing the exchange between LinkableComponents Somebody who wants
35. n during computation these events can be stored into log file check Log to file and type or browse filename of log file and or shown in list box check Show events in listbox Remember that handling of events can cause large performance overheads for models performing fast timesteps especially showing events in list box is relatively slow Event listerning is recommended to trace back errors or exceptions 3 Invoke trigger at defines the time when the simulation should stop It can be automati cally set to latest overlapping time of all models by clicking Lastest overlapping button The start of the simulation is defined in Timeframe of the Delft8D GUI 4 The Don t use separate thread check box determines whether simulation is run in the same thread as the user interface Ul If the simulation runs in a separate thread Ul responds immediately and the user can even stop it However some components wrapping for example a model using COM single thread apartments can run in problems because model in this case the COM object is intialised in UI thread and not in simulation thread If simulation runs in same thread as user interface and timestep of some model takes long time to execute Ul can stop to respond and the user isn t able to stop simulation 6 Change to the File menu and save the composition Now the composition could also run as a batchjob with OmiEd_cmd exe 4 1 5 Running Compositions as a batch job with OmiEd_cmd Page 27 B
36. nents on the right provide the engine Delft3D Flow in the middle with wind and waterlevel data The component on the left side triggers the application Page Bundesanstalt fur Wasserbau BAW OpenMI compliant Import of Initial and Boundary Data into Delft3D The manual is addressed to Delft3D users who already have experience with the Delft3D GUI Some knowledge of proprietary BAW formats is necessary as well Some basic OpenMI ideas and terms are explained in chapter 2 Chapter 3 and 4 give advice how to generate and run an OpenMI compliant simulation Each one starts with a general part Afterwards the specific case of accessing proprietary BAW data and running Delft3D are discussed Peter Gijsbers from the Harmonit Consortium was so generous that the above mentioned basics and general parts could be taken from The OpenMI Document Series Part B Guidelines For the OpenMI 1 0 Gijsbers Gregersen Westen et al 2005 Copyright The OpenMl specification related terminology methodologies and ideas as used in this document are the copyright of the OpenMI Association The concrete copyright is described in the above mentioned Guidelines The rest is the copyright of the Bundesanstalt f r Wasserbau Disclaimer The information in this document is made available on the condition that the user accepts responsibility for checking that it is correct and that it is fit for the purpose to which it is applied The user
37. nnotations GEIWrapper Quantity in Quantity published Quantity ID published Delft83D GUI In OmiEd in OmiEd Water level water elevation WasserStd Val 00003 m positive upwards recommended water elevation z Current Current recomm m s current c altern EinVol Val 01058 EntVol Val 01059 Total Discharge total discharge EinVol Val 01058 with m s Direction of bound recommended positive values ary is regarded total discharge t EntVol Val 01059 with along positive axis negative values indices even if it is defined the other way round Discharge per cell flux discharge q EinVol Val 01058 with m s Better discharges positive values at sources and EntVol Val 01059 with sinks negative values Salinity salinity SalzGeh Val 00005 1 0 positive downwards Salinity recomm Temperature temperature Temp Val 00005 degr cent Temperature recommended Sediment sediment_ lt 01 gt SchwStGh Val 00007 kg m GEIWrapper pub Sediment_ lt 01 gt 01 01 lt sediment01 gt lishes 10 fractions recommended as maximum sediment_ lt nn gt Sediment_ lt nn gt recommended SchwStGh Val 00007 10 01 lt sediment10 gt The fractions are mixed in one layer graded sediments are not supported Tab 2 Linking open boundary data Be aware that some similar Quantities e g salinity and Salinity have different ElementSets Page 31 Bundesanstalt fur Was
38. position save the cur rent composition with its existing name or a new name and exit the program Com positions are saved with an opr extension The Composition menu lets you add models connections and triggers edit connection and model properties and run the composition The Options menu enables the user to register the file extension omi and opr at the windows registry Doubleclicking e g on an omi file in a file manager will then start OmiEd The Help menu provides instructions for using OmiEd and displays information about the program At first you have to add models Page 10 Bundesanstalt flr Wasserbau BAW Federal Waterways Engineering and Research Institute I 3 Adding Models with OmiEd 3 1 General The composition must consist of two or more OpenMI compliant models each of which will have a corresponding omi file To add a model to the composition 1 From the Composition menu select Add Model As an alternative you can click the right mouse button in the OmiEd window A popup menu appears where you can add among others a model 2 Locate the omi file for the model and click on Open 3 A box containing the model name is added to the editor window Drag the box to a suitable position in the window 4 Add any other models required in the composition Figure 222 Fig 5 Two models a database on the left and Delft3D Flow have been added to OmiEd You can inspect a model s properties by rightclicking on t
39. r stream out of the model In this case the Total Discharges values have to be negative Even if the boundary is defined the other way round the values will have to be negative because OpenMI Delft3D changes the direction internally The recommended matching BAW quan tity is EntVol Val 01059 which has per definition only negative values and null 4 2 7 Mixing OpenMI compliant and traditional import An OpenMI compliant import and the traditional import with the Delft3D GUI can be mixed in one simulation One Quantity is imported OpenMI compliant another one the other way Page 36 Bundesanstalt flr Wasserbau Federal Waterways Engineering and Research Institute gt This mixing is even possible for one ElementSet Supposed there is an open boundary at the open sea Waterlevel time series in BDF format show variation in time and space A salinity time series is not available but it can be assumed to be constant Fig 24 Delft3D GUI Visualisation Area ee Ye Fosse Oe Ie Time dd mm yyyy hh mm ss 23 05 2005 00 00 OF 25 05 2005 00 00 0 ElementSet constant xyPoint Northsea salinity varying waterlevel D autotest Delft3D cases 08 md gern irre u Output Exchange Items Input Exchange Items Dv tota discharge Dv total discharge t Ov Vapour pressure AllLocations xyPt wi MD_Eibm_short loc_gnd dat O Location00001 xyPt wiMD_Elbm_short loc_grid O Location 0002 xyPt wiMD_Elbm_sho
40. rt loc_grid D Location00003 xyPt wd MD _Elbm_short loc_gtid I neatinn ANNIE MD Fihm ahnt Ine arid gt Ev water elevation it XYPont Northsea M1w water elevation i7 lt v Use Element Type fiker Use Dimension filter Fig 24 Different kinds of import for Quantities of one ElementSet It is recommended to import the Waterlevel OpenMI compliant You only have to generate a BAW mdf file and an omi file and to establish one link This is few work for such a complex time series On the other hand it is for the constant salinity easier to open Boundaries in Delft3D GUI to select the Boundary Northsea Edit transport conditions to select Constituent Salinity and finally to fill in the values Page 37 Bundesanstalt flr Wasserbau Federal Waterways Engineering and Research Institute 4 2 8 Comparing results of simulations As mentioned before OpenMI offers the user several ways to import data Supposed flux and salinity shall be imported at a source The user has the choice between three different Delft3D ElementSets for each Quantity Fig 25 Model properties Model D3D_flow D autotest Delft3D cases 05_omi_discharge D05_3d_loc3d_xyzpt work w32 x Output Exchange Items Properties dummy quantity A Input Exchange Items y Evaporation y flux discharge rate id lt provided gt id DBased 2 6 XYPoint 2 6 initial Salinity initial Sediment1 initial Sediment2 initial Se
41. serbau Federal Waterways Engineering and Research Institute 4 2 3 Linking free surface boundary data Data accepting WLDelft Wrapper Data providing Unit Annotations GEIWrapper Quantity in Quantity published Quantity ID published Delft8D GUI In OmiEd in OmiEd Wind Wind WindGe Vec 00906 m s Vector not working with DD Pressure Pressure LuftDr Val 0001 1 hPa Delft3D rescales 100N m the unit from hPa to Pa 100 if the values are between 500 and 2000 Air temperature Air temperature degr cent Ambient Ambient degr cent temperature temperature Back radiation Back radiation W m Cloud cover Cloud cover 1 Range from 0 to 1 Dry bulb temp Dry bulb temp degr cent Evaporation Evaporation m s Precipitation Precipitation m s Humidity Humidity Rain temperature Rain temperature degr cent has to be checked when used Solar irradiation Solar irradiation W m Vapour pressure Vapour pressure N m Tab 3 Linking free surface boundary data Page 32 Bundesanstalt fur Wasserbau Federal Waterways Engineering and Research Institute 4 2 4 Linking Sources and Sinks Discharges sediment_ lt nn gt SchwStGh Val 00007 10 01 lt sediment10 gt Data accepting WLDelft Wrapper Data providing Unit Annotations GEIWrapper Quantity in Quantity published Quantity ID published Delf
42. t3D to access bound ary data with more timesteps Interpolation in time and space is done automatically One OpenMI ElementSet can represent long open boundaries A lot of sub segments would be necessary to represent the same boundary in Delft3D without OpenMI Delft3D can import data from other LinkableComponents e g databases or numerical models BAW specific For varying wind and initial data OpenMI compliant import is the only convenient way to get the data into Delft3D Page 39 Bundesanstalt flr Wasserbau Federal Waterways Engineering and Research Institute pS 5 Troubleshooting 5 1 Exceptions while adding a GEIWrapper model 5 1 1 Fortran Error Code is available This is an example where the exception has occurred in the Fortran methods of gei nt dll Error occured while adding the model OMI filename D autotest Delft3D cases 03_omi_boundary b01_waterlevel work w32 Wil_2pts omi Exception BAW OpenMI GEIDotNet GEIException An exception has occured in the Fortran methods of gei nt dll Fortran Error Code 1000 Fehlerkategorie INQUIRY Methoden Status der angegebenen Datei ist OLD Datei ist aber nicht vorhanden Pfad D datalDelftiKanalwi Dateiname Ig 3pts dat Kanalnummer 0 Status OLD Existenz F gt Daten pruefen bei BAW OpenMI GEIDotNet GEIDotNet ccess CreateAndThrowException bei BAW OpenMI GEIDotNet GEIDotNetAccess Initialize String compld String mdfId Int32 Iprn Int32 ltrc bei
43. t83D GUI In OmiEd in OmiEd Flow flux discharge EinVol Val 01058 with m s As in Delft3D the positive values default of the flag EntVol Val 01059 with UpwSrc is true negative values Salinity salinity SalzGeh Val 00005 10 positive downwards Temperature temperature Temp Val 00005 degr cent Sediment sediment_ lt 01 gt SchwStGh Val 00007 kg m GEIWrapper pub 01 01 lt sediment01 gt lishes 10 fractions as maximum Tab 4 Linking Sources and Sinks 4 2 5 Selection of ElementSets GEIWrapper ElementSets can either be of type XYPoint or XYZPoint WLDelft Wrapper target ElementSets can be of type XYPoint XYLine XYPolyLine or ID Based Fig 20 You can link ElementSets of different types This will for example be necessary if you select a target ElementSet of type IDBased A XYPoint gt IDBased link is appropriate then Usual links including ElementSets are listed in OpenMI Delft3D Test Cases Page 33 Bundesanstalt fur Wasserbau BAW Federal Waterways Engineering and Research Institute gt Model properties Model D3D_flow D autotest Delft3D cases 08_md_elbe MO02_susp_omi work w32 MO02 mdf X Output Exchange Items ElementSet properties y dummy quantity os A Z y Waterlevel E General Input Exchange Items total discharge A N XYPalyLine GeesthachtBound Y Toterdiselnarge y Vapour pressure XYPoint Northsea HE WEWASNERFEUL Description F
44. that exception is thrown because something with the WLDelftWrapper model does not work There can be some cause This time the name of the Delft3D mdf referenced in the Delft3D omi file was not correct 5 3 Exceptions during the simulation run 5 3 1 listed in the composition log file The following exception occurs after clicking the Run button in Run properties dialogue There is no popup window The exception is written in the composition log file or in the simulation progress window For the subsequent message the checkbox for informative events must have been enabled before Type Informative Message Exception occured during simulation System Exception Ex ception in LinkableComponent ComponentlD D3D_flow gt System Exception GetValues method was invoked using a time argument that representes a time before the allowed time horizon This can e g happen if initial values have been imported from ipds dat with a date and time before the start of the Delft3D simulation Clicking Latest overlapping in the Page 42 Bundesanstalt fur Wasserbau Federal Waterways Engineering and Research Institute BAW Run properties dialogue will not work The user has to type a matching time for Invoke trigger at 5 3 2 not listed in the composition log file A look at the Delft3D diagnosis files might help Page 43
45. ting Exchangeltem One Connection between LinkableComponents can contain several links 2 3 7 Composition This section investigates the steps in building a complete integrated simulation from linkable components and links and representing it as a composition In the OpenMI terminology a composition is a set of LinkableComponents possibly popu lated with model data and interconnected with links Conceptually it represents the final stage before running the integrated simulation Physically it is the input to a utility usually referred to as the Deployer which instantiates all involved models and links sets all necessary pa rameters and finally initiates the simulation There are four steps in building a composition e Select all involved linkable components or schematizations e Create the links between the interacting components e Configure the links e Set any other simulation parameters The easiest way to build a composition is via a graphical utility the OmiEd configuration editor described in Chapter 2 4 First the linkable components involved in the simulation have to be selected and be positioned on the working area of the configuration editor The selection procedure is facilitated by builtin repositories that store all descriptive information about available components and their properties The second step is linking the components This is done simply by using the mouse to draw a connecting line between the two models If
46. tional They overwrite the environment variables CFGDIR and DICDIR lt Argument Key exedir Value bin BA W gt lt Argument Key CFGDIR Value remote_machine path gt lt Argument Key DICDIR Value remote_machine path gt The assembly path refers obviously to BAW OpenMI GEIWrapper dll but also to BAW OpenMI GEIDotNet dll and gei nt dll Vee Q __ The paths can either be absolute or relative to the path of the omi file Because several simulations and their omi files can refer to the same mdf file it is recommended to select absolute pathnames The values for the Argument Key Component are allowed to have the same values as the data type values in the mdf file s 3 2 1 lo_dataset and io_ipds are mainly used todo FKB omi file Page 16 Bundesanstalt flr Wasserbau Federal Waterways Engineering and Research Institute 3 2 3 Adding GEIWrapper Now all necessary files are available and the OmiEd user can add the omi file to the composition If any problems occur while adding a GEIWrapper model you should have a look at the mdf s printerfile named lt mdf gt gei sdr This file contains a history of exceptions thrown in gei nt dll Error occured while adding the model OMI Filename D autotest DelFt3D cases 99_training t01_scratch work w32 Flow_100000 omi Exception BAW OpenMI GEIDotNet GEIException 4n exception has occured in Fortran gei nt dll The fortran error code is not available
47. to exchange data between LinkableComponents has to answer three questions What has to be exchanged Where or at which locations does the exchange take place When do the values apply The following definitions and examples give an answer What Quantity be Wind 2 Where a ElementSet XYPoint m um a When 05 12 1999 K 18 00 00 W Fig 2 How OpenMI terms describes data exchange between models 2 3 1 Quantity What the exchanged values represent and in what unit they are expressed is indicated by the Quantity and its Unit The user is responsible for connecting appropriate quantities on the data providing and ac cepting side The dimension expresses the quantity as a combination of base SI quantities which helps the user to find the correct quantity connections Page 5 Bundesanstalt fur Wasserbau BAU Federal Waterways Engineering and Research Institute 2 3 2 ElementSet Where the exchanged values apply is indicated by an ElementSet which contains an or dered set of elements Each element is defined by an ordered set of nodes These nodes may be geo referenced with coordinates but do not need to be The following table contains only the element types that are used either by GEIWrapper or WLDelft Wrapper Element type Convention IDBased the only type which is not geo referenced identification by string XY Point point in the horizontal plan
48. two components exchange more than one quantity or exchange data in both directions separate links have to be set up After defining each link its properties have to be set Doubleclicking on the link will bring up the link properties dialog box where available quantities element sets and data operations are listed Finally any other modelspecific or simulationrelated parameters have to be set up The composition should be saved for the following reasons e Setting up a complex composition usually takes up a lot of effort e A simulation is frequently run repetitively each time with different parameters until the desired results are achieved e An integrated model simulation may use model engines running remotely or use data that do not exist on the local system Page 8 Bundesanstalt fur Wasserbau BAY Federal Waterways Engineering and Research Institute All linkable components are represented by an XML file which refers to the software unit and the data to populate it By calling and initializing this component it can supply metadata on the quantities it can provide or accept and the locations where it can provide or accept data Based on these metadata the modeller can establish the links between the components and build a composition which can be then saved into an XML file Of course this file can then be opened and edited each time the simulation has to be run or modified It is often referred to as an opr file The OpenM
49. ulation again unless they are reloaded and maybe they can have malformed properties like exchange items model ID etc However some models can delete result files of their simulation if you reload them Ja Nein Fig 19 Reload 12 You are asked whether you want to reload the project In most use cases it is highly recommended to click Nein or No A reload would be the same operation as saving the pro ject restart OmiEd and open your project again But some old files can t be overwritten Page 28 Bundesanstalt fur Wasserbau BAY Federal Waterways Engineering and Research Institute 13 Change to File click Exit You did it 4 1 5 Running Compositions as a batch job with OmiEd_cmd Supposed you have saved the complete composition to an opr file and would like to run it a second time Instead of clicking through the OmiEd menus you can execute it as a batch job Path on On BAW PCs with Delft3D installation D Delft shared OmiEd_cmd exe OmiEd_cmd exe lt option gt lt opr file gt with the following options r lt opr file gt runs the simulation defined the opr file v verbose mode off mta application creates and enters a multi threaded apartment COM model at startup not needed for GEIWrapper WLDelft Wrapper h help explains the command and its options 4 2 Building a composition to import boundary and initial data into Delft3D A GEIWrapper and a WLDelft Wrapper model must have been added be
50. undesanstalt f r Wasserbau BAW Federal Waterways Engineering and Research Institute gt 7 Switch back to Composition gt Run and click the final Run button 8 If Online Visualisation has been enabled in the Delft3D GUI gt Output you have to start it manually in the OLV 9 If you enabled Show events in listbox there will be a simulation progress dialog as in Fig 18 On top the simulation progress is shown Below is the event table The column Simula tion Time can be helpful amp Simulation progress Finished mine einigem ment tung tue te nt nat uemmtteem I Events Order Type Description Sender Simulation Time _ DataChanged DataChanged D3D_flow TO1 mdf 04 05 2006 02 00 SourceBefor SourceBeforeGetValuesR D3D_flow TO1 mdf 04 05 2006 02 00 Informative Closing models down Informative Calling Finish on model D Informative Call FINALIZE D3D_flow D3D_flow T01 mdf Informative Calling Finish on model or Informative Calling Finish on model D GlobalProgre Simulation finished succes Mm Fig 18 Simulation progress with event table 10 Stop stops a running simulation 11 When the simulation is complete Simulation finished successfully is written in the last line Click the Close button Question All models have been finished i e Finish method was called on them Do you want to reload project Hint Some models aren t able to run sim
Download Pdf Manuals
Related Search