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
  2. Copy the path provided, it will be the path for your simulation on Fitzroy
  3. d

6. Run the simulation

  1. d
  2. d
  3. d
  4. d
  5. d


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