YXTang / xmax

XMAX waveform display

XMAX

###Purpose XMAX waveform display for .seed files

###Configuration The main configuration is found in config.xml. File is under source control where user can change system paths accordingly

######Data Setup

Wildcarded mask of data files to load (when no cmd line args given):

    <DataMask>seed/IU_TUC/2014_21*</DataMask>

Temporary directory to store decompressed traces in the internal format:

    <TempPath>resources/DATA_TEMP</TempPath>

Quality control data file:

    <QCdataFile>/home/max/DATA/QC.xml</QCdataFile>

Station data file extras (events, station info, multiplexed data, picks):

    <EventFileMask>resources/qcmt.ndk</EventFileMask>
    <StationInfoFile>resources/gsn_sta_list</StationInfoFile>
    <ResponsePath>resources/Responses</ResponsePath>
    <AllowMultiplexedData>true</AllowMultiplexedData>
    <PickPath>resources/Picks</PickPath>

######View Setup

Show big cursor, status bar, buttons:

    <ShowBigCursor>true</ShowBigCursor>
    <ShowStatusBar>true</ShowStatusBar>
    <ShowCommandButtons>true</ShowCommandButtons>
    <ShowCommandButtonsTop>false</ShowCommandButtonsTop>

Panel order and count (trace, network, station, channel):

    <PanelCountUnit>1</PanelCountUnit>
    <UnitsInFrame>1</UnitsInFrame>
    <LogFile>logs/xmax.log</LogFile>

###Build

######Gradle Setup/Execution

Gradle commands to clean, compile and package xmax (uses build.xml)

    gradle jar		# create distribution xmax.jar (default target)
    gradle run		# run java com.isti.xmax.XMAX from /build dir

Gradle target descriptions (order of operations)

    gradle clean 	        -> delete build/ directory
    gradle build			-> compile java src/ code to build/ directory
    gradle jar				-> create distribution xmax.jar (default target)

###Usage

######Basic Execution Display

No arguments specified (reads data from resources/DATA in config.xml):

    java -Xms512M -Xmx512M -jar xmax.jar

Read data files found on path (-d option):

    java -Xms512M -Xmx512M -jar xmax.jar -d '/xs0/seed/IU_ANMO/2012/2012_1{59,60}_*/00_LHZ*seed'

Read serialized data from resources/DATA_TEMP specified in config.xml (-t option):

    java -Xms512M -Xmx512M -jar xmax.jar -t

Read serialized data from resources/DATA_TEMP AND from dataPath (-t -d options):

    java -Xms512M -Xmx512M -jar xmax.jar -t -d '/xs0/seed/IU_ANMO/2012/2012_1{59,60}_*/00_LHZ*seed'

######Basic Execution Serial Dump

Read any data files found in resources/DATA and dump serialized data into resources/DATA_TEMP (-T option):
(**NOTE: This will wipe out any existing serialized data in resources/DATA_TEMP)

    java -Xms512M -Xmx512M -jar xmax.jar -T

Read data files found on path and dump serialized data in resources/DATA_TEMP (-T -d options):
(**NOTE: This will wipe out any existing serialized data in resources/DATA_TEMP)

    java -Xms512M -Xmx512M -jar xmax.jar -T -d '/xs0/seed/IU_ANMO/2012/2012_1{59,60}_*/00_LHZ*seed'

Same as above but ALSO read existing serialized data in resources/DATA_TEMP (-T -d -t options):
(**NOTE: This will APPEND new serialized data to that already in resources/DATA_TEMP)

    java -Xms512M -Xmx512M -jar xmax.jar -T -t -d '/xs0/seed/IU_ANMO/2012/2012_1{59,60}_*/00_LHZ*seed'

Explicitly pointing to a log4j.properties file (default is ./log4j.properties)

    java -Dlog4j.configuration=file:./src/log4j.properties -Xms512M -Xmx512M -jar xmax.jar -d '/xs0/seed/IU_ANMO/2012/2012_1{59,60}_*/00_LHZ*seed'

######Basic Execution in Eclipse

Eclipse reads seed files from config DataMask at runtime (config.xml):

    <!-- Default DataMask path -->
    <DataMask>resources/Data/</DataMask>
   
    <!-- User DataMask examples --> 
    <DataMask>mseed/II_AAK/2013_026/</DataMask>
    <DataMask>seed/IU_PTGA/2014_193/</DataMask>