1 | Release Notes: Earthworm Version "working" |
---|
2 | Cleaned out after release of v7.1 on 4/15/2007 |
---|
3 | This release is EW V7.2 and has all of 7.0 SCNL upgrades. |
---|
4 | |
---|
5 | NEW MODULES: |
---|
6 | *********** |
---|
7 | seismic_processing/eqassemble |
---|
8 | Contributed by Peter Lombard of UCB. This module is an alternate head |
---|
9 | of the EW megamodule pipeline for doing hypocentral locations. Its a |
---|
10 | new variant that can mimic how earthquake processing is handled in |
---|
11 | the CISN codes. |
---|
12 | Paul Friberg 2007/10/12 |
---|
13 | |
---|
14 | tankplayer_tools/tanksniff - show a sniffwave output of a tanks contents. |
---|
15 | Saves you having to run tankplayer just to view the content. |
---|
16 | Paul Friberg 2007/08/28 |
---|
17 | |
---|
18 | tankplayer_tools/tankcut - a way to cut out a section of a tankplayer |
---|
19 | tank using a start time and end time or duration. |
---|
20 | Paul Friberg 2007/08/28 |
---|
21 | |
---|
22 | tankplayer_tools/dc2tank - a way to pull data from the DMC data center using |
---|
23 | DHI (requires Java to be installed and DHI2mseed.jar with accompanying files). |
---|
24 | Builds a tank file given a SCNL list and a start time and or end time. |
---|
25 | Paul Friberg 2007/08/28 |
---|
26 | |
---|
27 | tankplayer_tools/tr2dump - dump tankplayer tank as ASCII info to stdout |
---|
28 | (only in makefile.nt and makefile.ux currently) |
---|
29 | Ron Bakerian 2007/07/18 |
---|
30 | |
---|
31 | tankplayer_tools/ms2tank - new miniseed tank writer that works on Windows, |
---|
32 | Mac OS X, Linux, Solaris. |
---|
33 | Paul Friberg 2007/07/17 |
---|
34 | |
---|
35 | tankplayer_tools/ring2tank - suck tracebufs out of a ring and write them |
---|
36 | directly to a tank for later playback. Tested on Solaris, Windows and Mac OS X. |
---|
37 | Paul Friberg 2007/05/20 |
---|
38 | |
---|
39 | tankplayer_tools/smb2tb - take SMB format and convert to tanks. SMB format |
---|
40 | is from the Trinidad Soufrier system (part of the Carribean Tsunami work). |
---|
41 | Ron Bakerian 2007/06/15 |
---|
42 | |
---|
43 | MODIFICATIONS/BUG FIXES TO EXISTING MODULES: |
---|
44 | ******************************************** |
---|
45 | wave_serverV |
---|
46 | Added in Ron Bakerian's sqlite3 implementation for managing gaps and overlapping |
---|
47 | data that previously got dropped by wave_serverV. This feature needs .d entries |
---|
48 | to be activated. See the updated docs. |
---|
49 | Paul Friberg 2007/11/30 |
---|
50 | |
---|
51 | sac2tb (in archiving/tankplayer_tools) |
---|
52 | Fixed a bug where a location code of "<space-char><space-char>" was not being |
---|
53 | converted to "--", the default blank location code. |
---|
54 | Paul Friberg 2007/11/13 |
---|
55 | |
---|
56 | q3302ew |
---|
57 | lib330 was updated by Quanterra to solve some issues. The earthworm |
---|
58 | copy of this was updated and q3302ew uses this new version. |
---|
59 | Paul Friberg 2007/10/24 |
---|
60 | |
---|
61 | display/heli_ewII |
---|
62 | Jean-Michel Douchain pointed out that the IndexFile config setting was |
---|
63 | not working. I fixed it in this new version. |
---|
64 | Paul Friberg 2007/10/24 |
---|
65 | |
---|
66 | archiving/tankplayer_tools/sac2tb |
---|
67 | Matteo Quintiliani of INGV modified sac2tb so that it will read both SAC |
---|
68 | files written in Sparc and Intel byteorder. Previously it only handled |
---|
69 | SPARC (motorola byte order). |
---|
70 | Paul Friberg 2007/10/22 |
---|
71 | |
---|
72 | Fixes to many export modules as per Alex Nercessian recommendation: |
---|
73 | This short variable is found in the files: |
---|
74 | export_actv/export_actv.c: char processor[15]; |
---|
75 | export/export.c: char processor[15]; |
---|
76 | export/export_scn_pri.c: char processor[15]; |
---|
77 | ringdup/ringdup.c: char processor[15]; |
---|
78 | Made them all 17 or in some cases 20 to be safe. |
---|
79 | Paul Friberg 2007/09/20 |
---|
80 | |
---|
81 | import_gen_pasv: was using a bad way to strncpy the module ID such that |
---|
82 | errors could happen and the module could fail at startup. |
---|
83 | Paul Friberg 2007/09/18 |
---|
84 | |
---|
85 | remux_tbuf: |
---|
86 | modified to use a common code base for the remuxing since I reused it |
---|
87 | in a number of tankpayer_tools modules. |
---|
88 | Paul Friberg 2007/08/28 |
---|
89 | |
---|
90 | localmag: |
---|
91 | space for saveXMLdir not malloc'ed. Fixed using strdup. |
---|
92 | Mitch Withers 2007/07/20 |
---|
93 | |
---|
94 | wave_serverV: |
---|
95 | data_type's in tanks were turning up with blank values! |
---|
96 | There was a serious memory alignment bug in calls to WaveMsg2MakeLocal() - fixed, |
---|
97 | and the return of WaveMsg2MakeLocal() was checked for bad values, but the |
---|
98 | return which was being reported was the previous packet, not the bad one - fixed, |
---|
99 | Added more details about datatype to the error warnings for bad packets. |
---|
100 | Paul Friberg 2007/05/28 |
---|
101 | |
---|
102 | gmew: |
---|
103 | Fixed a bug reported by Ali Moeinvaziri of Utah.A qsort() call |
---|
104 | had some args switched! This caused some segfaults and was seen |
---|
105 | as far back as v6.2! Thanks to Ali for this catch. |
---|
106 | Fixed by Paul Friberg 2007/05/15 |
---|
107 | |
---|
108 | sgram: |
---|
109 | sgram.c had a number of fgets() calls that had |
---|
110 | a bad specification of the size of the char * array. This |
---|
111 | has been fixed. A new version is available. |
---|
112 | Bug reported by Alex Nercessian, Fixed by Paul Friberg 2007/05/15 |
---|
113 | |
---|
114 | k2ew_com,k2ew_tcp: |
---|
115 | Added a CtrlHandler (Windows only) to catch/ignore user logoff events |
---|
116 | so that k2ew console windows will survive user logouts when Earthworm |
---|
117 | is started with startstop_service. Also modified to log a descriptive |
---|
118 | message instead of a numeric value for handled signals. |
---|
119 | Changed version to v2.42. 2007/05/09 Lynn Dietz |
---|
120 | |
---|
121 | file2ring: |
---|
122 | Added optional command-line argument <sequence#> to be supplied as |
---|
123 | any positive integer. File2ring does sequence%256 before handing the |
---|
124 | sequence to transport, so an ever-increasing integer can be used as |
---|
125 | the sequence# argument for repeated invocations of file2ring. |
---|
126 | This feature can be used to implement Earthworm-style messages and |
---|
127 | heartbeats from non-Earthworm scripts. Remember to keep a seperate |
---|
128 | sequence counter for each <instid modid msgtype> used within each |
---|
129 | script. If the sequence# argument is ommitted, file2ring will load |
---|
130 | the message in transport with sequence=0. 2007/08/02 Lynn Dietz |
---|
131 | |
---|
132 | naqs2ew: |
---|
133 | Added three new Nanometrics instrument types: Taurus,Apollo,Trident305. |
---|
134 | These instruments will now be properly identified in log messages. |
---|
135 | 2007/10/02 Lynn Dietz |
---|
136 | |
---|
137 | eqprelim: |
---|
138 | Added new config command "ReportCoda" to control whether coda information |
---|
139 | is written to output. If ReportCoda=0, no coda info will be written, |
---|
140 | even if some exists at the time the event is reported. If ReportCoda is |
---|
141 | non-zero, coda information that exists at the time of report will be |
---|
142 | included. Default is ReportCoda=1 which is the previous default behavior. |
---|
143 | The new command is optional. 2007/11/29 Lynn Dietz |
---|
144 | |
---|
145 | CHANGES TO CONFIGURATION FILES and DESCRIPTOR FILES: |
---|
146 | **************************************************** |
---|
147 | |
---|
148 | KNOWN BUGS: |
---|
149 | *********** |
---|
150 | |
---|
151 | liss2ew: |
---|
152 | liss2ew has been observed intermittantly producing malformed |
---|
153 | TRACE_BUF messages. Currently the conditions for causing this problem |
---|
154 | are unknown. Due to this, liss2ew should be treated as suspect. Use at |
---|
155 | your own risk. JMP 6-18-2003 |
---|
156 | |
---|
157 | wave_serverV: |
---|
158 | appears not to reply to requests for a single sample of data. I noticed |
---|
159 | when testing wave_viewer, that if the start time and end time of a request were |
---|
160 | equal (in which case there should be one sample of data) then wave_serverV did |
---|
161 | not reply to the request (ASCII request) at all. No Data, No Flags, No Reply, |
---|
162 | No Nothing. It needs to issue a reply to every request. |
---|
163 | DavidK 09/25/01 |
---|
164 | |
---|
165 | Automatic restarts of adsend (using the "restartMe" line in the descriptor |
---|
166 | file) can cause an NT system to hang. Therefore, you should never |
---|
167 | use the autorestart feature with adsend, but you should bring down |
---|
168 | the entire Earthworm system if adsend needs to be restarted. |
---|
169 | LDD 5/31/2000 Comments added to adsend.desc, but leave this warning here! |
---|
170 | |
---|
171 | libsrc/utils/site.c: The strings used for station, channel and network are |
---|
172 | required to be fixed length with trailing spaces added to short names. If |
---|
173 | the strings given to site_index do not have these trailing blanks, SCN names |
---|
174 | will not match. This is not documented anywhere. PNL 10/15/00 |
---|
175 | |
---|
176 | |
---|
177 | KNOWN DEFICIENCIES: |
---|
178 | ******************* |
---|
179 | ringtocoax: |
---|
180 | In Windows NT, the time resolution of sleep_ew() is about 16 msec (one clock |
---|
181 | tick). On Solaris, the resolution is about 10 msec. This is a problem for |
---|
182 | ringtocoax, since packet delays need to be set to a few milliseconds. |
---|
183 | |
---|
184 | threads functions: The KillThread function on WindowsNT and Solaris |
---|
185 | terminate the thread without ensuring that no mutexes are held. If a thread |
---|
186 | holds a mutex when it dies, no other thread can get that mutex. PNL 1/12/2000 |
---|
187 | |
---|
188 | carlsubtrig: |
---|
189 | The system time must be set to GMT and ew_nt.cmd must have |
---|
190 | TZ=GMT for carlsubtrig to work. Comments in ew_nt.cmd done 5/25/00. Barbara |
---|
191 | |
---|
192 | localmag: |
---|
193 | needs GMT set on the system |
---|
194 | |
---|
195 | ew2seisvole: |
---|
196 | on NT, exits with horrible crash when system is stopped. |
---|
197 | |
---|
198 | NUMBER OF RINGS LIMITED ON SOLARIS: |
---|
199 | Under Solaris 2.6 (and probably other versions as well), the maximum number |
---|
200 | of shared memory segments is six. This means that on an out-of-the-box machine |
---|
201 | you can only configure six rings. If you try to configure more than that, you |
---|
202 | will see a cryptic message from tport_create about too many open files. The |
---|
203 | fix to this problem is to add the following lines to the /etc/system |
---|
204 | file, and then reboot the system. |
---|
205 | |
---|
206 | set shmsys:shminfo_shmmax = 4294967295 |
---|
207 | set shmsys:shminfo_shmmin = 1 |
---|
208 | set shmsys:shminfo_shmmni = 100 |
---|
209 | set shmsys:shminfo_shmseg = 20 |
---|
210 | set semsys:seminfo_semmns = 200 |
---|
211 | set semsys:seminfo_semmni = 70 |
---|
212 | |
---|
213 | This allows for 20 rings. |
---|
214 | |
---|
215 | Lucky Vidmar (7/6/2000) |
---|
216 | |
---|
217 | |
---|
218 | TRACEBUF messages. |
---|
219 | The definition of `endtime' of the TRACEBUF message is not documented. |
---|
220 | Some programmers are taking it as the "expected start time of the next |
---|
221 | TRACEBUF packet (if the sample interval is uniform.)" The more accepted |
---|
222 | practice is that `endtime' is the time of the last sample of the current |
---|
223 | TRACEBUF packet; that is, one sample interval less than the expected |
---|
224 | start time of the next TRACEBUF messsage. Using this last definition, if a |
---|
225 | TRACEBUF packet has exactly one sample, then its starttime and endtime are |
---|
226 | the identical. Clearly this distinction needs to be documented. The file |
---|
227 | waveform_format (in the /home/earthworm/DOC directory) gives no specifics |
---|
228 | about start or end times. PNL 1/24/01 |
---|
229 | |
---|