topcon - BSU reads a survey file (*.nez) and BISON Seismograph file, creates *.xyz file
topcon [ -h | topf | bisf | lid | shdp | is | nch | vpn | ir | esh | isa | isv | ira | ita ]
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
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.
bhelp(1), topcon2(1), bhed(1), bis2seg(1), genvsp(1), genref(1), bsegy(5)
No known bugs.
Copyright © 2024 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.
P. Michaels, PE. <[email protected]>