XYZGMS

Builds GM-SYS Starting Models

Version 1.04.04 August 16, 1999

XYZGMS is a command-line driven GM-SYS utility program that will read GEOSOFT format
'XYZ' files with several fields of data, and create a GM-SYS model. Input data fields may
include topography, additional global horizons, gravity data, magnetic data and station
elevations.

XYZGMS incorporates the following features:

q XYZGMS reads free format ASCII files, (i.e. fields of data separated by spaces). Data
fields can be in any order you chose. Geosoft line headers need to be present. You select
which 'Line' will be used for building the model
q XYZGMS can window and decimate your data to a subset of your data file.
q XYZGMS allows you to select default values for missing data types (e.g. magnetic station
elevations).
q XYZGMS creates all necessary files for a GM-SYS model including conveniently
recalled views.
q XYZGMS allows you to specify a starting X-coordinate offset.

Note that XYZGMS converts a multi-segment line into a single-segment profile as shown
below. The black line represents the original profile as digitized by the user. The red line is the
location of the model profile in real-world X,Y space with values projected perpendicularly onto
the model profile. The model-profile azimuth is based on the first and last points in the original
profile. The profile location is then shifted to minimize the average mis-fit.

GM-SYS Projected
Profile location

Original Profile
RUNNING XYZGMS:

XYZGMS is a command line driven program. Typing XYZGMS followed by a number of

parameters and options runs it.

Usage:

XYZGMS in out -l= -zg= -zm= -zeg= -zem= -eg= -em= -zt= -t= -u= -
d= -x= -x0= -y= -s=

where:

in (required) name of the XYZ file (.XYZ assumed)

out (required) root name of the output files (six files)
-l= (required) line type [B, T, or L] and line number
-zg= column for gravity values (a gravity or magnetics column is required)
-zm= column for magnetics values (a gravity or magnetics column is required)
-zeg= column for gravity elevation values (+ is up)
-zem= column for magnetics elevation values (+ is up)
-eg= value for constant gravity elevation (+ is up)
-em= value for constant magnetics elevation (+ is up)
-zt= column for topography values (+ is up)
-t= value for constant topography (+ is up)
-u= unit conversion (default meters). If input is in
feet -u=3.28
kilofeet -u=0.00328 or -u=3.28E-3
kilometers -u=0.001 or -u=1E-3
miles -u=6.2121E-4
-d= decimation factor. Take only every d th point (Default -d=1)
-x= min,max X limits. The default is to pass entire X range.
-x0= x-coordinate of first point in profile. The default is 0.
-y= min,max Y limits. The default is to pass entire Y range.
-s= min,max Station limits. The default passes all stations.
-h= h1,h2,h3... columns for up to 15 layer horizons. ( + is down )
-q 'quite mode' (i.e., supress version message and other non-error messages)

The first point in the model will be placed at X=0 (GM-SYS model coordinates) and GM-SYS
model coordinates will be calculated as the distance from that point. The -x0 parameter may be
used to shift the starting X-coordinate to any value. Those coordinates may also be shifted using
the GM-SYS utility program CVTGMS.
XYZGMS calculates the profile azimuth and assigns relative strike angle=90, magnetic
inclination=60, declination=20 and field intensity=56,000 as default values. You may change
these for each model in GM-SYS (Profile menu, set field and set azimuth) to the proper values
for your profile.

Example: XYZGMS test test -l=L19 -d=5 -t=400 -eg=400 -zg=5

This example will read data from file test.xyz and create a GM-SYS model named test. Only
every 5th point will be read, topography elevation is constant at 400 meters, gravity data is in the
5th field of the input data file, and the elevation of the gravity stations is constant at 400 meters.

Two sample files are included with the distribution:

1. gms.xyz is a sample input data file

2. sample.bat is a sample batch file using gms.xyz

SPECIFICATIONS:

Maximum number of columns (characters) in input record: 256

Maximum number of data fields in input file: 50
Maximum number of data points in output model: 2000

NGA'S LICENSE STATEMENT

Both United States Copyright Law and International Treaty provisions protect this software.
Therefore, you must treat this software just like a book. This means that this software may be
used by any number of people and may be freely moved from one computer location to another
so long as there is No Possibility of it being used at one location while it's being used at another.
Northwest Geophysical Associates authorizes you to make archive copies of the software for the
sole purpose of backing up your software and protecting your investment from loss.

Warranty

With respect to the physical diskette and physical documentation enclosed herein,
NORTHWEST GEOPHYSICAL ASSOCIATES, INC. ("NGA") warrants the same to be free of
defects in materials and workmanship for a period of 60 days from the date of purchase. In the
event of notification within the warranty period of defects in material or workmanship, NGA
will replace the defective diskette or documentation. The remedy for breach of this warranty
shall be limited to replacement and shall not encompass any other damages, including but not
limited to loss of profit, special, incidental, consequential, or other similar claims.

NORTHWEST GEOPHYSICAL ASSOCIATES, INC., SPECIFICALLY DISCLAIMS ALL

OTHER WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED
TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE WITH RESPECT TO DEFECTS IN THE DISKETTE AND
DOCUMENTATION, AND THE PROGRAM LICENSE GRANTED HEREIN. IN
PARTICULAR, AND WITHOUT LIMITING OPERATION OF THE PROGRAM LICENSE
WITH RESPECT TO ANY PARTICULAR APPLICATION, USE, OR PURPOSE. IN NO
EVENT SHALL NGA BE LIABLE FOR ANY LOSS OF PROFIT OR ANY OTHER
COMMERCIAL DAMAGE, INCLUDING BUT NOT LIMITED TO SPECIAL,
INCIDENTAL, CONSEQUENTIAL OR OTHER DAMAGES.

XYZGMS is copyrighted 1999 by

and GM-SYS is a trademark of
Northwest Geophysical Associates, Inc.
P.O. Box 1063, Corvallis, OR 97339
Phone (541) 757-7231
FAX (541) 757-7331
email: info@nga.com
anonymous ftp: nga.com
Web page: www.nga.com