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 output data file will be created. If this option is not given, then the data file 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 data-file Specify the name of the output data file. Normally the data file name is determined automatically, based on the pickfile name or on the start-time. The output data file will be written in the directory specified with the -d directory option if it is given. Otherwise the data file will be created in the current directory.
-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 earth2uw 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.
-n Put the network code in the chid field for each channel. By default, earth2uw puts "0" in the chid field for time channel WWVB and nothing in that field for other stations.
-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 earth2uw 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, earth2uw will query the server a second time for the SCN. The default delaytime limit is 30 seconds.
-v Verbose mode; useful for troubleshooting connection problems or filling your screen with gibberish.
-h Give the usage for earth2uw and exit.
Trace start-time and duration may be given as arguments to earth2uw . 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 earth2uw 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.