readme

用于2维的射线追踪

This package computes seismic ray tracing through a mesh,
and computes some scores based on ray information.

Requirement
===========

-libraydecartes
-libmesh

Parallel implementation
=======================

The parallel implementation is based on MPI code.
It can be activated at configure time with
./configure --with-mpi-name=<name of the mpi lib>
i.e. mpich if you have libmpich.{a,so} or mpi for libmpi.{a,so}
installed.
Additionnal argument --with-mpi-prefix can be used to specify
which mpi library and includes should be used.

At present, the MPI implementation is as follows :
o -i option is mandatory and the ray data input file must
  be accessible for the MASTER process

o The MASTER process (default is process 0) reads the entire
  ray data file and distributes an equal share of ray data
  to all processes (to itself as well). If the number of lines
  is not a multiple of the number of processes, the remainder
  is treated by the master.

o MASTER/SLAVE mode

o the -o <ofile> option that normally defines the output file, 
  renames <ofile> to <ofile>-<process_number> and each process
  writes its output to its own disk space. The various output
  files should be then merged into one to have an equivalent
  result as a sequential execution.

Importation of ray2mesh score in a mesh
=======================================

always use -r (raw output) to generate ray2mesh score file
that would be imported with the mesh package.

ray2mesh -m iasp.xml -i file.ray -o score.r2m -r
mesh -i score.r2m-0,...,score.r2m-i -o mesh-score.vtk