You are on page 1of 148

PlotView

User Guide
2001, 2002 Landmark Graphics Corporation

Part No. 159676 R2003.4

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


Building 1, Suite 200, 2101 CityWest, Houston, Texas 77042, USA
P.O. Box 42806, Houston, Texas 77242, USA
Phone: 713-839-2000
FAX: 713-839-2401
Web: www.lgc.com

Trademark Notice
Landmark, the Landmark logo, 3D Drill View, 3D Drill View KM, 3DVIEW, Active Field Surveillance, Active
Reservoir Surveillance, ARIES, Automate, BLITZ, BLITZPAK, CasingSeat, COMPASS, Contouring Assistant,
DataStar, DBPlot, Decision Suite, Decisionarium, DecisionDesktop, DecisionSpace, DepthTeam, DepthTeam
Explorer, DepthTeam Express, DepthTeam Extreme, DepthTeam Interpreter, DESKTOP-PVT, DESKTOP-VIP,
DEX, DFW, DIMS, Discovery, Drillability Suite, DrillModel, DrillVision, DSS, Dynamic Surveillance System,
EarthCube, EdgeCa$h, eLandmark, EPM, e-workspace, FastTrack, FZAP!, GeoDataLoad, GeoGraphix, GeoGraphix
Exploration System, GeoLink, GES, GESXplorer, GMAplus, GrandBasin, GRIDGENR, I2 Enterprise, iDims,
IsoMap, LandScape, LeaseMap, LMK Resources, LogEdit, LogM, LogPrep, Make Great Decisions, MathPack,
Model Builder, MyLandmark, MyWorkspace, OpenBooks, OpenExplorer, OpenJournal, OpenSGM, OpenTutor,
OpenVision, OpenWorks, OpenWorks Well File, PAL, Parallel-VIP, PetroBank, PetroWorks, PlotView, Point
Gridding Plus, Pointing Dispatcher, PostStack, PostStack ESP, PRIZM, PROFILE, ProMAX, ProMAX 2D, ProMAX
3D, ProMAX 3DPSDM, ProMAX MVA, ProMAX VSP, pStaX, QUICKDIF, RAVE, Real Freedom, Reservoir
Framework Builder, RESev, ResMap, RMS, SafeStart, SCAN, SeisCube, SeisMap, SeisModel, SeisSpace,
SeisVision, SeisWell, SeisWorks, SeisXchange, SigmaView, SpecDecomp, StrataMap, Stratamodel, StratAmp,
StrataSim, StratWorks, StressCheck, STRUCT, SynTool, SystemStart, T2B, TDQ, TERAS, Total Drilling
Performance, TOW/cs, TOW/cs The Oilfield Workstation, Trend Form Gridding, Turbo Synthetics, VIP, VIP-COMP,
VIP-CORE, VIP-DUAL, VIP-ENCORE, VIP-EXECUTIVE, VIP-Local Grid Refinement, VIP-POLYMER, VIPTHERM, WavX, Web OpenWorks, Well Editor, Wellbase, Wellbore Planner, WELLCAT, WELLPLAN,
WellXchange, wOW, Xsection, ZAP!, Z-MAP Plus are trademarks, registered trademarks or service marks of
Landmark Graphics Corporation.
All other trademarks are the property 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.

Table of Contents
Preface

About This Manual


Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Using the Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Overview
What Is PlotView? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Why Use PlotView? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Summary of PlotView Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Data Loading and Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Plotting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Display Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Getting Started
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Starting and Stopping PlotView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Starting from DESKTOP-VIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Starting from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Quitting PlotView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Understanding the PlotView Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
PlotView Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
PlotView Display Window(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Pull-Down Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Current X/Y Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Axis Annotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Legend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Pop-Up Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Attribute Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
PlotView Quick Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Add a Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
View/Edit Trace Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Use the Pop-Up Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
R2003.4 - Landmark

iii

Table of Contents

PLOTVIEW USERS GUIDE

Use the Attribute Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20


Add Windows and Make Them Listen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Add Multiple Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Close a Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Plotting the Data


Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
General Guidelines for Plotting Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Creating New Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Selecting Data To Be Plotted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Plotting a Trace In a Single Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Adding the Same Trace to Multiple Displays . . . . . . . . . . . . . . . . . . . . . . . . 32
Cross-Plotting Different Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Comparing Data Using Overlaid Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Cycling Through All Available Items in the Database . . . . . . . . . . . . . . . . 35
Cycling Through All Available Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Removing Traces from a Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Closing a Display Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Analyzing Displayed Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Reading the Legend and Annotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Viewing the Trace Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Highlighting the Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Viewing the Trace Data Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Saving Trace Data to a Separate File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Saving Trace Data to a PostScript File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Changing the Plotted Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Changing Individual Traces Using the Control Panel . . . . . . . . . . . . . . . . 45
Changing Individual Traces Using the Attributes Panel . . . . . . . . . . . . . . 46
Broadcasting a Change to Multiple Windows . . . . . . . . . . . . . . . . . . . . . . . 48
Calculating New Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Understanding the Calculator Keypad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Calculator Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Understanding How New Traces are Calculated . . . . . . . . . . . . . . . . . . . . 51
Understanding How Formulas are Built . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Calculating a New Trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Examples of Calculated Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Enhancing the Display


Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Changing the Layout of the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Changing Axis Scaling, Labels, or Other Attributes . . . . . . . . . . . . . . . . . . 58
Changing the Axis Notation Type or Precision . . . . . . . . . . . . . . . . . . . . . . 61
Minimizing/Maximizing the Axis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Changing the Plot Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

iv

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Table of Contents

Setting Up the Title and Legend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62


Changing the Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Setting the Plot Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Changing the Plot Window Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Adding and Changing Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Adding Drawn Objects to the Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Reshaping or Resizing an Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Editing a Text Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Selecting, Grouping, and Moving Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Changing the Sequence of Overlapping Objects . . . . . . . . . . . . . . . . . . . . . 76
Cutting, Copying, and Pasting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Changing the Fill, Line or Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Customizing the Dash Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Customizing the Line Width Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Customizing the Arrow Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Capturing an Image for Hardcopy Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Saving and Reloading Screen Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Creating and Saving a New Screen Definition File . . . . . . . . . . . . . . . . . . . 83
Loading an Existing Screen Definition File . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Merging Two Screen Definition Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Reviewing the Available Scenes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Editing the Scenes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Appendix A: Reference Guide to Properties


Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Alphabetical List of Property Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Property Names Grouped By Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Appendix B: Converting Data to VDB Format


Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Preparing the Control File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Example of Control File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Control File Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Database Filename/Casename (PLOT) . . . . . . . . . . . . . . . . . . . . . . . 99
Observed Data Filename (OBS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Name of Plot File (FILE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Name of CASE File (CASE) (optional) . . . . . . . . . . . . . . . . . . . . . . . 100
Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Start Date of file (STARTDATE) (optional) . . . . . . . . . . . . . . . . . . . 100
Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Well Variables (WELL VAR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Gathering Center Variables (GATHER VAR) . . . . . . . . . . . . . . . . . 101
Region Variables (REGION VAR) . . . . . . . . . . . . . . . . . . . . . . . . . . 102

R2003.4 - Landmark

Table of Contents

PLOTVIEW USERS GUIDE

Field Variables (FIELD VAR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103


Time Specification, In Days (TIME) . . . . . . . . . . . . . . . . . . . . . . . . . 104
Time Specification, In Timesteps (TSTEP) . . . . . . . . . . . . . . . . . . . . 105
End of Plot File (EOF) (optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Preparing the Observed Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Example of File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Observed Data File Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Title of Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Initial Date, Maximum Time Entries, Units . . . . . . . . . . . . . . . . . . 108
Number of Class Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Class Names, Maximum Items, Number of Properties . . . . . . . . . 109
Property Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Time/Date and Property Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
End of Observed Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
File Inclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Running DBPLOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
DBPLOT Comand Line Dump Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

Appendix C: Batch Plotview


Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Preparing to Use Batch Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Setting Up the Screen Definition File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Setting Up Substitution Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Starting Batch Mode from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Using Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Examples of Command Line Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Appendix D: Glossary
Appendix E: Well Event Files
Example of Well Event File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Subject Index

vi

Landmark - R2003.4

List of Figures
About This Manual
Overview
Figure1: History Matching with PlotView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Getting Started
Figure 1: The PlotView Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Figure 2: Example of Trace Plotted in a Display Window . . . . . . . . . . . . . . . . . . . . . . . . . 11
Figure 3: The Attribute Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Plotting the Data


Figure 2: The Add Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Figure 3: File Selection Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Figure 4: Case Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Figure 5: Class Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Figure 6: The Property Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Figure 7: Item Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Figure 8: Plotting a Trace in a Single Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Figure 9: X Axis Property Selection Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Figure 10: Edit Panel Delete Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Figure 11: Reading the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Figure 12: Reading the Trace Attribute Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Figure 13: Trace Data Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Figure 14: Save File Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Figure 15: Print File Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Figure 16: Edit Panel Trace Change Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Figure 17: Trace Attribute Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

R2003.4- Landmark

vii

List of Figures

PLOTVIEW USERS GUIDE

Enhancing the Display


Figure 18: Axis Attribute Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Figure 19: The Plot Attributes Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Figure 20: Font Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Figure 21: Plot Size Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Figure 22: The Plot Color Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Figure 23: Annotation Editor Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Figure 24: Drawing Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Figure 25: Text Object Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Figure 26: Drawing Object Control Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Figure 27: Text Object Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Figure 28: Fill, Line, and Pattern Selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Figure 29: Dash List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Figure 30: Line Width Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Figure 31: Arrowhead Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Figure 32: The Print Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Figure 33: Screen Definition Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Figure 34: Screen Definition File Selection Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Figure 35: Open File Selection Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Figure 36: Import Screen Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Appendix A: Reference Guide to Properties


Appendix B: Converting Data to VDB Format
Figure 1: Example of Plot Data Control File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Figure 2: Example of Observed Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Appendix C: Batch Plotview


Appendix D: Glossary
Appendix E: Well Event Files
Subject Index

viii

Landmark - R2003.4

List of Tables
About This Manual
Overview
Getting Started
Plotting the Data
Table 1: Data Classes In PlotView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Table 2: Trace Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Enhancing the Display


Table 3: Axis Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Table 4: Plot Attribute Panel Fields and Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Table 5: Summary of Annotation Editor Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Appendix A: Reference Guide to Properties


Table 1: List Of Property Names in Alphabetical Order . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Table 2: List Of Property Names Grouped By Function . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Appendix B: Converting Data to VDB Format


Appendix C: Batch Plotview
Appendix D: Glossary
Appendix E: Well Event Files
Table 3: Well Event File Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Subject Index

R2003.4- Landmark

ix

List of Tables

PLOTVIEW USERS GUIDE

Landmark - R2003.4

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-ofuse 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:

R2003.4 - Landmark

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.

xi

About This Manual

PLOTVIEW USERS GUIDE

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.

xii

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 Users 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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

About This Manual

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.

R2003.4- Landmark

xiii

About This Manual

xiv

PLOTVIEW USERS GUIDE

Landmark - R2003.4

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:

R2003.4- Landmark

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 easyto-use new point-and-click design based on the standard OSF/Motif
window interface.

Overview

PLOTVIEW USERS GUIDE

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 PlotViews 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

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Overview

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.

R2003.4- Landmark

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.

Overview

PLOTVIEW USERS GUIDE

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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

R2003.4- Landmark

Overview

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.

Overview

PLOTVIEW USERS GUIDE

Landmark - R2003.4

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 PlotViews major features.

Before using this chapter, you should be familiar with the general features
of the PlotView program, as explained in Chapter 1.

R2003.4- Landmark

Getting Started

PLOTVIEW USERS GUIDE

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 1.

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 1. 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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Getting Started

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 1: The PlotView Control Panel

R2003.4- Landmark

Getting Started

PLOTVIEW USERS GUIDE

The major components of the control panel are listed below:

10

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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Getting Started

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 25).
Pull-down menus

Axis annotations

Zoom and broadcast controls

Trace

Title

Current X/Y Values

Legend

Figure 2: 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:

R2003.4- Landmark

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.

11

Getting Started

PLOTVIEW USERS GUIDE

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.

12

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Getting Started

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.

R2003.4- Landmark

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.

13

Getting Started

PLOTVIEW USERS GUIDE

14

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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Getting Started

Attribute Panels
For maximum ease-of-use, PlotView provides attribute panels that show
all trace, axis annotation, and font attributes, as shown below.

Figure 3: 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.

R2003.4- Landmark

15

Getting Started

PLOTVIEW USERS GUIDE

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

16

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Getting Started

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.

R2003.4- Landmark

17

Getting Started

PLOTVIEW USERS GUIDE

View/Edit Trace Parameters


8. 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.

9. 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.
10. 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.
11. 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.

18

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Getting Started

Use the Pop-Up Menus


12. Hold down MB3 on any trace to see the Trace menu pop up.

13. Select Trace Attributes from the Trace menu. This displays the Trace
Attribute panel shown below (click OK to dismiss it).

14. Press and hold MB3 on any axis annotation area to view the Axis
menu shown below.

15. Select Notation/Integer then select Notation/Float from the Axis


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

R2003.4- Landmark

19

Getting Started

PLOTVIEW USERS GUIDE

Use the Attribute Panels


18. 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.
19. 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).
20. Try this with other cells in the panel.
21. Open other panels on the Plots menu and study them.

Add Windows and Make Them Listen


22. Click the New Plot button on the control panel again. Notice that this
adds another empty window to the display.
23. 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.
24. 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


25. 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.
20

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Getting Started

26. 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.
27. 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.
28. 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.
29. 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.
30. 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.

R2003.4- Landmark

21

Getting Started

PLOTVIEW USERS GUIDE

Close a Display
31. 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.
32. 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.

22

Landmark - R2003.4

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 9.

R2003.4- Landmark

23

Plotting the Data

PLOTVIEW USERS GUIDE

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.

24

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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 2: The Add Panel

R2003.4- Landmark

25

Plotting the Data

PLOTVIEW USERS GUIDE

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 3: 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 24). 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.

26

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

Figure 4: 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 5: Class Selection List

R2003.4- Landmark

27

Plotting the Data

PLOTVIEW USERS GUIDE

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 6: The Property Selection List

28

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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 7: 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.

R2003.4- Landmark

29

Plotting the Data

PLOTVIEW USERS GUIDE

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.

30

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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 8: Plotting a Trace in a Single Window

R2003.4- Landmark

31

Plotting the Data

PLOTVIEW USERS GUIDE

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 25).
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.

32

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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 9: 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.

R2003.4- Landmark

33

Plotting the Data

PLOTVIEW USERS GUIDE

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.

34

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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:

R2003.4- Landmark

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.

35

Plotting the Data

PLOTVIEW USERS GUIDE

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 10: 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.

36

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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.

R2003.4- Landmark

37

Plotting the Data

PLOTVIEW USERS GUIDE

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 11: Reading the Display

38

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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 12: 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 46).

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

R2003.4- Landmark

39

Plotting the Data

PLOTVIEW USERS GUIDE

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).

40

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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 13: 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.

R2003.4- Landmark

41

Plotting the Data

PLOTVIEW USERS GUIDE

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 13).
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 14: 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.

42

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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 13).
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 15: Print File Panel

3. Specify the various print options listed at the top of the panel.

R2003.4- Landmark

Color/
Monochrome

Click on Color if you expect to use a color printer, otherwise


click 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.

43

Plotting the Data

PLOTVIEW USERS GUIDE

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.

44

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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 16: 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.

R2003.4- Landmark

45

Plotting the Data

PLOTVIEW USERS GUIDE

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 25). 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 17: 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.

46

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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

R2003.4- Landmark

Column
Heading

Meaning

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/
Width

The style and width of the line used to draw this trace.
Width measurement is in screen pixels.

Point
Symbol/
Size/Color

The type, size, and color of the graphic symbol used to


indicate simulation data points for this property. Selecting
off for the symbol turns off the display of simulation data
points.

Obs Pt/
Size/Color

The type, size, and color of the graphic symbol used to


indicate observed data points for this property. Selecting
off for Obs Pt turns off the display of observed data
points.

Vertical/
Horizontal
Axis

The value plotted against the vertical and horizontal axis


for each trace.

47

Plotting the Data

PLOTVIEW USERS GUIDE

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 16).
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 25). The changes are applied to
all windows as soon as you make the selection.
NOTE:

48

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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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

R2003.4- Landmark

49

Plotting the Data

PLOTVIEW USERS GUIDE

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:

50

<

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

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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.

R2003.4- Landmark

51

Plotting the Data

PLOTVIEW USERS GUIDE

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.

3. Enter name of new trace.

2. Clicking here adds it to formula.

4. Formula appears here


5. Click here to display result

52

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

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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.

7. Enter name of new trace.

3. Clicking here adds it to formula.

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.

R2003.4- Landmark

53

Plotting the Data

PLOTVIEW USERS GUIDE

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.

54

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Plotting the Data

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.

R2003.4- Landmark

55

Plotting the Data

56

PLOTVIEW USERS GUIDE

Landmark - R2003.4

Enhancing the Display


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 9.

R2003.4- Landmark

57

Enhancing the Display

PLOTVIEW USERS GUIDE

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 18: 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:

58

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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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 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
Heading

R2003.4- Landmark

Meaning

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 minimummaximum 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 minimummaximum 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.

59

Enhancing the Display

PLOTVIEW USERS GUIDE

Table 3: Axis Attributes


Column
Heading

Meaning

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.

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.

60

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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.

R2003.4- Landmark

61

Enhancing the Display

PLOTVIEW USERS GUIDE

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 plots
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.

62

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

Figure 19: The Plot Attributes Panel

R2003.4- Landmark

63

Enhancing the Display

PLOTVIEW USERS GUIDE

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
Button

64

How to Use

Plot Title

You can edit this or click on any of the buttons below it to


insert variables into the plot title.

Trace
Values

Select exclusive if you only want macros expanded to a


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
Values

Select exclusive if you only want macros expanded to a


value when all the traces of the axis 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.

Legend
Entry

You can edit the label manually or click on any of the


buttons below it to insert variables.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

Table 4: Plot Attribute Panel Fields and Buttons


Field or
Button

How to Use

Legend
Values

Select exclusive if you only want macros expanded to a


value when all the trace attributes 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.

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.

R2003.4- Landmark

65

Enhancing the Display

PLOTVIEW USERS GUIDE

Figure 20: 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.

66

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

Figure 21: 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.

R2003.4- Landmark

67

Enhancing the Display

PLOTVIEW USERS GUIDE

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 22: 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:

68

If you have not used OK, Apply, or Auto yet, you can click the Reset
button to return the colors to their original settings.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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 23: Annotation Editor Control Panel

R2003.4- Landmark

69

Enhancing the Display

PLOTVIEW USERS GUIDE

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)

70

Purpose

Group/Ungroup

Lets you group or ungroup drawn objects.

Raise/Lower
Front/Back

Lets you change the sequence of overlapping objects in a


stack 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,
including 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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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
Text

Polyline

Figure 24: 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,
round box,
ellipse

Drag the mouse diagonally across the area to be covered by


the object until the object is the desired size and shape, then
release 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.

R2003.4- Landmark

71

Enhancing the Display

PLOTVIEW USERS GUIDE

Figure 25: 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/
Vertical
Alignment

The desired alignment for the text. Horizontal Alignment can 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

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

72

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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 26: 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.

R2003.4- Landmark

73

Enhancing the Display

PLOTVIEW USERS GUIDE

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 27: Text Object Editor

3. Make the desired changes in the Text Object Editor dialog. You can
change any of the features listed below:

74

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/
Vertical Alignment

The desired alignment for the text. Horizontal Alignment


can be left/center/right. Vertical Alignment is top/center/bottom.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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.

R2003.4- Landmark

75

Enhancing the Display

PLOTVIEW USERS GUIDE

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.

76

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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 28: 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.

R2003.4- Landmark

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.

77

Enhancing the Display

PLOTVIEW USERS GUIDE

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 28 on page 77). This displays the Dash List.

Figure 29: 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).

78

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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 28
on page 77). This displays the Line Width panel.

Figure 30: 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.
4. Click the OK button when you are finished using this panel (or click
Cancel to close the panel without applying your selections).

R2003.4- Landmark

79

Enhancing the Display

PLOTVIEW USERS GUIDE

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 28 on page 77). This displays the Arrowhead Editor panel.

Figure 31: 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.
5. Click the OK button when you are finished using this panel (or click
Cancel 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.

80

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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 32: 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:

R2003.4- Landmark

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.

81

Enhancing the Display

PLOTVIEW USERS GUIDE

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:

82

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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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 33: 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 isnt an unnamed
scene line, use the Edit/Insert command on the pull-down menu to
insert one before or after the currently selected line.

R2003.4- Landmark

83

Enhancing the Display

PLOTVIEW USERS GUIDE

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 34: 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.

84

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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.

R2003.4- Landmark

85

Enhancing the Display

PLOTVIEW USERS GUIDE

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 35: 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.

86

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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 36: 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.

R2003.4- Landmark

87

Enhancing the Display

PLOTVIEW USERS GUIDE

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 33)
using the following procedures. Notice all of the options described below
are available on the Edit pull-down menu, or the MB3 mouse button popup 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.

88

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Enhancing the Display

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.

R2003.4- Landmark

89

Enhancing the Display

PLOTVIEW USERS GUIDE

For example:

90

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.

Landmark - R2003.4

Appendix A: Reference Guide to Properties


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
Name

Description

English
Units

Metric
Units

Applicable
Classes

Applicable
Simulators

BHP

Bottom-hole pressure - Datum

PSIA

KPA

VMET

BHT

Bottom hole temperature

WF

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

CHCP

Cumulative heavy component


production

MSTB

MSTCM

WGRF

CGI

Cumulative gas injection

MMSCF

MMSCM

WF

VME

CHI

Cumulative heat injection

MBTU

MBTU

WF

CHP

Cumulative heat production

MBTU

MBTU

WF

COI

Cumulative oil injection

MSTB

MSTCM

WF

COP

Cumulative oil production

MSTB

MSTCM

WGRF

VMET

CSI

Cumulative solvent injection

MSTB

MSTCM

WGRF

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

R2003.4 - Landmark

91

Appendix A: Reference Guide to Properties

PLOTVIEW USERS GUIDE

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


Property
Name

Description

English
Units

Metric
Units

Applicable
Classes

Applicable
Simulators

CSP

Cumulative solvent production

MSTB

MSTCM

WGRF

CSP

Cumulative solvent production

MMSCF

MMSCM

WF

CSTP

Cumulative steam production

MSTB

MMSCM

WF

CWI

Cumulative water injection

MSTB*
MMSTB**

MSTCM*
MMSTCM**

WGRF

VMET

CWP

Cumulative water production

MSTB*
MMSTB**

MSTCM*
MMSTCM**

WGRF

VMTE

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

HCMF

Average heavy component


mole fraction

Fraction

Fraction

OIP

Oil in place

MSTB

MSTCM

RF

VME

PAVE

Grid block datum pressure

PSIA

KPA

VE

PAVH

Average pressure (weighted by


hydrocarbon pore volume)

PSIA

KPA

RF

VME

PAVT

Average pressure (weighted by


total pore volume)

PSIA

KPA

RF

VME

PTOP

Grid block pressure

PSIA

KPA

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

QHI

Heat injection rate

BTU/DAY

BTU/DAY

WF

QHP

Heat production rate

BTU/DAY

BTU/DAY

WF

QOI

Oil injection rate

STB/DAY

STCM/DAY

WF

QOP

Oil production rate

STB/DAY

STCM/DAY

WGRF

VMET

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

92

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix A: Reference Guide to Properties

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


Property
Name

Description

English
Units

Metric
Units

Applicable
Classes

Applicable
Simulators

QSI

Solvent injection rate

STB/DAY

STCM/DAY

WGRF

QSP

Solvent production rate

STB/DAY

STCM/DAY

WGRF

QSTP

Steam production rate

STB/DAY

MSCM/
DAY

WF

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

SO

Oil saturation

FRACTION

FRACTION

WF

SW

Water saturation

FRACTION

FRACTION

WF

THP

Tubing-head pressure

PSIA

KPA

VMET

WCUT

Water cut

Fraction

Fraction

WGRF

VMET

WIP

Water in place

MMSTB

MMSTCM

RF

VME

WOR

Water-oil ratio

STB/STB

STCM/
STCM

WGRF

VMET

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

R2003.4 - Landmark

93

Appendix A: Reference Guide to Properties

PLOTVIEW USERS GUIDE

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
Property
Name

Description

English
Units

Metric
Units

Applicable
Classes

Applicable
Simulators

Rate, Production
GOR

Gas-oil ratio

SCF/STB

SCM/STCM

WGRF

VME

CGV

Produced gas gravity

AIR=1.0

AIR=1.0

HCMF

Average heavy component


mole fraction

Fraction

Fraction

QGP

Gas production rate

MSCF/DAY

MSCM/
DAY

WGRF

VME

QHCP

Heavy component production rate

STB/DAY

STCM/DAY

WGRF

QOP

Oil production rate

STB/DAY

STCM/DAY

WGRF

VME

QSP

Solvent production rate

STB/DAY

STCM/DAY

WGRF

QWP

Water production rate

STB/DAY

STCM/DAY

WGRF

VME

WCUT

Water cut

Fraction

Fraction

WGRF

VME

WOR

Water-oil ratio

STB/STB

STCM/
STCM

WGRF

VME

QSTP

Steam Production Rate

STB/DAY

MSCM/
DAY

WF

QHP

Heat Production Rate

BTU/DAY

BTU/DAY

WF

Rate, Injection
QGI

Gas injection rate

MSCF/DAY

MSCM/
DAY

WGRF

VME

QSI

Solvent injection rate

STB/DAY

STCM/DAY

WGRF

QWI

Water injection rate

STB/DAY

STCM/DAY

WGRF

VME

QOI

Oil Injection Rate

STB/DAY

STCM/DAY

WF

QHI

Cumulative Heat Injection

MBTU

MBTU

WF

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

94

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix A: Reference Guide to Properties

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


Property
Name

Description

English
Units

Metric
Units

Applicable
Classes

Applicable
Simulators

Cumulative, Production
CGP

Cumulative gas production

MMSCF

MMSCM

WGRF

VME

CHCP

Cumulative heavy component

MSTB

MSTCM

WGRF

COP

Cumulative oil production

MSTB

MSTCM

WGRF

VME

CSP

Cumulative solvent production

MSTB

MSTCM

WGRF

CWP

Cumulative water production

MSTB*
MMSTB**

MSTCM*
MMSTCM**

WGRF

VME

CSTP

Cumulative Steam Production

MSTB

MMSCM

WF

CHP

Cumulative Heat Production

MBTU

MBTU)

WF

Cumulative, Injection
CGI

Cumulative gas injection

MMSCF

MMSCM

WGRF

VME

CSI

Cumulative solvent injection

MSTB

MSTCM

WGRF

CWI

Cumulative water injection

MSTB*
MMSTB**

MSTCM*
MMSTCM**

WGRF

VME

COI

Cumulative Oil Injection

MSTB

MSTCM

WF

CHI

Cumulative Heat Injection

MBTU

MBTU

WF

Pressure, Saturation, Temp


PAVH

Average pressure (weighted


by hydrocarbon pore volume)

PSIA

KPA

RF

VME

PAVT

Average pressure (weighted


by total pore volume)

PSIA

KPA

RF

VME

BHP

Bottom-hole pressure

PSIA

KPA

VME

PTOP

Grid block pressure

PSIA

KPA

VME

PAVE

Grid block datum pressure

PSIA

KPA

VE

THP

Tubing-head pressure

PSIA

KPA

VME

SO

Oil Saturation

FRACTION

FRACTION

WF

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

R2003.4 - Landmark

95

Appendix A: Reference Guide to Properties

PLOTVIEW USERS GUIDE

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


Property
Name

Description

English
Units

Metric
Units

Applicable
Classes

Applicable
Simulators

SW

Water Saturation

FRACTION

FRACTION

WF

BHT

Bottom Hole Temperature

WF

In Place Volumes
HCIP

Heavy component in place

MSTB

MSTCM

RF

OIP

Oil in place

MSTB

MSTCM

RF

VME

SIP

Solvent in place

MSTB

MSTCM

RF

GIP

Total gas in place

MMSCF

MMSCM

RF

VME

WIP

Water in place

MMSTB

MMSTCM

RF

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

96

Landmark - R2003.4

Appendix B: Converting Data to VDB


Format
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.

R2003.4 - Landmark

97

Appendix B: Converting Data to VDB Format

PLOTVIEW USERS GUIDE

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.

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
Case name

CASE casename [parent case] (optional)

Start date of study

STARTDATE day month year

Well variable
name list

WELL VAR
QOP QWP QGP
COP CWP CGP
ENDVAR

FILE input.filename

Gathering center
variable name list

GATHER VAR
QOP QWP QGP
COP CWP CGP
ENDVAR

Region variable
name list

REGION VAR
OIP GIP WIP
QOP QWP QGP
COP CWP
ENDVAR

Field variable
name list

FIELD VAR
OIP GIP WIP
QOP QWP QGP
COP CWP CGP
ENDVAR

Time specs (in days


or timesteps)

TIME
10 TO 30
ENDTIM
EOF

Specify second
simulator plot file

End first simulator


plot file (optional)

FILE input.filename
TSTEP
5 TO 300 BY 2
ENDTIM
EOF

End second simulator


plot file (optional)

Figure 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

98

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix B: Converting Data to VDB Format

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.

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
filename)

File name of the VDB file to be created by DBPLOT. The extension .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:

R2003.4 - Landmark

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 106).

99

Appendix B: Converting Data to VDB Format

PLOTVIEW USERS GUIDE

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:
Definition

casename [parentcase]
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

100

Alpha label indicating the start of well variables.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix B: Converting Data to VDB Format

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:

R2003.4 - Landmark

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.

101

Appendix B: Converting Data to VDB Format

PLOTVIEW USERS GUIDE

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:

102

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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix B: Converting Data to VDB Format

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:

R2003.4 - Landmark

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.

103

Appendix B: Converting Data to VDB Format

PLOTVIEW USERS GUIDE

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:

104

TIME

Alpha label indicating that extracted plot data must be limited


to certain 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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix B: Converting Data to VDB Format

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.

R2003.4 - Landmark

105

Appendix B: Converting Data to VDB Format

PLOTVIEW USERS GUIDE

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 2: Example of Observed Data File

106

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix B: Converting Data to VDB Format

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 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 99). 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:

R2003.4 - Landmark

OBS

Alpha label indicating observed data is being entered.

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.

107

Appendix B: Converting Data to VDB Format

PLOTVIEW USERS GUIDE

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, gathering 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. 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

108

Number of class names being entered. Valid entries are 1, 2, 3,


or 4.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix B: Converting Data to VDB Format

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:

R2003.4 - Landmark

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 number 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.

109

Appendix B: Converting Data to VDB Format

PLOTVIEW USERS GUIDE

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:

110

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.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix B: Converting Data to VDB Format

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
(item name)

The number of the item within that class (e.g., if entering the
data for 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 itemname must be nonnumeric. 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

R2003.4 - Landmark

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.

111

Appendix B: Converting Data to VDB Format

nprop

PLOTVIEW USERS GUIDE

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 simulation 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

112

A valid path or filename for the operating system.

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix B: Converting Data to VDB Format

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.

R2003.4 - Landmark

113

Appendix B: Converting Data to VDB Format

PLOTVIEW USERS GUIDE

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:

114

-dump=dumptype

valid types: form - VIP formatted plot file (default)


gss - generic spreadsheet file
pass - .pa spreadsheet file
ow - OpenWorks project

-case=casename

specify case name

-o=options

specify 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.

Landmark - R2003.4

Appendix C: Batch Plotview


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 83 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.

R2003.4 - Landmark

115

Appendix C: Batch Plotview

PLOTVIEW USERS GUIDE

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.

116

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix C: Batch Plotview

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 115. 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

R2003.4 - Landmark

Well event file.

117

Appendix C: Batch Plotview

PLOTVIEW USERS GUIDE

-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 116. 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

118

Landmark - R2003.4

Appendix D: Glossary
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.

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.

R2003.4 - Landmark

119

Appendix D: Glossary

PLOTVIEW USERS GUIDE

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.

file
The operating system file containing the AXON database that holds the
PlotView data.

120

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix D: Glossary

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.

R2003.4 - Landmark

121

Appendix D: Glossary

PLOTVIEW USERS GUIDE

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.

122

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix D: Glossary

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 Xaxis 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.

R2003.4 - Landmark

123

Appendix D: Glossary

124

PLOTVIEW USERS GUIDE

Landmark - R2003.4

Appendix E: Well Event Files


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 3: 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)

R2003.4 - Landmark

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 Users 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

125

Appendix E: Well Event Files

PLOTVIEW USERS GUIDE

Table 3: 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

126

talign

text alignment (compass position)


NW, N, etc.

tangle

text angle (0)

tcolor

text color

tdash

textbox dash style

tfcolor

textbox background fill color

Landmark - R2003.4

PLOTVIEW USERS GUIDE

Appendix E: Well Event Files

Table 3: Well Event File Keywords (Continued)


Keyword

Attribute

tfill

textbox background fill: on or off

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.

R2003.4 - Landmark

127

Appendix E: Well Event Files

PLOTVIEW USERS GUIDE

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/89
well J5
{type=prod}{abbr=J5}{talign=sw}
6/1/86
well J6
{type=prod}{abbr=J6}{lcolor=green}
1/1/89
well J7
{type=prod}{abbr=J7}{talign=sw}
1/1/85
well J8
{type=prod}{abbr=J8}{lcolor=brown}
6/1/87
well J9
{type=prod}{abbr=J9}{talign=sw}
6/1/88
well J10 {type=prod}{abbr=J10}{lcolor=brown}
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}

128

Landmark - R2003.4

000000Subject Index
A
Add button (control panel)
displaying Add Panel 25
example of use 16
Add Left button (control panel)
example of use 17, 20
procedure on 31
use of 11
Add Panel
description of 10
how to display 25
Add Right button (control panel)
example of use 17, 21
procedure on 31
use of 11
All Plot Broadcast toggle
using to broadcast 48
All Plot Broadcast toggle (control panel)
definition of 10
Annotation Editor
arrow style customization 80
control panel diagram 69
Copy button 76
Cut button 76
dash style menu customization 78
Edit button 74
fills and patterns 77
Front/Back buttons 76
Group button 75
how to use 69
line colors 77
line width menu customization 79
Paste button 76
Raise/Lower buttons 76
Ungroup button 75

R2003.4 - Landmark

Annotation Editor button (control panel)


definition of 10
AREA class
definition of 28
area data 3
attribute panels
how to read 39
using to change axis annotation 58
axis annotation
controllable features 60
definition of 12
minimize or maximize 61
setting notation or precision 61
Axis attributes 58
Axis pop-up menu
detailed description 14
example of use 19
Minimize option 61
Notation options 61

example of use 19
Precision option 61

example of use 19
use of 12
AXON database files
converting plot data to 97

B
batch mode 115
Broadcast feature
discussion of 32
Broadcast toggle (control panel)
example of use 20
procedure on 31

C
Calculator 10

Subject Index-129

Subject Index

Case button (control panel)


procedure on 26
case studies
use with PlotView 3
class (data)
list of valid classes 28
types used in PlotView 3
Class button (control panel)
procedure on 27
colors
how to change 68
command line options 117
comparing data 34
control panel
Add button 16, 25
Add Left button 11, 17, 20, 31
Add Right button 11, 17, 21, 31
All Plot Broadcast toggle 10
Annotation Editor button 10
Broadcast toggle 20, 31
Case button 26
Class button 27
Cycle Plot Focus button 21, 35
Delete buttons 36
Delete Current Trace button 18
diagram of 9
double-arrow buttons 18, 35
Edit button 18
Editable option 30
File button 26
Item button 29
Layer button 30
New Plot button 10, 20, 31, 32
Print button 10, 81
Property button 28
Quit button 8, 10
Screen Def button 10, 83
Set X Axis button 33
Toggle Menu/Tool Bar button 10
Trace slider 18, 40
cross-plotting values 33
current X and Y values display 12
cutting and pasting objects 76
Cycle 10
Cycle Plot Focus button (control panel)
definition of 21, 35

Subject Index-130

PLOTVIEW USERS GUIDE

D
data classes
list of valid classes 28
DBPLOT utility
preparing control file for 98
Delete buttons (control panel)
procedure on 36
Delete Current Trace button (control panel)
example of use 18
DESKTOP-VIP
starting PlotView from 8
documentation
related to Plotview xii
double-arrow buttons (control panel)
example of use 18
use in cycling through data 35
drawing objects
how to resize 73
drawing shapes 71
drawing tools
use of 71

E
Edit button (control panel)
example of use 18
Edit Panel
description of 10
example of use 18
using to change traces 46
Editable option (control panel)
procedure on 30
ellipse tool 71

F
FIELD class
definition of 28
field data 3
File button (control panel)
procedure on 26
File menu
Close option 37

Landmark - R2003.4

PLOTVIEW USERS GUIDE

example of use 22
definition of 11
Duplicate option 32
Print option 81
fill/pattern for drawn objects 77
FLOSTA class
definition of 28
flow station data 3
focus
cycling through windows 21, 35
fonts
changing for text components 65
freestyle drawing tool 71

Subject Index

legend
definition of 13
how to change position of 62
line color selection 77
line drawing tool 71
Listen button (tool bar)
definition of 12
example of use 20
procedure on 32
Listen feature
discussion of 32

M
G
GATHER class
definition of 28
gathering center data 3
grouping objects 75

manuals
related to Plotview xii
Menus 10
moving objects 75
multiple displays
setting up 32

hardcopy
generating from batch mode 115
hardcopy features 81
historical data
how displayed 13
history matching
preparing the observed data file 106
using PlotView for 2

New Plot button (control panel)


definition of 10
example of use 20
procedure on 31, 32

I
Item button (control panel)
procedure on 29
item number
use in PlotView 3

O
objects
cutting and pasting 76
raising or lowering 76
selecting, grouping, and moving 75
observed data
how displayed 2, 13
preparing for analysis 106
OSF/Motif
use with PlotView 1
overlapping objects 76

L
Layer button (control panel)
procedure on 30
Layout 10

R2003.4 - Landmark

Subject Index-131

Subject Index

P
plot display windows
broadcasting changes to multiple 48
definition of 11
how to change colors in 68
how to read legend and annotation 38
title 12
Plot menu
Color option 68
Font option 65
Size option 66
Plot pop-up menu
detailed description 13
Plots menu
Attributes option 62
Axis option 58

example of use 20
Color option 68
definition of 11
Fonts option 65
general usage 12
Size option 66
Traces option 39, 46
example of use 20
use to edit traces 13
use in changing title, font, etc. 12
PlotView software
general guidelines for using 24
starting and stopping 8
tutorial on 16
typical applications 2
polygon tool 71
polyline tool 71
pop-up menus
Axis menu 12, 14

example of use 19
Axis/Minimize option 61
Axis/Notation options 61
Axis/Precision option 61
general description of 13
Plot menu 13
Trace menu 12, 13

example of use 19
PostScript images 81
predictive simulations
using PlotView for 2
presentations 81

Subject Index-132

PLOTVIEW USERS GUIDE

Print button (control panel)


definition of 10
use in hardcopy 81
printing 81
properties
use in PlotView 3
Property button (control panel)
procedure on 28
property names
alphabetical list of 91
functional grouping of 94
pull-down menus
definition of 11

Q
Quit button (control panel) 8
definition of 10

R
raising/lowering objects 76
rectangle tool 71
REGION class
definition of 28
region data 3
reservoir simulation
using PlotView with 2

S
Screen Def button (control panel)
definition of 10
use of 83
screen definition files
merging 87
use in batch mode 115
screen definitions
creating and saving 83
editing 88
opening old ones 86
reviewing 88
saving to a file 83
Set X Axis button (control panel) 33
SIMOUT software
relation to PlotView 1

Landmark - R2003.4

PLOTVIEW USERS GUIDE

simulation data
display of 2
how displayed 13
size
setting for current window 66
Spreadsheet menu
Traces option 41
starting Plotview
from DESKTOP-VIP 8
from the command line 8
starting/stopping PlotView 8
substitution file
use in batch mode 116

Subject Index

Trace slider (control panel)


example of use 18
how to use 40
traces
adding to a single window 31
adding to multiple displays 32
getting information about 38
how to change 45
how to highlight 39
overlaying on display 34
removing from display 36

V
T

VIP simulation plot data


converting to AXON format 97

text annotation
adding to the plot window 71
how to add and edit 74
Text Object Editor
how to use 72, 74
text tool 71
title
how to change location 62
how to change wording of 62
in plot 12
Toggle Menu/Tool Bar button (control panel)
definition of 10
tool bar
definition of 12
Listen button 12, 20, 32
Zoom buttons 12
Trace Attributes panel
how to read 39
trace data
generating PostScript file 43
saving to a separate file 42
Trace Data panel
Print option 43
Save As option 42
Trace pop-up menu
Axis/Show option

W
WELL class
definition of 28
well data 3
well layer data 3
WELLYR class
definition of 28

X
X Axis Property selection 33
X/Y values
display of 12

Z
Zoom buttons (tool bar)
definition of 12

example of use 19
detailed description 13
example of use 19
Inquire option

example of use 19
use of 12

R2003.4 - Landmark

Subject Index-133

Subject Index

Subject Index-134

PLOTVIEW USERS GUIDE

Landmark - R2003.4