Plotview User Guide

PlotView™
User Guide
© 2008 Landmark Graphics Corporation
R5000.0.1
© 2008 Landmark Graphics Corporation
All Rights Reserved Worldwide
This publication has been provided pursuant to an agreement containing restrictions on its use. The publication is also
protected by Federal copyright law. No part of this publication may be copied or distributed, transmitted, transcribed,
stored in a retrieval system, or translated into any human or computer language, in any form or by any means,
electronic, magnetic, manual, or otherwise, or disclosed to third parties without the express written permission of:
Landmark Graphics Corporation

2107 CityWest Blvd, Building 2, Houston, Texas 77042-3051, USA
P.O. Box 42806, Houston, Texas 77242, USA
Phone:713-839-2000, FAX: 713-839-2015
Internet: www.halliburton.com/landmark
Trademarks
3D Drill View, 3D Drill View KM, 3DFS, 3D Surveillance, 3DView, Active Field Surveillance, Active Reservoir Surveillance, ADC,
Advanced Data Transfer, ARIES, ARIES DecisionSuite, AssetConnect, Asset Decision Solutions, Asset Development Center,
AssetDirector, Asset Journal, AssetLink, AssetLink Advisor, AssetLink Director, AssetLink Observer, AssetObserver, AssetObserver
Advisor, Asset Performance, AssetPlanner, AssetSolver, AssetSolver Online, AssetView, BLITZPAK, CasingLife, CasingSeat,
COMPASS, Corporate Data Archiver, Corporate Data Store, Data Analyzer, DataManager, DataStar, DBPlot, Decision Management
System, DecisionSpace, DecisionsSpace 3D Drill View KM, DecisionSpace AssetLink, DecisionSpace AssetPlanner, DecisionSpace
AssetSolver, DecisionSpace AssetView 2D, DecisionSpace AssetView 3D, DecisionSpace Atomic Meshing, DecisionSpace Decision
Management Systems(DMS), DecisionSpace for Production, DecisionSpace Infrastructure, DecisionSpace Nexus, DecisionSpace
PowerModel, DecisionSpace PrecisionTarget, DecisionSpace Reservoir, DecisionSpace TracPlanner, DecisionSpace Well Seismic
Fusion, DecisionSpace WellSolver, DecisionSuite, DepthTeam, Depth Team, DepthTeam Explorer, Depth Team Explorer, DepthTeam
Express, Depth Team Express, DepthTeam Extreme, Depth Team Extreme, DepthTeam Interpreter, Depth Team Interpreter, Desktop
Navigator, DESKTOP-PVT, DESKTOP-VIP, DEX, DIMS, Discovery, Discovery Asset, Discovery FrameBuilder, DMS, Drillability Suite,
Drilling Desktop, DrillModel, Drill-to-the-Earth Model, Drillworks, Drillworks ConnectML, DSS, Dynamic Reservoir Management,
Dynamic Surveillance System, EarthCube, EDM, EDT, eLandmark, Engineer’s Data Model, Engineer's Desktop, Engineer’s Link,
ESP, Event Similarity Prediction, ezFault, ezModel, ezSurface, ezTracker, FastTrack, FG+, FieldPlan, Field Scenario Planner, FZAP!,
GeoAtlas, GeoDataLoad, GeoGraphix, GeoGraphix Exploration System, GeoLink, GeoProbe GF DataServer, GES, GES97,
GESXplorer, GMAplus, GMI Imager, GRIDGENR, Handheld Field Operator, HHFO, I2 Enterprise, iDIMS, IsoMap, iWellFile, i Wellfile,
KnowledgeSource, Landmark, Landmark Decision Center, Landmark & Design, Landmark Logo and Design, Landscape, Lattix,
LeaseMap, LMK Resources, LogEdit, LogM, LogPrep, Make Great Decisions, MathPack, MIMIC, MIMIC+, Model Builder,
MyLandmark, Nexus, Object MP, OpenBooks, OpenJournal, OpenSGM, OpenVision, OpenWells, OpenWire, OpenWorks,
OpenWorks Development Kit, OpenWorks Well File, OpenWorks Production, PAL, Parallel-VIP, PetroBank, PetroBank Explorer,
PetroBank Master Data Store, PetroWorks, PetroWorks Asset, PetroWorks Pro, PetroWorks ULTRA, PlotView, Point Gridding Plus,
Pointing Dispatcher, PostStack, PostStack ESP, PostStack Family, PowerCalculator, PowerExplorer, PowerExplorer Connect,
PowerGrid, PowerHub, Power Interpretation, PowerJournal, PowerModel, PowerView, PrecisionTarget, Presgraf, Pressworks,
PRIZM, Production Asset Manager, Production, PROFILE, Project Administrator, ProMAGIC, ProMAGIC Connect, ProMAGIC
Server, ProMAX, ProMAX 2D, ProMAX 3D, ProMAX 3DPSDM, ProMAX 4D, ProMAX Family, ProMAX MVA, ProMAX VSP, pSTAx,
Query Builder, Quick, Quick+, QUICKDIF, QuickWell, QuickWell+, QUIKRAY, QUIKSHOT, QUIKVSP, RAVE, RAYMAP, RAYMAP+,
Real Freedom, Real Time Asset Management Center, Real Time Decision Center, Real Time Operations Center, Real Time
Production Surveillance, Real Time Surveillance, Real-Time View, Reference Data Manager, Reservoir Framework Builder, RESev,
ResMap, RightTime, RTOC, SCAN, SeisCube, SeisMap, SeisModel, SeisSpace, SeisVision, SeisWell, SeisWorks, SeisWorks 2D,
SeisWorks 3D, SeisWorks PowerCalculator, SeisWorks PowerJournal, SeisWorks PowerSection, SeisWorks PowerView,
SeisXchange, Semblance Computation and Analysis, Sierra Family, SigmaView, SimConnect, SimConvert, SimDataStudio,
SimResults, SimResults+, SimResults+3D, SIVA+, SLAM, smartSECTION, Spatializer, SpecDecomp, StrataAmp, StrataMap,
StrataModel, StrataSim, StrataWorks, StratWorks, StratWorks 3D, StreamCalc, StressCheck, STRUCT, Structure Cube, Surf &
Connect, SynTool, SystemStart, SystemStart for Clients, SystemStart for Servers, System Start for Servers, SystemStart for Storage,
Tanks & Tubes, TDQ, Team Workspace, TERAS, The Engineer’s Desktop, Total Drilling Performance, TOW/cs, TOW/cs Revenue
Interface, TracPlanner, TracPlanner Xpress, Trend Form Gridding, Turbo Synthetics, VESPA, VESPA+, VIP, VIP-COMP, VIP-CORE,
VIPDataStudio, VIP-DUAL, VIP-ENCORE, VIP-EXECUTIVE, VIP-Local Grid Refinement, VIP-THERM, WavX, Web Editor, Wellbase,
Wellbore Planner, Wellbore Planner Connect, WELLCAT, Well Cost, WELLPLAN, Well Seismic Fusion, WellSolver, WellXchange,
WOW, Xsection, You're in Control. Experience the difference, ZAP!, and Z-MAP Plus are trademarks, registered trademarks or
service marks of Landmark Graphics Corporation.
All other trademarks, service marks and product or service names are the trademarks or names of their respective owners.
Note
The information contained in this document is subject to change without notice and should not be construed as a commitment by Landmark
Graphics Corporation. Landmark Graphics Corporation assumes no responsibility for any error that may appear in this manual. Some states
or jurisdictions do not allow disclaimer of expressed or implied warranties in certain transactions; therefore, this statement may not apply to you.
Landmark acknowledges that certain third party code has been bundled with, or embedded in, Landmark’s
software. The licensors of this third party code, and the terms and conditions of their respective licenses,
may be found at the following location:
..\Nexus-VIP5000.0.1\help\com\lgc\dspx\Third_Party.pdf
❖
Table of Contents
About This Manual

Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Using the Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi
Overview
What Is PlotView? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Why Use PlotView? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Summary of PlotView Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Data Loading and Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Plotting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Display Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Getting Started
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Starting and Stopping PlotView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Starting from DESKTOP-VIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Starting from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Quitting PlotView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Understanding the PlotView Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
PlotView Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
PlotView Display Window(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Pull-Down Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Current X/Y Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Axis Annotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Legend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Pop-Up Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Attribute Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
PlotView Quick Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
R5000.0.1 Table of Contents v

PlotView™ User Guide Landmark
Add a Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
View/Edit Trace Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Use the Pop-Up Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Use the Attribute Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Add Windows and Make Them Listen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Add Multiple Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Close a Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Plotting the Data
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
General Guidelines for Plotting Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Creating New Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Selecting Data To Be Plotted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Plotting a Trace In a Single Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Adding the Same Trace to Multiple Displays . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Cross-Plotting Different Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Comparing Data Using Overlaid Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Cycling Through All Available Items in the Database . . . . . . . . . . . . . . . . . . . . 53
Cycling Through All Available Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Removing Traces from a Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Closing a Display Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Analyzing Displayed Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Reading the Legend and Annotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Viewing the Trace Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Highlighting the Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Viewing the Trace Data Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Saving Trace Data to a Separate File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Saving Trace Data to a PostScript File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Changing the Plotted Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Changing Individual Traces Using the Control Panel . . . . . . . . . . . . . . . . . . . . . 63
Changing Individual Traces Using the Attributes Panel . . . . . . . . . . . . . . . . . . . 64
Broadcasting a Change to Multiple Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Calculating New Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Understanding the Calculator Keypad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Calculator Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Understanding How New Traces are Calculated . . . . . . . . . . . . . . . . . . . . . . . . . 69
Understanding How Formulas are Built . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Calculating a New Trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Examples of Calculated Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Enhancing the Display
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Changing the Layout of the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Changing Axis Scaling, Labels, or Other Attributes . . . . . . . . . . . . . . . . . . . . . . 76
vi Table of Contents R5000.0.1

Landmark PlotView™ User Guide
Changing the Axis Notation Type or Precision . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Minimizing/Maximizing the Axis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Changing the Plot Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Setting Up the Title and Legend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Changing the Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Setting the Plot Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Changing the Plot Window Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Adding and Changing Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Adding Drawn Objects to the Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Reshaping or Resizing an Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Editing a Text Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Selecting, Grouping, and Moving Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Changing the Sequence of Overlapping Objects . . . . . . . . . . . . . . . . . . . . . . . . . 93
Cutting, Copying, and Pasting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Changing the Fill, Line or Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Customizing the Dash Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Customizing the Line Width Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Customizing the Arrow Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Capturing an Image for Hardcopy Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Saving and Reloading Screen Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Creating and Saving a New Screen Definition File . . . . . . . . . . . . . . . . . . . . . . 101
Loading an Existing Screen Definition File . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Merging Two Screen Definition Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Reviewing the Available Scenes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Editing the Scenes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Appendix A: Reference Guide to Properties
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Alphabetical List of Property Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Property Names Grouped By Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Appendix B: Converting Data to VDB Format
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Preparing the Control File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Example of Control File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Control File Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Database Filename/Casename (PLOT) . . . . . . . . . . . . . . . . . . . . . . . . . 117
Observed Data Filename (OBS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Name of Plot File (FILE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Name of CASE File (CASE) (optional) . . . . . . . . . . . . . . . . . . . . . . . . 118
Start Date of file (STARTDATE) (optional) . . . . . . . . . . . . . . . . . . . . . 118
Well Variables (WELL VAR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Gathering Center Variables (GATHER VAR) . . . . . . . . . . . . . . . . . . . 119
R5000.0.1 Table of Contents vii

Region Variables (REGION VAR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Field Variables (FIELD VAR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Time Specification, In Days (TIME) . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Time Specification, In Timesteps (TSTEP) . . . . . . . . . . . . . . . . . . . . . . 123
End of Plot File (EOF) (optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Preparing the Observed Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Example of File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Observed Data File Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Title of Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Initial Date, Maximum Time Entries, Units . . . . . . . . . . . . . . . . . . . . . 126
Number of Class Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Class Names, Maximum Items, Number of Properties . . . . . . . . . . . . . 127
Property Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Time/Date and Property Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
End of Observed Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
File Inclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Running DBPLOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
DBPLOT Comand Line Dump Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Appendix C: Batch Plotview
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Preparing to Use Batch Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Setting Up the Screen Definition File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Setting Up Substitution Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Starting Batch Mode from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Using Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Examples of Command Line Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Appendix D: Glossary
Appendix E: Well Event Files
Example of Well Event File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Subject Index
viii Table of Contents R5000.0.1

❖
List of Figures
About This Manual
Overview
Figure1: History Matching with PlotView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Getting Started
Figure 2: The PlotView Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Figure 3: Example of Trace Plotted in a Display Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Figure 4: The Attribute Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Plotting the Data
Figure 5: The Add Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Figure 6: File Selection Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Figure 7: Case Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Figure 8: Class Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Figure 9: The Property Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Figure 10: Item Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Figure 11: Plotting a Trace in a Single Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Figure 12: X Axis Property Selection Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Figure 13: Edit Panel Delete Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Figure 14: Reading the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Figure 15: Reading the Trace Attribute Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Figure 16: Trace Data Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Figure 17: Save File Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Figure 18: Print File Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
R5000.0.1 List of Figures ix

Figure 19: Edit Panel Trace Change Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Figure 20: Trace Attribute Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Figure 21: Axis Attribute Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Figure 22: The Plot Attributes Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Figure 23: Font Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Figure 24: Plot Size Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Figure 25: The Plot Color Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Figure 26: Annotation Editor Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Figure 27: Drawing Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Figure 28: Text Object Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Figure 29: Drawing Object Control Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Figure 30: Text Object Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Figure 31: Fill, Line, and Pattern Selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Figure 32: Dash List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Figure 33: Line Width Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Figure 34: Arrowhead Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Figure 35: The Print Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Figure 36: Screen Definition Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Figure 37: Screen Definition File Selection Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Figure 38: Open File Selection Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Figure 39: Import Screen Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Figure 0-1: Example of Plot Data Control File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Figure 0-2: Example of Observed Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
x List of Figures R5000.0.1

Subject Index
R5000.0.1 List of Figures xi

xii List of Figures R5000.0.1

❖
List of Tables
About This Manual
Overview
Getting Started
Plotting the Data
Table 1: Data Classes In PlotView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Table 2: Trace Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Table 3: Axis Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Table 4: Plot Attribute Panel Fields and Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Table 5: Summary of Annotation Editor Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Table 1: List Of Property Names in Alphabetical Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Table 2: List Of Property Names Grouped By Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Table 1: Well Event File Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Subject Index
R5000.0.1 List of Tables xiii

xiv List of Tables R5000.0.1

Preface
About This Manual
Purpose
This manual is designed to document the features and use of the PlotView
simulation data plotting program and its related utilities. Step by step instructions
on using these modules are presented to show their ease-of-use in analyzing
simulation results.
Audience
This manual is intended to be used by the simulation engineer for analyzing
results or by anyone needing to produce hardcopy results of simulation studies.
The reader should understand the concept of reservoir simulation and have a basic
knowledge of computer operation to use this software.
Organization
The information in this manual is arranged in a logical manner for maximum ease-
of-use. The following chapters are included:
■ Chapter 1 - Overview defines the PlotView software and lists its major
features.
■ Chapter 2 - Getting Started explains how to start PlotView and how to use it
for the first time.
■ Chapter 3 - Plotting the Data provides step-by-step procedures on how to

set up and edit data plots.
■ Chapter 4 - Enhancing the Display explains how to change the display axes,
traces, or annotation for a better visual presentation. It also shows how to use
the Annotation Editor and produce hardcopy.
■ Appendix A - Appendix A: Reference Guide to Properties provides a

complete list of the properties you may encounter while using PlotView to
plot simulation data.
■ Appendix B - Appendix B: Converting Data to VDB Format explains how

to convert VIP plot files to VIP database (VDB) format so they can be used
with PlotView.
R5000.0.1 About This Manual xv

■ Appendix C - Appendix C: Batch Plotview explains how to use the batch

version of PlotView to process data from the command line.
■ Appendix D - Appendix D: Glossary explains the various terminology used

in this manual.
Using the Mouse

The buttons on the mouse are named MB1, MB2, MB3, etc. (left to right). Button
arrangement may be reversed for left-handed mouses (e.g., MB1 on far right).
Typical uses for each button are described below.
■ Drag means to hold down the button as you move the mouse.
■ Control-click means to hold down the Control key and click MB1.
■ Control-drag means to hold down the Control key while you drag the mouse.
■ Control-Shift-click means to hold down the Control key and the Shift key
before clicking once with MB1.
Related Documentation
The following manuals provide more information on Landmark products related
to PlotView. For more information, please consult the appropriate manual listed
below.
■ Getting Started with VIP. An introduction to the VIP product line in general
and the DESKTOP-VIP program in particular. Explains all of the concepts
and data you need to prepare and run reservoir simulations.
■ VIP-CORE Reference Manual. A complete summary of all keywords and

data formats needed to build an initial reservoir model.
■ VIP-EXECUTIVE Reference Manual. A complete summary of the

keywords and data needed to simulate reservoir operation.
■ VIP-EXECUTIVE Technical Manual. A detailed discussion of the

mathematical theory behind the VIP simulators.
■ VIP-THERM Reference Manual. A summary of the keywords and data

entry formats needed to set up a VIP-THERM simulation.
■ DESKTOP-PVT User’s Guide. A summary of the keywords and data entry

formats needed to use the EOS-PAK product.
■ GeoLink User Guide. A summary of the user interface available with the
GeoLink package.
xvi About This Manual R5000.0.1

■ 3DVIEW User Guide. A summary of the user interface available with the
3DVIEW package.
■ GRIDGENR User Guide. A complete guide to the GRIDGENR software

used to create a gridding structure and describe properties for reservoir
simulation.
■ CURVED User Guide. A complete guide to the Landmark curve editing

package used to view and edit simulation data curves.
Contact your Landmark representative for more information about these manuals
or other Landmark products.
R5000.0.1 About This Manual xvii

xviii About This Manual R5000.0.1

Chapter
1
Overview
What Is PlotView?
PlotView is a graphics utility designed for plotting well production curves from a
VIP reservoir simulation and comparing the results to historical values or other
simulation case studies of the same data. In particular, you can do the following:
■ View color-coded plots of simulation data in a graphical display.
■ Overlay multiple curves on the same display for side-by-side comparison.
■ Create multiple displays containing different combinations of plotted data.
■ View the individual data points in a plot.
■ Control the visual attributes of plotted traces, graph titles and legends, or
annotation.
■ Produce hardcopy of plot displays for use in reports or presentations.
This chapter provides a preliminary introduction to the PlotView software and

explains its various features and components. Later chapters explain how to get
started and use the program.
NOTE: The PlotView software is a Motif-based replacement for the Landmark

product known as SIMOUT. The PlotView software combines many features
of the old SIMOUT software with an easy-to-use new point-and-click design
based on the standard OSF/Motif window interface.
R5000.0.1 Overview 19
Why Use PlotView?

Typically, engineers use PlotView as an interim step in the reservoir simulation
process to determine the validity of their modeling assumptions. In the history
matching phase, you can view the results of a reservoir simulation and directly
compare them to historical production data from the actual reservoir by
overlaying both on the same display (see illustration below). In a typical PlotView
display, solid lines represent the simulation data and free-floating points represent
the observed data. A good match between the two indicates that you have
constructed the simulator model accurately enough so that it is functionally in
tune with actual reservoir performance.
PlotView is also used in the predictive phase to compare various modeling

scenarios. PlotView gives you total flexibility and control over each element of
the display, including all axis scaling, axis annotations, and trace attributes. When
you are finished getting the data displayed in exactly the right manner, you can
use PlotView’s hardcopy features to capture images and use them for printing or
presentations.
Observed data points (unconnected) Simulation data trace (solid line)
Figure1: History Matching with PlotView
20 Overview R5000.0.1
Summary of PlotView Features

The PlotView program and related utilities let you perform the following
operations.
Data Loading and Selection

The following list is a summary of the data loading and selection features offered
by the PlotView software. These features are covered in more detail in Chapters 2
and 3.
■ Load simulation database files for plotting of simulation data. This must be a
VDB database file (*.vdb), or a plot file produced as output from a VIP
reservoir simulation that has been converted using the DBPLOT utility.
■ Select a case study to be used for plotting. A simulation database file may
contain multiple case studies.
■ Select the class of data to be plotted. This feature lets you view data on
various levels including the:
❑ Field level
❑ Region level
❑ Area level
❑ Flow station level
❑ Gathering center level
❑ Well level
❑ Well layer level
■ Select the property to be plotted, such as gas production rates (QGP) or

bottom-hole pressures (BHP).
■ Select the item number to be plotted. For example, to plot properties for
Well 5, you would set the class to Well and the item number to 5.
■ Select the layer to be plotted, for models that have layer data present.
Plotting
The following list is a summary of the plotting features offered by the PlotView
software. These features are covered in more detail in Chapter 3.
■ Plot multiple traces in a single window.
■ Plot the same or different data in multiple displays.
■ Compare traces from the same database or different databases, the same case
or different cases, the same class or different classes, etc.
■ Set broadcast and focus controls for creating or manipulating data in multiple
displays.
■ Remove any plot from any display.
■ Step through various plots in a complex multi-plot display.
■ Switch focus from one plot display to the next.
■ Change the attributes of any trace.
■ View the data in a plotted trace.
■ Produce hardcopy of any plot display, either as a PostScript or CGM file.
■ Close any plot display individually, or quit and close all at once.
Display Control
The following list is a summary of the display control features in PlotView. These
features are covered in more detail in Chapter 4.
■ Set the title to display automatically, based on simulation file data.
■ Change the title to any wording desired.
■ Control title position and display.
■ Control background/foreground colors of the plot display.
■ Change angle, font, label, units, and color of axis annotation text.
■ Show/hide tick marks and grid lines.
■ Reset the min/max range of any axis.
■ Change tick increment.
■ Change legend position.
■ Have the program resize the plots automatically if you shrink or expand the
size of the window.
■ Specify a fixed size for the plot display area, which does not change if the
window is resized (scroll bars appear instead).
■ Zoom in or out of a display.
■ Create annotations in the plot area using text or drawn objects (rectangles,
ellipses, etc.).
■ Save and manipulate screen definitions.
Chapter
2
Getting Started
Introduction
Although PlotView contains a wide array of plotting features, it is fairly simple to
start the program and begin working. This chapter explains:
■ How to start and exit the PlotView program.
■ How to use the PlotView menus and display screen.
■ A quick tutorial on PlotView’s major features.
Before using this chapter, you should be familiar with the general features of the
PlotView program, as explained in Chapter 1.
R5000.0.1 Getting Started 25

Starting and Stopping PlotView

There are two ways to start PlotView as explained below.
Starting from DESKTOP-VIP

If you are currently using DESKTOP-VIP, you can start PlotView from the Output
menu. When you do, the PlotView control panel appears automatically, as shown
in Figure 2.
Starting from the Command Line

If you are not currently using DESKTOP-VIP, you can start PlotView from the
command line in any xterm window. To start PlotView this way:
1. Open an xterm window and move your cursor to it. For example:
xterm &
2. Change your working directory to the location of your data and make sure you
have read/write permission to the data. For example:
cd /usr/jsmith/data
ls -l *.vdb
3. Type the following command:
plotview &
or
plotview -study database_filename.vdb
Either command brings up the Plotview control panel as shown in Figure 2.

You can use the former command if you do not know the name of the file you
want to open (you will have to select the database file from the control panel).
The latter command can be used if you already know the name of the database
file. In this case, the database file will already be selected in the control panel.
You can also use other command line options to run Plotview in batch mode
and generate plotted hardcopy directly from the command line, as explained
in Appendix C.
Quitting PlotView
You can close the PlotView control panel and quit the program by clicking on the
Quit button at the bottom of the PlotView control panel.
26 Getting Started R5000.0.1

Understanding the PlotView Interface

The PlotView software has several major components that let you view and
manipulate plot displays. Once you understand these components, you will
understand how PlotView works.
PlotView Control Panel

When you start PlotView, the first thing you see is a control panel such as the one
shown below. The control panel lets you select the data to be plotted and control
various features in the PlotView display window (discussed next).
Mode control buttons
Add/Edit panel
Other controls
Quit button
Figure 2: The PlotView Control Panel

The major components of the control panel are listed below:
■ Add/Edit panel. This part of the control panel changes, depending on

whether you are in the Add or Edit mode. You can change modes by clicking
the Add or Edit button at the top of the panel. The Add Panel lets you select
and add new traces to a plot. The Edit Panel lets you selectively modify or
delete previously plotted traces. The buttons in this part of the control panel
let you specify an item of data to be plotted or modified in the plot display
window.
■ Other controls. This part of the control panel never changes. It provides
buttons that let you control the behavior and appearance of the plot display
windows.
<< >> Cycle forward/back through multiple items in a

series (e.g., view the same set of properties at each
well in the database).
Layout Determine the number of plot displays to create on

your screen with New Plot. (e.g. 2 x 2 displays
four plots.)
New Plot Open a new plot display window.
All Plot Broadcast Apply (or do not apply) changes entered on the
control panel to all listening windows.
Menus On / Menus Off Turn on and off the menu bar and tool bar in the
currently focused window.
Cycle Plot Focus Switch the focus from one plot display window to
the next.
Plots... Display list of plots where you can turn them on or

off.
Screen Definition... Save and reload screen definition files that

represent a specific screen layout.
Print... Create hardcopy of all plots as they appear on the

screen.
Calculator... Display plot calculator for loading traces to

calculate.
Annotation Editor... Open the Annotation Editor panel, which lets you
add graphics or text to a plot.
Quit Close all display windows and the control panel,

then turns off the PlotView program.

PlotView Display Window(s)

You can use the control panel to display plotted well curves in one or more display
windows like the one below. To display a plot, you must select the desired file,
case, class, property, and item from the Add panel, then click the Add Left or Add
Right button (see procedures on page 43).
Pull-down menus Zoom and broadcast controls Title Current X/Y Values
Axis annotations Trace Legend
Figure 3: Example of Trace Plotted in a Display Window
Each PlotView display window has the following components:
Pull-Down Menus
Two major pull-down menus let you control various aspects of the display:
❑ File menu lets you print the current plot or close the display.
❑ Plots menu lets you edit attributes for traces or axis annotations, or
general attributes of the plot display such as font, color, and size.

Tool Bar
Several buttons along the top edge let you zoom the display and focus it in various
ways.
Listen button lets the window “listen” for new traces or editing
changes broadcast from the control panel. This only works if the
Broadcasting button is turned on in the control panel.
Zoom in button lets you zoom in on part of a trace by dragging the

pointer across the area to be magnified and then letting go of the
mouse button.
Zoom out button returns the display to its previous magnification.
You can control the display of the tool bar and pull-down menus (i.e., turn them
on or off) using the Toggle Menu/Tool Bar button on the control panel.
Title
A title at the top of the display indicates the case study, well, and other identifying
information about the current display. The title is generated automatically, based
on the contents of the simulation database file and currently plotted data.
However, you can use the Plots menu to control the title wording, position, and
font.
Current X/Y Values
These two fields show the current X and Y values, respectively, at the current
mouse position. As you move the mouse across the plot area, these two values
change dynamically.
Axis Annotation
User-definable axis annotations may appear on either side and along the bottom of
the plot display. The X axis usually shows the simulation time and the Y axes
show the type and range of values in the plotted data. You can use the Plots menu
to change the axis attributes, including the scale type, tick marks, grid lines,
annotation font, color, and angle, scale units, scale range, and label. You can also
use the Trace and Axis pop-up menus to edit trace or axis attributes.

Traces
The curves plotted in the display window are called traces. There may be two
types of data associated with a trace:
■ Observed or historical data are shown as free-floating data points in the

vicinity of the trace.
■ Simulation data points are connected by a line that can be set to connect the
points linearly or in a stepwise fashion. The line can also be eliminated
altogether.
You can use the Traces option on the Plots menu to change the attributes of a
trace, including the color, line style, thickness, data point symbol/color, and Y axis
used. You can also use the Trace Menu (pop-up) described below to edit attributes
or view data values in a trace.
Legend
A color-coded legend shows which curves are plotted. You can use the Plot option
on the Plots menu to change the position of the legend in relation to the plot
display.
Pop-Up Menus
There are three hidden pop-up menus defined for traces and axis annotation.
■ Trace menu opens when you point to a specific trace and hold down MB3.
This menu provides the following options:
Editable Switch trace properties from editable to non-editable.
Trace Attributes Change the trace attributes including color and style.
Legend Label Display the Trace Legend panel.
Delete Delete the current trace.
■ Plot menu opens when you point to the middle of the plotting area and hold
down MB3. This menu provides the following options:
Menus Toggle menu bar on or off.
Duplicate Duplicate the plot window.
Attributes Change the plot attributes.
Fonts Change the axis fonts.
Data Table Display Trace Data panel with trace data.
Print Display Print Panel for printing the graph.

Control Panel Display Control Panel.
Close Close the current window.
■ Axis menu pops up when you hold down MB3 inside the axis annotation area.
This menu provides the following options:
Minimize Minimize annotation for the selected axis.
Opposite Move the axis to the opposite side of the graph.
Shift Change the Axis order relative to other axes.
Axis Limits Control the axis min/max settings.
Notation Select the axis numeric format.
Precision Set the axis numeric precision.
Edit Attributes Change the axis attributes including color and style.
Axis Label Display Axis Label for editing.

Attribute Panels
For maximum ease-of-use, PlotView provides attribute panels that show all trace,
axis annotation, and font attributes, as shown below.
Figure 4: The Attribute Panels
You can access any of these panels from the Plots menu on the menu bar of any
plot display window. The panel that you bring up this way applies only to the plots
in the window from which it was selected.

PlotView Quick Tutorial

The following steps provide a quick tutorial that will take you through some of the
most commonly used steps in PlotView operation. Procedures in the next chapter
will provide much greater detail on each aspect of PlotView operation. The
following procedure is broken into sections with headings to indicate the different
components of the tutorial.
Add a Plot
1. Click the Add button at the top of the control panel.
2. Click the Study button to open a database file. When the following panel
opens, double-click on the desired database filename to select it. If you do not
see an VDB filename (*.vdb), use the Filter line to enter a pathname (ending
with /*.vdb) and click the Filter button, then double-click the desired
filename.

3. When you select a file from this panel, notice that PlotView automatically
selects a default Case, Class, Property, Item, and Layer as indicated by the
other parameters on the control panel. If these are not the parameters you want
plotted, you can click any of these buttons to select the desired ones.
Data selection parameters
Editable option
4. Select Well as the Class, so that you can view properties for different wells.
5. Click the Add Left or Add Right button to create the plot.
Either button causes PlotView to plot a trace with Y-axis annotation stacked
along the left or right edge of the graph (depending on which button you
pressed). The trace is plotted in a new plot window (or the currently focused
plot window, if one already exists). The simulation data is connected by a line.
If there is any observed data for this property in the database, the observed
data appears as unconnected points on the display.
6. Use the Property button to select several different properties. After selecting
each one, click the Add Left or Add Right buttons to add a trace for that
property to the plot window display.
7. Use the Add Special button to duplicate all traces in an active plot. The
duplicates are created with the selected file and case names.

View/Edit Trace Parameters

1. Click the Edit button at the top of the control panel. This changes the top half
of the control panel to an Edit Panel so that you can apply changes to the
various data parameters or delete individual traces.
2. Click or drag the Trace slider at the top of the control panel to “highlight” the
various traces in the current window.
Notice that as you change the number on the Trace slider, the corresponding
trace lights up in the current window. Also, the parameters (file/case/class/
etc.) change to reflect the parameters of the currently selected trace.
3. Now press the double-arrow buttons on the control panel to “cycle through”
the various items. Since you selected Well as the data class earlier in this
tutorial, this step lets you consecutively view the same properties at each well.
4. Use the Trace slider again to highlight a specific trace, then click the Delete
Current Trace button to remove the currently highlighted trace from the
current display window. You can also hold down MB3 over the trace to pop-
up the Trace Menu and select Delete.

Use the Pop-Up Menus

1. Hold down MB3 on any trace to see the Trace menu pop up.
2. Select Trace Attributes from the Trace menu. This displays the Trace
Attribute panel shown below (click OK to dismiss it).
3. Press and hold MB3 on any axis annotation area to view the Axis menu
shown below.
4. Select Notation/Integer then select Notation/Float from the Axis menu.

Notice how the axis annotation changes from an integer to a decimal number.
5. Select Precision/+0 twice on the Axis menu.
Notice how this adds zeros behind the decimal on the axis notation.
6. Select Precision/-0 twice.
Notice how this takes away the zeros.

Use the Attribute Panels

1. Select both the Axis and Traces option from the Plots menu on the menu bar
in the current window. To do this, click open the Plots menu then click Axis or
Trace.
Notice that both panels are now open, showing all the attributes for every axis
and trace in the current display. Use the scroll bars to view the entire table of
values.
2. Press and hold down MB3 in any column with the word color in the heading
and notice the list of available colors. Select any color, then notice how it is
applied to the display. You can also explicitly type in a color (those that are
listed and also many additional colors).
3. Try this with other cells in the panel.
4. Open other panels on the Plots menu and study them.
Add Windows and Make Them Listen

1. Click the New Plot button on the control panel again. Notice that this adds
another empty window to the display.
2. Click the Add button at the top of the main control panel, then follow steps 4
through 6 to add traces to the new plot.
3. Use the Listen button (far left on tool bar) in each selected window to turn
listening on or off. The selected windows are now in Listening mode. Any
changes on the Edit Panel when the All Plot Broadcast button is on will be
applied to all listening windows.

Add Multiple Traces

1. Once you have turned on listening in all windows, turn on the All Plot
Broadcast button on the control panel to broadcast to all traces. Then select a
new property and click the Add Left button to add the same trace to both
windows.
2. Use the Property button on the control panel to change the Property and now
click the Add Right button.
Notice that the new property is added to both windows, plotted against the
right Y axis.
3. Click inside the plot area of either display window to bring it into focus.
Notice that the entire plot area is circled with a red outline, indicating it is the
“focused” or “current” window.
4. Click the Cycle Plot Focus button on the control panel, and notice how each
separate display comes to the front. The focus shifts from one display to the
next with each click of this button.
5. Press the Case button on the control panel. The Add Case List panel is
displayed. Select a different case (if available) and press OK. Press the Add
Special button on the control panel. Case 1 and case 2 appear on the same
screen.
6. Press the Calculator button on the control panel. The Plot Calculator is
displayed.
The Plot Calculator is used to make calculations among traces. To dismiss the
Plot Calculator, click OK to accept entries, or Cancel to cancel entries.

Close a Display
1. Select Close from the File menu of the window to be closed. Or use MB3 to
popup the plot window in an empty part of the plot window and select Close.
Notice that the window closes automatically.
2. Click the Quit button at the bottom of the control panel to close all windows
and exit the program.
This tutorial has demonstrated the main features of the PlotView software, but not
all of them. Read the following chapters in this manual to learn about all PlotView
features in more detail.

Chapter
3
Plotting the Data
Introduction
Now that you understand how to start and stop PlotView and use its basic features,
you may be interested in learning in more detail about each of the tasks you can
perform using the program, including:
■ General guidelines for using PlotView.
■ Preparing data to be plotted.
■ Creating new plots (adding or removing traces).
■ Comparing data through simultaneous plots.
■ Getting information about displayed traces, including data values and

attributes.
■ Changing the plotted traces, including individual or multiple traces.
■ Broadcasting changes to one or more plot windows.
This chapter explains each of the tasks listed above in more detail. Before reading
this chapter, be sure you understand the material explained in “Understanding the
PlotView Interface” on page 27.
R5000.0.1 Plotting the Data 41

General Guidelines for Plotting Data

The following general guidelines will help you get the best results when using
PlotView for any purpose.
■ Make sure you have simulation data available in the correct VIP database
format (*.vdb). If not, you may have to run a simulation, then use the data
conversion procedure explained in Appendix B before using PlotView.
■ Remember you will only see the PlotView control panel at first. You will not
see plot display windows until you start selecting data and plotting it.
■ If you plan to create multiple plot displays, use the New Plot button to add
empty display windows to the screen for each separate plot display you will
need.
■ When you are ready to start plotting data, use the Add Panel to add plots to
the windows.
■ If you plan to do something to a specific plot like adding or editing the data in
it, always click inside the plot area to bring it “into focus” (as indicated by a
red border around the plot area of the window). Or use the Cycle Plot Focus
button on the control panel to cycle the focus through multiple plot displays.
Then turn off the All Plot Broadcast button so your changes are not applied
to other windows.
■ Do not turn on the All Plot Broadcast button unless you want your control
panel operations to apply to multiple windows. When the Broadcast button is
on, your control panel operations will only apply to windows that are
“listening” as indicated by the Listen button on the tool bar in each window.
■ Use the Edit Panel only to modify or delete traces in various plot displays.
Click the Edit button at the top of the control panel to activate this feature.
As mentioned above, these are only general guidelines for using PlotView. More
specific procedures are listed on the following pages.
42 Plotting the Data R5000.0.1

Creating New Plots

The purpose of PlotView is to plot simulation data on the screen. The following
procedures explain how to select the data to be plotted, and then plot the data in
one or more display windows.
Selecting Data To Be Plotted

To display a plot on the screen, you must specify the file, case study, data class,
property, and item to be plotted. For example, you may want to plot the CGI
(property) from Well No. 5 (class/item) in case study B5 which is located in
database file simudata.vdb. Use the following procedure to make these selections:
1. Make sure PlotView is started with the control panel displayed on the screen.
2. Make sure the Add Panel is visible, as shown below. If not, click the Add
button at the top of the control panel, to display it.
Data selection area
Editable options
Plot controls
Figure 5: The Add Panel

3. Click the File button. This brings up the File Selection panel shown below.
Filter (pathname/wildcard
specification)
Filename selection list

Directory selection list
Filename can be
entered here (click OK)
Control buttons
Figure 6: File Selection Panel
4. Select the name of the simulation data file you want to use for plotting data.
This must be an VDB database file (*.vdb), as explained earlier in this chapter
(see “General Guidelines for Plotting Data” on page 42). If the data is not in
VDB format, click Cancel and convert the data using the procedures in
Appendix B. If you do not see the desired VDB filename in the filename
selection list, you can navigate to other directories by double-clicking the
directory name. You can also type a different pathname on the Filter line at
the top of the panel, then click the Filter button.
Once you see the desired filename in this panel, the easiest way to select it is
to double-click it. You can also click it once (or type it at the end of the
Selection line), then click the OK button.
When you select a filename, the name appears on the PlotView control panel
next to the File button. PlotView automatically selects a default case, data
class, property and item, then displays each in its appropriate slot on the
control panel. You can select different ones using the following steps.
5. If there is more than one case study available, the following panel appears
automatically. Otherwise, click the Case button on the control panel if you
want to select a case study.

Figure 7: Case Selection List
6. Select the desired case study name, then click the OK button. Notice that you
can use the Apply button instead if you wish to leave this panel open while
you work.
NOTE: On any panel with multiple selections, you can double-click a single item to
select it, or select multiple items by dragging MB1 across the list, then
pressing OK.
7. To select a different data class, click the Class button on the control panel.
This brings up the Class selection list, as shown below.
Figure 8: Class Selection List

8. Select the desired data class, then click the OK button.(You can use the Apply
button instead to leave this panel open while you work.)
Typical classes are listed in the following table. The classes available for
selection depend on the contents of your simulation database. If the database
does not contain data for a given data class, the class will not appear in the
list.
Table 1: Data Classes In PlotView
Class Meaning
AREA Plot data for a specific area.
FIELD Plot data for field-wide properties
FLOSTA Plot data for a specific flow station.
GATHER Plot data for a specific gathering center.
REGION Plot data for region-wide properties.
WELL Plot data for a specific well.
WELLYR Plot data for a specific well layer.
9. To select a different property, click the Property button on the control panel.
This brings up the Property selection list, as shown below.
Figure 9: The Property Selection List

10. Select the desired property to be plotted, then click the OK button (or use the
Apply button if you wish to leave this panel open while you work).
The list of properties shown on this panel varies considerably with the class of
data you are viewing and the type of simulator that produced the data. For a
comprehensive list of available properties, see Appendix A of this manual. If
a desired property does not appear in this list, it means that the property was
not calculated by the simulation and is not available in the database file
selected in step 4.
Using Wildcards: In the field at the bottom of this screen, you can use a
wildcard (*) to select properties. Example: Entering CU* selects all properties
beginning with CU.
Prepend the wildcard with !1 to select property abbreviations in the first

column, e.g. !1 Q* selects all RATE properties when the enter key is pressed.
11. To select a different item, click the Item button on the control panel. This
brings up an Item selection list, as shown below.
Figure 10: Item Selection List
The items in this panel are the available items in the data class selected earlier.
For example, the above illustration shows a list of wells because WELL was
selected as the class. If you had selected GATHER as the class, this list would
show the available gathering centers in the database. If you selected FLOSTA,
the list would show available flow stations, and so forth.

12. Select the desired item to be plotted, then click the OK button (or use the
Apply button if you wish to leave this panel open while you work.)
Using Wildcards: To locate certain items, you may want to use the *
wildcard. For example, to select all items beginning with the letter C, type
“C*” in the field at the bottom of the list. To select all items beginning with
CU, type “CU*” in the field.
Prepend the wildcard with !1 to select item numbers in the first column.
13. If there is layer data in the model, you can select a different layer by clicking
the Layer button on the control panel. This brings up Layer selection list,
showing the available layers in the model, if any.
14. Select the desired layer to be plotted, then click the OK button (or use the
Apply button if you wish to leave this panel open while you work.)
15. Use the Trace Editable button on the control panel to determine whether the
trace is to be editable or not.
If you turn off this button, it means that any changes later broadcast from the
control panel will not affect the trace created from this group of selected
parameters. If you turn on this button, it means that the trace will be able to
accept changes broadcast from the control panel. You can also set the Editable
feature on/off by using the MB3 pop-up menu on a trace.

Plotting a Trace In a Single Window

Once you have selected the appropriate data as described earlier, you should see
the desired filename, case study, class, item, property and layer on the control
panel. Now you are ready to plot the data. The following procedure explains how
to plot a single trace in a single window. Later procedures will explain how to plot
a trace to multiple windows simultaneously.
1. If more than one plot window is open, click inside the plot area of the desired
window to place it “in focus” (indicated by a red line around the inside edge).
You can also use the Cycle Plot Focus button on the control panel to cycle the
focus through multiple plot displays.
If no plot windows are open, the next step will open one automatically. To
open an extra window manually, use the New Plot button on the control
panel.
2. Turn off the All Plot Broadcast toggle on the control panel.
3. Click the Add Left or Add Right button on the control panel. Add Left plots
the data against the left Y axis. Add Right plots it against the right Y axis.
Broadcast button (off)
Figure 11: Plotting a Trace in a Single Window

Adding the Same Trace to Multiple Displays

Occasionally, you may want to add the same trace to more than one display. For
example, you may have a plot that serves as a base case and want to set it up in
multiple windows so you can compare other plots to it.
The Plot Broadcast feature makes it easy to add the same trace to multiple
displays simultaneously. When you add a trace by broadcasting, it is added to all
the windows that have the Listen feature turned on. You can make a window listen
by turning on the Listen button in the tool bar of the window. Follow these steps:
1. Open as many windows as desired by clicking the New Plot button once for
each additional display window. For example, if you want to set up three
separate views containing the same data, click New Plot once for each
separate view. You can also use the Duplicate option on the File menu in any
window to create duplicate copies of that window.
2. Notice that the Listen button is already on in the new windows. If you already
have windows open that you want to receive the same additions or changes,
turn on the Listen button in them as well.
3. Click the Add button at the top of the control panel to make sure the Add
Panel is visible.
4. Select the desired database File, Case, Class, Property, and Item in the
control panel (see “Selecting Data To Be Plotted” on page 43).
5. Use the Editable option on the control panel to indicate whether you want to
be able to change this trace at a later time.
6. Turn on the All Plot Broadcast button near the bottom of the control panel.
7. Click Add Left or Add Right to add the trace to the active displays,
depending on whether you want the Y value plotted against the left or right
axis.
The trace is added automatically to all windows that are listening.
Cross-Plotting Different Values

Normally the X Axis of any plot display is set to Time, so that all values are
plotted against time. However, you can change the X axis to a value other than
time for a specific trace, or for all traces in a plot. Use the procedure below:
1. Set the focus to the window where you want to change the X axis. You can do
this by clicking in the plot area of the window, or by using the Cycle Plot
Focus button to bring the window to the front.

2. Make sure the first value is already plotted.
For instance, if you want to plot bottom-hole pressure versus cumulative

water injection, add one of these properties to the plot and then use the
remaining steps to plot the other value on the X axis. If you want to plot
multiple values versus bottom-hole pressure, make sure all the values are
plotted first, then use the remaining steps to plot bottom-hole pressure on the
X axis.
3. Click the Set X Axis button on the main control panel. This displays the
X Axis Property selection panel.
Figure 12: X Axis Property Selection Panel
4. To plot a certain property against one of the traces, set the Trace slider on the
control panel to the desired trace, select the property in this dialog, and then
click the Apply button. This adds the selected property to the X axis.
5. To plot a certain property against all of the traces, click the Apply All button.
This adds the selected property to the X axis and removes Time from the axis.
6. Click the OK button when you are finished to close the panel.

Comparing Data Using Overlaid Traces

You can continue adding traces to the same display, if you want to compare data
from different wells, case studies, or time periods. For example, you may want to:
■ Compare actual production data to simulated data from the same well or
group of wells.
■ Compare simulation data for the same well that was generated using different
case studies.
■ Compare different gas, oil, or water properties for the same well, gathering
center, or field.
■ Compare production data (same property) at different wells.
These are just a few examples. As you start using PlotView to its fullest, you will
undoubtedly discover many other ways to compare data. Use the following steps
for each plot that you want to add to a display:
1. Make sure the Add Panel is displayed by clicking the Add button at the top
of the PlotView control panel.
2. Make sure the desired plot window is in focus by clicking anywhere inside the
plot area (inside border should be red). You can also use the Cycle Plot Focus
button on the control panel to cycle the focus through multiple plot displays.
3. Change the database File, Case, Class, Property, Item or Layer in the
control panel, as needed to select the data to be plotted.
4. Use the Editable option on the control panel to indicate whether you want to
be able to change this trace at a later time.
5. Click Add Left or Add Right to add it to the current display, plotted against
the left or right axis.

Cycling Through All Available Items in the Database

Once you have a set of properties displayed on the screen for a given item in a
data class, PlotView lets you easily see the same properties plotted for all other
available items in that class. To do this:
1. Click anywhere inside the plot area of the display window where you want to
perform this action. You can also use the Cycle Plot Focus button on the
control panel to cycle the focus through multiple plot displays.
2. Use the left or right double-arrow button (<</>>) to increase or decrease

the item number or layer, if layer data is present.
For example, if you have a property such as CWI plotted for Well 1 and you press
the right double-arrow button, the plotted trace will change to show you how CWI
looks for Well 2, Well 3, and so forth. If you press the left double-arrow button,
this moves back through all the wells in reverse order.
If you have more than one class plotted in the same display, clicking the double-
arrow buttons cycles through all items in one class, then all items in the other
classes until all items have been displayed from all classes. If you have multiple
traces plotted for the same item, it replots all the traces simultaneously as you
cycle to the next/previous item.
Cycling Through All Available Windows

Normally, you must bring a window into focus to make changes to it. The window
currently in focus is indicated by a red border around the inside edge. There are
two ways to bring a window into focus:
■ Click anywhere inside the display area of the window.
■ Click the Cycle Plot Focus button on the control panel, and notice how each
separate display comes to the front. The focus shifts from one display to the
next with each click of this button.

Removing Traces from a Display

At some point, you may want to clear individual traces from a display window
without closing the window entirely. You can easily delete a trace by holding the
MB3 button over it in the plot window, then selecting Delete from the pop-up
menu. You can also use the following steps to remove traces from a display:
1. Click anywhere inside the plot area of the window where you want to remove
the trace. A red border should appear inside the window. You can also use the
Cycle Plot Focus button on the control panel to cycle the focus through
multiple plot displays.
2. Click the Edit button at the top of the control panel to display the Edit Panel
shown below.
Trace selection
Delete buttons
Figure 13: Edit Panel Delete Buttons
3. Select the trace to be deleted using the Trace slider at the top of the Edit
Panel, or click on the trace to select it.
4. Click the Delete Current Trace button at the bottom of the Edit Panel to
delete the selected trace.
5. Repeat the last two steps for each additional trace you want to delete in the
same window, if any. To remove all traces from the current display window,
click the Delete All Traces button. To delete traces in a different window,
start over at step 1 above.

Closing a Display Window

To close any display window, click inside the plot area to bring it into focus, then
use either of the following methods:
■ Select the Close option from the File menu.
■ Hold down MB3 in any empty part of the plot area and select Close from the
pop-up menu.
This closes the window automatically. The display you created will not be
recoverable.

Analyzing Displayed Traces

There are several ways you can get information about the displayed traces, as
explained in the following procedures.
Reading the Legend and Annotation

At the most basic level, you can readily tell which traces are plotted in a window
by viewing the legend and the axes in the window. The legend provides a color-
coded summary of the traces in the window, and the axes use the same color-
coding to show the type of data plotted and the data scale.
Axis annotations Legend
Figure 14: Reading the Display

Viewing the Trace Attributes

To get more information about the attributes of a trace, select Traces from the
Plots menu or from the Trace pop-up menu. This displays a “spreadsheet”
containing detail attribute information for each trace in the current window. For
example:
Trace 1
Trace 2
etc.
Figure 15: Reading the Trace Attribute Panel
You can use this panel to view or change the trace attributes. The procedure for
changing trace attributes is included later in this chapter (see “Changing
Individual Traces Using the Attributes Panel” on page 64).
Highlighting the Traces

You can also get certain basic information about each trace from the control panel.
To do this:
1. Click inside the plot area containing the desired traces, to bring it into focus.
You can also use the Cycle Plot Focus button on the control panel to cycle the
focus through multiple plot displays.
2. Click the Edit button at the top of the control panel to display the Edit Panel.
Trace Slider

3. Click or drag the Trace slider along the top of the control panel. At each
position of the slider, you will see a different trace number and the
corresponding trace will be highlighted in the display.
When the trace is highlighted in the display, you will see the selected database
filename, case, class, property, and item of the current trace. You will also see
whether the Editable option is on or off for that trace (i.e., whether or not the
trace will accept changes broadcast from the control panel).

Viewing the Trace Data Panel

To view a table showing the data values in all displayed traces:
1. Move the mouse pointer to the trace and hold down MB3 to display the Plot
Menu.
2. Select DataTable from the Plot Menu to display the Trace Data panel shown
below, or use the Traces option on the Spreadsheet menu.
Figure 16: Trace Data Panel
This panel shows the simulation run data and observed data (if any) for each
time step along the X axis, plus the difference (delta) between the values. This
data is read-only and cannot be changed.
3. Use the scroll bars if necessary to view the entire range of values, then select
the Close option from the File menu when finished, or use any of the other
File menu options discussed in the following procedures.

Saving Trace Data to a Separate File

Once you have trace data displayed on the screen, you can easily save it in a file in
a tabular format or in a comma- or tab-delimited format. Use the following steps:
1. Make sure the Trace Data panel is displayed on the screen (Figure 16). If not,
select DataTable from the Plot Menu.
2. Select the Save As option on the File menu in the Trace Data Panel. This
displays the Save File panel.
Figure 17: Save File Panel
3. Select the type of Delimiter you want to be inserted into the file. The data will
be stored in an ASCII file in tabular format, separated by a comma, spaces, or
a tab, depending on your selection.
4. Click at the end of the pathname entered in the Selection box and type the
filename you want to use for saving this file. If you want to save it in a
different directory than the one shown, change the pathname on the Selection
line, or double-click the entries in the Directories list to navigate through the
directory structure to the desired location.
5. Click the OK button when finished.

Saving Trace Data to a PostScript File

Once you have trace data displayed on the screen, you also can save it to a
PostScript file for printing on any PostScript-capable printer or for use in desktop
publishing or presentation applications. The data can be rendered in color or
monochrome and rescaled as desired. Use the following steps:
1. Make sure the Trace Data panel is displayed on the screen (Figure 16). If not,
select DataTable from the Plot Menu.
2. Select the Print option on the File menu in the Trace Data Panel to display the
Print File panel.
Figure 18: Print File Panel
3. Specify the various print options listed at the top of the panel.
Color/ Click on Color if you expect to use a color printer, otherwise click
Monochrome on Monochrome.
Scale Enter the desired scaling. This should be 0 if you want to rescale
the model to fit the output page, or some fraction if you want it
smaller than full page.
Resolution Enter the desired resolution for the PostScript output. Most
PostScript printers are either 300 or 600 dots per inch (dpi).
Height/Width Enter the width and height (in inches) of the output page. For U.S.
printers, this is normally 8.5 wide and 11 high.

4. Click at the end of the pathname entered in the Selection box and type the
filename you want to use for saving this file. If you want to save it in a
different directory than the one shown, change the pathname on the Selection
line, or double-click the entries in the Directories list to navigate through the
directory structure to the desired location.
5. Click the OK button when finished.

Changing the Plotted Traces

Once you have the desired data selected and plotted, you may want to change
individual traces or groups of traces in multiple display windows. The following
procedures explain how.
Changing Individual Traces Using the Control Panel

The Edit Panel lets you change any trace currently plotted in any display window.
There are two ways to do this, from the control panel or from the spreadsheet. To
change an individual trace using the buttons on the control panel, use the
following procedure:
1. If more than one display window is open, click inside the plot area of the
desired window to bring it “into focus” (as indicated by a red border around
the inside edge of the window). You can also use the Cycle Plot Focus button
on the control panel to cycle the focus through multiple plot displays.
2. Click the Edit button at the top of the control panel. This displays the Edit
Panel, as shown below.
Trace selection
Trace data parameters
Editable option
Figure 19: Edit Panel Trace Change Controls
3. Use the Trace slider to select the trace you want to change, then set the
Editable option to Yes for that trace.

4. Use the appropriate Edit Panel options to change the File, Case, Class,
Property, Item or Layer, as desired (see “Selecting Data To Be Plotted” on
page 43). As soon as you make the selection, and click OK or Apply, the
change is made to the window.
Changing Individual Traces Using the Attributes Panel

The following procedure explains how to view and change the attributes of
displayed traces using the Trace Attributes Panel. You can easily change the
appearance of any trace by editing the information in this panel.
1. If more than one display window is open, click inside the plot area of the
desired window to bring it “into focus” (as indicated by a red border around
the inside edge of the window). You can also use the Cycle Plot Focus button
on the control panel to cycle the focus through multiple plot displays.
2. Select the Traces option from the Plots menu. This displays the Trace
Attribute Panel shown below.
Trace 1
Trace 2
etc.
Figure 20: Trace Attribute Panel
This panel contains a separate row for each trace in the plotted display and a
column for each separate attribute. You can tell which trace is which by
looking at the first few columns (especially the Property column).
Highlighting (selecting) a trace in the plot will highlight the corresponding
row in the table. Use the scroll bars to see all available rows and columns, or
make the window larger by dragging on the borders.
NOTE: You can also display this panel by moving the mouse pointer to a specific
trace in the display, then holding down MB3 as you select Trace Attributes
from the pop-up Trace menu. When you use this method, the spreadsheet
panel opens with the row highlighted which pertains to the selected trace.
However, you can still edit any row in the spreadsheet.
3. To change the Case, Class, Property, or Item plotted for any trace, hold down
MB3 over the value to be changed and select the Option selection. Then select
the desired value from the pop-up dialog.

4. To change the appearance of any trace, move the cursor to the appropriate row
and edit the information in the appropriate column of the spreadsheet, as
explained in the following table.
You can move to a cell by clicking on it. You can change the values in some
cells by pointing to the cell with the mouse and holding down MB3 while you
select one of the available options from the pop-up menu. You can also
directly type in a value. Finally, you can set all values in a column to the same
value by using MB3 in the column heading. All changes are immediate.
5. When you are finished making all desired changes to the trace(s), click the
OK button to apply the changes and close the panel.
Table 2: Trace Attributes
Column
Meaning
Heading
File The database file from which the data is derived.
Case The case from which the trace data is derived.
Class The class from which the trace data is derived.
Property The property being plotted.
Item The item being plotted.
Legend Label The notation that appears in the legend for this trace.
Trace type The trace can be plotted as a straight linear graph (XY) or as a
stepped graph (Step).
Color The color coding used for this trace.
Line Style/ The style and width of the line used to draw this trace. Width
Width measurement is in screen pixels.
Point The type, size, and color of the graphic symbol used to indicate
Symbol/Size/ simulation data points for this property. Selecting “off” for the
Color symbol turns off the display of simulation data points.
Obs Pt/Size/ The type, size, and color of the graphic symbol used to indicate
Color observed data points for this property. Selecting “off” for Obs Pt
turns off the display of observed data points.
Vertical/ The value plotted against the vertical and horizontal axis for each
Horizontal trace.
Axis

Broadcasting a Change to Multiple Windows

When you make a change on the Edit Panel, you can broadcast it to all editable
traces in all windows that are “listening.” For example, suppose you want to
change the case study of all plots in all windows. You can do this using the
broadcast buttons features in PlotView. Use the following steps:
1. Click the Edit button at the top of the control panel. This displays the Edit
Panel (Figure 19).
2. Turn on the Listen button in the toolbar just below the menu bar in the
windows where you want changes to be applied.
3. Turn on the All Plot Broadcast toggle button at the bottom of the control
panel.
4. Use the appropriate Edit Panel options to select a different File, Case, Class,
Property, or Item for the selected trace, as desired (see “Selecting Data To Be
Plotted” on page 43). The changes are applied to all windows as soon as you
make the selection.
NOTE: If this is the first time you have used the Edit Panel with the current database
in the current session, you must select the File option first, before selecting
any of the others.

Calculating New Traces

The Plot Calculator allows you to perform arbitrary calculations using the plotted
data from your case studies. The formulas for these calculations are composed,
viewed, stored, and calculated using the Plot Calculator. The result of the
calculation is displayed in the PlotView window.
To access the calculator, press the Calculator button on the PlotView control
panel. The Plot Calculator is displayed:
Understanding the Calculator Keypad

Notice that the Plot Calculator keypad is much like the keypad on any calculator
but with a few added buttons as shown in the figure below. You will use the
keypad with other fields to set up calculations for new traces.
Operators Simulation
Both Observed
Summation Clears formula field.
Average
Minimum
Maximum
Absolute

Some of the special buttons on the keypad are described below.
Button Use
Summation Sum a list of trace values. The result is a vector value.
Average Average a list of trace values. The result is a vector value.
Minimum The minimum value of a trace. The result is a scalar value when
applied to a trace, or a vector value when applied to a list of
traces.
Maximum The maximum value of a trace. The result is a scalar value when
applied to a trace, or a vector value when applied to a list of
traces.
Absolute The absolute trace value. The result is a vector value when
applied to a vector, and a scalar value when applied to a scalar.
Both Include both simulation and observed values of the “Load Trace”
into the “New Trace” formula.
Simulation Include only the simulation trace values.
Observed Include only the observed trace values.
Calculator Operators
The keypad allows you to enter various operators into your calculation
formulas. These are listed and defined below:
< Less than.
> Greater than.
<= Less than or equal to.
>= Greater than or equal to.
== Equal to
!= Not equal
? Asks, “If this is true, then...” It then looks for a true statement
immediately before or after the semicolon (:) which follows.
: Separates two entries, only one of which makes the formula true.
! Boolean NOT
& Boolean AND
| Boolean OR
^ Power

<- Clear last formula segment
- Subtraction
+ Addition
* Multiplication
/ Division
( Open term
) Close term
Understanding How New Traces are Calculated

Each trace in the regular PlotView window is based on a set of data points that
reflect changes in the values of a certain reservoir property over time. For
instance, a plotted trace might represent the Gas Production Rate (QGP) of a
certain well in a certain case study. The Plot Calculator lets you treat this kind data
as an object that can be plugged into a formula, so that you can perform various
arithmetical or logical operations on combinations of traces.
For example, you may want to add two traces together and see the resulting “new
trace” plotted in the PlotView Window. Such a calculation is performed by simply
adding all the data values in one trace to the corresponding values in another trace.
The result is a new set of values that represents the sum of the data values in the
original two traces. When you plot this new set of values, you are simply plotting
the results of the summation.
For example, suppose you want to see the combined cumulative gas production
(CGP) of two separate wells: Well 1 and Well 2. You can use the Plot Calculator to
add the CGP of Well 1 to the CGP of Well 2 and produce a resulting trace that
represents the combined production. The formula might look like this:
[CGP 1]+[CGP 2]
This same basic concept of identifying traces and using them in calculations
applies to nearly any operation you may want to perform. Once a formula is set up
like this, the result of the calculation can be broadcast back to the PlotView
window for viewing.

Understanding How Formulas are Built

The Plot Calculator contains several fields which are used to build formulas and
perform calculations. The central fields in this process are the Load Trace and
New Trace fields.
1. Selected trace appears here. 2. Clicking here adds it to formula.
3. Enter name of new trace. 4. Formula appears here

5. Click here to display result
■ The Load Trace field is used to set up traces that you are about to plug into
calculations. The correct trace can be selected using the lists along the top
edge of the calculator.
■ The New Trace field is where you build the calculation formula. This field is
totally editable, and you can clear it completely using the C button on the
keypad.
■ You can use the equal button (=) in the Load Trace field to add selected traces
to the formula. Or you can use the B, S, or O buttons. If you click the B button
or the Load Trace equal sign, the calculation will use both simulated and
observed data from the trace. If you click S or O instead, the calculation will
use only the simulation data (S), or only the observed data (O).
■ You can use the buttons to the left of the keypad to perform operations on the
selected trace within the context of the formula. For instance, selecting a trace
in the Load Trace field, then pressing MAX, gets the maximum value of the
trace as a scalar value.
■ You can use the calculator keypad to enter numerals and operators to the
formula. You can edit and retype any mistakes.
■ You can specify a name for the new trace by typing it in to the left of the equal
sign (=) in the New Trace field. You can specify a description (axis label/
units) of the new trace by typing it in the Description and Units fields.
■ You can use the blank text fields under Item or Layer to select a group of
items or layers. For instance, entering * and pressing the Enter key selects all
the items or layers in the list.
■ The STO buttons and the field to the right of it are used to store any formulas
or terms that you may want to use later. Pressing the RCL button inserts the
stored term into the formula being built on the New Trace line. You can also

use the Remove button to remove individual formulas from the storage area,
or the Clear button to clear all formulas.
Pressing Store
displays your
formula in this
field.
■ The File buttons to the right of the storage area let you save the stored
formulas in a file, or open a file containing stored formulas.
■ You can use the equal button (=) on the calculator keypad or the equal button
next to the New Trace field to view the trace that is calculated from the final
formula entered in the New Trace field.
Calculating a New Trace

The following procedure provides step-by-step instructions on how to set up a
calculation in the Plot Calculator window:
1. Use the lists along the top edge of the Plot Calculator to select a trace to be
plugged into your formula. Selected items appear in the LoadTrace text fields.
A name is automatically generated for the selected item, however, you can
modify this name at your discretion. Traces that are loaded into a new formula
must have unique names.
2. Selected trace name appears here. 3. Clicking here adds it to formula.
7. Enter name of new trace. 3,4. Formula appears here

8. Click here to display result
2. Click the = button to the right of the Load Trace field to add the selected trace
to the formula. Alternately, you may use the O button (for observed data only)
or the S button (for simulation data only). The name of the trace you are
loading is inserted in the second field to the right of New Trace at the insertion
cursor. Inserted traces must have unique names in the formula.
3. Click any operator on the keypad. The operator appears in sequence (or at
cursor position) in the second field to the right of New Trace.
4. Select another trace to be added to the formula, then add it to the New Trace
field using the first equal button (=) or the S/O keys.

5. Continue selecting traces and operators as needed.
6. Enter the name of the new trace in the New Trace field, to the left of the equal
sign (=). Enter a description for the new trace in the Description field.
7. When you are ready to see the result of the formula, click the equal sign (=) in
the New Trace field. The new trace is displayed in the current plot or a new
plot is created for it if necessary. Notice how the New Trace name is shown in
the plot legend, and the Description/Units are shown along the Y axis.
8. To store your formula, click the STO button. Your formula is displayed in the
large field on the bottom right. You can continue to build and store formulas,
then add them back into the formula being built by hitting the RCL button.
9. To save the stored formula(s), press the Save button and give it a filename.
Once saved, when you want to reuse the formula to calculate traces, you can
access Plot Calculator, press Open, select the file and have the formulas
reloaded into the storage area of the Plot Calculator, where you can recall
them (RCL) for plotting.
Examples of Calculated Traces

Example 1: Compare the simulated and observed histories of QOP J1. To do this,
you will subtract the observed data from the simulated data using the following
formula:
[QOP1]SIM-[QOP1]OBS
To build this formula:
1. Select QOP for item 1 from the lists at the top of the Plot Calculator window.
2. Click the S, -, and letter O buttons.
3. Enter “QOP Match” in the New Trace name field.
Formula appears here.
4. Click the = button on the keypad or next to the New Trace field to view the
results.
Example 2: Compare simulation to observed data for a COP trace. If the observed
data is greater, use the simulation data, otherwise use the observed data. This is
expressed using the following formula:
[COP 1]SIM<[COP 1]OBS?[COP 1]SIM:[COP 1]OBS
where the question mark (?) means “If the previous is true, then...” and the colon
symbol (:) means “else.”

To build this formula:
1. Select COP for item 1 from the lists at the top of the Plot Calculator window.
2. Click the following buttons: S, <, O, ?, S, :, O.
3. Enter “QOP Compare” in the New Trace name field.
4. Click the = button on the keypad to view the results.
Example 3 - Create a new property. Calculate the fraction of total oil produced
from a well using the following formula:
[QOP1]/[QOPLIST].SUM
This formula takes the QOP from a selected well and divides it by the QOP from
all wells in the list. To build this formula:
1. Select the well in the Item field and then select QOP from the Property field.
2. Click the Load Trace (=) button to load this into the New Trace field.
3. Click the / button in the calculator keypad.
4. Enter * in the text field below the Item list and press the Enter key. This
selects all items and shows the selection as QOPLIST in the Load Trace field.
5. Click the Load Trace (=) button to add the QOPLIST to the formula being
built in the New Trace field.
6. Click the SUM button to indicate you want the sum of QOPLIST.
7. Enter QOPfrac as the New Trace name (left of = button).
8. Enter ‘FRACTION OF TOTAL OIL PRODUCED’ as the Description.
9. Enter FRACTION for the Units.
10. Click the = button on the keypad to view the resulting trace.


Chapter
4
Introduction
Now that you have plotted the data, there are various features you can use to
improve the appearance of the data on the screen, including:
■ Changing the axis scaling, labels, or other attributes.
■ Adding annotation text and graphics to the plot.
■ Changing window attributes, such as the title, legend, and others.
■ Capturing an image for hardcopy printing or presentation.
This chapter explains each of the tasks listed above in more detail. Before reading
this chapter, be sure you understand the material explained under “Understanding
the PlotView Interface” on page 27.
R5000.0.1 Enhancing the Display 75

Changing the Layout of the Display

PlotView provides a number of options that you can use to change the layout of
the display, including the:
■ Axis scaling and labeling.
■ Trace attributes, such as color and plotting symbol.
■ Legend
■ Title
■ Foreground/background colors
Each of the major change options are discussed in more detail on the following
pages.
Changing Axis Scaling, Labels, or Other Attributes

The following procedure explains how to view and change the attributes of any
axis in a display window using the spreadsheet designed for this purpose. Follow
these steps:
1. Select the Axis option from the Plots menu in the window where you want to
make the change. This displays the Axis Attribute panel shown below.
Axis 1
Axis 2
etc.
Figure 21: Axis Attribute Panel
This panel contains a separate row for each axis in the plotted display. You
can tell which axis is which by looking at the Label column.
NOTE: You can also display the panel by moving the mouse to any axis, holding
down MB3, and selecting Edit Attributes from the pop-up menu.
2. To change the appearance of any axis, move the mouse pointer to the
appropriate row and edit the appropriate column, as explained in the
following table. You can move to a cell by clicking on it or by pressing the
Tab key until the cursor is focused on it. You can change the values in some
76 Enhancing the Display R5000.0.1

cells by pointing to the cell with the mouse and holding down MB3 while you
select one of the available options from the pop-up menu. You can also
directly type in a value. All changes are immediate.
Table 3: Axis Attributes
Column
Meaning
Heading
Axis Type The method of scaling the X and Y axes (linear scale or
logarithmic scale).
Label The label for the current axis (e.g., CUMULATIVE OIL
PRODUCTION). Selecting the Customize option from the pop-up
menu displays a small window you can use to edit the label text.
Units The units displayed for the current axis (e.g., MSTB).
Min The minimum scale value for the current axis. If this is changed,
the plotted trace that depends on this axis will be rescaled
automatically to match the new minimum-maximum range. These
can only be changed after you set the Axis Limits value to User
(below). To change, you can select +increment or -increment
from the pop-up menu.
Max The maximum scale value for the current axis. If this is changed,
the plotted trace that depends on this axis will be rescaled
automatically to match the new minimum-maximum range. These
can only be changed after you set the Axis Limits value to User
(below). To change, you can select +increment or -increment
from the pop-up menu.
Axis Limits MB3 displays the three options below:
Data Sets the axis limits to what exists in the data.
Auto Indicates limits are automatically computed based on attached

trace data.
User Indicates limits will be set by the user. Be sure to change the Min/
Max columns to the desired min/max value.
Freeze Freezes the axis limits. If set to On, Axis Limits is set to User; if
set to Off, Axis Limits is set to Auto.
Mult Factor A multiplication factor used to express axis values in either

positive or negative exponential notation.
Increments The increment of tick marks along the current axis. If set to
dynamic, Major Increments is set to dynamic.
Major Incr The major increment of tick marks along current axis. If set to
auto, Increments is set to dynamic.

Table 3: Axis Attributes
Column
Meaning
Heading
Text Angle The desired angular orientation for the axis scale annotations in
relation to the axis itself (0=horizontal, 45 = diagonal, 90 =
vertical).
Color Color of the text used for axis scale annotation.
Ticks Indicates whether you want minor tick marks on or off along
current axis.
Span The percentage of window area used to display the plot.
Axis Grids Indicates whether you want the plot to show background major
grid lines corresponding to this axis (i.e., grid on or grid off).
Axis Orient The location of the current axis in relation to the overall plot
display (left/right/top/bottom).
3. When you are finished making all desired changes to the axes in the current
display, click the OK button to close the panel.

Changing the Axis Notation Type or Precision

You can also use the MB3 pop-up Axis menu to reset the axis notation or
precision. The axis notation may be shown as an exponential number, a floating
point number, an integer, or a dynamic setting in which PlotView selects the
shortest appropriate format for the value. The precision option lets you add or
subtract decimal positions from floating point or exponential numbers (the default
precision is two decimal positions). To reset the notation or precision:
1. Move the mouse pointer to the axis you want to change.
2. Hold down the MB3 button to display the pop-up Axis menu.
3. Move the pointer to the Notation or Precision option. This displays a

submenu containing the Notation or Precision options.
4. Select the desired option, then let go of MB3. The axis is reset automatically.
For example, if you selected Notation/Integer, the axis numbers are changed
automatically to integers. Selecting Precision/+0 increases the number of
decimal positions in floating point or exponential numbers. Selecting
Precision/–0 decreases the number of decimal positions in these types of
numbers.
Minimizing/Maximizing the Axis

If desired, you can create more room on the plot display by minimizing the axis.
When you minimize an axis, the scale annotations still remain in the window. To
minimize or maximize the axis:
1. Move the mouse pointer to the axis you want to change.
2. Hold down the MB3 button to display the pop-up Axis menu.
3. Move the pointer to the Minimize option. If the axis is already minimized,
this option maximizes it to the original plot display.

Changing the Plot Attributes

PlotView lets you change various components in the overall layout of a plot
display window, including the:
■ Window title and title location
■ Legend content (case, class, etc.), placement (inside or outside of the graph)
and position (top, bottom, left right, etc.).
■ Text fonts for all window components.
■ Foreground and background colors of the plot display area.
■ Window size.
These options are especially useful when preparing a plot for hardcopy
presentation, since they let you control every aspect of the plot’s appearance. The
following procedures explain how to set each of these options.
Setting Up the Title and Legend
The following procedures explain how to change each of these window layout
attributes.
1. Select the Attributes option from the Plots menu in the window you want to
change. This displays the Plot Attribute panel shown in the following
illustration.

Figure 22: The Plot Attributes Panel

2. Notice that this window lets you edit or change the Plot Title, Axis Label, and
Legend, including the Location and relative Placement of the legend. See the
following table to determine how to edit each different component shown
here.
Table 4: Plot Attribute Panel Fields and Buttons
Field or
How to Use
Button
Plot Title You can edit this or click on any of the buttons below it to
insert variables into the plot title.
Trace Select exclusive if you only want macros expanded to a

Values value when all the traces in the plot have the same macro
value. Select inclusive to have macros expanded to include
all unique plot trace macro values. An ampersand (&) before
a macro name indicates exclusive expansion. A percent (%)
before a macro name indicates inclusive expansion.
Placement Select the desired position of the plot title in relation to the
plot window. The title position may be Top or Bottom.
Select the Off option if you do not want a title displayed.
Axis Label You can edit the label manually or click on any of the buttons
below it to insert variables.
Axis Select exclusive if you only want macros expanded to a

Values value when all the traces of the axis have the same macro
Legend You can edit the label manually or click on any of the buttons
Entry below it to insert variables.

Table 4: Plot Attribute Panel Fields and Buttons
Field or
How to Use
Button
Legend Select exclusive if you only want macros expanded to a

Values value when all the trace attributes have the same macro
Location Use the N, E, S, W buttons to indicate the position of the
legend, relative to the plot area. These buttons represent
directions of the compass relative to the display window (N
is the top, W is the left, etc.). Pressing a corner button puts
the legend in a corner; pressing the center button puts it in
the center; pressing an edge button places it on the edge; and
so forth.
Placement Use to indicate the placement of the legend relative to the

rest of the display window. The legend may be placed Inside
the graph or Outside the graph, or in a Separate Window.
Select the Off option if you do not want the legend
displayed.
3. Click the Apply button if you want to test various setting before closing this
window, or OK if you want to apply the settings and close the window.
Clicking the Cancel button closes the window without applying the latest
settings.
Changing the Fonts
You can change the font of any text in the plot display window, including the
following component:
■ Plot title or legend.
■ Axis label and scale annotations for each plotted variable.
The following procedure explains how to change the fonts for a given plot
window display.
1. Select the Fonts option from the Plots menu in the plot window you want to
change. This displays the Font Panel shown in the following illustration.

Figure 23: Font Panel
2. Examine the displayed table in the Font Panel. It contains current settings for
each of the text components in the plot window. These include:
❑ Family (Helvetica, Times Roman, etc.).
❑ Slant (roman, italic, etc.).
❑ Weight (bold, normal).
❑ Width (normal),
❑ Size (in points).
❑ Scale (on, off) automatically scales font according to size.
❑ Name (based on available names of fonts in your system).
3. To change any value in any table cell, move the mouse pointer into the cell,
then click and hold down MB3 while you select the new value from the pop-
up menu. Use MB3 over the column label if you want to set all cells in a
column to the same value.
4. Click the OK button when you are finished changing the font information.
Setting the Plot Size
You can set the height or width of the current plot window, or have it set
automatically when you resize the display. Use the following procedure:
1. Select the Size option from the Plots menu in the plot window you want to
change. This displays the Plot Size Panel shown in the following illustration.

Figure 24: Plot Size Panel
2. Turn on the Auto Sizing button if you want the plot to be sized automatically
based on the window size. Or use the sliders to set the desired width and
height of the window (in pixels), if Auto Sizing is turned off.
3. Click the Apply button if you want to test how the size is affected by your
settings, or click the OK button to apply the settings and close this panel.
Clicking Cancel will close the panel without applying the latest settings.

Changing the Plot Window Colors

You can set the plot window foreground/background colors using the following
procedure:
1. Select the Color option from the Plots menu in the plot window you want to
change. This displays the Plot Color Panel shown below:
Figure 25: The Plot Color Panel
2. If you want to adjust the color dynamically, turn on the Auto button before
setting the colors.
3. Move the appropriate sliders in the Foreground Color and Background

Color areas to give more/less red, green, or blue.
4. If the Auto button is not on, you can test the effect of various settings by
clicking the Apply button. Or click OK to apply your settings and close this
panel when you are finished using it. Clicking the Cancel button closes the
panel without applying the latest settings.
NOTE: If you have not used OK, Apply, or Auto yet, you can click the Reset button
to return the colors to their original settings.

Adding and Changing Annotations

Plotview includes extensive annotation and drawing features that allow you to add
graphics and text to the plot. All of these features are controlled through the
Annotation Editor control panel, which you can open by selecting the Annotation
Editor button on the main Plotview control panel.
Control buttons
Drawing tools
Color selections
Fill type
Line types
Patterns
Figure 26: Annotation Editor Control Panel

The various features on the control panel are summarized in the following table.
Complete procedures for using the Annotation Editor are included on the
following pages:
Table 5: Summary of Annotation Editor Controls
Button(s) Purpose
Group/Ungroup Lets you group or ungroup drawn objects.
Raise/Lower Lets you change the sequence of overlapping objects in a stack

Front/Back by selecting the object(s) to be moved and then raising/lowering
the selected object(s) a step at a time or moving the object(s)
directly to the front or back.
Cut/Copy/Paste Lets you cut, copy, or paste selected object(s).
Edit Lets you edit the currently selected text annotation.
(drawing tools) Lets you add various graphic objects and text to the plot, includ-
ing rectangles, ellipses, straight lines, polylines, polygons, round
cornered boxes and free-style curves.
Fill Color Lets you select the fill color for shaped objects.
Pattern Color Lets you select the pattern color for shaped objects.
Line Color Lets you select the line color for line objects.
(fill type) Lets you select the type of fill for selected objects.
(line types) Various controls let you select the line type, weight, dash style,
and arrow style for selected objects. If the object is a shape, the
line type described is along the borders of the object and arrow
styles do not apply.
(patterns) Lets you select the pattern for opaque or translucent fills.

Adding Drawn Objects to the Plot

The drawing tools on the Annotation Editor panel let you add various shapes or
text to the plot.
Round box
Rectangle
Ellipse
Line
Polygon
Freestyle Polyline
Text
Figure 27: Drawing Tools
To draw a shape or add text, use the following steps:
1. Click on the drawing tool.
2. Draw the appropriate shape or insert the object using MB1 on the mouse. The
methods are summarized below:
Freestyle Drag the mouse over the desired path. A freestyle curve appears
with control points. The slower you draw, the more control points.
Line Drag the mouse from the beginning to the ending point of the line,
then release MB1.
Polyline Click MB1 on the beginning point and each subsequent point;
MB2 on the end point.
Polygon Click MB1 on the beginning corner and each subsequent corner;
MB2 to close the shape.
Rectangle, Drag the mouse diagonally across the area to be covered by the
round box, object until the object is the desired size and shape, then release
ellipse MB1.
Text Drag at the location of the text and complete the text dialog.Text is
drawn with a box around it, and you can hide the box using the line
controls mentioned later in this chapter.
If you use the text tool to add text to the plot, the Text Object Editor opens.

Figure 28: Text Object Editor
3. Complete the following information in the Text Object Editor.
Font Family Select the desired type style from the pull-down menu.
Font Size Select the desired font size in points.
X/Y Position The absolute x,y coordinates of the text.
Font Slant Select whether the text should be normal or slanted.
Font Weight Select whether the text should be normal weight or bold.
Horizontal/ The desired alignment for the text. Horizontal Alignment can
Vertical Align- be left/center/right. Vertical Alignment is top/center/bottom.
ment
Rotate Select the text rotation angle.
Round Edge Turn on this check box if you want the text to be displayed in
a round-cornered box. Otherwise it is displayed in a rectangu-
lar box.
Text Enter the desired text string to appear on the plot.
4. Use the OK or Apply button to apply your entries. OK closes the dialog and
Apply leaves it open. Cancel closes the dialog without applying your
selections

Reshaping or Resizing an Object

Once you have used the drawing tools to add an object to the plot, you can reshape
or resize the object as desired. Use the following steps:
1. Click on the object.
2. Grab the control points and drag them in the appropriate direction. The
following diagram shows the control points for each object type.
Freestyle
Rectangle
Line
Ellipse
Polyline
Polygon
Text
Round box
Figure 29: Drawing Object Control Points
NOTE: For most objects, the control points can be moved in any direction. For the
ellipse, rectangle and round box, the control points on the sides, top, and
bottom of the object can only be used to stretch the object in one direction
(horizontally or vertically). Text objects cannot be resized using the
mouse. The size of the text object depends on the font size and text
string configuration. Text objects cannot be reshaped, but they can be
edited as explained in the next procedure.

Editing a Text Object

Once you add text to the plot, you can go back and edit it at any time, or change
the font or size of the text. To edit the text:
1. Click on the text object to be edited.
2. Click the Edit button on the Annotation Editor panel. This displays the Text
Object Editor.
Figure 30: Text Object Editor
3. Make the desired changes in the Text Object Editor dialog. You can change
any of the features listed below:
Font Family Select the desired type style from the pull-down menu.
Font Size Select the desired font size in points.
X/Y Position The absolute x,y coordinates of the text.
Font Slant Select whether the text should be normal or slanted.
Font Weight Select whether the text should be normal weight or bold.
Horizontal/ Ver- The desired alignment for the text. Horizontal Alignment can
tical Alignment be left/center/right. Vertical Alignment is top/center/bottom.
Rotate Select the text rotation angle.

Round Edge Turn on this check box if you want the text to be displayed in a
round-cornered box. Otherwise it is displayed in a rectangular
box.
Text Change the text string as desired.
4. Use the OK or Apply button to apply your entries. OK closes the dialog and
Apply leaves it open. Cancel closes the dialog without applying your changes
Selecting, Grouping, and Moving Objects

You can use the Annotation Editor to select and move existing objects within the
current plot window. To select and move objects:
1. Click on the object(s) to be selected and/or moved.
You can select multiple objects by holding down the Control key while you
click on them. You can also select them by dragging the mouse around them.
As you drag the mouse, the pointer draws a “bounding box” around the
objects. Release the mouse once the objects are completely surrounded by the
bounding box. An object is selected once its control points are visible.
2. If you want the selected objects to be treated as a group, click the Group
button on the Annotation Editor panel.
Grouping objects allows you to move or resize the entire group

simultaneously. Any changes to fills, patterns, or lines will also apply to the
entire group. When you group multiple objects, they lose their individual
control points. Instead, you will see control points around the group.
3. If the selected objects are already in a group and you want to move, resize, or
change them individually, select the group by clicking on any of the objects,
then click the Ungroup button on the Annotation Editor panel.
You can tell when the objects have been ungrouped because the control points
reappear on each individual object. You can then select any of the objects to
be moved, resized, or changed.
4. To move the object or group of objects, move the mouse pointer over any part
of a selected object and hold down MB1 as you drag the object or group to the
new location. Release MB1 when the object(s) are in the desired position.
Changing the Sequence of Overlapping Objects

If you have multiple drawn objects in a plot that overlap each other, you can easily
change the overlap in various ways. You can raise or lower any object a step at a
time in the stack, or you can move it directly to the front or back of the stack. To
do this:
1. Decide which object you want to raise, lower, or move.

2. Click on it to select it.
3. Use the Raise/Lower buttons on the Annotation Editor panel to move the
object a step at a time toward the front or back of the stack.
4. Use the Front/Back buttons on the Annotation Editor panel to move the
selected object directly to the front or back of the stack.
Cutting, Copying, and Pasting Objects

You can use the Annotation Editor to cut, copy and paste objects in the plot
window. You can also use these features to copy or move annotations from one
window to another. To do this:
1. Select the object to be moved or copied.
2. Select the Cut button on the Annotation Editor panel if you want to delete the
object or move it to a different window. Select the Copy button if you want to
make a copy of the object in the same window or a different window.
3. If you are moving the object to a different window, move the focus to the
window where the object is to be moved.
4. Select the Paste button to paste the object into the current window.
Pasting a copied object pastes it back on top of the original copy. You can
easily move the pasted object to a new location by dragging it.

Changing the Fill, Line or Pattern

When you draw a new object, the object is drawn in a certain style and color based
on the currently selected fill, line, and pattern attributes on the Annotation Editor
panel. You can change these attributes at any time, by using the following steps:
1. Select the object(s) to be changed.
2. Select the appropriate fill, pattern, or line colors from the Annotation Editor
panel.
Colors
Fill treatment
Line treatment
Line width
Dash style
Arrow style
Patterns
Figure 31: Fill, Line, and Pattern Selections
3. Use the first menu box to select the fill treatment.
Solid Fill No pattern, only fill color.
Fill Opaque Displays the selected pattern and fill color in the selected
object.
Translucent Displays the pattern only, without the fill.
No Fill No pattern and no fill color.
4. Use the second menu box to select the line treatment.
Solid Line Line appears with no dash pattern, only the line color.
Double Dash Line appears with the selected dash pattern, with the fill
color showing between the dashes. This effect may not
show up well for thin lines.

On Off Dash Line appears with the selected dash pattern, with the fill
color showing between the dashes.
No Line Line is hidden.
5. Use the next three menu boxes to select the line width, dash style, and arrow
style.
6. Use the pattern matrix to select the fill pattern. Patterns only apply to shapes,
not lines.
Customizing the Dash Style

The Annotation Editor provides a number of preformatted dash styles you can use
for lines and borders on drawn objects in the plot window. However, you can also
create your own custom dash style. To do so:
1. Select the Edit List option from the dash styles menu box (see Figure 31 on
page 95). This displays the Dash List.
Figure 32: Dash List
This list shows the configuration of different dash styles. The numbers after
the colon in each line indicate the number of short dashes followed by the
number of long dashes in each preformatted dash sequence.
2. To modify any line, click on it, backspace, and retype the numbers after the
colon, being careful to use the same format as before.
3. Click the Apply button then pull open the dash style menu to see if the dash
style shows up.
4. Click the OK button when you are finished using this panel (or click Cancel
to close the panel without applying your selections).

Customizing the Line Width Menu

The Annotation Editor provides a number of preformatted line widths you can use
to select a thickness of the lines and borders on drawn objects in the plot window.
However, you can modify the Annotation Editor line width menu so that different
line widths are available. To modify the line width menu:
1. Select the Edit List option from the line width menu box (see Figure 31 on
page 95). This displays the Line Width panel.
Figure 33: Line Width Panel
This panel shows the different line widths available on the menu, in screen
pixels. You can have up to eight different line widths on the menu. The line
widths appear on the menu in the same sequence they are listed here.
2. To change any of the line widths, click on it, backspace, and retype the
numbers.
3. Click the Apply button then pull open the line width menu to see if it reflects
the new widths.
to close the panel without applying your selections).

Customizing the Arrow Style

The Annotation Editor provides a number of preformatted arrow styles you can
use for lines and polylines in the plot window. However, you can also create your
own custom arrowhead styles. Use the following steps:
1. Select the Modify option from the arrow styles menu box (see Figure 31 on
page 95). This displays the Arrowhead Editor panel.
Figure 34: Arrowhead Editor
This panel lets you set the size, shape, and fill style of the arrowhead. The
settings entered here will not affect arrowheads already drawn in the display,
but will apply to any future arrow heads you add to lines or polylines.
2. Set the angle of the arrowhead Tip and Base, using the diagram as a
guideline. To change either number, click on it, backspace, and retype the
numbers.
3. Set the Length of the arrowhead, from tip to base.
4. Select the Arrow Type, which can be solid, hollow, or stick-shaped.
to close the panel without applying your selections). The new arrow style you
created will only apply if you create a new object that can have an arrowhead,
or if you apply an arrow style to an existing object currently in the plot
window.

Capturing an Image for Hardcopy Printing

Once you have the data plotted in a display window exactly as you want it to look,
PlotView lets you save a PostScript or CGM image to a disk file for use in
presentations or for printing as hardcopy. You can set up the hardcopy so that plot
displays print individually on separate sheets, or so that all plot displays print on
the same sheet. The following procedures explain how to set up the print options,
capture multiple images, and print the images.
Use the following steps to set up the options used for capturing screen images:
1. To produce an individual hardcopy of a plot display, select the Print option

from the File menu in the desired plot window. To produce a hardcopy image
of all displays together, click the Print button on the control panel. Either
option displays the Print panel shown below:
Figure 35: The Print Panel
2. Enter the File Name of the file where you want to save the captured image. If
you want to save it somewhere other than the directory where you started
PlotView, enter a complete pathname as well.
3. Select settings in the following panels:
Output Type Defines whether you want the produced

image to be PostScript or CGM.
Color Scheme Defines whether you want to produce a Color

or MonoChrome image.
Background Determines if the background is white or

color.

Orientation Defines whether you want the final image to

be treated as portrait (right side up), landscape
(sideways on the page), or automatically uses
whichever orientation produces the best fit,
given the shape of the image.
Page Allows you to enter the size and scale of the

page. For scaling, a value larger than 1.0
enlarges the image; smaller than 1.0 reduces
the image.
Margins Determines the page margins.
4. Click the OK button if you want to apply your selections to a single image.
Alternately, you can use the Apply button if you want to leave this panel open
to capture multiple images.
NOTE: If you use the same filename to capture more than one image, the images are
not appended to the file. Instead, each successive image overwrites the
previous contents of the file.

Saving and Reloading Screen Definitions

PlotView lets you store the current layout of any plot display in a screen definition
file, which you can reload at anytime to recreate a particular plot display. This
feature can save you a considerable amount of time if it ever becomes necessary to
restore a previous display to the screen.
All screen definition features are controlled by clicking the Screen Definition
button on the control panel. This displays the following panel for saving, loading,
and controlling screen definition files:
Figure 36: Screen Definition Panel
The following procedures explain how to use the various menus and options on
the Screen Definition panel.
NOTE: The overlay file and case behave like Add Special. The file and case will
override file and case values in the Scene when viewed.
Creating and Saving a New Screen Definition File

To save a new screen definition, you must first create the screen definition file to
save it in. Use the following steps:
1. Set the screen layout exactly the way you want it to be saved in a screen
definition file.
2. Enter the desired scene description on a blank line in the Screen Definition
panel (i.e., any line with the words “unnamed scene”).
This could be something as simple as “scene1” or something more description

like “BHP and THP vs. Time.” If there isn’t an “unnamed scene” line, use the
Edit/Insert command on the pull-down menu to insert one before or after the
currently selected line.

3. Select the Overwrite option from the Edit menu.
4. Repeat the previous steps for any other screen layouts you want to store.
5. Select the Save option in the File menu in the Screen Definition Menu panel.
If this is the first time you have saved a screen definition for this plot, this
displays the file selection box shown in the following illustration. Otherwise,
the saved scene is saved to the current screen definition file.
Figure 37: Screen Definition File Selection Box
6. If you see the File Selection box, make sure the Directories list shows the
correct directory where you want to save the file. If not, navigate through the
directory list by clicking on directory names, or type a complete pathname in
the Filter line (ending with /*.vdf) and click the Filter button.
7. Click at the end of the Selection line and type in the desired filename. The file
extension must be .vdf. If you omit the file extension, it will be added
automatically.
8. Click the OK button in the file selection box to create the new screen
definition file and close the file selection box.

9. Click the Overlay button and select a filename in the same way you selected a
file in the Screen Definition File Selection box.
10. Select the name of the overlay file and press OK. You are returned to the
Screen Definition panel with the overlay filename displayed in the Overlay
window.
11. Select Save from the File menu. The screen definition is saved.

Loading an Existing Screen Definition File

Once you have saved a screen definition file, you can reload it at any time. Use the
following steps:
1. Select the Open on the File menu in the Screen Definition panel. This
displays the Open File selection box.
Figure 38: Open File Selection Dialog
2. Double-click the desired filename in the Files list to select the file to be
loaded, or click the filename and click the OK button.
If you do not see the desired filename, it may be in a different path. To find it,
navigate through the directory list by clicking on directory names, or type a
complete pathname in the Filter line (ending with
/*.vdf) and click the Filter button.

Merging Two Screen Definition Files

You can merge the definitions in one file with the definitions in another. To do
this:
1. Create a screen definition file, or use the Open option on the File menu to
open an existing one.
This will be the file that contains the merged screen definitions. The previous
procedures explain how to create a new screen definition file or open an
existing one.
2. Use the Import option on the File menu to import another existing screen
definition file into the one that is currently open. This displays the Import
Scene dialog shown below.
Figure 39: Import Screen Definition
3. Double-click the desired filename in the Files list to select the file to be
loaded, or click the filename and click the OK button.
If you do not see the desired filename, it may be in a different path. To find it,
navigate through the directory list by clicking on directory names, or type a
complete pathname in the Filter line (ending with
/*.vdf) and click the Filter button.

Reviewing the Available Scenes

Once you have saved multiple screen layouts in a screen definition file, you can
use the following procedure to review the various scenes in the file:
1. Make sure you have loaded the desired screen definition file.
2. Click the scene you want to view and then click the View button.
3. Click the Next button to view each separate screen definition in the screen
definition file.
4. Click the Previous button to move back through the previous screen
definitions.
NOTE: Whenever you switch between scenes in the plot window, the previous view
is removed from the screen before the next view is loaded.
Editing the Scenes

You can edit the scenes listed in the Screen Definition panel (Figure 36) using the
following procedures. Notice all of the options described below are available on
the Edit pull-down menu, or the MB3 mouse button pop-up menu. When you use
the Edit menu, you must select the line first. If you use the MB3 menu, it applies
directly to the line where the mouse is pointing.
1. Use the Insert option to insert new lines above or below existing ones. When
you create a new line (i.e., scene), you must type in a name for the scene and
then use the Overwrite option to save the current screen layout on that line of
the Screen Definition panel.
2. You can copy a scene (i.e., a line in the panel) using the Copy option.
3. You can delete a scene (i.e., a line in the panel) using the Cut option.
4. You can paste the last copied or deleted scene using the Paste option.
5. Once a scene is pasted, you can change use the View button to view it, modify
the layout as desired, then use Overwrite again to save its new layout.

Batch
You can print several items to a scene with one print command. To do this:
1. From the Screen Definition panel, select Batch from the File menu. The Batch
Print Panel is displayed:
2. Select items from the list to be presented.
3. Optionally enter a layout scheme. Any nonzero row and column values will
resize and rearrange plots in the scene to fit the page. In this case, plots will be
duplicated as necessary.
4. Optionally select an overlay file and case. An overlay file will print the scene
using data from selected files.
5. Click Apply or OK.
6. Plotview will create hardcopies using the current scene and the selected items.
For each item, all traces in the scene are set to the item and printed.

For example:
■ Create a scene consisting of one plot with one item and one property.
■ Select several items from the batch item list.
■ Click OK.
■ Individual hardcopies will be created for all selected items using the plot
created from Step 1.

Appendix
A
Introduction
When you are selecting a property to be plotted in PlotView, the list of properties
may vary considerably depending on the data class selected and the type of
simulator that produced the data. The following sections provide two different
ways to get more information about properties.
Alphabetical List of Property Names

The following table provides an alphabetical listing of the various properties that
you can plot using PlotView. Each row shows the name, description, English
units, and metric units for a given property. The last two columns contain codes
that represent various classes (i.e., reporting levels) and simulation types to which
the property might apply, as explained in the legend at the bottom of the table.
Table 1: List Of Property Names in Alphabetical Order
Property English Applicable Applicable

Description Metric Units
Name Units Classes Simulators
BHP Bottom-hole pressure - Datum PSIA KPA W VMET
BHT Bottom hole temperature F F WF T
CGI Cumulative gas injection MMSCF MMSCM WGRF VMET
CGP Cumulative gas production MMSCF MMSCM WGRF VMET+
CGV Produced gas gravity AIR=1.0 AIR=1.0 G E
CHCP Cumulative heavy component pro- MSTB MSTCM WGRF V

duction
CGI Cumulative gas injection MMSCF MMSCM WF VME
CHI Cumulative heat injection MBTU MBTU WF T
CHP Cumulative heat production MBTU MBTU WF T
COI Cumulative oil injection MSTB MSTCM WF T
LEGEND Units: *Units for well or gathering center data. **Units for region or field data. + for any region in VIP-COMP, these values are set
to zero unless a separator battery was defined for the region. Classes: W=Well, G=Gathering Center, R=Region, F=Field Simulators: V=VIP,
M=VIP-MISC, E=VIP-EXECUTIVE, T=VIP-THERM
R5000.0.1 Appendix A: Reference Guide to Properties 109

Table 1: List Of Property Names in Alphabetical Order (Continued)

COP Cumulative oil production MSTB MSTCM WGRF VMET
CSI Cumulative solvent injection MSTB MSTCM WGRF M
CSP Cumulative solvent production MSTB MSTCM WGRF M
CSP Cumulative solvent production MMSCF MMSCM WF T
CSTP Cumulative steam production MSTB MMSCM WF T
CWI Cumulative water injection MSTB* MSTCM* WGRF VMET

MMSTB** MMSTCM**
CWP Cumulative water production MSTB* MSTCM* WGRF VMTE

MMSTB** MMSTCM**
GIP Total gas in place MMSCF MMSCM RF VME
GOR Gas-oil ratio SCF/STB SCM/STCM WGRF VMET
HCIP Heavy component in place MSTB MSTCM RF V
HCMF Average heavy component mole Fraction Fraction W V

fraction
OIP Oil in place MSTB MSTCM RF VME
PAVE Grid block datum pressure PSIA KPA W VE
PAVH Average pressure (weighted by PSIA KPA RF VME

hydrocarbon pore volume)
PAVT Average pressure (weighted by PSIA KPA RF VME

total pore volume)
PTOP Grid block pressure PSIA KPA W VMET
QGI Gas injection rate MSCF/DAY MSCM/DAY WGRF VMET
QGP Gas production rate MSCF/DAY MSCM/DAY WGRF VMET
QHCP Heavy component production rate STB/DAY STCM/DAY WGRF V
QHI Heat injection rate BTU/DAY BTU/DAY WF T
QHP Heat production rate BTU/DAY BTU/DAY WF T
QOI Oil injection rate STB/DAY STCM/DAY WF T
110 Appendix A: Reference Guide to Properties R5000.0.1

Table 1: List Of Property Names in Alphabetical Order (Continued)

QOP Oil production rate STB/DAY STCM/DAY WGRF VMET
QSI Solvent injection rate STB/DAY STCM/DAY WGRF M
QSP Solvent production rate STB/DAY STCM/DAY WGRF M
QSTP Steam production rate STB/DAY MSCM/DAY WF T
QWI Water injection rate STB/DAY STCM/DAY WGRF VMET
QWP Water production rate STB/DAY STCM/DAY WGRF VMET
SIP Solvent in place MSTB MSTCM RF M
SO Oil saturation FRACTION FRACTION WF T
SW Water saturation FRACTION FRACTION WF T
THP Tubing-head pressure PSIA KPA W VMET
WCUT Water cut Fraction Fraction WGRF VMET
WIP Water in place MMSTB MMSTCM RF VME
WOR Water-oil ratio STB/STB STCM/ WGRF VMET

STCM

Property Names Grouped By Function

The following table presents the same information as the previous table, except
this time the properties are grouped in functional categories.
Table 2: List Of Property Names Grouped By Function

Rate, Production
GOR Gas-oil ratio SCF/STB SCM/STCM WGRF VME
CGV Produced gas gravity AIR=1.0 AIR=1.0 G E
HCMF Average heavy component mole Fraction Fraction W V

fraction
QGP Gas production rate MSCF/DAY MSCM/DAY WGRF VME
QHCP Heavy component production STB/DAY STCM/DAY WGRF V

rate
QOP Oil production rate STB/DAY STCM/DAY WGRF VME
QSP Solvent production rate STB/DAY STCM/DAY WGRF M
QWP Water production rate STB/DAY STCM/DAY WGRF VME
WCUT Water cut Fraction Fraction WGRF VME
WOR Water-oil ratio STB/STB STCM/ WGRF VME

STCM
QSTP Steam Production Rate STB/DAY MSCM/DAY WF T
QHP Heat Production Rate BTU/DAY BTU/DAY WF T
Rate, Injection
QGI Gas injection rate MSCF/DAY MSCM/DAY WGRF VME
QSI Solvent injection rate STB/DAY STCM/DAY WGRF M
QWI Water injection rate STB/DAY STCM/DAY WGRF VME
QOI Oil Injection Rate STB/DAY STCM/DAY WF T
QHI Cumulative Heat Injection MBTU MBTU WF T
Cumulative, Production
CGP Cumulative gas production MMSCF MMSCM WGRF VME
LEGEND Units: *Units for well and gathering center data. **Units for region and field data. Classes: W=Well, G=Gathering Center,
R=Region, F=Field Simulators: V=VIP, M=VIP-MISC, E=VIP-EXECUTIVE, T=VIP-THERM

Table 2: List Of Property Names Grouped By Function (Continued)

CHCP Cumulative heavy component MSTB MSTCM WGRF V
COP Cumulative oil production MSTB MSTCM WGRF VME
CSP Cumulative solvent production MSTB MSTCM WGRF M
CWP Cumulative water production MSTB* MSTCM* WGRF VME

MMSTB** MMSTCM**
CSTP Cumulative Steam Production MSTB MMSCM WF T
CHP Cumulative Heat Production MBTU MBTU) WF T
Cumulative, Injection
CGI Cumulative gas injection MMSCF MMSCM WGRF VME
CSI Cumulative solvent injection MSTB MSTCM WGRF M
CWI Cumulative water injection MSTB* MSTCM* WGRF VME

MMSTB** MMSTCM**
COI Cumulative Oil Injection MSTB MSTCM WF T
CHI Cumulative Heat Injection MBTU MBTU WF T
Pressure, Saturation, Temp
PAVH Average pressure (weighted by PSIA KPA RF VME

hydrocarbon pore volume)
PAVT Average pressure (weighted by PSIA KPA RF VME

total pore volume)
BHP Bottom-hole pressure PSIA KPA W VME
PTOP Grid block pressure PSIA KPA W VME
PAVE Grid block datum pressure PSIA KPA W VE
THP Tubing-head pressure PSIA KPA W VME
SO Oil Saturation FRACTION FRACTION WF T
SW Water Saturation FRACTION FRACTION WF T
BHT Bottom Hole Temperature F F WF T
In Place Volumes

Table 2: List Of Property Names Grouped By Function (Continued)

HCIP Heavy component in place MSTB MSTCM RF V
OIP Oil in place MSTB MSTCM RF VME
SIP Solvent in place MSTB MSTCM RF M
GIP Total gas in place MMSCF MMSCM RF VME
WIP Water in place MMSTB MMSTCM RF VME

Appendix
B
Introduction
A utility called DBPLOT can be used to generate a VDB database from VIP plot
files. DBPLOT can process formatted ASCII or binary VIP plot files. This chapter
explains:
■ How to prepare a control file listing the variables to be extracted for the
database.
■ How to prepare an observed data file containing the observed data variables.
■ How to run the DBPLOT utility.
Since the PlotView software only accepts data stored in an VDB database, you
will be using this utility each time you want to prepare VIP data in a format that
you can read into PlotView.
Preparing the Control File

You must prepare a control file before you can use DBPLOT. The control file
gives DBPLOT the parameters it needs to make the conversion. This section
shows an example of a control file and explains each component.
R5000.0.1 Appendix B: Converting Data to VDB Format 115

Example of Control File

The following listing is an example of a DBPLOT control file.
Process plot data PLOT databasename casename

Observed data file
OBS obsdata.filename
Specify first
simulator plot file FILE input.filename
Case name CASE casename [parent case] (optional)

Start date of study STARTDATE day month year
WELL VAR
Well variable QOP QWP QGP
name list COP CWP CGP
ENDVAR
GATHER VAR
Gathering center QOP QWP QGP
variable name list COP CWP CGP
ENDVAR
REGION VAR
OIP GIP WIP
Region variable QOP QWP QGP
name list COP CWP
ENDVAR
FIELD VAR
OIP GIP WIP
Field variable QOP QWP QGP
name list COP CWP CGP
ENDVAR
TIME
Time specs (in days 10 TO 30
or timesteps)
ENDTIM
EOF End first simulator

plot file (optional)
Specify second
FILE input.filename
simulator plot file
TSTEP
5 TO 300 BY 2
ENDTIM
End second simulator
EOF plot file (optional)
Figure 0-1: Example of Plot Data Control File
Notice in this example that the control file contains several lines of header data,
followed by groups of variables for wells, gathering centers, regions, and so forth.
These indicate the list of variables that you want to include. If you do not list
specific variables to be included, then all available variables in that category are
included. Each group of variables ends with an ENDVAR keyword.
You can also limit the data to certain simulation days or timestep numbers using
the TIME or TSTEP statements. The EOF statement indicates the end of each plot
file specification, whereas the STOP and END statements are placed at the end of
the control file itself.
116 Appendix B: Converting Data to VDB Format R5000.0.1

Control File Specifications

The following specifications should be used when building a control file for
DBPLOT. Notice that the control file can contain multiple entries, but that all
entries become part of the same case study in the VDB database.
Database Filename/Casename (PLOT)
Format: PLOT (database filename) (casename)
Definitions:
PLOT Alpha label indicating the plot data file to be processed. This must
start the first row in the input file.
(database file- File name of the VDB file to be created by DBPLOT. The extension
name) .vdb is appended automatically, if not included here.
casename The name of the case study that the following data will be stored
under.
Observed Data Filename (OBS)
Format: OBS filename
Definitions:
OBS Alpha label indicating the observed data filename associated with this
simulator plot file, if any. This must start the second row in the control
file.
filename Filename of the observed data file (see “Preparing the Observed Data
File” on page 124).

Name of Plot File (FILE)
Format: FILE filename
Definition:
filename Name of the file containing simulator plot data.
Name of CASE File (CASE) (optional)
Format: casename [parentcase]
Definition Casename for the simulator plot data, followed by optional parentcase.
Start Date of file (STARTDATE) (optional)
The start date of the study is required when using a spreadsheet input file.
Format: Day Month Year
Definition
Well Variables (WELL VAR)
You can indicate specific well variables to be included in the database file by
listing them between a WELL VAR statement and an ENDVAR statement. If you
do not include a list of well variables, all available well data is extracted for the
database.
Format:
WELL VAR
(ALL) (wellvar1) (wellvar2) . .
(wellvarn)
ENDVAR
Definitions:
WELL VAR Alpha label indicating the start of well variables.
ALL Alpha label indicating that all well variables will be extracted
(default).

wellvar Specified well variables, if not all are to be included. May be listed
on multiple lines.
ENDVAR Alpha label indicating the end of well variables.
Gathering Center Variables (GATHER VAR)
You can indicate specific gathering center variables to be included in the database
file by listing them between a GATHER VAR statement and an ENDVAR
statement. If you do not include a list of gathering center variables, all available
gathering center data is extracted for the database.
Format:
GATHER VAR
(ALL) (gathervar1) (gathervar2) . .
(gathervarn)
ENDVAR
Definitions:
GATHER VAR Alpha label indicating the start of gathering center variables.
ALL Alpha label indicating that all gathering center variables will be
extracted (default).
gathervar Specified gathering center variables, if not all are to be included.

May be listed on multiple lines.
ENDVAR Alpha label indicating the end of gathering center variables.

Region Variables (REGION VAR)
You can indicate specific region variables to be included in the database file by
listing them between a REGION VAR statement and an ENDVAR statement. If
you do not include a list of region variables, all available region data is extracted
for the database.
Format:
REGION VAR
(ALL) (regionvar1) (regionvar2) . .
(regionvarn)
ENDVAR
Definitions:
REGION VAR Alpha label indicating the beginning of region variables.
ALL Alpha label indicating that all region variables will be

extracted (default).
regionvar Specified region variables, if not all are to be included. May be

listed on multiple lines.
ENDVAR Alpha label indicating the end of region variables.

Field Variables (FIELD VAR)
You can indicate specific field variables to be included in the database file by
listing them between a FIELD VAR statement and an ENDVAR statement. If you
do not include a list of field variables, all available field data is extracted for the
database.
Format:
FIELD VAR
(ALL) (fieldvar1) (fieldvar2) . .
(fieldvarn)
ENDVAR
Definitions:
FIELD VAR Alpha label indicating the beginning of field variables.
ALL Alpha label indicating that all field variables will be extracted
(default).
fieldvar Specified field variables, if not all are to be included. May be

listed on multiple lines.
ENDVAR Alpha label indicating the end of field variables.

Time Specification, In Days (TIME)
Normally, all data will be read into the database file for the selected properties. If
you want to limit the data to certain days, you can list the days between a TIME
and ENDTIM statement.
Format:
TIME
(t1 TO t2) (t3)
(tn)
ENDTIM
Definitions:
TIME Alpha label indicating that extracted plot data must be limited to cer-
tain days in the simulation.
t1,t2,t3 Time specified in days.
TO Alpha label indicating that a range of times must be extracted from

the first day specified to the last day specified.
ENDTIM Alpha label indicating the end of time specification.

Time Specification, In Timesteps (TSTEP)
Normally, all data will be read into the database file for the selected properties. If
you want to limit the data to certain timesteps, you can list these between a
TSTEP and ENDTIM statement.
Format:
TSTEP
(t1 TO t2) (t3)
(t4 TO t5 BY tinc)
.
(tn)
ENDTIM
Definitions:
TSTEP Alpha label indicating that extracted plot data must be limited to
certain timesteps in the simulation.
t1,t2,t3, t4,t5,tn Time specified as timestep numbers.
TO Alpha label indicating that a range of times must be extracted from

the first timestep to the last timestep specified.
BY Alpha label indicating that a timestep increment will be specified.
tinc Timestep increment.
ENDTIM Alpha label indicating the end of time specification.
End of Plot File (EOF) (optional)
The EOF statement indicates the end of the plot file specification.

Preparing the Observed Data File

If desired, you can include a user-generated observed data file in the database.
Typically, this feature is used in history matching applications to compare the
simulation data to observed or historical data. PlotView will let you display the
simulation data and observed data overlaid on the same plot to check the validity
of a simulation.
Example of File Format

The observation data file is a “free field” format similar to that used by the
simulators. The following figure shows an example of the format.
Figure 0-2: Example of Observed Data File

In this example, notice that the observed data file contains the actual observed
data. The top of the file contains summary information, such as a title, class
names, and properties. The end of the file contains an END statement. For
example, the file shown in Figure 0-2 contains two classes: well data and field
data. The well data includes two items (Well 1 and Well 2) with three columns of
data for each item (TIME, QOP, and GOR). In other words, each row of well data
shows the QOP and GOR that occurred at a certain historical time at that well.
Observed Data File Specifications

The following specifications should be used when building an observed data file
for DBPLOT. If you want the observed data file to be stored in the VDB database
as part of a case study, you must include the name of the observed data file on the
second line of the plot data control file used as input to DBPLOT (see “Control
File Specifications” on page 117). You can include only one observed data file in
an VDB database containing simulator plot data.
Title of Data File
The title information must be entered as a series of lines at the top of the file, with
the first line counting the total number of title lines included after the first line.
Format:
OBS n
title1
title
Definitions:
OBS Alpha label indicating observed data is being entered.
n The number of title lines following the first line. Any number of lines
of descriptive information can be used. However, only the first 3
(maximum) are written to the database file. If there is no title data,
enter 0.
title Alphanumeric titles. The number of lines of title must correspond to

the value entered on the previous line.

Initial Date, Maximum Time Entries, Units
The date, time, and unit information must follow the title on a single line.
Format iday imo iyr ntmax units
Definitions:
iday, imo, iyr Initial day/month/year from which all time is measured for this data
set. Must correspond to the initial date entered in the simulator utility
data on the DATE card. Time is initialized to zero at this date and
measured from this date in days. For example, if January 1, 1990 is
the initial date, then February 2, 1990 is Day 32 of the simulation.
ntmax Maximum number of time/date entries entered for any item (e.g., the
maximum number of observed time entries for any given well, gath-
ering center, region, or field.)
units Alpha label indicating the units for the data.
• “E” indicates English units (standard oil field units)

• “M” indicates SI metric units
• “L” indicates lab units
• “B” indicates Metric Bar units
• “K” indicates Metric KG units
There are no unit conversions performed on observation data. These
are simply used for reference or display purposes and all similar data
should be entered in the same units.
Number of Class Names
The number of class names is a single integer entered on a line by itself.
Format: ncn
Definitions:
ncn Number of class names being entered. Valid entries are 1, 2, 3, or 4.

Class Names, Maximum Items, Number of Properties
This information is listed in columns, with the first class of data in the first
column, the second class in the second column, and so forth.
Format:
class1name class2name ... classnname
class1imax class2imax ... classnimax
class1nprop class2nprop ... classnnprop
Definitions:
name Alpha labels indicating the classes for which data is being entered.
Valid entries are WELL, GATHER, REGION, or FIELD. Any or all
of these labels can be entered; they are order-independent. The num-
ber of labels entered must be equal to number of class names.
imax Maximum number of items in each class (i.e., maximum number of

wells, gathering centers, regions, and/or fields.)
nprop Exact number of properties (quantities) entered for each class. TIME
or DATE is considered to be a property.

Property Names
The property names for each class of data are listed in rows with the first row
containing the property names for the first class, the second row containing
property names for the second class, and so forth. The number of property
definition lines entered must equal the number of classes defined earlier.
In a sense your entries in this section serve as the column headings for the actual
data listed in the next section. The property data values for each class will be
listed in columns that correspond to the sequence shown here. Notice that the first
property name must be TIME or DATE, since the first column(s) of data (next
section) will be either a time in days from the initialization date or an actual day/
month/year.
Format:
[TIME/DATE] class1pname1 class1pname2 ... class1pnamen
[TIME/DATE] class2pname1 class2pname2 ... class2pnamen
[[TIME/DATE] class3pname1 class3pname2 ... class3pnamen
Definitions:
TIME/DATE Alpha label indicating the unit of time used for data entry. Only
TIME or DATE are valid labels. TIME indicates that the first column
of data values for each item of each class will be time measured as
the number of days from the initialization date. DATE indicates that
the first three columns of data for each item of each class will be the
day, month, and year of the date to which the data applies. You must
use either TIME or DATE for all classes; you cannot use TIME for
one and DATE for another.
pname Alpha labels representing the names of the properties being entered
for that class of data. The number of labels entered, including TIME/
DATE, corresponds to the nprop value (exact number of properties
entered for each class). The labels can differ from class to class and
are order-independent. In order to be plotted, the property names
must be the same as in the corresponding simulator plot file.

Time/Date and Property Data
This section contains the actual values of the observed data. For each item in each
class, you must start with the class name and item number on the first row,
followed by columns of data corresponding to the previous property name
definitions. The total number of rows of data for any given item cannot exceed the
maximum number of time/date entries specified at the top of the file (ntmax).
Format:
classname itemno (item name)
ntd1 nprop1 npropn
ntd2 nprop1 npropn
. . .
. . .
Definitions:
classname Alpha label defining the class of data being entered (WELL,
GATHER, REGION, or FIELD).
itemno The number of the item within that class (e.g., if entering the data for
(item name) well number 5, item would be 5). These numbers must correspond to
the numbers used to define items (wells, etc.) in the simulator. Name
of the item is also accepted in place of itemno provided that an item
name to item no mapping is specified. The first character of item-
name must be non-numeric. Item name to item number mapping uses
the same format as well location and well management input data for
VIP-EXECUTIVE.
TIP: Use the INCLUDE directive to include the case.wij, which is

the well location data file generated by PREXEC.
ntd If TIME was specified as the first property name for this class in the
previous section, the first column of data must always be the time (in
days) since the beginning of the simulation. If DATE was specified,
the first three columns must always contain the day, month, and year
of the observed data. The first date must be greater than or equal to
the initialization date specified at the top of the file (iday, imo, iyr).
The time/date values must increase from row-to-row and cannot
decrease from one row to the next.
nprop The actual data values for each named property must be entered in
columns in the same order as the corresponding property names for
that class specified in the previous section. The values on each row
must all correspond to the time/date entered in the first column of the
row. The data must be entered in appropriate units to match the simu-
lation data. If there is no known value for a property at one of the
time entries, a value of -1.0E+10 is entered.

End of Observed Data File
The last line of the observed data file must contain the keyword END on a line by
itself.
Format END
Definition:
END Alpha label indicating the end of all observed data entry.
File Inclusion
The file inclusion directive can be placed on any line in the observed data file, any
number of time.
INCLUDE filename
Definition:
filename A valid path or filename for the operating system.

Running DBPLOT
When you are finished preparing the observed data file, there are two methods of
adding this data to the .vdb file. The first and easiest way is to select the
OUTPUT/VIPconv from the Desktop menu. This will start the VIPconv
conversion utility. One of the menu choices in VIPconv is Create [v]db from
Map and/or Plot Files. This option can be chosen to add t he observed data to the
.vdb file. The user will be prompted for the name of the study, case, and observed
data file.
The second method requires that you create a file with the editor containing data
similar to one of the following:
PLOT example.vdb example

OBS example.obs
EOF
or:
PLOT example.vdb example

OBS example.obs
FILE examplei.plt
EOF
FILE exampler.plt
EOF
The first control file will read observed data from a file named example.obs and
insert it into a .vdb file named example.vdb (existing or new). The second form of
the control file will insert the ‘Run CORE’ initialization plot data, ‘Run EXEC’
simulation plot data, and the observation plot data into the file example.vdb. To
use either of these control files, you can run DBPLOT from the command line by
entering the following command:
dbplot < randp_db.dat
where ‘randp_db.dat’ is the name of the control file (form 1 or 2) as described

above. The message ‘Loading Observed Data’ will appear on your terminal to
signify the successful insertion of observed into the .vdb file.
DBPLOT runs automatically and produces an output file in VDB format. The
name of the output file is the same name as the database name on the first line of
the control file, with the extension .vdb added to the end of the filename. You can
use this output file directly as input to PlotView by selecting it from the control
panel in the PlotView interface.

DBPLOT Comand Line Dump Options

DBPLOT can be run from the command line with a specified dump option to
output PLOT data to a
■ VIP-formatted plot file,
■ Generic ASCII spreadsheet file,
■ .pa spreadsheet file,
■ or OpenWorks project (if OpenWorks is installed).
DESKTOP-VIP version 2000 does not integrate with OpenWorks. At the time this
release was certified, OpenWorks has not certified on Windows 2000. References to
OpenWorks have not been removed from the documents because it will be supported in
a future release.
The DBPLOT command line dump syntax is:
dbplot -dump=dumptype -case=casename[caseoptions] studyname.vdb
where:
-dump=dumptypevalid types: form - VIP formatted plot file (default)

gss - generic spreadsheet file
pass - .pa spreadsheet file
ow - OpenWorks project
-case=casenamespecify case name
-o=optionsspecify output options for given dumptype. For

‘form’, ‘gss’, and ‘pass’ it specifies the file prefix for
the output file(s). The default is ‘study_case’.
For ‘ow’, this option specifies the destination
OpenWorks project.

Appendix
C
Introduction
Instead of starting the Plotview program and using the control panel, you can also
use Plotview in batch mode to generate hardcopy plots automatically from the
command line. The plots are based on a screen definition file that you have
already set up in Plotview. This appendix explains how to use the Plotview batch
mode features.
Preparing to Use Batch Mode

Before using batch modes, you need to set up a screen definition file for
generating hardcopy, and you may also want to create a substitution file that
allows you to easily specify different properties or other values on the command
line.
Setting Up the Screen Definition File

Before using the batch mode, you should go into Plotview and define the screen
layouts you will be printing on a regular basis (see “Saving and Reloading Screen
Definitions” on page 101 for details). For instance, you might have a screen
definition set up to plot BHP vs. time, or BHP and THP vs. time, or both.
Once you have defined the types of plots you want, you can refer to the saved
screen definition file from the command line and have the screen definitions
automatically applied to a specific database to generate hardcopy. If the file
contains multiple screen definitions, they will be concatenated, applied to the
database, and output as a separate hardcopy page for each screen definition. The
screen definition feature in Plotview creates a VSDF file which is saved to disk.
R5000.0.1 Appendix C: Batch Plotview 133

Setting Up Substitution Variables

Normally, the screen definition file defines the specific properties to be plotted.
However, you may want to set up a screen definition file so that the property
name, region name, or other characteristics can be treated as variables that you
can specify from the command line.
The way you do this is by placing a variable string in the VDF file then having
substitution strings that you specify in a substitution file or directly from the
command line. For example, the plotting of a particular property in a VDF file is
controlled by the statement:
property = ’BHP’;
If you open a VDF file, you will see this kind of statement in it. If you want to be
able to replace the property name “on the fly” from the command line, you can
enter a variable name into the file instead of a property name. Any variable name
substituted for a property must be enclosed by percent signs (%), such as:
property = %PTY1%;
and then a substitution string of the following type could be used on the command
line or in a substitution file:
’BHP’
Likewise, you might insert a variable for the Class. In the VDF file, look for every
instance of "Class =" such as:
Class = ’WELL’;
and insert the variable %CLASS% in place of the class name, such as:
Class = %CLASS%;
Inserting variables like these into the file allows you to substitute any string of
names into the VDF file through the command line. If you plan to do a certain
substitutions more than once, you can create a unique substitution file that looks
something like this:
PROPERTY1 ’THP’
PROPERTY2 ’BHP’
where the left column specifies the variable names in the PVDF file and the right
column specifies the strings to be substituted for those variables on any given
batch job. Notice that in the case of property substitutions, the substitution string
must include the single apostrophes with exactly four characters between them
(including a blank, if necessary).
However, you do not have to create a substitution file. You can specify the
substitution strings directly on the command line, as explained in the next section.
134 Appendix C: Batch Plotview R5000.0.1

Starting Batch Mode from the Command Line

Once you have prepared a screen definition file and substitution files (if any), you
can initiate a Plotview job from the command line.
Using Command Line Options

Plotview provides a number of command line options which you can use to
initiate the batch mode. The following command line options are used to run
Plotview in batch mode:
plotview [-study file.vdb [-b batch_template.vdf][-s

substitution_file] [-SUBSTTKEY string] ...]
where:
-study file.vdb or -v file.vdb
Indicates the VDB database file to be plotted. If this option is used alone, it will
start the graphical version of Plotview, with the specified database file already
opened.
-b batch_template.vdf
Indicates the screen definition file that contains the screen definitions you wish to
plot. This file must be set up in Plotview first before you can use it. For details see
“Setting Up the Screen Definition File” on page 133. This is the flag that initiates
the batch mode of Plotview. As such, it is required to operate Plotview in batch
mode. All other flags after this one are optional.
Flags Without Arguments
-m Multiple output files, one for each page.
-u Generate separate page for each plot (turn off montage).
Flags With Arguments
-p type Output file type; CGM or postscript (ps).
-o name Output filename. Defaults to vdb filename root plus output file type
extension.
-lCxR Plot layout in columns and rows, e.g. -l2x2.
-class class Indicates class to be plotted.
-w p.wev Well event file.
R5000.0.1 Appendix C: Batch Plotview 135

-itemfile itemfile
A file containing an item list.
-itemlist itemlist
Comma seperated list of item numbers and or item names to be plotted. E.g., 1-
10,A20 is item numbers 1 thru 10 and item A20.
-c case or -case case
Indicates the case to be plotted.
-s substitution_filename
Name of the substitution file to be used, if any. For details see “Setting Up
Substitution Variables” on page 134. If this flag is omitted (or a substitution file
does not exist), no substitutions will be made in the VDF file unless they are
specified by the next flag.
-SUBSTTKEY string
Substitution strings which can be applied instead of a substitution file, or to

override commands in the substitution file. For instance:
-PROPERTY1 BHP -PROPERTY2 THP
These flags must be at the end of the argument list.
Examples of Command Line Operation

As an example of how you can use the Plotview batch mode, suppose you have a
screen definition file called lgr.vdf and you want to generate hardcopy plot of data
for each well. You would enter the batch command as follows:
plotview -b lgr.vdf
Now suppose you have edited the file lgr.vdf to insert variable strings such as
%PTY1% and %PTY2%, so that you can specify the exact properties to be plotted
as BHP and THP. The command would be:
plotview -b lgr.vdf -PTY1 BHP -PTY2 THP
If instead you created a substitution file called lgr.sub and listed the variable
substitutions in it, the command line might look as follows:
plotview -b lgr.vdf -s lgr.sub
136 Appendix C: Batch Plotview R5000.0.1

Appendix
D
Display window Menu bar Tool bar Scene Title Plot
Control
panel
X/Y axes w/ annotation Trace Legend
Add Panel
A portion of the control panel used to add traces to the display.
annotation
The tick marks, value ranges, and axis titles displayed in the annotation area of
each respective axis. Also, any drawn objects or text added to the plot window.
Annotation Editor
A special panel you can use to add drawn objects or text to the plot window.
R5000.0.1 Appendix D: Glossary 137

attribute panel
A convenient display that shows trace, axis, or font attributes displayed in a

tabular format. Any change made to the panel automatically changes the
corresponding attribute in the display.
Axis menu
A pop-up menu that lets you change the axis annotations in various ways.
Axon database
A proprietary database management system used to store data for use by PlotView
and other Western Atlas Software applications.
broadcast/listen
Broadcasting is the ability to apply changes to the traces in multiple windows.

Listening is the ability of individual windows to “pay attention to” or “ignore”
those changes. Broadcasting can be turned on from the control panel, and listening
can be controlled from the control panel (Active Plots button) or from individual
windows (Listen button in tool bar).
case
A group of related data stored together as a case study in the AXON database.
class
A data category used to indicate how broadly the data applies. For example, the
WELL class contains all data that applies to specific wells.
control panel
The menu panel for adding to or editing plots and for creating new PlotView
windows.
DBPLOT
A Landmark utility used to convert VIP simulation plot data to VDB database
format so it can be used by PlotView.
Edit Panel
A portion of the control panel used to change traces in the display.
138 Appendix D: Glossary R5000.0.1

file
The operating system file containing the AXON database that holds the PlotView
data.
File menu
A pull-down menu that lets you print plot displays or close the current plot display
window.
hardcopy
A feature that lets you capture images for printing or presentation.
item
A member of a class. For example, the class of well data may have multiple items
in it, each item being a separate well.
legend
An optional component of a plot containing a set of lines and symbols along with
the variable name descriptor that they represent.
listen
A feature that allows individual display windows to apply or ignore changes

broadcast from the control panel (see broadcast/listen).
menu bar
An area at the top of the PlotView window containing the pull-down menus for
interacting with the Plot.
observed data
The actual data from historical observation of the reservoir. The observed data, if
available, may be represented by symbols plotted against the X--axis and the
appropriate Y-axis.
pop-up menu
A hidden menu that pops-up from the background when you press and hold down
MB3.

plot
The major component of the PlotView window consisting of a scene, a title, an X-

axis, any number of Y-axes, and optionally a legend.
Plot menu
A pull-down menu that lets you view or change trace attributes, axis annotation
attributes, or general display attributes (title, legend, etc.).
plot window
A managed X-window containing a menu bar, tool bar and plot.
PlotView
The total application containing a single control panel and any number of plot
display windows.
property
A type of data being plotted, such as gas-oil ratio.
pull-down menu
A menu that opens when you click a label on the menu bar.
scene
The graphical area of the plot containing any number of traces of plotted data.
simulated data
The results of a reservoir simulation. The simulated data may be displayed using a
line connecting all the data points. Additionally, the simulated data points may be
represented by symbols.
title
The plot title consisting of up to three lines of text describing the plot.
Automatically determined based on the plotted data or set via menu choices.
tool bar
Optional area (disabled via menu choice) below the menu bar containing a set of
tool icons for interacting with the plot.

trace
A set of data plotted against the X-axis and the assigned Y-axis. The trace contains
both simulated data and optionally observed data.
Trace menu
A pop-up menu that lets you change the attributes of traces in various ways.
X-axis
The horizontal axis against which all traces are plotted. Normally, the X-axis is set
to TIME and can be displayed in YEARS or DAYS. The X-axis can also be set to
a different value other than TIME.
Y-axis
The vertical axes against which the traces are plotted. Each trace is assigned to a
Y-Axis. Multiple traces may be assigned to the same Y-axis. Y-Axes may be
designated as being either Left-Y-axes or Right-Y-axes.
zoom
The ability to enlarge or reduce the prominence of features in a plot scene.


Appendix
E
Well Event files have a .wev file extension and can be used to set well attributes or
to automatically create attributes. These files contain certain keywords defining
the attributes of a well. These keywords and their descriptions are listed below.
Table 1: Well Event File Keywords
Keyword Attribute
abase arrow base angle(75)
abbr label for well event
aends arrow ends - double, top, bottom, or none

(default)
alength arrow length (6) in pixels
atip arrow tip angle (20)
atype arrow type: hollow, stick, or filled

(default)
bcolor text background color
font attributes for well event label (abbr)
family times, courier, schoolbook, or helvetica

(default)
fsize (10)
fslant italic or regular (default)
fweight medium or bold (default)
lcolor line and text color of PROPERTY,

WELL, or EVENT as defined in the
Plotview User’s Guide.
lbottom EVENT bottom point, trace or axis

(default)
ltop EVENT top point, trace or axis (default)
ldash dash style of PROPERTY, WELL, or

EVENT
R5000.0.1 Appendix E: Well Event Files 143

Table 1: Well Event File Keywords (Continued)
Keyword Attribute
lstyle line style of PROPERTY, WELL, or

EVENT, which could be none, on_off,
double, or solid (default)
ltype line type for PROPERTY or WELL, step

or xy (default)
lwidth line width for PROPERTY, WELL, or

EVENT
ocolor observed point color for PROPERTY or

WELL
opoint observed point type for PROPERTY or

WELL
“none”
“X”
“Cross”
“Diamond”
“Square”
“Circle”
“Filled Diamond”
“Filled Square”
“Filled Circle”
“Horizontal Bar”
“Vertical Bar”
osize observed point size for property or well
scolor simulation point color for PROPERTY

or WELL
spoint simulation point type for PROPERTY or

WELL
ssize simulation point size for PROPERTY or

WELL
well event label attributes
talign text alignment (compass position) NW,

N, etc.
tangle text angle (0)
tcolor text color
tdash textbox dash style
tfcolor textbox background fill color
tfill textbox background fill: on or off
144 Appendix E: Well Event Files R5000.0.1

Table 1: Well Event File Keywords (Continued)
Keyword Attribute
title item title appearing in Plot Attribute

Panel as Item Title button, for inclusion
in Plot, Axis, or Legend label;
exclusively a WELL attribute
tstyle line style of text box; none, on or off,

double, or solid (default)
twidth line width of text box (0).
type prototype name for setting default

attributes of events; use as first attribute;
subsequent attributes override them
Note: Well attributes have precedence over Property attributes.
R5000.0.1 Appendix E: Well Event Files 145

Example of Well Event File

/ * example well event file */
PROTOTYPE
prod {tcolor=black}{aends=bottom}{lwidth=1}{ltop=trace}{lcolor=black}
PROPERTY /* corner */
COP {opoint=X}{scolor=navy}{lwidth=2}{osize=5}
CGP {opoint=cross}{scolor=darkgreen}{lwidth=2}{osize=7}
WELL /* corner */
/* class item name [layer] {attributes} */
well J1 {opoint=Filled Diamond} {title=J1-1}{scolor=black}{lwidth=1}
well J3 {opoint=X} {title=J2-2}{scolor=red}{lwidth=3}
EVENT /* corner */
/* date or day class item name [layer]{attributes} */
1/1/84 well J1 {type=prod}{abbr=J1-1}{talign=sw}
1/1/84 wllyrJ1 2 {type=prod}{abbr=J1-layer 2}{talign=se}
1/1/85 well J1 {type=prod}{abbr=J1-2}
1/1/86 well J2 {type=prod}{abbr=J2-1}{talign=sw}{lcolor=green}
7/1/89 well J2 {type=prod}{abbr=J2-1}{talign=sw}{lcolor=green}
1/1/87 well J3 {type=prod}{abbr=J3}{talign=sw}
1/1/88 well J4 {type=prod}{abbr=J4}{lcolor=brown}
6/1/86 well J6 {type=prod}{abbr=J6}{lcolor=green}
WELL /* newgrid */
well S_91 {opoint=Filled Diamond}{title=S_91}{scolor=gold}{lwidth=1}{osize=5}
well S_4 {opoint=Cross}{title=S_4}{scolor=navy}{lwidth=3}{osize=7}
well S_D5 {opoint=X}{title=S_4}{scolor=white}{lwidth=2}{osize=5}
EVENT /* newgrid */
11/30/85 well S_129{type=prod}{abbr=11-30\nstart production}{talign=ne}
4/30/90 well S_129{type=prod}{abbr=4-30 end production}{talign=ne}
1/1/88 well S_D2 {type=prod}{abbr=S_D2}{talign=nw}
4/23/93 well S_133{type=prod}{abbr=S_133}{talign=ne}{lcolor=white}
146 Appendix E: Well Event Files R5000.0.1

Subject Index
AREA class
A definition of 46
area data 21
Add button (control panel)
attribute panels
displaying Add Panel 43
how to read 57
example of use 34
using to change axis annotation 76
Add Left button (control panel)
axis annotation
example of use 35, 39
controllable features 78
procedure on 49
definition of 30
use of 29
minimize or maximize 79
Add Panel
setting notation or precision 79
description of 28
Axis attributes 76
how to display 43
Axis pop-up menu
Add Right button (control panel)
detailed description 32
example of use 35, 39
example of use 37
procedure on 49
Minimize option 79
use of 29
Notation options 79
All Plot Broadcast toggle
example of use 37
using to broadcast 66
Precision option 79
All Plot Broadcast toggle (control panel)
example of use 37
definition of 28
use of 30
Annotation Editor
AXON database files
arrow style customization 98
converting plot data to 115
control panel diagram 87
Copy button 94 B
Cut button 94 batch mode 133
dash style menu customization 96 Broadcast feature
Edit button 92 discussion of 50
fills and patterns 95 Broadcast toggle (control panel)
Front/Back buttons 94 example of use 39
Group button 93 procedure on 49
how to use 87 C
line colors 95 Calculator 28
line width menu customization 97 Case button (control panel)
Paste button 94 procedure on 44
Raise/Lower buttons 94 case studies
Ungroup button 93 use with PlotView 21
Annotation Editor button (control panel) class (data)
definition of 28 list of valid classes 46
R5000.0.1 Subject Index 147

types used in PlotView 21 procedure on 54

Class button (control panel) Delete Current Trace button (control panel)
procedure on 45 example of use 36
colors DESKTOP-VIP
how to change 86 starting PlotView from 26
command line options 135 documentation
comparing data 52 related to Plotview xvi
control panel double-arrow buttons (control panel)
Add button 34, 43 example of use 36
Add Left button 29, 35, 39, 49 use in cycling through data 53
Add Right button 29, 35, 39, 49 drawing objects
All Plot Broadcast toggle 28 how to resize 91
Annotation Editor button 28 drawing shapes 89
Broadcast toggle 39, 49 drawing tools
Case button 44 use of 89
Class button 45 E
Cycle Plot Focus button 39, 53 Edit button (control panel)
Delete buttons 54 example of use 36
Delete Current Trace button 36 Edit Panel
diagram of 27 description of 28
double-arrow buttons 36, 53 example of use 36
Edit button 36 using to change traces 64
Editable option 48 Editable option (control panel)
File button 44 procedure on 48
Item button 47 ellipse tool 89
Layer button 48 F
New Plot button 28, 38, 49, 50 FIELD class
Print button 28, 99 definition of 46
Property button 46 field data 21
Quit button 26, 28 File button (control panel)
Screen Def button 28, 101 procedure on 44
Set X Axis button 51 File menu
Toggle Menu/Tool Bar button 28 Close option 55
Trace slider 36, 58 example of use 40
cross-plotting values 50 definition of 29
current X and Y values display 30 Duplicate option 50
cutting and pasting objects 94 Print option 99
Cycle 28 fill/pattern for drawn objects 95
Cycle Plot Focus button (control panel) FLOSTA class
definition of 39, 53 definition of 46
D flow station data 21
data classes focus
list of valid classes 46 cycling through windows 39, 53
DBPLOT utility fonts
preparing control file for 115 changing for text components 83
Delete buttons (control panel) freestyle drawing tool 89
148 Subject Index R5000.0.1

G procedure on 49, 50
GATHER class O
definition of 46 objects
gathering center data 21 cutting and pasting 94
grouping objects 93 raising or lowering 93
H selecting, grouping, and moving 93
hardcopy observed data
generating from batch mode 133 how displayed 20, 31
hardcopy features 99 preparing for analysis 124
historical data OSF/Motif
how displayed 31 use with PlotView 19
history matching overlapping objects 93
preparing the observed data file 124 P
using PlotView for 20 plot display windows
I broadcasting changes to multiple 66
Item button (control panel) definition of 29
procedure on 47 how to change colors in 86
item number how to read legend and annotation 56
use in PlotView 21 title 30
L Plot menu
Color option 86
Layer button (control panel)
Font option 83
procedure on 48
Size option 84
Layout 28
Plot pop-up menu
legend
definition of 31
Plots menu
how to change position of 80
Attributes option 80
line color selection 95
Axis option 76
line drawing tool 89
example of use 38
Listen button (tool bar)
Color option 86
definition of 30
definition of 29
example of use 38
Fonts option 83
procedure on 50
general usage 30
Listen feature
Size option 84
discussion of 50
Traces option 57, 64
M example of use 38
manuals use to edit traces 31
related to Plotview xvi use in changing title, font, etc. 30
Menus 28 PlotView software
moving objects 93 general guidelines for using 42
multiple displays starting and stopping 26
setting up 50 tutorial on 34
N typical applications 20
New Plot button (control panel) polygon tool 89
definition of 28 polyline tool 89
example of use 38 pop-up menus

Axis menu 30, 32 creating and saving 101

example of use 37 editing 106
Axis/Minimize option 79 opening old ones 104
Axis/Notation options 79 reviewing 106
Axis/Precision option 79 saving to a file 101
general description of 31 Set X Axis button (control panel) 51
Plot menu 31 SIMOUT software
Trace menu 30, 31 relation to PlotView 19
example of use 37 simulation data
PostScript images 99 display of 20
predictive simulations how displayed 31
using PlotView for 20 size
presentations 99 setting for current window 84
Print button (control panel) Spreadsheet menu
definition of 28 Traces option 59
use in hardcopy 99 starting Plotview
printing 99 from DESKTOP-VIP 26
properties from the command line 26
use in PlotView 21 starting/stopping PlotView 26
Property button (control panel) substitution file
procedure on 46 use in batch mode 134
property names T
alphabetical list of 109 text annotation
functional grouping of 112 adding to the plot window 89
pull-down menus how to add and edit 92
definition of 29 Text Object Editor
Q how to use 90, 92
Quit button (control panel) 26 text tool 89
definition of 28 title
R how to change location 80
raising/lowering objects 93 how to change wording of 80
rectangle tool 89 in plot 30
REGION class Toggle Menu/Tool Bar button (control panel)
definition of 46 definition of 28
region data 21 tool bar
reservoir simulation definition of 30
using PlotView with 20 Listen button 30, 38, 50
S Zoom buttons 30
Trace Attributes panel
Screen Def button (control panel)
how to read 57
definition of 28
trace data
use of 101
generating PostScript file 61
screen definition files
saving to a separate file 60
merging 105
Trace Data panel
use in batch mode 133
Print option 61
screen definitions
Save As option 60
150 Subject Index R5000.0.1

Trace pop-up menu

Axis/Show option
example of use 37
example of use 37
Inquire option
example of use 37
use of 30
Trace slider (control panel)
example of use 36
how to use 58
traces
adding to a single window 49
adding to multiple displays 50
getting information about 56
how to change 63
how to highlight 57
overlaying on display 52
removing from display 54
V
VIP simulation plot data
converting to AXON format 115
W
WELL class
definition of 46
well data 21
well layer data 21
WELLYR class
definition of 46
X
X Axis Property selection 51
X/Y values
display of 30
Z
Zoom buttons (tool bar)
definition of 30

Plotview User Guide

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Plotview User Guide

Uploaded by

Copyright:

Available Formats

PlotView™

Landmark Graphics Corporation

About This Manual

R5000.0.1 Table of Contents v

vi Table of Contents R5000.0.1

Changing the Axis Notation Type or Precision . . . . . . . . . . . . . . . . . . . . . . . . . . 79

R5000.0.1 Table of Contents vii

Region Variables (REGION VAR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

viii Table of Contents R5000.0.1

About This Manual

Figure1: History Matching with PlotView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Figure 2: The PlotView Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Plotting the Data

Figure 5: The Add Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

R5000.0.1 List of Figures ix

Figure 19: Edit Panel Trace Change Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Enhancing the Display

Figure 21: Axis Attribute Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Appendix A: Reference Guide to Properties

Appendix B: Converting Data to VDB Format

Figure 0-1: Example of Plot Data Control File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

x List of Figures R5000.0.1

Appendix C: Batch Plotview

Appendix E: Well Event Files

R5000.0.1 List of Figures xi

xii List of Figures R5000.0.1

About This Manual

Plotting the Data

Table 1: Data Classes In PlotView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Enhancing the Display

Table 3: Axis Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Appendix A: Reference Guide to Properties

Table 1: List Of Property Names in Alphabetical Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Appendix B: Converting Data to VDB Format

Appendix C: Batch Plotview

Appendix E: Well Event Files

Table 1: Well Event File Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

R5000.0.1 List of Tables xiii

xiv List of Tables R5000.0.1

About This Manual

■ Chapter 3 - Plotting the Data provides step-by-step procedures on how to

■ Appendix A - Appendix A: Reference Guide to Properties provides a

■ Appendix B - Appendix B: Converting Data to VDB Format explains how

R5000.0.1 About This Manual xv

■ Appendix C - Appendix C: Batch Plotview explains how to use the batch

■ Appendix D - Appendix D: Glossary explains the various terminology used

Using the Mouse

■ VIP-CORE Reference Manual. A complete summary of all keywords and

■ VIP-EXECUTIVE Reference Manual. A complete summary of the

■ VIP-EXECUTIVE Technical Manual. A detailed discussion of the

■ VIP-THERM Reference Manual. A summary of the keywords and data

■ DESKTOP-PVT User’s Guide. A summary of the keywords and data entry

xvi About This Manual R5000.0.1

■ GRIDGENR User Guide. A complete guide to the GRIDGENR software

■ CURVED User Guide. A complete guide to the Landmark curve editing

R5000.0.1 About This Manual xvii

xviii About This Manual R5000.0.1

■ View color-coded plots of simulation data in a graphical display.

■ Overlay multiple curves on the same display for side-by-side comparison.

■ Create multiple displays containing different combinations of plotted data.

■ View the individual data points in a plot.

■ Produce hardcopy of plot displays for use in reports or presentations.

This chapter provides a preliminary introduction to the PlotView software and