FWT2D

From arccwiki
Jump to: navigation, search

FWT2D

FWT2D (from Seiscope): 2D Full-Waveform Topography: is a massively parallel program which performs 2D frequency-domain modeling of acoustic wave propagation and full-waveform inversion for seismic imaging. FWT2D is more specifically designed to process wide-aperture (or global offset) seismic data.

Loading FWT2D

To begin, load the FWT2D module which will also set the FWT2D_ROOT environment variable, using:

module load fwt2d
echo $FWT2D_ROOT
[...]$ /apps/u/opt/fwt2d-v4.8/software

Documentation

The pdf manual can be found in:

ls $FWT2D_ROOT/DOC
doc_fwt2d.v4.8.pdf  doc_fwt2d.v4.8.ps.gz

Please note that chapter 4 of the manual goes into detail about the various input and output files required to run the application.

Simply Batch Script

The following is a very simple example of a batch script:

#!/bin/bash

#SBATCH --account=arcc 
#SBATCH --time=10:00 
#SBATCH --nodes=2 
#SBATCH --ntasks-per-node=1 
#SBATCH --cpus-per-task=8 
#SBATCH --partition=teton

module load fwt2d/4.8

srun fwt2d.v4.8.seq64

Replace arcc with your associated project account name. It is important to use the teton partition (and not moran) otherwise you will experience an error trying to run the application. The submit the job using sbatch command.

Running in Interactive Mode

salloc --account=arcc --time=10:00 --nodes=1 --ntasks-per-node=1 --cpus-per-task=8 --partition=teton

Replace arcc with your associated project account name. It is important to use the teton partition (and not moran) otherwise you will experience an error trying to run the application. Run the application using:

srun fwt2d.v4.8.seq64

It it recommended to pipe the output of running in interactive mode to a file, using something of the form:

srun fwt2d.v4.8.seq64 > output.txt

For example, while testing, performing an inverse, 1000s of lines of output were generated.

Running FWT2D

As a very brief introduction, FWT2D runs in two modes, either Forward Modeling or Inverse. Both modes use the same fwt.par input file, in which the various parameter settings are used to define the mode of execution and associated input parameters and files.
The application does come with a set of examples, that can be found in:

ls $FWT2D_ROOT/EXAMPLES
00_DO_FIRST   INCLUSION2  OVERTHRUST                RESSOURCES.RC_CSH         RUN_ALL_SEQ_INTEL.sh
00README      INCLUSION3  RESSOURCES.RC_BASH        RESSOURCES.RC_CSH_EUREKA  RUN_ALL.sh
CLEAN_ALL.sh  INCLUSION4  RESSOURCES.RC_BASH_FRIPP  RUN_ALL_PAR_PATH.sh       SETDIR_ALL.sh
INCLUSION1    MODELING    RESSOURCES.RC_BASH_THERA  RUN_ALL_PAR_PGI.sh        VSP

It is highly recommended to read the various README files, as well as viewing and understanding the script files as these will teach you how to setup a folder, which input files are required, what additional scripts are required, and the general workflow of using the application.
Additional and referenced scripts can be found in:

ls $FWT2D_ROOT/SHELL
00README     ddlastall.sh    graphp.sh   model1.sh   plotrms.sh       psgraph.sh    sismos2.sh
cleanold.sh  ddlastgroup.sh  graph.sh    model2p.sh  plotsismos.sh    psimage.sh    sismos3.sh
clean.sh     ddlast.sh       mapgmtp.sh  model2.sh   plotsnapshot.sh  ricker.sh     sismosres.sh
conv.su.sh   dd.sh           mapgmt.sh   model3p.sh  psgraphq1.sh     scanacqui.sh  wavepath.sh
dddata.sh    fit.v2.sh       model1p.sh  model3.sh   psgraphq.sh      sismos1.sh

Do not expect to simply run these scripts and things will work. You will need to modify and create your own to suit your specific needs. Consider them as basic examples from which you tailor to your needs.

Note: Although ARCC happily takes responsibility for setting up, installing, and testing the software is running, this is a very feature rich application and we are unable to test every feature and all the parameter settings. To assist us, and other uses, we would sincerely appreciate feedback from users that we can share with the wider research community.

Back to HPC Installed Software