Seismo-VLAB  1.3
An Open-Source Finite Element Software for Meso-Scale Simulations
Installation

This section presents how Seismo-VLAB can be installed in your local machine. Although we strongly recommend SVL to be installed in Linux or Unix environment, we provide a simple way to minimize Microsoft Windows (troubleshooting) issues.

A detailed explanation on how to install SVL is provided in the following sections:

Once Run-Analysis python libraries are installed, we recommend to export the SVL python path as follows:

export PYTHONPATH="/path/to/SeismoVLAB/01-Pre_Process"

The later will allow the user to import SeismoVLAB as a normal python module (in any Python script) as follows:

from Core import SeismoVLAB as SVL

The user can then verify the proper SVL Run-Analysis installation by executing in a terminal:

/path/to/SVL/02-Run_Process/SeismoVLAB.exe --help

The following message should be printed on the screen:

                ░                                              
  ███████╗ ░░░░   ░░░░ ░░░░░░░ ░░░░ ██╗   ██╗ ██╗   ░░░  ░░░░  
  ██╔════╝ ░    ░ ░    ░  ░  ░ ░  ░ ██║   ██║ ██║  ░   ░ ░   ░ 
  ███████╗ ░░░  ░ ░░░░ ░  ░  ░ ░███╗██║   ██║ ██║  ░   ░ ░░░░  
  ╚════██║ ░    ░    ░ ░  ░  ░ ░╚═░╝╚██╗ ██╔╝ ██║  ░░░░░ ░   ░ 
  ███████║ ░░░░ ░ ░░░░ ░  ░  ░ ░░░░  ╚████╔╝  ███████╗ ░ ░░░░ 
  ╚══════╝                            ╚═══╝   ╚══════╝
                  Seismo Virtual Laboratory                         
        Module for Serial and Parallel analysis of seismic              
   wave propagation and soil-structure interaction simulation           
   Copyright (C) 2020, The California Institute of Technology 
                    All Rights Reserved.
 Written by:                                         
   Danilo S. Kusanovic (dkusa.nosp@m.nov@.nosp@m.calte.nosp@m.ch.e.nosp@m.du)                           
   Elnaz E. Seylabi    (elnaz.nosp@m.e@un.nosp@m.r.edu)
 Supervised by:                                      
   Domniki M. Asimaki  (domni.nosp@m.ki@c.nosp@m.altec.nosp@m.h.ed.nosp@m.u)
 COMMAND LINE FLAGS TO PROVIDE:                                  
     -dir  : Location of the working directory.                  
     -file : Name of the SeismoVLAB input file to be loaded.      

Finally, a serial/parallel execution of Seismo-VLAB is performed in the following manner:

mpirun -np n /path/to/SeismoVLAB.exe -dir '/path/to/simulation/directory' -file 'model.$.json'
Note
the flag -np = n specifies that the number of processors are n, this requires the mesh and simulation files to be partitioned in such number of files. The latter explains the .$. token which internally is replaced by the processor number.