GPS-X User’s Guide

image

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.

Logo, company name  Description automatically generated

 


Table of Contents

CHAPTER 1. 1

GPS-X Preview.. 1

Starting GPS-X.. 1

Elements of The Main Window.. 1

Title Bar 1

Menu Bar 1

File Menu. 2

Edit Menu. 4

View Menu. 6

Layout Menu. 8

Tools Menu. 9

Library Menu. 13

Help Menu. 14

Main Toolbar 15

Drawing Board. 16

Modelling/Simulation Mode. 16

Simulation Toolbar 16

CHAPTER 2. 19

Creating Model Layouts. 19

Layouts. 19

Selecting and Placing Objects. 21

Connecting Objects. 22

Editing the Layout 25

CHAPTER 3. 36

Influent Advisor 36

CHAPTER 4. 39

Specifying Object Data. 39

Types of Data. 39

Object Menus. 40

Data Entry Forms. 42

Influent Objects. 45

Process Objects. 45

Summary of Changes. 47

Labels. 48

Find. 51

Sourcing. 53

General Data. 55

Site Properties. 56

CHAPTER 5. 57

Defining Data. 57

Introduction. 57

Moving Averages, Mass Flows, and Totalizer 58

Food/Microorganism (F/M) Ratio. 62

Solids Retention Time (SRT) 63

Dynamic SRT. 65

CHAPTER 6. 66

Preparing Input Controls. 66

What is an Input Control?. 66

Controls Toolbar 67

Types of Input Controls. 68

Creating A Control From An Independent Variable. 70

Input Controls Properties. 72

Renaming an Input Control Tab. 74

Removing a Control 74

Transfer Controller Values. 75

Using File Input Controllers. 76

Adding Input Files to a Layout 81

Dynamic Data Validation. 82

CHAPTER 7. 84

Preparing Output 84

What is an Output Display?. 84

Outputs Toolbar 85

Type Summary. 85

Process Schematic Output Summary. 87

Quick Display. 88

Table Displays. 90

Bar Charts from Table Display. 94

User-Defined Displays. 95

State Point Analysis Graphs. 105

Sankey Diagram.. 107

Mass Balance Diagram.. 109

Energy Usage and Operating Cost Summary. 112

Saving Data to Text File. 116

Generating a Report 118

Exporting Layout Image. 125

Statistical Analysis. 126

CHAPTER 8. 130

Building and Running a Model 130

Dynamic Modelling & Simulation. 130

Overview of The Model Building Process. 141

Building a Model 142

Building Options. 143

Starting Simulations. 145

Pausing/Resuming the Simulation. 149

Output Variable Form.. 149

Simulation Control 150

Using Scenarios. 153

Automating Simulations (Autorun) 157

CHAPTER 9. 159

Analysis Tools. 159

Introduction. 159

What is Steady-State Analysis?. 159

What is Dynamic Analysis?. 160

Steps in Sensitivity Analysis. 163

What is Monte Carlo Analysis?. 165

CHAPTER 10. 168

Optimization Tools. 168

Introduction. 168

Uses of Optimization. 169

Algorithm Used. 169

Types of Optimization. 169

Dynamic Simulation Initial Conditions. 172

Selection of the Optimization Variables. 173

Steps in an Optimization. 173

Advanced Optimizer Settings. 178

Troubleshooting. 178

CHAPTER 11. 179

Customizing GPS-X.. 179

Introduction. 179

Types of Customization. 180

GPS-X Software System.. 181

Customizing Layouts. 187

Troubleshooting. 192

CHAPTER 12. 194

Units Conversion. 194

Introduction. 194

Unit Systems. 194

Selecting Individual Units. 194

Units Data File. 195

CHAPTER 13. 197

On-line Data Reading Tools. 197

Continuous Reading of Text Files. 197

CHAPTER 14. 200

Model Developer 200

Introduction. 200

Accessing Model Developer 200

Model Developer Components. 201

Entering Models into Model Developer 206

Generating Models. 210

A Note About Using Your New Models. 211

Technical Support and Troubleshooting. 211

References. 211

CHAPTER 15. 212

GPS-X Python Integration. 212

Introduction. 212

The Python Script Manager 212

Editing Python Scripts. 213

Running Python Scripts. 215

Python Settings. 216

Incorporating Python in a GPS-X Macro. 217

Appendix A: GPS-X Recognized Python Functions. 219

FOOTNOTES. 212