z Macros

8/20/2019 z Macros

1/678

Macro Reference Manual for Z-MAP Plus/ZCL

© 2003 Landmark Graphics Corporation

Part No. 161336 October 2003

MacroReference

Manual for

8/20/2019 z Macros

2/678

© 2003 Landmark Graphics Corporation

All Rights Reserved Worldwide

This publication has been provided pursuant to an agreement containing restrictions on its use. The publication is also

protected by Federal copyright law. No part of this publication may be copied or distributed, transmitted, transcribed,

stored in a retrieval system, or translated into any human or computer language, in any form or by any means,

electronic, magnetic, manual, or otherwise, or disclosed to third parties without the express written permission of:

Landmark Graphics Corporation

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

3D Drill View, 3D Drill View KM, 3Dview, Active Field Surveillance, Active Reservoir Surveillance, ADC,

ARIES, Asset Development Center, Asset Development Centre, Automate, BLITZ, BLITZPAK, CasingSeat,

CDDM, COMPASS, Contouring Assistant, Corporate Data Archiver, Corporate Data Store, DataStar, DBPlot,

Decision Suite, Decisionarium, DecisionDesktop, DecisionSpace, DecisionSpace AssetPlanner, DecisionSpaceAtomic Meshing, DecisionSpace PowerModel, DecisionSpace PrecisionTarget, DecisionSpace TrackPlanner,

DecisionSpace Well Seismic Fusion, DepthTeam, DepthTeam Explorer, DepthTeam Express, DepthTeam Extreme,

DepthTeam Interpreter, DESKTOP-PVT, DESKTOP-VIP, DEX, DFW, DIMS, Discovery, Drillability Suite,

DrillModel, DrillVision, DSS, Dynamic Reservoir Management, Dynamic Surveillance System, EarthCube,

EdgeCa$h, eLandmark, Engineer's Desktop, EOS-PAK, EPM, Executive Assistant, FastTrack, FZAP!,

GeoDataLoad, GeoGraphix (stylized), GeoGraphix Exploration System, GeoLink, GES, GESXplorer, GMAplus,

GRIDGENR, Handheld Field Operator, I2 Enterprise, iDIMS, IsoMap, Landmark, Landmark and Design,

Landmark logo and Design, LandScape, Lattix, LeaseMap, LMK Resources, LogEdit, LogM, LogPrep,

Make Great Decisions, MathPack, MIRA, Model Builder, MultiWell, MyLandmark, MyWorkspace, OpenBooks,

OpenExplorer, OpenJournal, OpenOrigin, OpenSGM, OpenVision, OpenWells, OpenWire, OpenWorks,

OpenWorks Well File, PAL, Parallel-VIP, PetroBank, PetroWorks, PlotView, Point Gridding Plus,

Pointing Dispatcher, PostStack, PostStack ESP, PowerView, PRIZM, PROFILE, ProMAGIC, ProMAX,

ProMAX 2D, ProMAX 3D, ProMAX 3DPSDM, ProMAX MVA, ProMAX VSP, pSTAx, QUICKDIF,QUIKCDP, QUIKDIG, QUIKRAY, QUIKSHOT, QUIKVSP, RAVE, RAYMAP, Real Freedom,

Real-Time Asset Management Center, Real-Time Asset Management Centre, Real Time Knowledge Company,

Reservoir Framework Builder, RESev, ResMap, RMS, SafeStart, SCAN, SeisCube, SeisMap, SeisModel, SeisSpace,

SeisVision, SeisWell, SeisWorks, SeisWorks MultiView, SeisWorks PowerSection, SeisXchange, Sierra,

Sierra (design), SigmaView, SimResults, SIVA, SpecDecomp, StrataMap, StrataModel, StrataAmp, StrataSim,

StratWorks, StressCheck, STRUCT, Surf & Connect, SynTool, SystemStart, SystemStart for Clients,

System Start for Servers, SystemStart for Storage, T2B, TDQ, Team Workspace, TeamView, TERAS,

Total Drilling Performance, 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-THERM, WavX, Web Editor, Web OpenWorks, Wellbase, Wellbore Planner, WELLCAT, WELLPLAN,

WellXchange, WOW, Xsection, Xsource, You're in Control. Experience the difference, ZAP!, and Z-MAP Plus

are trademarks, registered trademarks or service marks of Landmark Graphics Corporation.

All other trademarks 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.

8/20/2019 z Macros

3/678

Landmark Macro Reference Manual for Z-MAP Plus / ZCL

R2003.12.0 Contents iii

Macro Reference Manual

for Z-MAP Plus / ZCL

Introduction.................................................................................................. 1

Overview............................................................................................................ 1

Uses of Macros............................................................................................ 1

Types of Macros .......................................................................................... 1

About This Guide.............................................................................................. 2Purpose of and Audience for This Guide.................................................. 2

Contents of This Guide............................................................................... 2

Typographic Conventions .......................................................................... 3

Related Documentation .............................................................................. 4

Macro Descriptions ............................................................................... 5

Introduction....................................................................................................... 5

Macro Description Table .................................................................................. 6

Macros Called by Menu Options ..................................................................... 12

Macros Menu ............................................................................................... 12

Macros: Quick-look Menu ..................................................................... 13

Macros: Graphics Menu ........................................................................ 13

Macros: Operations Menu..................................................................... 14

Macros: Geophysics Menu ................................................................... 14

Macros: Utilities Menu........................................................................... 15

Contents

8/20/2019 z Macros

4/678


R2003.12.0 Contents iv

Macro Descriptions .......................................................................................... 15

Information Included in Macro Descriptions ............................................ 15

Macro Name ........................................................................................... 16

Menu Option........................................................................................... 16

Purpose .................................................................................................. 16

Description ............................................................................................. 16

Results .................................................................................................... 16

Technical Notes ..................................................................................... 16

Prompt and Parameter Descriptions.................................................... 17

Description........................................................................................ 18

Macro Parameter .............................................................................. 18

Options for ETEXT Type Parameter ................................................ 19

Data Type .......................................................................................... 19

Range ................................................................................................ 20

Default Value..................................................................................... 21

ZCL Processes Used ............................................................................. 21

Additional Information ................................................................................ 22

ANTILOG-TEN-DATA......................................................................................... 23

ANTILOG-TEN-GRID......................................................................................... 26

APPEND-XY....................................................................................................... 28

AREA-DEPTH .................................................................................................... 32

BUBBLE-POSTING ........................................................................................... 40

CHANGE-MFD-NAME ....................................................................................... 49

CLEAN ............................................................................................................... 50

COLOR-BAR...................................................................................................... 51

COLOR-CONTOURS ......................................................................................... 60

CONTOUR-WINDOW......................................................................................... 72

8/20/2019 z Macros

5/678


R2003.12.0 Contents v

CONVERT-DMS-DEG ........................................................................................ 78

DATA-BLANK..................................................................................................... 82

DATA-ENUMERATION....................................................................................... 85

DATA-HISTORY ................................................................................................. 88

DATA-PROFILES ............................................................................................... 90

DATA-SUMMARY ............................................................................................... 97

DEBUG-SIL-TOGGLE........................................................................................ 99

DIP-PLOT-DATA................................................................................................. 100

DIP-PLOT-GRID ................................................................................................. 105

ENVELOPE ........................................................................................................ 110

Summary of the ENVELOPE Macro........................................................... 111

Understanding the ENVELOPE Macro ...................................................... 112

Modeling the Envelope Control Parameters ............................................. 115

Discontinuity Use .................................................................................. 115

Discontinuity Generalization Tolerance .............................................. 116

Quantized Contours .............................................................................. 116

Map Design Parameters ........................................................................ 117

File Saving.............................................................................................. 118

Framework Logic ........................................................................................ 119

Minimal Input Requirements................................................................. 119

File Saving.............................................................................................. 120

Gross Rock Volume Modeling .............................................................. 120

Graphical Outputs ................................................................................. 121

Other Volumetric Evaluations .................................................................... 125

EVALUATE-CONGRID ....................................................................................... 154

EVALUATE-POLYN............................................................................................ 157

EXPORT-CPS-FILE ............................................................................................ 167

8/20/2019 z Macros

6/678


R2003.12.0 Contents vi

EXPORT-ZGF-FILE ............................................................................................ 169

FASTCONTOURMAP ........................................................................................ 171

FASTMAPFROMGRID ....................................................................................... 174

FAULT-BACKFILL-FLDS ................................................................................... 177

FAULT-BALANCER............................................................................................ 182

FAULT-CONTOURS ........................................................................................... 186

FAULT-DIP-SYMBOL ......................................................................................... 197

FAULT-MIGRATION............................................................................................ 202

FAULT-PROFILING ............................................................................................ 208

FAULT-SHRINKER ............................................................................................. 214

FIELD-LISTING .................................................................................................. 223

FILL-BORDER ................................................................................................... 225

FISHNET-PLOT .................................................................................................. 227

GEOSORT.......................................................................................................... 239

GRIDANDMAPX ................................................................................................ 242

GRID-LT-EQ-GT ................................................................................................. 246

GRID-TO-SEISMIC ............................................................................................ 249

HAND-CONTOUR .............................................................................................. 252

IMPORT-CPS-FILE ............................................................................................ 257

IMPORT-GRID .................................................................................................... 268

IMPORT-ZGF-FILE............................................................................................. 273

INTERPOLATION .............................................................................................. 275

LABL-FOUR-CRNS ........................................................................................... 277

8/20/2019 z Macros

7/678


R2003.12.0 Contents vii

LEASE-DRAWING ............................................................................................. 281

Technical Notes ........................................................................................... 283

Preparing Lease Polygon (Vertex) Files .............................................. 283

Segment I.D. Field ............................................................................ 283

Area Identification Field................................................................... 283

Color Code Field............................................................................... 283

Preparing Lease Identification (Text) Files.......................................... 284

Text Fields (Required) ...................................................................... 284

Area Identification Field (Required)................................................ 285

Area Symbol Code Field (Optional) ................................................ 286

Segment I.D. Field (Optional) .......................................................... 287

Color Code Fields (Optional)........................................................... 287

Z Fields (Optional)............................................................................ 287

Lease Drawing Hints ............................................................................. 288

Activating Shared Lease Attributes ..................................................... 288

LINE-GRID-PLUS .............................................................................................. 295

LIST-CPS-FILE................................................................................................... 312

MAKEMAPGENERAL ....................................................................................... 313

NADCONCV....................................................................................................... 314

NEW-CONTOUR ................................................................................................ 318

NIV-DATA ........................................................................................................... 330

NIV-GRIDS ......................................................................................................... 336

PATCH-GRID...................................................................................................... 343

PENETRATE-GRIDS ......................................................................................... 346

PENETRATE-ONEGRD ..................................................................................... 354

8/20/2019 z Macros

8/678


R2003.12.0 Contents viii

PICT-AND-PST-DLS........................................................................................... 358

PICT-AND-PST-NTS........................................................................................... 366

PICT-NTS-DLS ................................................................................................... 385

PICTURE-STATS ............................................................................................... 394

POLYGON-CLOSE ............................................................................................ 395

POLYGON-FILL ................................................................................................. 397

POST-DLS.......................................................................................................... 399

POST-LINE......................................................................................................... 403

POST-NTS.......................................................................................................... 407

POST-NTS-DLS ................................................................................................. 423

POST-PIC-STATS............................................................................................... 441

POST-STAR ....................................................................................................... 445

PROFILE-CONTOURS ...................................................................................... 468

QUALITY ............................................................................................................ 496

QUICKVOL-TWOPOLS ..................................................................................... 504

QUIKVOL-FORTYPOL....................................................................................... 508

REDUCE-POSTING ........................................................................................... 512

RESAMP-W-AOIGRID ....................................................................................... 516

RMLOCK............................................................................................................ 519

SHADE-POLYGONS.......................................................................................... 520

SPAWN-PROCESS ............................................................................................ 524

SPECIFY-CONTOURS ...................................................................................... 526

START ................................................................................................................ 533

STRATATHICKNESS ......................................................................................... 534

Technical Notes ........................................................................................... 535

Technical Approach............................................................................... 536

8/20/2019 z Macros

9/678


R2003.12.0 Contents ix

SURFCORRECT................................................................................................ 539

Summary...................................................................................................... 540

Production Geology .............................................................................. 540

Basin Studies ......................................................................................... 541

Stratigraphic/Reservoir Framework Building...................................... 541

Understanding the SURFCORRECT Macro ......................................... 543

Method of Macro Application (MMETHOD) .................................... 543

Quality Control Data File (OPRSDAT) ............................................. 545

SURFACE-INTRSECT ....................................................................................... 557

SURFACEPIC..................................................................................................... 566

Parameters for constructing first surface................................................. 569

Parameters for constructing second surface ........................................... 571

Parameters for constructing second surface ........................................... 573

THREED-T-TO-D ................................................................................................ 575

Technical Notes ........................................................................................... 576

Preparing the Three-Dimensional Grid ................................................ 576

TIME-SLICE ....................................................................................................... 580

TRANSFORM-COORDS.................................................................................... 585

TREND-ANAL-GRID.......................................................................................... 589

Technical Notes ........................................................................................... 590

Factors Affecting Trend Gridding Accuracy ....................................... 590

Spatial Distribution .......................................................................... 591

Number of Terms .............................................................................. 592

Accuracy of the Trend Fit ................................................................ 592

Block Averaging..................................................................................... 595

Output Grid Parameters ........................................................................ 595

Limiting Z Values ................................................................................... 596

8/20/2019 z Macros

10/678


R2003.12.0 Contents x

USER-FILTER .................................................................................................... 600

VEL-FUN-T-TO-D ............................................................................................... 604

VERT-TO-DGRID................................................................................................ 612

ZGF-SUMMARY................................................................................................. 615

Running Macros....................................................................................... 617

Overview............................................................................................................ 617

Running a Macro in Z-MAP Plus ..................................................................... 618

Running a Macro from ZCL.............................................................................. 621

Creating a Macro ..................................................................................... 623

Overview............................................................................................................ 623

Creating a Log File with Z-MAP Plus .............................................................. 626

Creating Macros ............................................................................................... 627

Steps for Creating a Macro ........................................................................ 628

Common User Errors ....................................................................................... 644

Storing and Gaining Access to Macros.......................................................... 645

Z-MAP Plus Access..................................................................................... 645

ZCL Storage and Access............................................................................ 646

Using the Z-MAP Plus Command Menu .............................................. 646

Using the RZCL Script........................................................................... 648

8/20/2019 z Macros

11/678


R2003.12.0 Contents xi

Macro Structure........................................................................................ 649

Overview............................................................................................................ 649

Parts of a Macro................................................................................................ 652

Macro Name Record ................................................................................... 652

Parameter Definition Records.................................................................... 652

Possible Elements of a Parameter Definition Record ........................ 653

Example Macro Parameter Definition Records ................................... 654

Detailed Descriptions of Parameter Definition Elements .................. 657

Required Parameter Flag ................................................................. 657

Parameter Name ............................................................................... 657

Parameter Type................................................................................. 657

Color Button Widget ........................................................................ 659

Font Widget....................................................................................... 659

File Type ............................................................................................ 660

Field Type.......................................................................................... 661

Maximum Length .............................................................................. 661

Precision Value................................................................................. 661

Default Value..................................................................................... 662

Range ................................................................................................ 662

End Record Symbol ......................................................................... 662

Options .............................................................................................. 662

Comments ......................................................................................... 663

End Parameters ................................................................................ 663

Abstract........................................................................................................ 663

8/20/2019 z Macros

12/678


R2003.12.0 Contents xii

Prompts........................................................................................................ 663

Parameter Prompt Records .................................................................. 664

New Dialog Box Control ........................................................................ 664

ZCL Commands........................................................................................... 666

8/20/2019 z Macros

13/678


R2003.12.0 Overview 1

Introduction

Overview

A macro is a set of Z-MAP Command Language (ZCL) processcommands that have been packaged together and are called and executed as a group, either by Z-MAP Plus or by another ZCLcommand stream. The 2003.3.0 release of Z-MAP Plus includes over 70 macros supplied by Landmark. However, you can also write your

own macros and then store them for your use or for use by others.

Uses of Macros

In general, macros are used to “can” procedures. For the novice user,this can make a difficult procedure easier to execute. Canning procedures is also an excellent way of documenting and storing acomplex workflow that may need to be duplicated in the future.

Because macros have access to all functionality within ZCL, you canuse them to gain access to ZCL functions that are not yet available inthe Z-MAP Plus interface.

Types of Macros

Macros executed from Z-MAP Plus are called Z-MAP Plus macros,

and macros executed from a ZCL Command Stream are called ZCLmacros. The structure of these two types of macros is slightly different,and is covered in “Macro Structure” starting on page 649. You can runZ-MAP Plus macros as ZCL macros, but you cannot run ZCL macrosfrom Z-MAP Plus. Z-MAP Plus macros are also classified as either user-supplied or Landmark-supplied.

8/20/2019 z Macros

14/678


R2003.12.0 About This Guide: Introduction 2

About This Guide

Purpose of and Audience for This Guide

This guide is designed as a reference tool to help you more fullyunderstand the Landmark-supplied macros, their components, and howto use them to the best advantage.

You can help ensure this guide meets that goal by providingconstructive feedback. Help us make sure this guide covers the areas of most importance to you.

This guide is intended for ZCL and Z-MAP Plus users who want tolearn:

• More about the Landmark-supplied macros

• How macros are structured

• How to create macros

Typical users of this guide include petroleum engineers, geologists,

geophysicists, and geo-technicians.

Contents of This Guide

This guide is divided into five sections:

• Introduction — A general introduction to macros and this guide.

• Macro Descriptions — Details about the Z-MAP Plus macrossupplied with the current release, including:

• A quick reference table describing the function of theLandmark macros

• Graphic representations of the Macro menu options and themacros they call

• An alphabetical listing of all Landmark-supplied macros. Thelists are divided into 4 groups: A-H, I - M, N-R, S-Z. Eachlisting includes:

– Purpose and use of the macro

– Required and optional input

– Results

– Prompt and parameter descriptions

– ZCL processes used by the macro

8/20/2019 z Macros

15/678



• Running Macros — Steps for:

– Running a macro in Z-MAP Plus

– Creating a command stream to run a macro in ZCL.

• Creating A Macro — Steps for: – Using Z-MAP Plus to log a procedure

– Creating a macro to run in Z-MAP Plus or ZCL

and information about:

– Common errors in user-written macros

– Storing and accessing macros

• Macro Structure — Definitions of each part of a macro,including:

– Macro parameter definitions

– Abstract

– Prompts

– ZCL commands

Typographic Conventions

To make the information in this guide as accessible as possible, thefollowing conventions are observed throughout:

• Examples of macro records and screen displays are in a

typewriter-style font, such as:

NCONTOUR, INTEGER , 1, , 0, 256 /

• A portion of an example that is to be replaced by a user value is presented in italic typewriter-style font, such as:

MACRO NAME = DESIRED-MACRO-NAME

• The names of menu and button selections appear in bold type. The

path to a Z-MAP Plus process is shown with the menu selectionsconnected by arrows, such as:

Select Files → Directory Paths in the Z-MAP Plus window.

• Default field names (as described in Appendix B. File and Field Codes *) appear in all capital letters. In text, they are sometimesappear with initial capitals for easier reading. X (Easting) and Y(Northing) are often represented with X and Y.

• Notes contain information to assist you in understanding anapplication.

8/20/2019 z Macros

16/678



Related Documentation

The following guides are available from your system administrator or Landmark representative.

• ZCL Operator’s Manual (Volumes 1 and 2) present the Z-MAPCommand Language and shows you how to start the program and use process statements to write a command stream for generating avariety of maps. The ZCL Operator’s Manual covers all parameters for ZCL processes.

• Z-MAP Plus Reference Manual provides easy access to referenceinformation about Z-MAP Plus procedures and features. Overviewworkflows, tables, and selected screen captures supplement thetext to help you understand how to use each task.

Each of these guides contains appendixes with information you mayfind useful for structuring macros.

Z-MAP Plus Users See this Prompt Even If NUMFLDS = 1

If you do not want to post a second field, select (None - use no field).

8/20/2019 z Macros

17/678


R2003.12.0 Introduction 5

Macro Descriptions

Introduction

This section describes over 70 Landmark-supplied Z-MAP Plus macrosdesigned to supplement the standard suite of Z-MAP Plus capabilities.Other macros may be available at your site, which are not described here — user-supplied macros (for example, ones written by you or

other company employees).Landmark-supplied macros are presented in alphabetical order in thisguide. Macro descriptions include the macro type, menu optionassociated with the macro, purpose, results, prompt and parameter descriptions. In addition, technical notes accompany the descriptions of the following macros: LEASE-DRAWING, STRATATHICKNESS,

THREED-T-D, and TREND-ANAL-GRID.

In this first topic of the section, Landmark macros are organized in twoways:

• In an alphabetical table that includes a brief description of thefunction of each macro,

• In a graphic format where Macros menu options are correlated to

the name of the macro they call.

8/20/2019 z Macros

18/678


R2003.12.0 Macro Descriptions: Macro Description Table 6

Macro Description Table

The following table lists the Landmark-supplied macros in alphabeticalorder, with a brief description and a link to the beginning of the macro

documentation.

Table 1: Macros Described in This Guide

Macro Name Description Page

ANTILOG-TEN-DATA Computes the antilogarithm to base ten for the values in theinput field.

23

ANTILOG-TEN-GRID Computes the antilogarithm (base ten) for the value of eachgrid node.

26

APPEND-XY Attaches x and y values to a seismic file. 28

AREA-DEPTH Checks the results of the volumetrics task as compared tovolumetric results arrived at by hand.

32

BUBBLE-POSTING Posts symbols on a map, with symbol size being determined by the z field value.

40

CHANGE-MFD-NAME Changes the internal name on an MFD. 49

CLEAN Used only for performing product demonstrations. 50

COLOR-BAR Posts a color bar on your map. 51

COLOR-CONTOURS Places color-filled contours and color bar on map. 60

CONTOUR-WINDOW Generates a contour map of a windowed area of the dataset. 72

CONVERT-DMS-DEG Converts degrees, minutes, and seconds lat/long to decimaldegrees lat/long or vice versa.

78

DATA-BLANK Blanks a data field on the selected data file inside all

polygons. It is designed as a work-around for Operations → Data Operations → Blank Data, whichonly blanks using the first polygon on the vertex file.

82

DATA-ENUMERATION

Builds a Segment ID field from an input dataset. 85

DATA-HISTORY Prints the history of a selected data file to the screen. 88

DATA-PROFILES Generates profiles along lines of a dataset with a line IDfield.

90

8/20/2019 z Macros

19/678



DATA-SUMMARY Displays all files in the attached master files (MFDs). 97

DEBUG-SIL-TOGGLE This macro toggles on or off the SIL debug flag. 99

DIP- PLOT -DATA Generates arrows on a map that point in the direction of dipor gradient.

100

DIP-PLOT-GRID Adds dip vectors at grid locations to a plot. 105

ENVELOPE Produces net hydrocarbon pore thickness grids. 110

EVALUATE-

CONGRIDBuilds a constant grid from user-defined input. 154

EVALUATE-

POLYN

Evaluates a polynomial function over a user defined grid

and stores the results as a new grid. Polynomial trends of upto the 2nd order can be handled by the macro.

157

EXPORT-CPS-FILE Exports an MFD to a CPS SAVE file. 167

EXPORT-ZGF-FILE Converts a ZGF to a flat ASCII file. 169

FASTCONTOURMAP Builds a grid and generates a contour map. 171

FASTMAPFROMGRID Builds a contour map using a grid file. 174

FAULT-BACKFILL-FLDS Given a value for two fields describing a centerline fault, backfills the value of the third field.

177

FAULT-BALANCER Locates bifurcations in a center-line fault file and balancesthrow at the bifurcations.

182

FAULT-CONTOURS Puts color-filled contours and a color bar on your map. 186

FAULT-DIP-SYMBOL Produces polylines that aid in the symbolization of fault polygons produced by the fault expansion phase of PointGridding Plus post processing module.

197

FAULT- MIGRATION Migrates a set of center-line traces from their current map position to the position they would have on a structuresurface.

202

FAULT-PROFILING Creates a fault file and an optional vertex file that can beused to validate graphically vertical separation distributionalong the faults in a center-line fault file.

208

FAULT-SHRINKER Automatically converts faults with gaps to center-linefaults.

214



8/20/2019 z Macros

20/678



FIELD-LISTING Lists the field descriptors for the selected dataset. 223

FILL-BORDER Fills the selected area of the map with a user-defined color. 225

FISHNET-PLOT Generates an isometric plot. 227

GEOSORT Geographically sorts fragmented line data back. 239

GRIDANDMAPX Grids a z field on a data file and contours the resultant grid.Adds a border, border labels, and posts well points.

242

GRID-LT-EQ-GT Creates a Boolean grid. 246

GRID-TO-SEISMIC Converts the rows and columns of a grid to seismic linesand concatenates them into one seismic file.

249

HAND-CONTOUR Performs linear interpolation along lines and outputsinterpolated values to a file.

252

IMPORT-CPS-FILE Imports a CPS SAVE file into an MFD. 257

IMPORT-GRID Uses formats you create to import a grid dataset from anexternal diskfile.

268

IMPORT-ZGF-FILE Converts a flat Z-MAP Graphics File (ZGF) into a ZGFusable in Z-MAP Plus.

273

INTERPOLATION Interpolates along a seismic line, repopulating the line at theindicated shotpoint limit.

275

LABL-FOUR-CRNS Labels each of the four corners of a map with either latitude/longitude or northing/easting labels.

277

LEASE-DRAWING Posts and annotates lease polygons. 281

LINE-GRID-PLUS Extends the functionality of Line Gridding. 295

LIST-CPS-FILE Lists the contents of a CPS SAVE file. 312

MAKEMAPGENERAL Not a standalone macro. It is used by the ENVELOPE and SURFCORRECT macros.

313

NADCONCV Translates NAD 27 latitude and longitude values to NAD 83latitude and longitude values. The translation is available in both directions.

314

NEW-CONTOUR Contours opaque faults, profile faults, colorfills and postscolor bar.

318



8/20/2019 z Macros

21/678



NIV-DATA Uses a Carter-Good Iterative Depth Algorithm (IDA) to

produce a depth field.

330

NIV-GRIDS Uses a Carter-Good Iterative Depth Algorithm (IDA) to produce an output depth grid.

336

PATCH-GRID Patches a small grid into a large grid using the x and ycoordinates in both grids to determine its position.

343

PENETRATE-GRIDS Calculates the x, y, z coordinates at which deviated welltracks penetrate one or more gridded horizons.

346

PENETRATE-ONEGRD Calculates the x, y, z coordinates at which deviated welltracks penetrate one gridded horizon.

354

PICT-AND-PST-DLS Creates a new picture on which you may plot DominionLand Survey (DLS) information.

358

PICT-AND-PST-NTS Creates a picture on which you may plot NationalTopographic Survey (NTS) information.

366

PICT-NTS-DLS Creates a picture using the area of interest parameters from

the Dominion Land Survey (DLS) or the NationalTopographic Survey (NTS).

385

PICTURE-STATS Gives information on a picture. 394

POLYGON-CLOSE Closes all polygons in a vertex file. 395

POLYGON-FILL Fills polygons with a solid color and stores them on anMFD.

397

POST-DLS Posts Dominion Land Survey (DLS) lines on a picture that

has already been created.

399

POST-LINE Posts a single line using FALT, DATA or VERT type files. 403

POST-NTS Posts National Topographic Survey (NTS) Map, Series,Block, Unit and/or Quarter lines and labels on a previously

created picture.

407

POST-NTS-DLS Posts DLS or NTS survey onto existing map 423

POST-PIC-STATS Draws a box on a map and posts information about the

scale, size, and projection of the map.

441



8/20/2019 z Macros

22/678



POST-STAR Posts star symbols on the current picture for data distributed

at control points.

445

PROFILE-

CONTOURSContours grids that have abrupt changes in surface slopealong well-defined profile lines.

468

QUALITY Performs quality assurance on a grid and a dataset. 496

QUICKVOL-TWOPOLS Provides a quick estimate of the volume between thesurface represented by the input grid and a flat surface witha constant z value. User can specify a maximum of two

input polygons.

504

QUIKVOL-

FORTYPOL

Provides a quick estimate of the volume between thesurface represented by the input grid and a flat surface witha constant z value. User can specify a maximum of 40 input polygons.

508

REDUCE-POSTING Reduces posting of a text field in an area based on a keyfield

such as operator name.

512

RESAMP-W-AOIGRID Resamples a grid using a control grid as a source of outputgrid parameters.

516

RMLOCK Used only for performing product demonstrations. 519

SHADE-POLYGONS Fills a set of polygons with hachured lines. 520SPAWN-PROCESS Spawns a process to allow another program to run within

Z-MAP Plus.524

SPECIFY-CONTOURS Enables the user to specify special contour levels as input(such as the OWC or GOC), which do not fall in evenincrement levels.

526

START Used only for performing product demonstrations. 533

STRATATHICKNESS Computes stratigraphic thickness for an interval defined bytop and base grids.

534

SURFACEPIC Contours up to three surfaces and posts the Z-Fields around

the control points

566

SURFCORRECT Provides a way of correcting a surface or of conformablymerging a surface with a set of new well picks

539



8/20/2019 z Macros

23/678



SURFACE-INTRSECT Determines whether two input grids intersect; if they do, it

produces the curve of their intersection as a fault file.

557

THREED-T-TO-D Converts a time grid to a velocity grid using a specialthree-dimensional “time slice” grid in the conversion process.

575

TIME-SLICE Builds the pseudo three-dimensional velocity grid needed for the Time-to-Depth conversion method that is provided in the THREED-T-TO-D macro

580

TRANSFORM-COORDS Performs coordinate transformations (map projections). 585

TREND-ANAL-GRID Creates a trend grid and a residual grid. 589

USER-FILTER Uses various methods to define a grid filter and filter operator.

600

VEL-FUN-T-TO-D Executes Velocity-Function-Time-to-Depth Conversion. 604

VERT-TO-DGRID Records the shortest distance from each grid node to any point along any line segment in a user-specified input vertex

file of the form ( x,y,seg id ).

612

ZGF-SUMMARY Generates a report for each picture in your graphics file(ZGF).

615



8/20/2019 z Macros

24/678

8/20/2019 z Macros

25/678


R2003.12.0 Macro Descriptions: Macros Called by Menu Options 13

Macros: Quick-look Menu

The following illustration shows the Macros: Quick-look menu optionsand the macros they call:

Macros: Graphics Menu

The following illustration shows the Macros: Graphics menu options

and the macros they call:

GRIDANDMAPX

FASTMAPFROMGRID

FAULT-CONTOURS

AREA-DEPTH

BUBBLE-POSTING

COLOR-CONTOURS

FILL-BORDER

DATA-PROFILES

DIP-PLOT-DATADIP-PLOT-GRID

LABL-FOUR-CRNS

PROFILE-CONTOURS

SURFACEPIC

POST-LINE

POST-STAR

REDUCE-POSTING

CONTOUR-WINDOW

SPECIFY-CONTOURS

8/20/2019 z Macros

26/678


R2003.12.0 Macro Descriptions: Macros Called by Menu Options 14

Macros: Operations Menu

The following illustration shows the Macros: Operations menu optionsand the macros they call:

Macros: Geophysics Menu

The following illustration shows the Macros: Geophysics menu optionsand the macros they call:

CONVERT-DMS-DEG

DATA-BLANK

PATCH-GRID

RESAMP-W-AOIGRID

STRATATHICKNESS

SURFACE-INTRSECT

PENETRATE-ONEGRD

PENETRATE-GRIDS

QUALITY

GEOSORT

GRID-TO-SEISMIC

INTERPOLATION

TIME-SLICE

THREED-T-TO-D

VEL-FUN-T-TO-D

8/20/2019 z Macros

27/678


R2003.12.0 Macro Descriptions: Macro Descriptions 15

Macros: Utilities Menu

The following illustration shows the Macros: Utilities menu optionsand the macros they call:

Macro Descriptions

Macros are presented in alphabetical order.

Information Included in Macro DescriptionsInformation provided in the macro description consists of:

• Macro name (next topic)

• Corresponding menu option (16)

• Purpose (16)

• Description (optional) (16)

• Results (16)

• Technical notes (optional) (16)

• Prompt and parameter descriptions (17)

• ZCL processes called by the macro (21)

POLYGON-CLOSE

CHANGE-MFD-NAME

DATA-HISTORY

DATA-SUMMARY

VERT-TO-DGRID

PICTURE-STATS

DATA-ENUMERATION

FIELD-LISTING

8/20/2019 z Macros

28/678



Macro Name

The macro name identifies the procedure(s) to be executed. A macroname is a string of up to 16 characters and may contain no blanks,numbers, or underbars.

All Z-MAP Plus macros are identified by the .ZCLMAC extension.

Menu Option

Many Z-MAP Plus menu options call macros to accomplish their tasks.This field in the description of the macro identifies the menu optionassociated with the macro, if any.

Purpose

The purpose provides a description of what the macro does.

Description

The description includes additional information about the macro, suchas a list of the parameters that you are asked to specify. In some cases,this description is extensive.

Results

This section summarizes the expected output. Where appropriate,

examples of graphic or data output are provided.

Technical Notes

Technical notes explain theory and use of four of the more complexmacros — LEASE-DRAWING, STRATATHICKNESS,THREED-T-D, and TREND-ANAL-GRID.

8/20/2019 z Macros

29/678



Prompt and Parameter Descriptions

This portion of the macro description links each prompt to its related macro parameter.

The first line of each description is the Z-MAP Plus prompt. Two typesof prompts appear in the documentation:

* Bolded prompt

When the prompt is bolded, the prompt appears during the use of themacro in Z-MAP Plus. An asterisk (*) preceding the prompt indicatesthat it is a required parameter.

o Unbolded Prompt

Unbolded prompts represent an input MFD. These prompts are not

seen by the user when running the macro in Z-MAP Plus. Input MFD prompts have a degree (ο) symbol preceding the prompt. These prompts are included in the descriptions because when the macro isexecuted as a ZCL macro values for these parameters must besupplied.

Prompts are listed in the order in which they appear in the macro. Each prompt is followed by these elements:

• A description of the parameter

• The name of the macro parameter

• Popup button options, if any

• Data type

• Data range, if any

• Default value, if any

8/20/2019 z Macros

30/678



Example Macro Parameter Descriptions

Description

This item describes the purpose of the parameter.

Macro Parameter

This is the actual parameter name used to specify an input value for the parameter when writing the ZCL macro process call. For example:

FAULTIN = ’Triangle Faults’

Data Type for FIELDis listed as I (Integer),used for ZCL input

Data Type for ETEXTis listed as C*N where N is themaximum length

Range of acceptableInput Member File types

Range of acceptableInput Field types

Input Master File Prompt

(not seen in Z-MAP Plus)

Required Parameter

Prompt

ETEXT Options

8/20/2019 z Macros

31/678



Options for ETEXT Type Parameter

ZCL users can only specify one of these valid character stringresponses. Z-MAP Plus users select one of these options from a pop-up button list. See the example on 18.

Data Type

The Data Type is one of three types: C*N, R , or I.

C* N indicates the response is a text string up to N characters in length.For example, C*8 stands for character text of a maximum length of 8characters. Note that embedded blanks are counted as characters.

• Z-MAP Plus users enter values in fields or select from popupmenus.

• ZCL users enter values in single quotes; see Parameter value in the

ZCL Operator’s Manual . When options are listed, the text stringresponse must come from the list; see “Options for ETEXT Type Parameter ," above.

R indicates that the value must be a real number—for example, anumber with a decimal point such as 1.0, 2.27325, 21252.52, or 1.0E7.

I indicates that the value must be an integer number, such as 1, 2002, or 25.

• ZCL users must not use a decimal point to specify an integer value, or ZCL responds with an error message.

• If the user specifies a real number as input (instead of an integer),Z-MAP Plus ignores the decimal value.

8/20/2019 z Macros

32/678



Range

Range identifies supported values for the parameter. A value outsidethe range causes an error. Ranges are given for input files, input fields,MFDs, and some real and integer parameters.

Range for Input Member Files

The range for input member files corresponds to the acceptable File

Type(s) , such as DATA, CNTR, GRID, and VERT .

• Z-MAP Plus users select from a list of all attached member files of the correct type(s).

• ZCL users must enter an appropriate member file name as acharacter string.

Input Fields

The range for input fields corresponds to the acceptable Field Type(s) ,such as X (EASTING), Z VALUE, and vertical separation.

• Z-MAP Plus users select from a list of all fields of the correcttype(s) in the input file.

• ZCL users must enter the sequential number of the field.

Master Files

The range for MFDs is always 0 through 5, since 5 is the maximumnumber of MFDs and scratch files that can be attached at the same

time.

• Z-MAP Plus users do not have to specify input MFDs. The input

MFDs are the currently attached MFDs. Output MFDs arespecified by selection from a popup menu.

• ZCL users must enter the sequential number of the desired MFD,as described in the ZCL Operator’s Manual .

8/20/2019 z Macros

33/678



Default Value

The default value is used when the macro user does not specify a macro parameter value. If no value is specified by the user and the macro parameter default given is ZCL Default , then the ZCL parameter default

is used if one exists.

The ZCL default output file name is based on the input file name or is

based on a field name.

Be careful about using default values. Default values are not alwaysoptimal for your application. The documentation in the guide should

help you to choose optimal parameter values.

ZCL Processes Used

This portion of the macro description lists the ZCL processes used bythe macro. However, you are not told how many times the process wasused and processes that are common to all macros, such as STOP, arenot listed. Users are encouraged to look at Landmark-supplied macrosto see how they are structured.

Color Index Referenced by a Macro Parameter

The color index specified by a macro parameter refers to that color index in

the color table associated with the current picture.

8/20/2019 z Macros

34/678



Additional Information

For more information on the parts of a macro, see “Macro Structure”starting on page 649. Appendixes in Z-MAP Plus and ZCL guides provide additional information about and examples of:

• Graphics Feature (Segment Type) Codes

• Data File Type Codes

• Data Field Type Codes

• Well Symbols

• Font Types

• Line Patterns

• State Plane Projection Codes

• Color Representation Section and Color Index Section of theDefault Color Table

• Reference Spheroids

8/20/2019 z Macros

35/678


R2003.12.0 ANTILOG-TEN-DATA 23

ANTILOG-TEN-DATA

Macro Name ANTILOG-TEN-DATA

Menu Option Operations → Data Operations → Antilog Base 10 (from Data)

Purpose This macro computes the antilogarithm to base ten (also called thecommon logarithm) of the numbers in the input field. This is the inverseoperation for the single data operation LOG10.

Description You are asked to specify the following input values:

• name of the input data file and its associated MFD

• field on the input data file to be used as input to the antilogoperation

• name for the output data file

• MFD for the output data file

• field to receive the output antilogarithm

• name for the field to receive the output antilogarithm

Results The antilogarithm is calculated and saved in the specified field in theoutput file. Note: Antilogarithms can be calculated successfully onlyfor numbers in a range from about -40.0 to +38.0; the exact rangedepend on the machine being used. Antilogarithms are always positivenumbers.

PROMPT AND PARAMETER DESCRIPTIONS

*Select Input File

Description Name of the input data file.

Macro Parameter DATAIN

Data Type C*24

Range All attached DATA files

Default Value No default

8/20/2019 z Macros

36/678


R2003.12.0 ANTILOG-TEN-DATA: Parameters 24

ANTILOG-TEN-DATA: Parameters

oMFD for the Input File

Description The MFD for the input data file.Macro Parameter MFDIN

Data Type I

Range 0 through 5

Default Searches all attached MFDs

Select Input Field

Description Field on the input file whose antilogarithm is to be calculated.

Macro Parameter INFLD

Data Type IRange All real-number value fields on the input file


*Select Output Field

Description Number of the field where output antilogarithms are written. Thisoverwrites the existing data in the designated field.

Macro Parameter OUTFLD

Data Type I

Range Any non-text field on the file.Default Value No default

*Output Field Name

Description Name for the field where output antilogarithms will be written.

Macro Parameter FLDNAME

Data Type C*20

8/20/2019 z Macros

37/678

8/20/2019 z Macros

38/678


R2003.12.0 ANTILOG-TEN-GRID 26

ANTILOG-TEN-GRID

Macro Name ANTILOG-TEN-GRID

Menu Option Operations → Grid Operations → Antilog Base 10 (from Grid)

Purpose The ANTILOG-TEN-GRID macro calculates the antilogarithm (base10) for the value of each grid node. This is the inverse operation for Single Grid Operation LOG10.

Description Specify the following input values:

• name of the input grid file and its associated MFD

• name of the output grid file

• MFD for the output grid fileResults Output is a grid file whose node values are the antilogarithms of the

corresponding node values in the input grid. Note: Antilogarithms can be calculated successfully only for numbers in a range from about -40.0to +38.0; the exact range will depend on the machine being used.Antilogarithms are always positive numbers.


*Input GRID File

Description Name of the input grid file.Macro Parameter GRIDIN

Data Type C*24


oMFD of Input GRID File

Description The MFD containing the input grid file.

Macro Parameter MFDIN

Data Type I

Range 0 through 5


8/20/2019 z Macros

39/678


R2003.12.0 ANTILOG-TEN-GRID: Parameters 27

ANTILOG-TEN-GRID: Parameters

*Output GRID file name

Description Name of the output grid file.Macro Parameter GRIDOUT

Data Type C*24


oMFD of Output GRID File

Description The MFD for the output grid file.

Macro Parameter MFDOUT

Data Type I

Range 0 through 5Default Value 1 — first attached MFD

ZCL PROCESSES

SINGLE GRID OPS

DELETE FILE

8/20/2019 z Macros

40/678


R2003.12.0 APPEND-XY 28

APPEND-XY

Macro Name APPEND-XY

Menu Option Operations → Geophysical Operations →Append X-Y to Seismic Time File

Purpose The APPEND-XY macro attaches X (Easting) and Y (Northing) valuesto a seismic time file. Using shotpoint locations in a Seismic LocationFile (sometimes called a geographic location file), the macrointerpolates x,y values from the location values. As a result, x,y valuesfor the shotpoint numbers in the Seismic Time File are merged with the

Digitized Seismic Section File.

Description If the process must interpolate or extrapolate to get the correct locationvalues, you can specify:

• a maximum distance between points for interpolation

• an interpolation value

• an extrapolation value

The seismic time file must be of type DATA, and it must contain Line Name and Shotpoint Number fields. Sort the file first by Line Nameand then by Shotpoint Number. * 3D seismic data files (containing 3DLine Name and 3D Shotpoint Numbers do not work with this macro.

The coordinate reference file must be of type DATA, and it mustcontain line name, shotpoint number, and x and y coordinate fields. Sortthe file first by Line Name and then by Shotpoint Number.1

Results The correct interpolated x and y values appended to a seismic time file.

1. Z-MAP Plus users select Operations → Data Operations → Sort Data. ZCL users call SORT process.

8/20/2019 z Macros

41/678


R2003.12.0 APPEND-XY: Parameters 29

APPEND-XY: Parameters


*Enter the Seismic Time File

Description Name of the input data file.

Macro Parameter DATAIN

Data Type C*24



oMFD for the Input File

Description The MFD for the input data file.


Data Type I

Range 0 through 5


*Enter the Seismic Location File

Description Name of the input coordinate reference file, also known as thegeographic location file or digitized basemap shotpoint locationfile.

Macro Parameter COORDIN

Data Type C*24



oMFD for the Reference Coordinate File

Description The MFD for the reference coordinate file.

Macro Parameter MFDCOORD

Data Type I

Range 0 through 5


8/20/2019 z Macros

42/678




Maximum Distance for Interpolation

Description Specifies the break distance tolerance. If two successive points inthe seismic location file are further apart than this distance, then noshotpoint interpolation or extrapolation is performed.

Macro Parameter DISTANCE

Data Type R

Default Value 0.10000E+09

Max SP Number Difference for Interpolation

Description Interpolation shotpoint numbering interval tolerance. Uponselecting two shotpoints on the seismic location file, the program

checks to see if the difference in shotpoint number between thesetwo points exceeds this parameter value. If so, interpolation is not performed and extrapolation is considered.

Macro Parameter INTERPOL

Data Type R


Max SP Number Difference for Extrapolation

Description Extrapolation shotpoint numbering interval tolerance. Thedifference between the shotpoint number of the input point (taken

from the seismic location file) and the shotpoint number of theclosest coordinate reference point (taken from the seismic locationfile) is compared to this parameter value. If it exceeds the value,then extrapolation is not performed for that point.

Macro Parameter EXTRAPOL

Data Type R


Enter the name of the Merged Output File

Description Name of the output data file.Macro Parameter DATAOUT

Data Type C*24

Default Value GETXY

8/20/2019 z Macros

43/678




MFD for the Output File

Description The MFD for the output file.Macro Parameter MFDOUT

Data Type I

Range 0 through 5

Default Value 1 — first attached MFD

ZCL PROCESSES

SEIS APPEND XY

8/20/2019 z Macros

44/678


R2003.12.0 AREA-DEPTH 32

AREA-DEPTH

Macro Name AREA-DEPTH

Menu Option Macros → Graphics → Area/Depth Plot or CARM → Area/Depth Plot

Purpose The AREA-DEPTH macro checks the results of the volumetrics task ascompared to volumetrics results achieved by hand. This macro runsvolumes by slice increment on a surface and converts the output to aline suitable for plotting on an area versus depth plot.

Description The input depth grid is scaled to a negative value, and then biased by avalue that you provide. The volume of the grid covered by the polygon

area is then calculated using the following values that you supply:• volume and area scaling factors

• slice limit

• increment

The resulting file is converted to a vertex file and used to produce a picture plotting the area versus depth.

You are asked to input:

• the GRID file on which volumetrics is calculated (TVDSS)

• an optional fault (FALT) file

• the polygon vertex (VERT) file defining the area for thevolumetrics calculation

• bias to move grid up or down

• volume and area scaling factors (optional)

• slice limit for end of volumes and slice increment

8/20/2019 z Macros

45/678


R2003.12.0 AREA-DEPTH: Results 33

AREA-DEPTH: Results

Results A picture that plots the area versus depth, as shown in the following

example.

This isochore grid is based on true triple point geometry from fault plane models. The area bounded by the box is processed to generate thearea depth curve.

AREA-DEPTH.PICMAC Plot

Area Depth Curve

8/20/2019 z Macros

46/678


R2003.12.0 AREA-DEPTH: Parameters 34

AREA-DEPTH: Parameters


*Enter the Grid File Representing Surface

Description Name of the input grid file representing the surface.

Macro Parameter GRIDIN

Data Type C*24

Range All attached GRID files


oMFD for the Surface Grid File

Description The MFD for the input grid.

Macro Parameter MFDGRID

Data Type I

Range 0 through 5

Default Search all attached MFDs

Polygon File Defining Area of Integration

Description Name of the vertex file defining the area of the grid for which thevolume is calculated.

Macro Parameter POLYGON

Data Type C*24

Range All attached VERT files

Default Value ZCL default

oMFD for the Polygon File

Description The MFD for the input polygon vertex life.

Macro Parameter MFDPOLY

Data Type I

Range 0 through 5Default Search all attached MFDs

8/20/2019 z Macros

47/678




Enter Constraining Fault File

Description Name of the input fault file.Macro Parameter FAULTS

Data Type C*24

Range All attached FALT files


oMaster File for the Fault File

Description The MFD for the input fault file.

Macro Parameter MFDFAULT

Data Type IRange 0 through 5


Constant Number to Add to All Grid Values

Description Bias factor applied to input grid to shift the value up or down.

Macro Parameter BIAS

Data Type R

Default Value 0.0

Area Scale Factor of the Surface Grid

Description Area scale factor.

Macro Parameter AREASCAL

Data Type R

Default Value 0.0001

Volume Scale Factor of the Surface Grid

Description Volume scale factor.

Macro Parameter VOLSCAL

Data Type R

Default Value 1.0

8/20/2019 z Macros

48/678




Base Level to Start Slicing

Description Minimum contour level.Macro Parameter BASEPLAN

Data Type R

Default Value 0.0

Slice Increment

Description Slice thickness. Volumes are generated for slices of thickness fromthe baseplane upwards to the cutoff.

Macro Parameter SLINC

Data Type R Default Value 10.0

Top Level to Stop Slicing

Description Maximum contour level.

Macro Parameter SLICLIM

Data Type R

Default Value 100.0

Label for the Area AxisDescription Character string that labels the x axis of the area vs. depth plot.

Macro Parameter AREALABL

Data Type C*40

Default Value Acre

Label for the Volume Axis

Description Character string that labels the y axis of the area vs. depth plot.

Macro Parameter DPTHLABL

Data Type C*40Default Value Feet

8/20/2019 z Macros

49/678




Label Increment of Area (X) Axis

Description Value interval for labeling x axis.Macro Parameter LABLINCR

Data Type R

Default Value 10.0

Number of Decimal Places to Label Axes

Description Number of places to the right of the decimal point for area ( x) and depth ( y) axes labels.

Macro Parameter NDECIMAL

Data Type IDefault Value 2

Specify the Format of the Area to Depth Labels

Description Format for axis labels.

Macro Parameter LABLFRMT

Options

Data Type C*12

Default Value SCIENTIFIC

Character Size of Plot Title

Description Size of the characters to use for the title of the area vs. depth plot.

Macro Parameter TITLSIZE

Data Type R

Default Value 0.3

Color of the Plot Line

Description Specify the color to use for the area vs. depth plot line.

Macro Parameter LINCOLOR

Data Type I

Range 0 through 255

Default Value 7

COMMAS = Integers with commas

SCIENTIFIC = Scientific notation

8/20/2019 z Macros

50/678




Symbol Type to Post at Plot Point

Description Symbol to use to identify a point on the area vs. depth graph.Macro Parameter LINSYMBL

Data Type I

Default Value 14

Save the Area to Depth Curve Vertex File

Description Decide whether to save the area vs. depth vertex file or not.

Macro Parameter SAVEOUT

Options

Data Type C*4

Default Value NO

Enter the Name of the Output Vertex File

Description Name of the vertex file for the area vs. depth plot.

Macro Parameter AREADPTH

Data Type C*24

Default Value AREA DEPTH CURVE

Master File for the Vertex File

Description MFD for the output area vs. depth vertex file.

Macro Parameter MFDPLOT

Data Type I

Range 0 through 5

Default Value 0 — scratch MFD

*Graphics File to Hold Area to Depth PlotDescription Name of the graphics file for the area vs. depth plot.

Macro Parameter ZGFNAME

Data Type C*80


NO = Do not save the vertex file.

YES = Save the vertex file.

8/20/2019 z Macros

51/678




New or Old Graphics File

Description Specify whether the graphics file (ZGF) is new or old.Macro Parameter NEWZGF

Options

Data Type C*4

Default Value OLD

*Picture Name of Area to Depth Plot

Description Name of the picture for the area vs. depth plot.

Macro Parameter PICTURE

Data Type C*80


ZCL PROCESSES

SINGLE GRID OPS VOLUMETRICS

DELETE FILE FILE UTILITYSINGLE DATA OPS BRANCH

FILE CONVERSION POST LINES

DATA BLOCK DATA STATISTICS

DATA BLOCK UTILITY PICTURE

BORDER LABEL N/E

TEXT

NEW = New graphics file

OLD = Old graphics file

8/20/2019 z Macros

52/678


R2003.12.0 BUBBLE-POSTING 40

BUBBLE-POSTING

Macro Name BUBBLE-POSTING

Menu Option Macros → Graphics → Bubble Map Posting

Purpose Use the BUBBLE-POSTING macro to create a “bubble map” in whichthe size of the symbol posted at each control point depends on the

z field value.

Description You are asked to input:

• a control point dataset

• the z field which varies the size of the symbol

• up to two fields for annotation

• an optional symbol code field

• color, size, and location of the two annotation values

Results Control points posted on the current picture, as shown in the example.

Example of BUBBLE-POSTING.ZCLMAC Output

8/20/2019 z Macros

53/678


R2003.12.0 BUBBLE-POSTING: Parameters 41

BUBBLE-POSTING: Parameters


Input Data File

Description Name of the input file to control posting. This file contains the z field that controls the symbol size.

Macro Parameter FILEIN

Data Type C*24

Range All attached DATA and DWEL files


oMFD for the Input Data

Description The MFD that contains the input file.


Data Type I

Range 0 through 5


Z Field to Use to Determine Symbol Size

Description The z field used to vary the size of the top symbols.

Macro Parameter SIZEFLD

Data Type I

Range All Z VALUE fields on the input file


Number of Fields to Annotate Symbol (1-2)

Description Number of fields for annotation (specify 1 or 2).

Macro Parameter NUMFLDS

Data Type I

Range 1 or 2Default Value 1

8/20/2019 z Macros

54/678




First Field for Annotation

Description First field to post at the top location. All field types are valid.Macro Parameter TOPFLD1

Data Type I


Second Field for Annotation

Description Second field to post at the top location. All field types are valid.

Macro Parameter TOPFLD2

Data Type I


Mode of Picking Symbol

Description Determine the source of the symbol to post at top locations.

Macro Parameter SYMMODE

Options

Data Type C*8

Default Value NUMBER

Symbol Number (If Using Number)

Description Code of the symbol to post at top locations. Used whenSYMMODE = NUMBER.

Macro Parameter SYMBOL

Data Type I

Default Value 1

Z-MAP Plus Users See this Prompt Even If NUMFLDS = 1If you do not want to post a second field, select (None - use no field).

NUMBER = Use symbol given by SYMBOL parameter.

FIELD = Use symbol given by SYMFIELD parameter.

8/20/2019 z Macros

55/678




Mode of Picking Symbol Color

Description Method for defining the color of the symbol at top locations.Macro Parameter COLMODE

Options

Data Type C*8

Default Value INDEX

Color of Symbol (If Using Index)

Description Color index for symbols at top locations.

Macro Parameter SYMCOLOR

Data Type I

Range 0 through 255

Default Value 5

Symbol Field (If Using Field)

Description Symbol field used to determine the symbol to post at top locations.Used when SYMMODE = FIELD.

Macro Parameter SYMFIELD

Data Type R

Default Value 21

Color Field (if Using Field)Description Color field used to determine the color index for the symbol color.

Used when COLMODE = FIELD.

Macro Parameter COLFIELD

Data Type R

Default Value 41

INDEX = Vary color based on the color index given by SYMCOLOR.

FIELD = Vary color based on a field given by COLFIELD.

Z-MAP Plus Users Receive an Error Message if there is no

Symbol Fields on the File

Z-MAP Plus users see a list of fields. If there are no fields of the correct

type, you must dismiss the dialog box.

8/20/2019 z Macros

56/678




Minimum Symbol Size

Description Minimum symbol size to post at tops, in plotter units (in or cm).You cannot enter a value smaller than the default.

Macro Parameter MINSIZE

Data Type R

Default Value 0.05 in or 0.15 cm

Maximum Symbol Size

Description Maximum symbol size to post at tops, in plotter units (in or cm).You cannot enter a value larger than the default; to exaggeratesymbol size, make your maps smaller.

Macro Parameter MAXSIZE

Data Type R


Increment for Symbol Size

Description Symbol size increment at tops, in plotter units (in or cm). Theremay be no more than six increments, and increments must fit in between minimum and maximum sizes given above.

Macro Parameter INCREMENT

Data Type R Default Value 0.05 in or 0.15 cm

Number of Increments

Description Number of increments for top symbol size.

Macro Parameter LEVELS

Data Type I

Range 1 through 6

Default Value 6

8/20/2019 z Macros

57/678




Color of the First Label

Description The color index for posting the first field of annotation.Macro Parameter LBLCLR1

Data Type I

Range 0 through 255

Default Value 5

Font of the First Label

Description The font type for posting the first field of annotation.

Macro Parameter FONT1

Options

Data Type C*8

Default Value PLAIN

Digits Right of Decimal - First Label

Description The number of digits right of decimal to post for the first field of annotation.

Macro Parameter NUMDEC1

Data Type I

Default Value 0

PLAIN

SIMPLEX

COMPLEX

ITALIC

DUPLEX

8/20/2019 z Macros

58/678




Location of the First Label

Description The location for posting the first field of annotation relative to thesymbol.

Macro Parameter LOCATE1

Options

Data Type C*8

Default Value ABOVE

Size of the First Label

Description The size for posting the first field of annotation, in plotter units (inor cm).

Macro Parameter LBLSIZE1

Data Type R


Color of the Second LabelDescription The color index for posting the second field of annotation.

Macro Parameter LBLCLR2

Data Type I

Range 0 through 255

Default Value 5

ABOVE = Above the top symbol

BELOW = Below the top symbol

RIGHT = Right of the top symbol

LEFT = Left of the top symbol

CENTERED = At the well location. Normally, this is used only when nosymbol is posted.

8/20/2019 z Macros

59/678




Font of the Second Label

Description The font type for posting the second field of annotation.Macro Parameter FONT2

Options

Data Type C*8

Default Value PLAIN

Digits Right of Decimal - Second Label

Description The number of digits right of decimal to post for the second field of annotation.

Macro Parameter NUMDEC2

Data Type I

Default Value 0

Location of the Second Label

Description The location for posting the second field of annotation relative tothe symbol.

Macro Parameter LOCATE2

Options

Data Type C*8

Default Value ABOVE

PLAIN

SIMPLEX

COMPLEX

ITALIC

DUPLEX

ABOVE = Above the top symbol

BELOW = Below the top symbol

RIGHT = Right of the top symbol

LEFT = Left of the top symbol

CENTERED = At the well location. Normally, this is used only when nosymbol is posted.

8/20/2019 z Macros

60/678




Size of the Second Label

Description The size for posting the second field of annotation, in plotter units(in or cm).

Macro Parameter LBLSIZE2

Data Type R


ZCL PROCESSES

POST DATA NEW

8/20/2019 z Macros

61/678


R2003.12.0 CHANGE-MFD-NAME 49

CHANGE-MFD-NAME

Macro Name CHANGE-MFD-NAME

Menu Option Macros → Utilities → Change Internal MFD Name

Purpose The CHANGE-MFD-NAME macro changes the internal name of anMFD. The internal name is assigned when the MFD is created and isusually the same as the MFD name.

Z-MAP Plus displays the MFD internal name in all dialog boxes thatrefer to MFDs. If you change the disk file name, change the internal

name to match.

Description You are asked to specify these input values:

• MFD to change

• new internal name for the MFD

Results The internal name for the selected MFD is changed.


*Enter the MFD for Changing

Description Disk file name of the MFD.

Macro Parameter MFDNAME

Data Type C*80


*Enter the New Internal Name for the MFD

Description New internal name for MFD.

Macro Parameter HEADER

Data Type C*24


ZCL PROCESSES

RENAME MFD

8/20/2019 z Macros

62/678


R2003.12.0 CLEAN 50

CLEAN

Macro Name

z Macros

Documents

Transcript of z Macros