topcon

NAME
SYNOPSIS
DESCRIPTION
FILES
SEE ALSO
BUGS
COPYRIGHT
AUTHOR

NAME

topcon - BSU reads a survey file (*.nez) and BISON Seismograph file, creates *.xyz file

SYNOPSIS

topcon [ -h | topf | bisf | lid | shdp | is | nch | vpn | ir | esh | isa | isv | ira | ita ]

DESCRIPTION

Basic Seismic Utilities (BSU) reads a Northing, Easting, Elevation (*.nez) survey file and BISON Seismograph generated file (includes some header information). Writes a file (*.xyz) which combines both survey and Bison information. If one runs bis2seg, an *.seg file will be created with the data part of the Bison file. Running bhed with both the *.xyz file and the *.seg files as input produces a new *.seg file with all the header information attached. Much of this is can be automated using programs genvsp (for down-hole, vertical seismic profiles), or genref (for surface reflection or refraction shooting). These two latter programs generate executable bash scripts which call topcon and bis2seg. If the seismograph is not a Bison, an alternative program, topcon2 may be considered. It is suitable for use with seismographs that output data in SEG-2 format. Fortran 77.

Options

-h

Online help giving details on command line arguments

topf

Input *.nez file name

bisf

Input Bison file name (typically 8 characters)

lid

Line ID (limited to 4 characters)

shdp

Shot Depth (positive down)

is

Shot location number (corresponds to SPxx label in *.nez file, where xx=is)

nch

Number of channels (<48 unless you change in source and recompile)

vp1

Voltage Point (geophone location) channel 1 (corresponsds to VPxxxx in *.nez file, where xxxx= vp1)

vpn

Voltage Point (geophone location) channel MAXIMUM

ir

Shot record number

esh

Elevation adjustment (datum shift) to be applied to z-coordinates of all survey data.

isa

Source polarization AZIMUTH. For polarizable sources, direction of initial horizontal motion.

isv

Source polarization VERTICAL angle. This is measured from 0 (zenith) to 180 (nadir).

ira

Reference geophone polarization, AZIMUTH or "R-component". Author uses a stationary reference phone to monitor variations in source. If you don’t use one, set to zero.

ita

Reference geophone polarization, AZIMUTH or "T-component". Author uses a stationary reference phone to monitor variations in source. If you don’t use one, set to zero.

NOTE:
If invoked with no options, will prompt user for input parameters.

EXAMPLE:
topcon stp001.nez x1wl0001 00X1 .0 1 6 0001 0006 1 0. 270 135 0 270

Read survey data from stp001.nez, other header data from Bison file x1w10001. Line id is set to 00X1, shot at zero depth, channels run from 1 to 6, (VP0001 to VP0006 in *.nez file). This is the first shot, 0. meters datum shift, source delivers blow to WEST (270deg.), blow inclined 135 degrees from vertical, reference geophone R-component arrow points NORTH (0 degrees), T-component arrow points WEST (270 degrees). See BSU User’s Guide for more details.

SAMPLE from *.nez FILE:
0001 10038.5100 10006.6400 849.6500 SP01

0002 10038.5100 10006.6400 849.6500 SP02

0001 10039.5900 10006.6400 831.6500 VP0001

0002 10039.5900 10006.6400 831.6500 VP0002

0003 10039.5900 10006.6400 831.6500 VP0003

0004 10037.4700 10006.6400 849.5000 VP0004

0005 10037.4700 10006.6400 849.5000 VP0005

0006 10037.4700 10006.6400 849.5000 VP0006

FILES

in_file.xyz

Name convention is input file name with .xyz added. For example above, x1wl0001.xyz would be the output file name. This is the file to be read by bhed.

standard output

lists header information from Bison file (time of shot, etc.) and some *.nez file info.

in_file.lst

Echo check of input parameters.

SEE ALSO

bhelp(1), topcon2(1), bhed(1), bis2seg(1), genvsp(1), genref(1), bsegy(5)

BUGS

No known bugs.

COPYRIGHT

Copyright © 2017 by Paul Michaels

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

AUTHOR

P. Michaels, PE. <pm@cgiss.boisestate.edu>