brot

NAME
SYNOPSIS
DESCRIPTION
FILES
SEE ALSO
BUGS
COPYRIGHT
AUTHOR

NAME

brot - BSU program to rotate 3-C seismic traces to a new coordinate system

SYNOPSIS

brot [ -h | infile | itrx | itry | iopt | iangle ]

DESCRIPTION

Basic Seismic Utilities (BSU) trace rotation program. This program was designed for use with 3-component Vertical Seismic Profile (VSP) data. The usual use is to rotate the two downhole horizontal component data into a new reference frame. For example, one might wish to align one component with a polarized source axis and the other horizontal component would become orthogonal to the source polarization axis. This program is designed to be used with the particular recording decisions made by the author (channels 1,2,3 downhole; vertical, "radial", "transverse"). A reference phone on the surface (channels 4,5,6; vertical, "radial", "transverse"). A typical survey around which this code was designed will have the reference phone be trace 5 aligned North, trace 6 aligned West, trace 4 vertical. The source axis will be aligned parallel to the trace 6 geophone. See author’s sign conventions, man page (polarity). Code is in Fortran 77.

Options

-h

Online help giving details on command line arguments

infile

Input file name.

itrx

Trace number to associate with output x-axis. (This is usually the same as the transverse component on the reference phone)

itry

Trace number to associate with output y-axis. (This is usually the same as the radial component on the reference phone).

iopt

Rotation option.

0=user supplied rotation angle
1=Transverse Allignment: trace 3 aligned to trace 6
(assumes azimuths in headers)
2=Radial Allignment: trace 2 aligned to trace 5

iangle

User supplied rotation angle from x-axis

NOTE:
If invoked with no options, will prompt user for input parameters. Trace header angles are used with options iopt=1 or 2. These are limited to integer values (see bsegy).

EXAMPLE:
brot w001.seg 2 3 1

This will rotate the down-hole "radial", trace 2 to align with the surface reference phone "radial", trace 5. This assumes that the headers have encoded the azimuth for each geophone element (see bsegy, bhod, btor).

FILES

brotxxxx.seg

Output, rotated data. Named according to convention (first 4char brot, the next 4char are the first 4char of the input file name, suffix .seg)

standard output

produces a progress bar

brotxxxx.lst

Echo check of input parameters in listing file.

SEE ALSO

bhelp(1), bsegy(5), bhod(1), btor(1), polarity(5)

BUGS

no known bugs

COPYRIGHT

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.

AUTHOR

P. Michaels, PE. <[email protected]>