Configuration

The most important part of Gisola is to set a representative configuration file.

Version: 1.0

# Set the workspace where all MT calculations will perform 
# (including the web suite outputs).
WorkDir: results/realtime

# The Inventory refers to the stations' characteristics such
# as the poloes-zeros, digitizer's gain etc.
Inventory:
  # Supported types of retrieval services can be the FDSNWS-station
  # and/or file in stationXML format. You can use as many services as
  # you want and the stations' metadata will be merged by looking 
  # in FIFO order. At the below example first, it will try to retrieve
  # the metadata from the first entry, then it will merge the results
  # from the second service etc.
  # Format is: [FDSNWS, url, token] or [StationXML, file.xml] 
  # When FDSNWS-station is used, you have to set null to the 3rd variable
  # since no restricted metadata exist and no token is needed. Also, the
  # most updated inventory will be retrieved from the FDSNWS hosts, 
  # relevant to the seismic events. The more services you provided, 
  # the more time will be consumed for retrieval. If stationXML file is
  # used, you are responsible to provide updated meta-data relevant to the
  # seismic events or real-time scenario (e.g. daily inventory update cron-job).
  Service:
    - [FDSNWS, http://eida.gein.noa.gr, null] # get meta from NOA
    - [FDSNWS, http://www.orfeus-eu.org, null] # get meta from ODC
    - [StationXML, inventory.xml] # get meta from file

  # The WhiteList parameters indicate the quality evaluation of the stations.
  # 0 - Zero value indicate station blacklisting
  # int - A higher integer value denotes a good quality station,
  # while a lower value a bad quality station.
  WhiteList:
    # Set filepath to station evaluation
    # The file consists of lines with the format: NET STA QUALITY
    # For example: HL ATH 5 denotes as station ATH of network HL to be 
    # quality of 5. If more than one lines found for a certain station
    # the first one will be used.
    # You can use the * (asterisk) wildcard if you want to apply the 
    # evaluation for the entire network. At the below example 
    # all stations from NET2 are disabled from process, while 
    # all stations, apart from STA -which is set to 5-, of network NET 
    # are set to 1
    # Example of ./stations file:
    # NET STA 5
    # NET2 * 0
    # NET * 1
    # You can set filepath to null not to take into account 
    # the stations' evaluation
    Filepath: ./stations
    Priority: 2  # default 2
    Rules:
      #- [3.5, 4.0, 2] # 0 value indicates blacklisted station in ./stations file
      - [4.0, 4.5, 3]
      - [4.6, 5.0, 3]
      - [5.1, 5.8, 4]
      - [5.9, 9.0, 5]

  # Accepted types of components
  Components: ['Z23', 'Z12', '123', 'ZNE']

  # Retrieve channel types based on distance rules
  # Distance rules has the form of: minMag, maxMag, minDist, maxDist, channels
  Distance:
    #- [3.5, 4.0, [5, 150, ['BH','HH']]]
    - [4.0, 5.0, [10, 250, ['BH','HH']]]
    - [5.1, 5.5, [40, 300, ['BH','HH']]]
    - [5.1, 5.5, [20,  100, ['HN','EN']]]  
    - [5.6, 6.0, [50, 450, ['BH','HH']]]
    - [5.6, 6.0, [50, 150, ['HN','EN']]]  
    - [6.1, 9.0, [100, 700, ['BH','HH']]] 

  Azimuth: [3,2] # sectors, stations per sector # null for all!

# The Stream Service supports FDSNWS-station only and file in XML format (as mentioned in ObsPy documentation)
Stream:
  # If you add more that one FDSNWS Hosts, results will be merged according to ObsPy's policy
  # Service can have a value of: FDSNWS, SDS
  # FDSNWS accepts multiple hosts but SDS only one
  Service:
    - [FDSNWS, http://eida.gein.noa.gr, null]

  # filter data by these modules
  Modules: ['clip', 'ppsd', 'mouse']

# Greens' Functions computation
Green:

  Grid:
    - Rule: [4.0, 5.5] # mag condition
      Distance:     # maxValue is NOT reached (+1 if you want to reach it)
        - [0,9,2]   # minValue, maxValue, stepValue in km
      Depth: # relevant to init depth
        - [0,31,2]

    - Rule: [5.6, 6.5]
      Distance:
        - [0,9,4]
        - [15,21,5]
      Depth:
        - [0,31,2]

    - Rule: [6.6, 9.0]
      Distance:
        - [0,31,5]
      Depth:
        - [0,31,2]

  Crustal:
    - Filepath: crustals/drakatos.vz
      Geobox: (22.6163,37.6465), (23.3432,36.8208), (24.6418,36.6669), (25.6634,37.5202), (24.9950,38.6259), (23.6373,39.4235), (22.3654,39.2644), (21.8251,39.1394), (22.6163,37.6465)

    - Filepath: crustals/hasslinger.vz
      Geobox: (19.2844,39.7272), (19.3869,39.6062), (20.6181,36.2835), (21.0868,36.3442), (21.6460,36.3353), (22.4078,36.3616), (22.4193,36.8072), (22.3387,37.8602), (22.1245,38.5904), (21.5799,39.8288), (20.8563,41.2116), (19.2330,40.5713), (19.2844,39.7272)

    - Filepath: crustals/karagianniN.vz
      Geobox: (27.8207,37.7397), (27.7968,37.8825), (27.6912,39.8097), (26.7934,40.8404), (25.5053,41.0043), (23.8058,40.9247), (22.2572,40.3739), (22.7997,39.5096), (23.6678,38.8283), (24.5977,38.1499), (25.4623,37.5535), (27.8207,37.7397)

    - Filepath: crustals/karagianniS.vz
      Geobox: (23.0601,34.3852), (23.6039,34.0317), (26.8522,33.6953), (29.1178,34.7188), (29.9628,36.1148), (27.4820,37.5490), (26.4968,37.6732), (21.4060,37.0584), (23.0601,34.3852)
      
    - Filepath: crustals/novotny.vz
      Geobox: null # null indicates default: if none of the above crustal models match use this

  ExePath: core/green/gr_xyz

  MaxStations: 30 # must be the same with the one in parameters.f90
  MaxSources: 100 # must be the same with the one in parameters.f90


Inversion:

  TimeShift:
    - [4.0, 4.5, [-67, 10, 167]] # must be the same with the one in parameters.f90
    - [4.6, 5.5, [-51, 10, 161]]
    - [5.6, 9.0, [-81, 15, 341]]

  Window:
    - [4.0, 4.5, 245.76]
    - [4.6, 5.5, 327.68]
    - [5.6, 9.0, 409.6]

  Frequency:
    - [4.0, 5.5, [0.04, 0.05, 0.08, 0.09]]
    - [5.6, 5.9, [0.02, 0.03, 0.06, 0.07]]
    - [6.0, 7.0, [0.01, 0.02, 0.05, 0.06]] 
    - [6.0, 7.0, [0.007, 0.008, 0.02, 0.03]]
    - [7.1, 9.0, [0.007, 0.008, 0.02, 0.03]]

  ExePath: core/inversion/isola

# This service provides gisola with event info
Event:
  Host: http://eida.gein.noa.gr

Notification:
  Email:
    Smtp: null # use null if not in use
    User: user
    Pass: pass
    Sender: sender
    Recipients: null
    HostSite: http://orfeus.gein.noa.gr/gisola2/ppsd

  Command: null # invoke bash command when processing is finished.
                # Use keyword $bestinvdir in your script. Gisola will 
                # reserve this keyword to indicate the full path 
                # of the best inversion directory 

# The Watcher Service monitors FDSNWS-event
# for new events and triggers the auto MT procedure
Watcher:
  Magnitudetype: MLh # or null if not specifications is wanted
  Range: 540 # check interval in sec
  Playback: 0 # set sec for historic run
  Historical: true # set playback option
  Geobox: (20.3054,37.2037), (22.4079,33.6323), (27.0569,33.8793), (30.3113,35.8225), (27.4245,41.5998), (24.9779,42.0729), (21.7796,41.8349), (18.6751,40.6285), (20.3054,37.2037) # null indicates not bounds
  Quality: # uncertainty
    Time: 1
    Depth: 10 # km
    Latitude: 15
    Longitude: 15
    Magnitude: 0.3
    Timeout: 540 # must get associated with the Time Range

# Apply your citation for the results generation
Citation:
  Agency: National Observatory of Athens - Institute of Geodynamics
  Website: http://bbnet.gein.noa.gr
  Logo: web/logo.png
  Quality: B4 # choose threshold to view starting from A1 to D4
  Author: Gisola
  Version: 1.0