GPS-X Tutorial Guide

A STEP-BY-STEP GUIDE FOR LEARNING
AND GETTING FAMILIAR WITH GPS-X

GPS-X Version 8.5

Copyright ©1992-2022 Hatch. All rights reserved.

No part of this work covered by copyright may be reproduced in any form or by any means - graphic, electronic or mechanical, including photocopying, recording, taping, or storage in an information retrieval system - without the prior written permission of the copyright owner.

The information contained within this document is subject to change without notice. Hatch makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hatch shall not be liable for errors contained herein or for incidental consequential damages in connection with the furnishing, performance, or use of this material.

Trademarks

GPS-X and all other Hatch trademarks and logos mentioned and/or displayed are trademarks or registered trademarks of Hatch in Canada and in other countries.

ACSL is a registered trademark of AEgis Research Corporation

GPS-X uses selected Free and Open Source licensed components. Please see the readme.txt file in the installation directory for details.

Table of Contents

Introduction. 1

Welcome to GPS-X Version 8.5. 1

What is GPS-X?. 1

Why Create Models of Wastewater Treatment Plants?. 1

Objectives. 2

Modelling environment 2

Simulation Environment 4

Tutorial 1. 6

Building a Plant Model 6

Introduction. 6

Objectives. 6

Building a Simple Plant Layout 7

Selecting Object Models. 16

Building a Model 21

Simulation Environment 22

Running a Simulation. 24

Tutorial 2. 25

Running Dynamic Simulations. 25

Objectives. 25

Creating Input Controls. 25

Creating Output Graphs. 27

Running a Dynamic Simulation. 33

Analyzing the Plant 35

Tutorial 3. 38

Editing Layouts and Using Scenarios. 38

Problem Statement 38

Objectives. 38

Expanding the Plant 39

Using Scenarios. 44

Tutorial 4. 49

Generating Records of Model Dependent and Independent Variables. 49

Problem Statement 49

Objectives. 49

Creating a New Output Table Tab. 49

Additional Output Displays. 52

Creating a Sankey Diagram.. 53

Creating a Mass Balance Diagram.. 54

Viewing an Energy Usage Summary. 56

Viewing an Operating cost Summary. 58

Generating a Report 59

Tutorial 5. 61

Influent Data & Influent Advisor 61

Problem Statement 61

Objectives. 61

Influent Data. 61

Using Influent Advisor 64

Influent Advisor Warnings. 67

Dynamic Data Validation. 68

Tutorial 6. 72

Data Input & Output 72

Problem Statement 72

Objectives. 72

Setting up Dynamic Input 72

Plotting Measured Data along with Simulated Results. 83

Statistical Analysis of the Models Performance. 85

Creating a Bar Chart for Steady-State Condition. 88

Tutorial 7. 92

Using Automatic Controllers. 92

Problem Statement 92

Objectives. 92

Using an Automatic DO Controller 92

Using an Automatic MLSS Controller 94

Tutorial 8. 104

The Define Function. 104

Problem Statement 104

Objectives. 104

Setting up the Layout 104

Defining Mass Flows. 106

Defining an SRT. 110

Defining Averages. 113

Controlling SRT with Waste Pump Rate. 115

Tutorial 9. 118

Sensitivity Analysis. 118

Problem Statement 118

Objectives. 118

Setting up the Layout 118

Setting up the Analysis Parameters. 120

Steady-State Analysis. 121

Time Dynamic Analysis. 123

Phase Dynamic Analysis. 124

Tutorial 10. 126

Parameter Optimization. 126

Problem Statement 126

Objectives. 126

Initial Manual Calibration. 126

Automatic Calibration Using the Optimizer 131

Tutorial 11. 136

Basic Customization. 136

Problem Statement 136

Objectives. 136

Setting Up the Layout 137

Adding Custom Macros. 139

Adding Custom Input Variables. 141

Adding Custom Output Variables. 142

Setting Up Simulations with Custom Variables. 144

Running Simulations. 144

Tutorial 12. 146

Dynamic Parameter Estimator (DPE) 146

Problem Statement 146

Objectives. 146

Setting Up the Layout 147

Setting Up the DPE.. 148

Tutorial 13. 153

Monte Carlo Analysis. 153

Problem Statement 153

Objectives. 153

Setting Up the Layout 154

Selecting Analyze Mode. 158

Running Simulations. 158

Tutorial 14. 161

GPS-X with Python - Introduction. 161

Problem Statement 161

Objectives. 161

GPS-X and Python - Basics. 162

GPS-X and Python – Basic Simulation. 167

Installing Python Libraries. 172

Tutorial 15. 175

GPS-X with Python – Random Events. 175

Problem Statement 175

Objectives. 175

Setting Up the Layout 175

Creating a Random Event 176

Limiting Maximum Influent 179

Creating an Input Delay. 183

Tutorial 16. 187

GPS-X with Python – Sensitivity Analysis. 187

Problem Statement 187

Objectives. 187

Two Manipulated Variable Sensitivity Analysis. 188

Multi-Variable Sensitivity Analysis. 195

Tutorial 17. 200

GPS-X with Python – Java Classes. 200

Problem Statement 200

Objectives. 200

Adding Jar Class Paths. 200

Using JARS to Create Real Time Plots. 202

Tutorial 18. 208

GPSX With Python – DDO Optimization. 208

Problem Statement 208

Objective. 208

Manipulated Variables. 208

Operational Constraints. 209

Creating an Objective Function. 210

Preform DDO on 0-Day Simulation. 213

Preform DDO on Dynamic Simulations.

Footnotes. 225

217