This guide is for someone who would like to run a simulation with current library and packaging.

Step-by-step guide

1. How to create a working folder

  1. get the current working version of gm_sim_pkg by using git clone:
    $ git clone git@github.com:ucgmsim/gm_sim_pkg.git
  2. download the lastest package from the FTP server:
    $ download script and ftpserver
  3. Go to the location where you cloned gm_sim_pkg, and use the install.sh to install the package just downloaded:
    $ ./install.sh gmsim_pack_latest.tar.gz event_date event_location event_magnitude
    e.g. $ ./install.sh gmsim_pack_latest.tar.gz 20100904 Darfield 7.1
  4. Follow the instruction shown on screen to create required Models and files.

2. How to create a Velocity Model

  1. Go to the VM directory that instruction has provided
    e.g. $ cd /home/jonney/20100904_Darfield_m7p1_201705181350/VM
  2. Create the config file that is needed for generating a Velocity Model
    $ config_vm.py magnitude centroid_Depth Latitude Longitude
    e.g. $ config_vm.py 7.1  46.00 172.3 -43.6
  3. Edit the parameter file to your requirements with prefered editor
    e.g. $ vim params_vel.py
  4. If you have edited the params_vel.py, please run test_vm_params.py
    $ test_vm_params.py
  5. Run make_vm.sh to create the Velocity Model
    $ make_vm.sh
  6. Follow the instruction given on the screen to provide a path to a admin.

3. How to create Rupture Model (Source)

  1. Go to the Src directory that instruction has provided
    e.g. $ cd /home/jonney/20100904_Darfield_m7p1_201705181350/Src
  2. Create the config file that is needed for generating a Rupture Model
    $ config_src.py type
    e.g. $ config_src.py 2
  3. Go to the folder provided by instrutions
    e.g. $ cd /home/jonney/20100904_Darfield_m7p1_201705181350/Src/Model/20100904_Darfield_m7p1/t2_103245_20170518_175214
  4. Edit the setSrfParams.py
    note: every variables with #!!!PLEASE SPECIFY!!!# must be provided
  5. Create the Model using make_src.sh
    e.g. $ make_src.sh
  6. Follow the instruction given on the screen to provide a path to a admin.

4. How to create observation files

note: you can skip this part if you are running for a future event (not yet happened)

  1. Go to the Obs directory that instruction has provided
    e.g. $ cd /home/jonney/20100904_Darfield_m7p1_201705181350/GM/Obs
  2. Create the config file that is needed
    $ config_obs.py geoNet_ftp_url
    e.g. $ config_obs.py ftp://ftp.geonet.org.nz/strong/processed/Proc/2010/09_Sep/2010-09-04_045556/Vol1/data/
  3. Run make_obs.sh to generate all the files
    e.g. $ make_obs.sh
  4. Follow the instruction given on the screen to provide a path to a admin.

5. How to setup the simulation

  1. After admin tells you that all files are uploaded to Fitzroy, Run setup_remote.sh
    $ setup_remote.sh username
    e.g $ setup_remote.sh jonney

6. Run the simulation on Low Frequency (LF)

  1. Go to the Simulation Folder, located at /nesi/projects/nesi00213/RunFolder/user/run_name
    e.g. $ cd /nesi/projects/nesi00213/RunFolder/ykh22/20100904_Darfield_m7p1_201705181350
  2. Run submit_emod3d.sh
    $ ./submit_emod3d.h
  3. It will ask you to enter a wall_clock_limit and if it should auto submit the job.
    note: if you prefer to change some detail configurations, press 2(no) for auto submit.*
  4. use llsubmit to submit your job if you selected to not to auto submit.
  5. Use llq to check if your job has finished. (job status: R= running, C= Complete, I = idle)
    $ llq -u user
  6. After Emod3d finished, run submit_post_emod3d.sh
    note: if you prefer to change some detail configurations, press 2(no) for auto submit.*
    $ ./submit_post_emod3d.sh

7. Run the simulation on High Frequency (HF)

note: this part can run before LF is finished

  1. Run install_bb.sh, to setup the parameters
    $ ./install_bb.sh
  2. Choose from the options according to simulation requirement
  3. Run submit_hf.sh
    $ ./submit_hf.sh
    note: if you prefer to change some detail configurations, press 2(no) for auto submit.*

*: use llsubmit to submit your job if you selected not to auto submit. $ llsubmit job.ll

8. Run the Simulation on Broad Band (BB)

Note: This part MUST wait untill both LF and HF are finished

  1. Run submit_bb.sh
    $ ./submit_bb.sh




You may also want to use visual panels to communicate related information, tips or things users need to be aware of.

Related articles

Related articles appear here based on the labels you select. Click to edit the macro and add or change labels.

Related issues