ASKI and some of its components, as well as documentation and some examples are available under terms of the GNU General Public License (version 2 or higher) on github. Please find contact addresses there, or visit http://www.rub.de/aski in case you want to get in touch with the authors. If you encounter any problems installing or using the software, it will be helpful to open (or add to) an "issues" topic at the github repository.
The main authors are Florian Schumacher and Wolfgang Friederich (Ruhr-University Bochum, Germany).
Please refer to documents in doc/ :
- the ASKI user manual
- Florian Schumacher's doctoral dissteration about waveform sensitivity kernels and the modularized iterative full waveform inversion concept on which ASKI is based
- the accepted version of our GJI 2016 paper, re-typeset in a standard layout
Any files packages for the ASKI toy examples, as described in the manual (chapter 0 ASKI workflows) are attached to release 1.0 of the ASKI main package. These inversion examples use release version 1.0 of the extension packages SPECFEM3D_Cartesian and SPECFEM3D_GLOBE, respectively.
- GNU Make
- Fortran compiler (sufficient standard, so far tested: GNU Fortran (Ubuntu 5.4.0-6ubuntu1~16.04.2) 5.4.0 20160609)
- BLAS and LAPACK libraries for all applications
- BLACKS, SCALAPACK and MPI libraries optionally for few parallel applications (e.g. available via netlib.org/)
-
If not yet done, you should downloade the source code of the ASKI main package by either
-
cloning the master branch of the ASKI repository on gitHub.com:
git clone --depth 1 --branch master https://github.com/seismology-RUB/ASKI
-
or downloading a zipped version of the source code from there:
wget https://github.com/seismology-RUB/ASKI/archive/master.zip
The directory to where you have cloned/extracted the master branch, will in the following be referred to as
ASKI/
-
-
Adjust the software to your system and personal requirements by:
- setting the variables
COMPILER
,MPICOMPILER
in file ASKI/Makefile appropriately - setting the variables
BLAS
,LAPACK
, (BLACS
,SCALAPACK
,MPILIB
) in file ASKI/Makefile in order to correctly bind required libraries - adjusting the variable
FFLAGS
in file ASKI/Makefile, if required
- setting the variables
-
Run command
make all
from installation path
ASKI/
to compile all serial programs (nearly all functionality) -
Run command
make parallel
from installation path
ASKI/
to compile all parallel programs (two optional linear system solvers which run in parallel)
Now ASKI/bin should contain all binaries and no error should have occurred (at best...).
Refer to the user manual for any details on using ASKI.