Hyp2prof Manual

HYP2PROF MANUAL

Version 97.0109


Table of Contents


NAME

hyp2prof - interactive Sphypit90 reformating software

VERSION

These notes pertain to version 97.0109

SYNOPSIS

hyp2prof (return)

DESCRIPTION

hyp2prof is a program used to interactively read in output files from the tomographic inversion program SPHYPIT90 (which see) and reformat them into files that can be read and plotted using the Xprofile program (which see).

hyp2prof was developed on a SUN SPARCstation LX running Solaris 2.3, and compatibility with other environments should not be assumed. It is a fairly straightforward program, however, so modifications should not be extensive.

ARGUMENTS

This version of hyp2prof does not take any arguments.

OPTIONS

This version of hyp2prof does not take any options on the command line, but the user may redefine some default file names by specifying them in the file

.hyp2prof_defaults
This file contains up to four lines with information in the following order:
  1. Base name used in generating output files
  2. File name of SPHYPIT90 parameter file
  3. File name of SPHYPIT90 slowness file
  4. File name of Map file to use in Xprofile Macro

Fewer than four lines may be specified, but they must be specified in this order. Thus, to specify a slowness file only, two dummy lines must appear before it.

BASIC USAGE NOTES

Hyp2prof is a program to create Xprofile input files from Sphypit90 output files. In this version, the following types of information can be plotted:

The format of the Xprofile files are as follows:

Other options, such as the resolution and error files, are not yet implemented, although constructing these files as velocity files will allow them to be plotted.

Both map and cross section views are supported. Map views are optionally calculated in a km distance from coordinate center frame or in a lat/lon frame. The km to lat/lon conversion is done using hypit spherical routines. Cross sections are specified by the two end points on a map and a depth. A dip (other than the usual 90 degrees) may also be specified, although the box boundary option only approximates the result of a dip other than 90 degrees (it doesn't draw in mid-layer intersections). Box boundaries are drawn correctly for ireparm = 0 or 1 but not for ireparm = 2 (reparameterization across layers).

3D files can be output as "raw" or as percent differences between the 1d or mean layer values. Note that for cross-sections "mean value" refers to the mean value of the section, not of each layer, so the parameter file should be edited if deviation from mean 1D values are desired. A file with the suffix "1dmean_sum" can be output to help with this editing (this is output when selecting the 1D P or 1D S options).

An Xprofile macro file is optionally produced for quick viewing. If there are several large files produced, a good idea is to select the "delete from memory" option to make sure that Xprofile doesn't run up against a memory problem

Default basenames, parameter files, and slowness files can be read in with the file .hyp2prof_defaults. If this file doesn't exist, internal defaults apply


STEP BY STEP OPERATIONS

Hyp2prof communicates with the user though a series of windows. In order, these are:

Window 1: Select Output Types

This window allows the user to specify what types of information he/she would like to have plotted. The current options shown are:

Map TypeXProfile data file type
Box Map Meta-block boundaries as an Xprofile map file
Station File X, Y, Z, ID data set
Add a Map Specify a map for macro purposes
Vp/Vs ratio Full contourable data set of Vp/Vs
P Velocity Full contourable data set of Vp
S Velocity Full contourable data set of Vs
1D P Velocity XY line-connect data set of Vp
1D S Velocity XY line-connect data set of Vs
P Hit Map Full contourable data set of P Ray hits
S Hit Map Full contourable data set of P Ray hits
P Resolution (not implimented yet)
S Resolution (not implimented yet)
P Error (not implimented yet)
S Error (not implimented yet)

The user may select as many of these options as desired. This window also allows specification of the projection type, the velocity type, and whether or not a MACRO file for Xprofile is desired.

Windows 2 and 3: File Connections

The next 2 windows ask for file connections for a Sphypit90 format parameter file and slowness file. If the file .hyp2prof_defaults is present, it will read these files from there, otherwise internal default names are used.

Window 4: Select Parameters
Window 4 has a lot of information about the maps to be produced. The first 5 items are identical to the variables set in Xprofile. The sixth item (Detailed Menus:) tells the program whether or not to bother the user with an interactive window for each map plotted. If you want to use the same parameters for each map, set this option to NO.

The Map View parameters show the boundaries of the map, the sampling increment for generating contours, and the range of layers for which output files will be generated. Hyp2prof selects extremal values when it can discern them, and tries to make intelligent choices for the ones it can't, but of course the user can change any of these as desired.

The Cross Section Parameters shows the corrdinates of the left and right sides of the section, the minimum and maximum depths of the section, the sampling increments for generation on contours, (left-right and depth increments) the spacing between individual sections (in km) and the total number of sections to be generated.

Note that the Map View (Cross section) parameters will be heeded by the program only if a map view (cross section) was selected in the first window.

The last set of input lines shows the base name of the files used in creating names for output files, and the map name used in the MACRO. the number of maps that will appear on the screen at once, and a means of specifying format by selecting the number of columns for multiple plots per page. The base name and map name may be specified in the defaults file.

If you select OK at this point the program will generate the files requested, with a report on the stdio showing its progress.

After the completion of the program, the user should be able to plot the maps with XProfile.

SEE ALSO

Xprofile, Xest

AUTHOR

Steve Roecker
roecker@harold.geo.rpi.edu

ACKNOWLEDGMENTS

The first versions of hyp2prof was written by the author during sabattical at Oxford.

BUG REPORTS

Send bug reports to: roecker@harold.geo.rpi.edu


Go to Table of Contents