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

Post on 15-Jan-2016

215 views 0 download

Tags:

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

©GoldSim Technology Group LLC., 2015

Designing Well-Structured and Scalable Models

April 2015 Webinar

©GoldSim Technology Group LLC., 2015

Overview

Design Implementation Documentation Validation and review Presentation

©GoldSim Technology Group LLC., 2015

Types of Models

A model to answer a specific question

A tool to answer on-going questions

©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

©GoldSim Technology Group LLC., 2015

Design: Formulate Conceptual Model

How to fulfill requirements? Schematic diagrams Top down approach

©GoldSim Technology Group LLC., 2015

Design: Model Framework

Input/output Performance Interface

©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/dHow big should new pond be?

Can water quality be improved?

How can we maximize supplies?

Expenses < $5M

Supplies >= 100 ML

©GoldSim Technology Group LLC., 2015

Design: Draw a System Schematic

Upstream

Pond 1

Pond 3

Pond 2

Return Flow

Overflow

Supply A

A

Supply BSDownstream

A

Re

turn

Flo

w

©GoldSim Technology Group LLC., 2015

Document the Design

Include requirements Criteria and assumptions Diagrams Basis for model documentation

©GoldSim Technology Group LLC., 2015

Implementation

Build using “top-down” approach Testing Documentation and graphical design User interface Standards Versioning and file management

©GoldSim Technology Group LLC., 2015

Implementation: System Components

©GoldSim Technology Group LLC., 2015

Keep it DRY

Don’t Repeat Yourself Local containers provide local scope Cloned containers Maintain libraries

©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

©GoldSim Technology Group LLC., 2015

Simulation Settings

Assume the settings will change Don’t structure expressions on single

time setting

©GoldSim Technology Group LLC., 2015

Implementation: Build Data Model

Global inputs Avoid embedding data in expression

fields Main outputs Import/export

©GoldSim Technology Group LLC., 2015

Generic Objects

Localized containers with local scope Switch out “chunks” of the model Concise names

©GoldSim Technology Group LLC., 2015

Standardize

Naming conventions Influence lines Documentation File Management Versioning

©GoldSim Technology Group LLC., 2015

Model Framework Example

©GoldSim Technology Group LLC., 2015

Model Framework Example

©GoldSim Technology Group LLC., 2015

Model Framework Example

©GoldSim Technology Group LLC., 2015

System Representation

©GoldSim Technology Group LLC., 2015

System Representation

©GoldSim Technology Group LLC., 2015

System Representation

©GoldSim Technology Group LLC., 2015

System Representation

©GoldSim Technology Group LLC., 2015

System Representation

©GoldSim Technology Group LLC., 2015

System Representation

©GoldSim Technology Group LLC., 2015

Model Documentation

Focus on needs of audience Text Graphic objects Hyperlinks

©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

©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

©GoldSim Technology Group LLC., 2015

Versioning

©GoldSim Technology Group LLC., 2015

Validation

Independent models or algorithms Excel – note difference in time stepping! Reporting periods High-resolution results

©GoldSim Technology Group LLC., 2015

Independent Review

Documentation is the basis Markup the model

©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

©GoldSim Technology Group LLC., 2015

©GoldSim Technology Group LLC., 2015

©GoldSim Technology Group LLC., 2015

©GoldSim Technology Group LLC., 2015

©GoldSim Technology Group LLC., 2015

©GoldSim Technology Group LLC., 2015

Thank you!