Program Run Parameters



SeisGram2K is invoked with optional arguments specifying channel files and other program parameters:

Usage: java -cp <classpath>] net.alomax.seisgram2k.SeisGram2K [-help] [[-<parameter>=<value>]...]

-help prints this usage and argument list

Argument pairs (* indicates defaults):

-browser.url=<Default trace browser URL>

-bud.browser.url=<Default BUD directory browser URL>

-bud.browser.open=<Open BUD browser at startup (YES | NO*)>

-channel.N=<Data channel N (FileURL[#gatherIndex[#inclination[#azimuth]]][[#parameter%value]...])>

-channel.binarytype=<Binary data byte order (BIG_ENDIAN* | SUN_UNIX* | LITTLE_ENDIAN | PC_INTEL)>

-channel.concatenate=<Concatenate channel on read (YES | NO*)>

-channel.dump.coordinates=<Dump coordinates in NonLinLoc format for each channel read (YES | NO*)>

-channel.format=<Channel data format (SAC_BINARY* | SAC_ALPHA | SG2K_ASCII | FULL_SEED | MINI_SEED | MINI_SEED_BUD | GSE21 | WAV | QCNLIVE_CSV | MEL_CSV | USGS_SMC | NIED_KNET | CDMG_CSMIP | PEPP | TITAN | FVGN | DEPREM_ASCII | SEESLO | DART)>

-channel.format.write=<Channel data format for writing (SAC_BINARY | SG2K_ASCII | MINI_SEED | WAV | KIKUCHI)>

-channel.gapmode=<Fill gaps with last valid data value on read (YES* | NO)>

-channel.groupmode=<Channel group association mode (AUTO_HEADER* | AUTO_FILENAME,<nchar>,<pos_start>,<pos_end> | EACH_IN_OWN_GROUP | ALL_IN_SAME_GROUP)>

-channel.merge.sg2kascii=<Attempt to merge meta-data (header fields) from file <FileURL>.sg2k for each channel <FileURL> read (YES | NO*)>

-channel.merge.fdsn.station=<Attempt to merge meta-data (header fields and response) from fdsn station web service (YES | NO*)>

-channel.merge.fdsn.station.host|file=<Host name of fdsn station web service or fdsn-station XML file name (service.iris.edu*)>

-channel.merge.fdsn.event.apply_to_all_groups=<Merge meta-data from fdsn event web service to all trace groups (YES* | NO)>

-channel.merge.fdsn.event.host|file=<Host name of fdsn event web service or fdsn-event XML file name (service.iris.edu*)>

-channel.merge.fdsn.event.minmag=<Default value for fdsn-event minmag option (3.0*)>

-channel.merge.fdsn.event.maxmag=<Default value for fdsn-event maxmag option (10.0*)>

-channel.response.units.before=<Units before application of response, if not specified in response file (nm|micron|mm|cm|dm|m*|volts|amps|counts)>

-channel.response.units.after=<Units after application of response, if not specified in response file (nm|micron|mm|cm|dm|m|volts|amps|counts*)>

-channel.response.ext=<Default instrument response file name extension>

-channel.response.file=<Default instrument response file name, or RDSEED_SAC_PZ for rdseed pole-zero files with default names | INTERNET_SERVICE_POLE_ZERO>

-channel.response.path=<Default path to instrument response files (<data directory>*)>

-channel.response.path.net=<Append network code as subdirectory to channel.response.path (YES | NO*)>

-channel.response.type=<Default instrument response file type (POLE_ZERO* | GSE) >

-color.seis.z|y|x=<Seismogram Z or Y or X component color in R,G,B (0-255,0-255,0-255)>

-color.seis.z|y|x.grayscale=<Seismogram Z or Y or X component color for grayscale in R,G,B (0-255,0-255,0-255)>

-commands=<List of commands to apply after reading all channels (<command>;...)>

-commands.onread=<List of commands to apply on reading channels (<command>;...)>

-commands.preset=<List of commands for Presets menu (description1,command1a,command1b,...;...)>

-cwbquery.begintime=<Beginning limit of query time interval (yr,mo,dy[,hr[,mn[,sec]]])>

-cwbquery.duration=<Duration of the time interval of the query in seconds (1800)>

-cwbquery.switch=<NSCL or REGEXP specifying a seed channel name (.*)>

-edur.coeff=<Coefficient for energy-duration calculation (1.55e10*) >

-edur.power=<Power for energy-duration calculation (1.5*) >

-edur.result=<Result type, value or pseudo Mw = 2/3(log10(value)+9.1 (VALUE* | MAGNITUDE ) >

-dir.open=<Default directory for opening data files>

-dir.save=<Default directory for saving data files>

-dir.save.autoname=<Auto filename type for saving data files (INDEX* | ID )>

-display=<Show SeisGram2K main window, use NO for batch processing (YES* | NO)>

-display.align=<Group window alignment at startup (NONE* || ACTIVE || GLOBAL || START || OTIME || PHASE || LAST_DATA || REALTIME)>

-display.analysistoolbar=<Show analysis toolbar at startup (YES* | NO)>

-display.amplitude.auto=<Automatic amplitude scaling (PEAK | SMART*)>

-display.amplitude.zerocenter=<Keep zero amplitude centered for automatic amplitude scaling (YES | NO*)>

-display.beep.error=<Sound system beep for errors (ON* | OFF)>

-display.beep.warning=<Sound system beep for warnings (ON | OFF*)>

-display.font=<Font for trace-group display window (<size factor>, BOLD | ITALIC | PLAIN*)>

-display.greyscale=<Set colors to greyscale (YES | NO*)>

-display.group.antialias=<Apply rendering anti-aliasing (smoothing) in trace-group window (YES | NO*)>

-display.group.id=<Display trace-group id text (YES* | NO)>

-display.group.id.short=<Display short version of group id text (YES | NO*)>

-display.group.selectpanel=<Draw selection panel to the right of each group (YES* | NO)>

-display.group.separator=<Draw separator lines between groups (YES* | NO)>

-display.helicorder=<Helicorder mode display (YES | NO*, number of trace rows per group (24*), row length (sec) (3600*))>

-display.helicorder.cyclecolors=<Cycle colors for each trace row in helicorder mode display (YES* | NO)>

-display.invertcolors=<Set colors to inverted/reverse (YES | NO*)>

-display.lockalignment=<Lock group windows to common time base at startup (YES | NO*; YES* with seedlink/waveserver)>

-display.maxvisible=<Maximum number of groups to display without scrolling (6*)>

-display.messagewindow=<Show message window at startup (YES* | NO)>

-display.monitor=<Monitor mode display (YES | NO*, number of trace rows per group, auto full window delay (sec))>

-display.navigator=<Show trace-group navigator at startup (YES | NO*)>

-display.overlay=<Overlay group traces at startup (YES | NO*)>

-display.position=<Main window, upper left corner position at startup as horizontal, vertical fraction of screen size (left-center*)>

-display.realtimetoolbar=<Show realtime toolbar at startup (YES* | NO)>

-display.ring=<Ring mode display (YES | NO*, direction (-1,+1*), update interval (sec))>

-display.size=<Main window size at startup as horizontal, vertical fraction of screen size (0.75,0.75*)>

-display.sort.type=<Sort type (NONE* | ID=net-sta-instN-chan-comp-event | DATE | GCARC | AZ | BAZ | PHA)>

-display.timeaxes=<Show group window time axes at startup (YES* | NO)>

-display.trace.comp=<Display trace component text (YES* | NO)>

-display.trace.id=<Display trace id text (YES* | NO)>

-display.trace.id.short=<Display short version of trace id text (YES | NO*)>

-display.viewingtoolbar=<Show viewing toolbar at startup (YES* | NO)>

-event.id=<Unique event identification number>

-event.info=<Event information string, use \n for line breaks>

-event.url=<Name of remote process or URL to send picks>

-event.protocol=<Protocol for event/readings communications (NON_LIN_LOC_XML* | XML_STANDARD | CGI_BIN_EARTHWORM)>

-event.sendall=<Send all picks, otherwise send only new picks (YES* | NO)>

-file.filters=<List of filename filter substrings for Open File Dialog (<filterString1>,<description1>[;...])>

-freq.convolve.master.index=<Convolution mater reference trace index (0*)>

-freq.convolve.master.ref=<Feature on mater reference trace index to use as reference time (WINDOW_CENTER* | WINDOW_START | 0-P_max | <label>)>

-freq.convolve.type=<Convolution type (CONVOLUTION* | DECONVOLUTION)>

-freq.convolve.waterlevel=<Convolution water level in dB (-1.0*)>

-freq.rattenuation.fmax=<Maximum frequency at which to remove attenuation (Infinite*)>

-freq.spectral.mode=<Default mode for spectral display (LogLog* | LogLin | LinLog | LinLin | EquiLogLog)>

-freq.spectral.type=<Default type for spectral display (Magnitude* | Phase | Real | Imaginary | SpectralDensity)>

-freq.spectrogram.colors=<Default color scalte for spectrogram display (Rainbow* | Greyscale | Hot | Cool | Green)>

-freq.spectrogram.method=<Default filter method for spectral display (Gaussian* | Butterworth | Amplitude)>

-freq.spectrogram.maxsizefft=<Maximum size for spectrogram trace segment FFT (2048*)>

-freq.spectrogram.mode=<Default frequency axis mode for spectrogram display (LinFreq* | LogFreq)>

-freq.spectrogram.taper.percent=<Percentage cosine taper to apply to each end of spectrogram trace segments before FFT (10*)>

-freq.taper.percent=<Percentage cosine taper to apply to each end of trace before FFT (5*)>

-header.ampunits=<Set header amplitude units, overrides value in channel data file header>

-help.url=<URL for help web page, will open in external browser>

-help.html=<Generate help information in HTML format in working directory . (YES | NO*)>

-help.create_java_help_files=<Generate help file set in Java Help format in working directory. (YES | NO*)>

-help.create_properties_list=<Display parameter list to stdout formatted for help properties file. (YES | NO*)>

-hodo.addphases=<Hodochrone tool: additional phases to display (pP,sP,PcP,PP,SS,Pdiff,Sdiff,PKP,PKiKP,PKIKP,Lr2,Lr3,Lq,Lq2,Lq3*)>

-hodo.display.seismograms=<Hodochrone tool: Enable display of seismogram traces over hodochrone (YES* | NO)>

-hodo.global=<Hodochrone tool: Enable global/spherical mode display and set relevant parameters (allow_edit=YES&vel_model=GLOBAL)>

-hodo.global.distmax=<Hodochrone tool: maximum distance in deg (GLOBAL) for distance axis comma separated list corresponding to each model (95*)>

-hodo.grad_layer_halfspace=<Hodochrone tool: Enable flat earth mode display and set relevant parameters (allow_edit=YES&distmax=300&num_time_decimals=1&vel_model_name=Europe&vel_model=GRAD_LAYER_HALFSPACE&hodo.vel_p=4.5&hodo.vel_s=2.5&hodo.vel_p_lower_crust=6.8&hodo.vel_s_lower_crust=3.8&hodo.vel_p_mantle=8.0&hodo.vel_s_mantle=4.5&hodo.moho_depth=35)>

-hodo.grad_layer_halfspace.distmax=<Hodochrone tool: maximum distance in km (GRAD_LAYER_HALFSPACE) for distance axis; comma separated list corresponding to each model (300*)>

-hodo.display.LrMinusTp=<Hodochrone tool: Display Lr - To time (YES* | NO)>

-hodo.display.TpMinusTo=<Hodochrone tool: Display Tp - To time (YES* | NO)>

-hodo.taup.model=<Hodochrone tool: TauP model name or FileURL (Current SG2K TauP model*)>

-iopath=<local filesystem path for (certain) processing i/o>

-livechannel.N=<LiveSeis data channel N (FileTemplateURL[#gatherIndex[#inclination[#azimuth]]])>

-liveseis[.M]=<LiveSeis [groupIndex M] (numSegments#numSegmentsDisplay#waitTime[#minPeakToPeakAmplitude[#maxPeakToPeakAmplitude[#title]]])>

-liveseis.contig=<Segments are contiguous (YES | NO*)>

-locale=<Language/locale (en_US | fr_FR | it_IT | pt_BR | tr_TR | zh)>

-mag.percentile=<Percentile robust statistics to use for prefered magnitudes, 10->10-90% (10.0*)>

-mask.default_fill_value=<Default fill value to use for Mask (INVALID_AMPLITUDE | ZERO | MEAN* | NaN | <value>)>

-messages.pull=<Enables message pull from file/URL (MessageSourceURL, check interval (ms), maximum interval (ms))>

-messages.push.heartbeat=<Enables heartbeat message sending to file/URL (HeartbeatDestinationURL, send interval (ms))>

-mode=<Display mode (DEFAULT* | SCHOOL | ECOLE)>

-mode.expert=<Enable school expert mode at startup (YES | NO*)>

-mode.applytoall=<Enable apply processing and tool actions to all trace groups at startup (YES | NO*)>

-multicomp.align.sample=<Align multicomp data by sample instead of by time (YES | NO*)>

-multicomp.polarisation.width=<Default polarization analysis window width in samples (10*) >

-multicomp.polarisation.type=<Default polarization analysis type (COHERENCY* | COVARIANCE) >

-ndecimal=<Number of decimals for display of time seconds (3*)>

-pick.file=<FileURL for readings i/o>

-pick.file.autoupdate=<Check every 2 sec for updates to readings file (YES | NO*)>

-pick.format=<Format of readings file (NON_LIN_LOC* | NON_LIN_LOC_SNCL | HYPO71)>

-pick.sorttype=<Sorting type for writing readings file (STA_TIME* | TIME | STATION | TRACE_GROUP)>

-pick.source.pickfile=<Get readings from readings file (YES* | NO)>

-pick.source.channelfiles=<Get readings from channel files (YES* | NO)>

-pick.phases=<List of phase labels for pick tool pop-up menu (onset,phase,first motion,quality,(Set);...)>

-pick.p2pmax.windowlen=<Length in seconds of sliding window, use a neg value for full trace length (0.8*)>

-pick.qual2err=<Comma separated list of pick errors in seconds corresponding to imported pick qualities 0,1,2,3,4,.. (0.1,0.2,0.5,1.0,99999.9*)>

-planet=<Planet name for TauP and geographic calculations (EARTH* | MOON | MARS)>

-predictedphases.file=<FileURL for predicted phases i/o>

-predictedphases.format=<Format of predicted phases file (NON_LIN_LOC_PRED*)>

-print.font.size=<Printer font size (24*)>

-print.resolution=<Printer resolution in dots per inch (150*)>

-properties=<Properties file URL (FileURL)>

-realtime.update=<Realtime scrolling update interval in seconds (1.0*)>

-seedlink=<SeedLink Aquisition (host1:port#stream1,stream2,...[#windowLength(sec)|yr,mo,dy,hr,mn,sec-length(sec)[#minPeakToPeakAmplitude[#maxPeakToPeakAmplitude[#title[#multiplier[#commands_onread]]]]]][;host2...]>

-seedlink.backfill=<read data from now-windowLength to now to back fill view window with data (YES | NO*)>

-seedlink.clocktype=<Time source for estimating realtime base (SEEDLINK_INFO* | SYSTEM)>

-seedlink.groupchannels=<SeedLink channel group mode (YES* | NO)>

-seedlink.status.latency.limits=<Comma separated list of maximum latency times in sec for green->red panel color (t1,t2,...)>

-seedlink.status.dump=<Dump latency values to console (YES | NO*)>

-seedlink.status.dump.interval=<Min time delay in sec between dump of latency values to console (0*)>

-seedlink.status.ndecimal=<Number of decimals for display of numbers in SeedLink status panel (0*)>

-seedlink.status.show=<Show SeedLink status panel (YES* | NO)>

-seedlink.dialog.networks=<Comma separated list of network codes to display in Open SeedLink dialog>

-seedlink.dialog.stations=<Comma separated list of station codes to display in Open SeedLink dialog>

-seedlink.dialog.locations=<Comma separated list of location codes to display in Open SeedLink dialog>

-seedlink.dialog.channels=<Comma separated list of channel codes to display in Open SeedLink dialog>

-seedlink.dialog.server_channels=<Semi-colon (;) separated list of host:port@FDSNWS_station_web_wervice_URI to display in Open SeedLink dialog>

-sound.ratefactor=<Realtime playback rate factor for sound file output (1000.0*dt*)>

-source.mechanism=<Source double-couple mechanism as phi (strike), delta (dip), lamda (rake or slip) in radians as defined in Aki & Richards Fig. 4.20 (strike,dip,rake)>

-stroke.seis=<<Seismogram line (width (1.0+); type (SOLID|DASHED|DOTTED|DASHDOT)>

-taup.dist.min=<Minimun distance in degrees to active TauP/Phases for each gather (0.0*)>

-taup.model=<TauP model name or FileURL (1066a | ak135* | alfs | herrin | iasp91 | jb | prem | pwdk | qdt | sp6)>

-taup.firstonly=<Show only first phase of each type (YES | NO*)>

-taup.phases=<List of phases for TauP/Phases display (<phs1>,<phs2>,...)>

-taup.source=<Initial source time/dist for TauP/Phases display (yr,mo,dy,hr,mn,sec,depth,dist,distUnits)>

-taup.velocity.rayleigh|love|twave|t1wave=<Wave velocities in km/s for extra TauP/Phases display (vel)>

-timedom.filterpick.filtw=<Default filter picker Filter Window (200*dt*) >

-timedom.filterpick.ltw=<Default filter picker Long-term Window (500*dt*) >

-timedom.filterpick.thres1=<Default filter picker Threshold 1 (10*) >

-timedom.filterpick.thres2=<Default filter picker Threshold 2 (10*) >

-timedom.filterpick.tupevt=<Default filter picker Time up event tUpEvent (20dt*) >

-timedom.peakwindow.threshold=<Default time domain peak window threshold (INF*) >

-timedom.peakwindow.width=<Default time domain peak widnow width in seconds (1.0*) >

-timedom.smooth.halfwidth=<Default time domain smoothing half-width in samples (50*) >

-timedom.smooth.type=<Default time domain smoothing type (TRIANGLE* | BOXCAR) >

-titanlivechannel.N=<TitanLive data channel N (FileTemplateURL[#gatherIndex[#inclination[#azimuth]]])>

-titanlive[.M]=<TitanLive [groupIndex M] (unused#numSegmentsDisplay#waitTime[#minPeakToPeakAmplitude[#maxPeakToPeakAmplitude[#title]]])>

-titanlive.contig=<TitanLive segments are contiguous (YES* | NO)>

-title=<Window title>

-waveserver=<Waveserver Aquisition (host1:port#stream1,stream2,...[#windowLength(sec)][;host2...]>

-waveserver.groupchannels=<Waveserver channel group mode (YES* | NO)>

-waveserver.status.latency.limits=<Comma separated list of maximum latency times in sec for green->red panel color (t1,t2,...)>

-waveserver.status.show=<Show Waveserver status panel (YES* | NO)>

-waveserver.type=<Waveserver type (SCNL* | SCN)>

The periods . in the parameter names are optional.
The stand alone version of SeisGram2K also loads these program parameters from a defaults file named .sg2kdefaults or sg2kdefaults, first from the user's home directory, then from the current directory, if either or both of these files exist. The format of an entry in a default file is:

seisgram2k.<parameter> = <value>

where <parameter> and <value> are any valid SeisGram2K name-value argument pairs listed above. A parameter specified as a command line argument will superceed the same parameter in the defaults file.