|SUMMARY:||Add a new file to the stack file list.|
[A]DD[S]TACK filename [property ...]|
where property is one or more of the following:
[DE]LAY v [[S]ECONDS|[P]OINTS]
[I]NCREMENT v [[S]ECONDS|[P]OINTS]
Name of the file to be added to the stack file list.
Weighting factor for this file in the range zero to one. Each data point is multiplied by this value when the stack is summed.
Station to epicenter distance in kilometers for this file. This is used to calculate dynamic time delays.
Time of the begining of the event.
Time of the end of the event.
[DE]LAY v [[S]ECONDS|[P]OINTS]:
Static time delay to apply to file.
This delay is in either seconds or number of data points.
[I]NCREMENT v [[S]ECONDS|[P]OINTS]:
Static time delay increment for this file. This increment is in either seconds or number of data points. The static time delay is incremented by this ammount each time the incrementstack command is executed.
File has normal polarity.
File has reversed polarity. (Each data point in the signal is multiplied by -1.0 when the stack is summed.)
|DEFAULT VALUE:||Each file is given the global property value if no local one is entered. The default units for the DELAY and INCREMENT options is SECONDS.|
There are seven properties associated with each stack list file.
There is a global value associated with each of these properties. They are defined by the globalstack command. When a file is added to the stack file list, that file's properties will be set to the global value if no local value is given. The changestack command can be used to change a file's properties after it has been added to the stack file list.
The following examples illustrate several of the features of the
Signal Stacking Module. Suppose you entered the following set of commands:
u: GLOBALSTACK DELAY 1.0 INCREMENT 0.03
u: ADDSTACK FILEA DELAY 2.0
u: ADDSTACK FILEB DELAY 3.0 INCREMENT 0.01 REVERSED
u: ADDSTACK FILEC
u: ADDSTACK FILED WEIGHT 0.5
The first command changes the global property values for time delay and
time delay increment.
The other global properties have their default values.
FILEA's properties would be the global ones except for the time delay.
FILEB's properties would be the global ones except for the time delay,
the time delay increment, and the signal polarity.
FILEC's properties would be the same as the global ones.
FILED's properties would be the global ones except for the weighting factor.
Now you enter:
5108: Maximum length of stack file list exceeded.|
1306: Illegal operation on unevenly spaced file - stacking module requires evenly spaced data files. 1307: Illegal operation on spectral file 5109: Sampling intervals are not equal.
|LIMITATIONS:||The maximum number of files in the stack file list is limited to the maximum number of data files allowed by SAC.|
|SEE COMMANDS:||GLOBALSTACK, SUMSTACK, CHANGESTACK, INCREMENTSTACK, DELETESTACK|
Back to The Commands