1. ©GoldSim Technology Group LLC., 2015 Designing Well-Structured and Scalable Models April 2015 Webinar

2. ©GoldSim Technology Group LLC., 2015 Overview Design Implementation Documentation Validation and review Presentation

3. ©GoldSim Technology Group LLC., 2015 Types of Models A model to answer a specific question A tool to answer on- going questions

4. ©GoldSim Technology Group LLC., 2015 Design: Model Requirements Before design Basis for level of effort What does the model do and not do? Specific requirements –Interface and Reporting –Data –Functional requirements –Performance –Delivery & Maintainability

5. ©GoldSim Technology Group LLC., 2015 Design: Formulate Conceptual Model How to fulfill requirements? Schematic diagrams Top down approach

6. ©GoldSim Technology Group LLC., 2015 Design: Model Framework Input/output Performance Interface

7. ©GoldSim Technology Group LLC., 2015 Design: Top Down Approach Start with “Here is the problem I’m solving…” Formulate problem using diagrams and logical statements Diversion <= 4 m3/d How big should new pond be? Can water quality be improved? How can we maximize supplies? Expenses < $5M Supplies >= 100 ML

8. ©GoldSim Technology Group LLC., 2015 Design: Draw a System Schematic Upstream Pond 1 Pond 3 Pond 2 Return Flow Overflow Supply A A A Supply B S S Downstream A A Return Flow

9. ©GoldSim Technology Group LLC., 2015 Document the Design Include requirements Criteria and assumptions Diagrams Basis for model documentation

10. ©GoldSim Technology Group LLC., 2015 Implementation Build using “top-down” approach Testing Documentation and graphical design User interface Standards Versioning and file management

11. ©GoldSim Technology Group LLC., 2015 Implementation: System Components

12. ©GoldSim Technology Group LLC., 2015 Keep it DRY Don’t Repeat Yourself Local containers provide local scope Cloned containers Maintain libraries

13. ©GoldSim Technology Group LLC., 2015 Group Elements with Common Purpose Scenario data Data controlled by dashboard External data sources Logic flow and/or physical flows Results that export

14. ©GoldSim Technology Group LLC., 2015 Simulation Settings Assume the settings will change Don’t structure expressions on single time setting

15. ©GoldSim Technology Group LLC., 2015 Implementation: Build Data Model Global inputs Avoid embedding data in expression fields Main outputs Import/export

16. ©GoldSim Technology Group LLC., 2015 Generic Objects Localized containers with local scope Switch out “chunks” of the model Concise names

17. ©GoldSim Technology Group LLC., 2015 Standardize Naming conventions Influence lines Documentation File Management Versioning

18. ©GoldSim Technology Group LLC., 2015 Model Framework Example

19. ©GoldSim Technology Group LLC., 2015 Model Framework Example

20. ©GoldSim Technology Group LLC., 2015 Model Framework Example

21. ©GoldSim Technology Group LLC., 2015 System Representation

22. ©GoldSim Technology Group LLC., 2015 System Representation

23. ©GoldSim Technology Group LLC., 2015 System Representation

24. ©GoldSim Technology Group LLC., 2015 System Representation

25. ©GoldSim Technology Group LLC., 2015 System Representation

26. ©GoldSim Technology Group LLC., 2015 System Representation

27. ©GoldSim Technology Group LLC., 2015 Model Documentation Focus on needs of audience Text Graphic objects Hyperlinks

28. ©GoldSim Technology Group LLC., 2015 What Prevents Good Documentation? Insufficient funds It is difficult and time consuming to translate model logic and formulation to written descriptions The person writing the logic might not have the patience or ability to assist with documentation Lacking a good example to draw from

29. ©GoldSim Technology Group LLC., 2015 Components of Documentation Abstract/Introduction/Background The underlying methodology (theory) Model limitations (and capabilities) Data requirements Input specifications (how is data put into the model?) Summary of model output and any processing of results Example application of the model

30. ©GoldSim Technology Group LLC., 2015 Versioning

31. ©GoldSim Technology Group LLC., 2015 Validation Independent models or algorithms Excel – note difference in time stepping! Reporting periods High-resolution results

32. ©GoldSim Technology Group LLC., 2015 Independent Review Documentation is the basis Markup the model

33. ©GoldSim Technology Group LLC., 2015 Presentation High level access to important results Low level access to all other results Consistency Muted colors Dashboards –Light background for Windows controls

34. ©GoldSim Technology Group LLC., 2015

39. Thank you!