Changes between Initial Version and Version 1 of v7.2


Ignore:
Timestamp:
01/17/12 12:51:27 (10 years ago)
Author:
branden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • v7.2

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