NAME
sps_aps - module to read acquisition geometry data from
standard sps-format point-record geometry files, and:
* add source/receiver polarization info to them (creating
aps-format geometry files);
* write 2 plot files to be input into module aqplot, for
mapping this info.
SYNOPSIS
sps_aps [ -Ssps_source-file ] [ -Rsps_receiver-file ] [
-Xsps_relation-file ]
[ -Aazimuth-0 ] [ -MCLmulti_component_list ]
[ -s1source_1-azimuth ] [ -s2source_2-azimuth ]
[ -r1receiver_1-azimuth ] [ -r2receiver_2-azimuth ]
[ -SIp ] [ -SIn ] [ -SIaalternating_code ]
[ -SXp ] [ -SXn ] [ -SXaalternating_code ]
[ -RIp ] [ -RIn ] [ -RIaalternating_code ]
[ -RXp ] [ -RXn ] [ -RXaalternating_code ]
[ -1nsStart_trace_number(Comp_1) ]
[ -1neEnd_trace_number(Comp_1) ]
[ -2nsStart_trace_number(Comp_2) ]
[ -2neEnd_trace_number(Comp_2) ]
[ -3nsStart_trace_number(Comp_3) ]
[ -3neEnd_trace_number(Comp_3) ]
[ -V ] [ -? ]
DESCRIPTION
sps_aps : This routine adds polarization info to an acquisi-
tion geometry file, and prepares 2 plot files for displaying
this info. It expects input data file(s) in "sps" format,
as well as polarization info (on the command line), and pro-
duces output data files appending this polarization info
onto the sps records (thereby creating "aps" geometry
files). It also writes 2 plot files which serve as input
into module aqplot which plots tehm, so that this geometry
info may be visually checked for errors.
sps_aps gets both its data and its parameters from command
line arguments. These arguments specify the input and out-
put filenames, concise polarization information, and a ver-
bose printout flag. You may use sticky or non-sticky argu-
ments as you wish.
Command line arguments
-Ssps_source-file
Enter the filename for the seismic-source input
dataset, in sps format. This filename should include
the complete path, if the file resides in a different
directory. [NOTE: sps_aps will write an output file
with ".aps". appended to the end of this filename, and
a plotfile with ".aqp" appended, in this same
directory. So, you must have WRITE PERMISSION in that
directory.]
-Rsps_receiver-file
Enter the filename for the receiver input dataset, in
sps format. This filename should include the complete
path, if the file resides in a different directory.
[NOTE: sps_aps will write an output file with ".aps".
appended to the end of this filename, and a plotfile
with ".aqp" appended, in this same directory. So, you
must have WRITE PERMISSION in that directory.]
-Xsps_relation-file
Enter the filename for the "relation" input dataset, in
sps format. This filename should include the complete
path, if the file resides in a different directory.
[NOTE: sps_aps will write an output file with ".aps".
appended to the end of this filename, in this same
directory. So, you must have WRITE PERMISSION in that
directory.] If you don't specify a source or a
receiver or a relation input, you need help.
-Aazimuth-0
The coordinates in the sps file are given with respect
to ANY coordinate system (that is, +x may or may not be
East). Enter here the azimuth (in + degrees E of N) of
the positive x-axis of these sps coordinates (default
is 90). These sps x's and y's are assumed to
correspond to a right-handed coordinate system with +z
pointed up, (like graph paper). The aps (output) coor-
dinate system will have aps x's and y's referred to the
standard coordinate system (in + degrees E of N), with
+z pointed DOWN (as the SEG recommends), hence +x =
East and +y = SOUTH.
-MCLsequence
The sequence in which the various polarizations are
written in the seismic data files to which this info
will eventually be written (default: 11,12,21,22).
-s1 source_1-azimuth
If ALL sources have their 1-axes oriented in a certain
absolute azimuth, enter it here (in + degrees E of N).
-s2 source_2-azimuth
If ALL sources have their 2-axes oriented in a certain
absolute azimuth, enter it here (in + degrees E of N).
-SIp Enter the command line argument '-SIp' if ALL source-
points have a polarization oriented in the LOCAL IN-
LINE positive direction. The positive direction is the
direction of INcreasing indices.
-SIn Enter the command line argument '-SIn' if ALL source-
points have a polarization oriented in the LOCAL IN-
LINE negative direction. The negative direction is the
direction of DEcreasing indices.
-SIa alternating_code
This code controls alternating local in-line source
polarizations:
-SIa1 => odd source lines polarized inline positive
-SIa0 => disabled (default)
-SIa-1 => odd source lines polarized inline negative
-SXp Enter the command line argument '-SXp' if ALL source-
points have a polarization oriented in the LOCAL
CROSS-LINE positive direction. The positive cross-line
direction has a larger azimuth (in + degrees E of N,
without unwrapping) than the positive in-line direc-
tion.
-SXn Enter the command line argument '-SXn' if ALL source-
points have a polarization oriented in the LOCAL
CROSS-LINE negative direction. The negative cross-line
direction has a smaller azimuth (in degrees E of N,
without unwrapping) than the positive in-line direc-
tion.
-SXa alternating_code
This code controls alternating local cross-line source
polarizations:
-SXa1 => odd source lines polarized crossline positive
-SXa0 => disabled (default)
-SXa-1 => odd source lines polarized crossline negative
default
[NOTE: if no source polarization information is given, the
assumption is that the sources are vertical.]
-r1 receiver_1-azimuth
If ALL receivers have their 1-axes oriented in a cer-
tain absolute azimuth, enter it here (in + degrees E of
N).
-r2 receiver_2-azimuth
If ALL receivers have their 2-axes oriented in a cer-
tain absolute azimuth, enter it here (in + degrees E of
N). These axes should compose a right-handed coordi-
nate system, with z DOWN (like a compass, not like
graph paper). If they don't, sps_aps will record them
anyway, as you specify, but this will be rectified when
they are put into USP trace headers later.
-RIp Enter the command line argument '-RIp' if ALL
receiver-points have a polarization oriented in the
LOCAL IN-LINE positive direction. The positive direc-
tion is the direction of INcreasing indices.
-RIn Enter the command line argument '-RIn' if ALL
receiver-points have a polarization oriented in the
LOCAL IN-LINE negative direction. The negative direc-
tion is the direction of DEcreasing indices.
-RIa alternating_code
This code controls alternating local in-line receiver
polarizations:
-RIa1 => odd receiver lines polarized inline positive
-RIa0 => disabled (default)
-RIa-1 => odd receiver lines polarized inline negative
-RXp Enter the command line argument '-RXp' if ALL
receiver-points have a polarization oriented in the
LOCAL CROSS-LINE positive direction. The positive
cross-line direction has a larger azimuth (in + degrees
E of N, without unwrapping) than the positive in-line
direction.
-RXn Enter the command line argument '-RXn' if ALL
receiver-points have a polarization oriented in the
LOCAL CROSS-LINE negative direction. The negative
cross-line direction has a smaller azimuth (in degrees
E of N, without unwrapping) than the positive in-line
direction.
-RXa alternating_code
This code controls alternating local cross-line
receiver polarizations:
-RXa1 => odd receiver lines polarized crossline posi-
tive
-RXa0 => disabled (default)
-RXa-1 => odd receiver lines polarized crossline nega-
tive
default
[NOTE: if no receiver polarization information is given, the
assumption is that the receivers are vertical.]
-1ns Start_trace
Enter start trace number (Comp-1). Default value is
the first trace.
-1ne End_trace
Enter end trace number(Comp-1) . Default value is last
trace.
-2ns Start_trace
Enter start trace number (Comp-2). Default value is
the first trace.
-2ne End_trace
Enter end trace number(Comp-2) . Default value is last
trace.
-3ns Start_trace
Enter start trace number (Comp-3). Default value is
the first trace.
-3ne End_trace
Enter end trace number(Comp-3) . Default value is last
trace.
-V Enter the command line argument '-V' to get additional
printout.
-? or -h
Enter the command line argument '-?' or -h to get
online help. The program terminates after the help
screen is printed.
DISCUSSION
This routine simply records what was done in the field, and
reformats it for later use; it does NOT correct for anything
done wrong.
BUGS
None known.
SEE ALSO
regsys(1) aps_usp(1) aqplot(1) gthrplot(1) usp_aqp(1)
usp_sps(1)
AUTHOR
Leon Thomsen (STAT x 7716; zlat02)
COPYRIGHT
copyright 2001, Amoco Production Company
All Rights Reserved
an affiliate of BP America Inc.
Man(1) output converted with
man2html