A single seismic trace is identified by its station name (geographical location within a network), component , and network name (e.g., UW for University of Washington.) This three-part identification is sometimes known as the SCN . The network name is a necessary part of the identification, since station names are not necessarily unique across different networks.
-d directory Set the directory in which the SAC directory will be created. If this option is not given, then the SAC directory will be created in the current directory.
-e event-file Specify an event file from which to get start-time and duration for saving data. See Event Files below for details. The event file may be in the current directory or the full or relative path included in event-file .
-g gap Set the gap threshold in number of sample periods. If there is a gap of more than this periodd of time in the trace data, then it will be filled with zero's. Tracesave will report on standard error when it has filled gaps in data. The default gap threshold is 20 sample periods. See Note below about possible gaps in data from sunworm.
-o basename Specify the base name of the output data files and the directory which will be created to hold them. Normally this name is determined automatically, based on the pickfile name or on the start-time. The output SAC directory will be created in the directory specified with the -d directory option if it is given. Otherwise the SAC directory will be created in the current directory. earth2sac appends the station, component and network names to the basename to form the complete filename for each SCN.
-s server:port Specify a wave server by its name or IP address and its port number, separated by a colon: e.g., -s verme:16022 This flag and option may be specified more than once to use more than one wave server. It may be used in conjunction with the -S server-file option as well. If neither the -s or -S options are used, then earth2sac uses the default server list, currently /wormdata/run/params/servers. The order of servers is significant in that a given SCN will be retrieved from the first wave server that has it in its menu.
-S server-file adds the servers listed in the file to the list from which to get wave traces. This option may be used in conjunction with the -s server:port option above, which see. The server file is a simple ASCII list of server names or IP address and port number separated by whitespace, one pair to a line. Comment lines have a # character in the first column of the line and are ignored.
-t seconds Wait this many seconds for a wave server to respond. The default timeout is 30 seconds. If a server does not respond to the initial earth2sac request in this time, it will be ignored.
-T delaytime Wait this many seconds for seismic waves to get from their origin to the server. Tracesave can make two requests to the server for each SCN. If the time interval requested is not yet held by the server at the first request, the server will report a wait-time after which it expects the waves to have arrived. After the lesser of delaytime or wait-time, earth2sac will query the server a second time for the SCN. The default delaytime limit is 30 seconds.
-u Urgent mode; don't retry connections to servers; don't wait for waves to get to server. Normally, if the connection to a server fails, earth2sac will try once to re-establish that connection.
-v Verbose mode; useful for troubleshooting connection problems or filling your screen with gibberish.
-h Give the usage for earth2sac and exit.
Trace start-time and duration may be given as arguments to earth2sac . The start-time is up to 14 digits in the format YYMMDDHHMMSS.SS , that is year, month, day, hours, minutes, seconds and hundredths of seconds. Digits on the right end of this format may optionally be omitted, in which case they will treated as zero. The duration is in seconds expressed as an integer. The duration must be given if the start-time is specified. If neither start-time and duration, nor event file are specified on the command line, then earth2sac will try to read an event file from standard input.
The second format for event files is a trigger file. This is an ASCII file with one or more lines of station, channel, network, start-time and duration, all separated by white space. Any of station, channel or network may be the wildcard character * , which will match any SCNs which also match the non-wildcarded components. The start-time in the trigger file is up to 14 digits in the format YYMMDDHHMMSS.SS . Missing digits on the right will be treated as zero's. The duration time is in seconds expressed as an integer.
When the data file name is not specified on the command line (with -o data-file ), then the data file name is obtained as follows. If the pickfile name is known (because it was specified on the command line with the -e eventfile option, then the data file name will be obtained by replacing the final letter in the pickfile name with W . If a UW2-format pickfile name is not known, then the data file name consists of the 11 digit start-time in format YYMMDDHHMMS concatenated with the letter W .
The wildcard character * may be used for one or more of station , component , and network in the trace request. The wildcard will match all the menu SCNs which also match the non-wildcard parts of the SCN. Currently the trace requests generated from UW pickfiles or from command-line arguments of start-time and duration consist of wildcards for station and component for the UW network . If trace data is needed for stations in other regional networks, they should be specified in a custom-made trigger file .
As the retrieved trace data for each SCN is prepared for inclusion in the trace data file, the mean value of the first 1000 (approximately) samples is taken as the bias value, subtracted from the trace data and written to the channel header bias field. If a gap happens to occur within the first 1000 samples, the mean value will include only those samples before the gap. Gaps in data are filled with zeros after the bias is removed.