103 lines
5.5 KiB
Markdown
103 lines
5.5 KiB
Markdown
|
# TomoATT
|
|||
|
|
|
|||
|
|
[](LICENSE)
|
|||
|
|
[](https://github.com/mnagaso/TomoATT/actions/workflows/CI.yml)
|
|||
|
|
[](https://anaconda.org/conda-forge/tomoatt)
|
|||
|
|
[](https://anaconda.org/conda-forge/tomoatt)
|
|||
|
|
[](https://anaconda.org/conda-forge/tomoatt)
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
TomoATT is a library which implements an eikonal equation solver based Adjoint-state Traveltime Tomography for a very large-scale computation, which implements the methods described in the publications:
|
|||
|
|
|
|||
|
|
- **The TomoATT software package**
|
|||
|
|
- Chen, J., Nagaso, M., Xu, M., & Tong, P. (2025). TomoATT: An open-source package for Eikonal equation-based adjoint-state traveltime tomography for seismic velocity and azimuthal anisotropy. Computers & Geosciences, 105995. [DOI](https://doi.org/10.1016/j.cageo.2025.105995).
|
|||
|
|
|
|||
|
|
- **Regional tomography in Cartesian coordinates**
|
|||
|
|
|
|||
|
|
- Tong, P. (2021). Adjoint‐state traveltime tomography: Eikonal equation‐based methods and application to the Anza area in southern California. Journal of Geophysical Research: Solid Earth, 126(5), e2021JB021818. [DOI](https://doi.org/10.1029/2021JB021818).
|
|||
|
|
|
|||
|
|
- Tong, P. (2021). Adjoint‐state traveltime tomography for azimuthally anisotropic media and insight into the crustal structure of central California near Parkfield. Journal of Geophysical Research: Solid Earth, 126(10), e2021JB022365. [DOI](https://doi.org/10.1029/2021JB022365).
|
|||
|
|
|
|||
|
|
- **Regional tomography in Spherical coordinates**
|
|||
|
|
|
|||
|
|
- Chen, J., Chen, G., Nagaso, M., & Tong, P. (2023). Adjoint-state traveltime tomography for azimuthally anisotropic media in spherical coordinates. Geophysical Journal International, 234(1), 712-736. [DOI](https://doi.org/10.1093/gji/ggad093).
|
|||
|
|
|
|||
|
|
- **Teleseismic tomography in Spherical coordinates**
|
|||
|
|
|
|||
|
|
- Chen, J., Wu, S., Xu, M., Nagaso, M., Yao, J., Wang, K., ... & Tong, P. (2023). Adjoint‐state teleseismic traveltime tomography: Method and application to Thailand in Indochina Peninsula. Journal of Geophysical Research: Solid Earth, 128(12), e2023JB027348. [DOI](https://doi.org/10.1029/2023JB027348).
|
|||
|
|
|
|||
|
|
|
|||
|
|
Thanks to the efficiency of an eikonal equation solver, the computation of the travel-time is very fast and requires less amount of computational resources.
|
|||
|
|
As an input data for TomoATT is travel times at seismic stations, we can easily prepare a great amount of input data for the computation.
|
|||
|
|
|
|||
|
|
This library is developped to be used for modeling a very-large domain. For this purpose, 3-layer parallelization is applied, which are:
|
|||
|
|
- layer 1: simulutaneous run parallelization (travel times for multiple seismic sources may be calculated simultaneously)
|
|||
|
|
- layer 2: subdomain decomposition (If the number of computational nodes requires too large memory, we can separate the domain into subdomains and run each subdomain in a separate compute node)
|
|||
|
|
- layer 3: sweeping parallelization (in each subdomain, sweeping layers are also parallelized)
|
|||
|
|
|
|||
|
|
The details of the parallelization method applied in this library are described in the paper [Miles Detrixhe and Frédéric Gibou (2016)](https://doi.org/10.1016/j.jcp.2016.06.023).
|
|||
|
|
|
|||
|
|
Regional events (sources within the global domain) and teleseismic events (sources outside the global domain) may be used for inversion.
|
|||
|
|
|
|||
|
|
## Quick installation
|
|||
|
|
This library is available in the [conda-forge channel](https://anaconda.org/conda-forge/tomoatt). You can install it on personal computer by the following command:
|
|||
|
|
``` bash
|
|||
|
|
conda install -c conda-forge tomoatt pytomoatt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
TomoATT is also capable of running on high-performance computing (HPC) systems and. Detailed installation instructions are described in the [installation manual](https://tomoatt.com/docs/GetStarted/Installation/Dependencies).
|
|||
|
|
|
|||
|
|
<!--
|
|||
|
|
|
|||
|
|
## dependency
|
|||
|
|
- MPI v3.0 or higher
|
|||
|
|
|
|||
|
|
optinal:
|
|||
|
|
- HDF5 (parallel IO needs to be enabled)
|
|||
|
|
- h5py (used in pre/post processes examples)
|
|||
|
|
|
|||
|
|
## to clone
|
|||
|
|
``` bash
|
|||
|
|
git clone --recursive https://github.com/TomoATT/TomoATT.git
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## to compile
|
|||
|
|
``` bash
|
|||
|
|
mkdir build && cd build
|
|||
|
|
cmake .. && make -j 8
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
compile with cuda support
|
|||
|
|
``` bash
|
|||
|
|
cmake .. -DUSE_CUDA=True && make -j 8
|
|||
|
|
``` -->
|
|||
|
|
|
|||
|
|
## to run an example
|
|||
|
|
``` bash
|
|||
|
|
mpirun -n 4 ./TOMOATT -i ./input_params.yml
|
|||
|
|
```
|
|||
|
|
Please check the [user manual](https://tomoatt.com/docs) and `examples` directory for the details.
|
|||
|
|
|
|||
|
|
|
|||
|
|
<!-- ## FAQs.
|
|||
|
|
### git submodule problem
|
|||
|
|
In the case you will get the error message below:
|
|||
|
|
``` text
|
|||
|
|
-- /(path to your tomoatt)/TomoATT/external_libs/yaml-cpp/.git does not exist. Initializing yaml-cpp submodule ...
|
|||
|
|
fatal: not a git repository (or any of the parent directories): .git
|
|||
|
|
CMake Error at external_libs/CMakeLists.txt:9 (message):
|
|||
|
|
/usr/bin/git submodule update --init dependencies/yaml-cpp failed with exit
|
|||
|
|
code 128, please checkout submodules
|
|||
|
|
Call Stack (most recent call first):
|
|||
|
|
external_libs/CMakeLists.txt:13 (initialize_submodule)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
You will need to update the submodule manuary by the command:
|
|||
|
|
``` bash
|
|||
|
|
git submodule update --init --recursive
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
In the case that `git submodule` command doesn't work in your environment, you need to download yaml-cpp library from [its repository](https://github.com/jbeder/yaml-cpp), and place it in the `external_libs` directory,
|
|||
|
|
so that this directory is placed as `external_libs/yaml-cpp`. -->
|