REVIEW 4 major objections 7 minor 10 references
TomoATT: An open-source package for Eikonal equation-based adjoint-state traveltime tomography for seismic velocity and azimuthal anisotropy
T0 review · 4 major / 7 minor · reviewed 2026-08-12 · deepseek-v4-flash
Pith's one-line read TomoATT packages Eikonal-based adjoint-state tomography for velocity and azimuthal anisotropy into an open-source, three-file workflow that runs regional and teleseismic inversions in under two hours on 64 processors.
desk verdict A well-engineered open-source tomography package; the synthetic validation is internally consistent but thin, and the real-data sections need resolution tests before 'effectiveness' is fully earned. read the letter →
The pith
A machine-rendered reading of the paper's core claim, the machinery that carries it, and where it could break.
The reading
What carries the argument
The central object is the adjoint-state traveltime tomography workflow, built on the anisotropic Eikonal equation in spherical coordinates, $\nabla T^t M(\mathbf{x};\xi,\eta)\nabla T = s^2(\mathbf{x})$, solved with the fast sweeping method and multiplicative factorization. The adjoint equation $\nabla\cdot(P(\mathbf{x}) M(-\nabla T)) = \sum_m R_m \delta(\mathbf{x}-\mathbf{x}_m)$ turns receiver misfits into volumetric sensitivity kernels $K_s, K_\xi, K_\eta$, which are then projected onto coarse multiple-grid basis functions and normalized by kernel density. This combination is what lets the package handle multipathing, avoid ray-path undersampling, and regularize uneven data coverage.
What would settle it
A controlled synthetic inversion on the same grid spacings as the real-data cases (for example, $5$ km $\times$ $5$ km $\times$ $1$ km) using a strongly heterogeneous model with sharp velocity contrasts and realistic noise levels would settle the accuracy question: if reconstructed anomalies are smeared or displaced beyond the grid scale, or if traveltime residuals exceed the forward-model errors reported in Section 3.1, the claimed effectiveness for real Earth would be undercut.
Extended reading notes
Core claim
TomoATT's core claim is that Eikonal equation-based adjoint-state traveltime tomography can be packaged as an efficient, user-friendly tool for routine seismic imaging. It solves for slowness $s(\mathbf{x})$ and azimuthal anisotropy parameters $\xi(\mathbf{x})$, $\eta(\mathbf{x})$ by minimizing a weighted sum of traveltime, common-source differential, and common-receiver differential misfits. Each iteration solves the anisotropic Eikonal equation for every source (or, via reciprocity, every receiver), solves the adjoint equation to obtain gradient kernels, and updates model parameters by step-size-controlled gradient descent with multiple-grid parameterization and kernel density normalization. The synthetic experiment recovers staggered velocity and anisotropy perturbations, while the two real-data inversions reproduce features such as the velocity contrast across the San Andreas Fault and the high-velocity Khorat Plateau lithosphere. From these results the paper concludes that TomoATT is a verified, efficient tool for both regional and teleseismic tomography.
Load-bearing premise
The load-bearing premise is that the fast sweeping Eikonal solver, validated only on simple synthetic models and the AK135 teleseismic test, remains accurate enough on the moderately coarse inversion grids used for the real-data benchmarks to produce trustworthy sensitivity kernels in strongly heterogeneous crust and mantle.
Editorial extensions
If this is right
- Regional and teleseismic inversions can be set up from three files, so the package removes much of the scripting burden in traveltime tomography.
- The source-receiver reciprocity trick reduces the Parkfield inversion to 607 Eikonal solves per iteration instead of 32,721, making 80 iterations feasible in 57 minutes.
- Multiple-grid parameterization and kernel density normalization let the inversion recover anomalies in sparsely sampled regions while suppressing parameter-count artifacts.
- The same machinery relocates hypocenters, so simultaneous inversion can avoid the artifacts shown when source locations are inaccurate.
- Users can image azimuthal anisotropy as well as isotropic velocity from first P arrivals, enabling stress and fabric interpretation near faults.
Reading between the lines
- If the claimed two-hour turnaround holds on typical HPC nodes, adjoint-state Eikonal tomography could become a routine replacement for ray-based tomography in regional networks, where kernel accuracy and multipathing have been the main barriers.
- The kernel density normalization trades noise amplification against anomaly recovery; the paper shows that high $\zeta$ values can create artifacts in poorly constrained regions, so an adaptive or data-driven choice of $\zeta$ would be a natural extension.
- The solver validation suggests that users on coarser grids or in very strong-contrast media should first run the package's traveltime-error tests on their own models before trusting recovered anomalies.
- Because the package is open source and supports YAML, HDF5, and TEXT formats, it could serve as a building block for joint inversions or full-waveform approaches that need a fast, trustworthy traveltime prior.
Editorial analysis
A structured set of objections, weighed in public.
Referee Report
Summary. The manuscript presents TomoATT, an open-source C++/Python package for Eikonal-equation-based adjoint-state traveltime tomography for seismic velocity and azimuthal anisotropy. It reviews the mathematical formulation (objective function with traveltime and differential arrival times, anisotropic Eikonal equation, adjoint-state kernels, multiple-grid parameterization, kernel density normalization), describes the multi-level parallelization architecture, and demonstrates the package through toy experiments, a synthetic inversion with earthquake relocation, and two real-data benchmarks (Parkfield, California; Thailand). The central claim is that the package is efficient and user-friendly, with inversions starting from three input files and completing within about two hours on 64 processors, and that synthetic recovery plus consistency with previous studies verifies the package's effectiveness.
Significance. If the central claims are substantiated, TomoATT would be a valuable open-source contribution: it provides a complete workflow for Eikonal-based traveltime tomography, including azimuthal anisotropy, with validated forward modeling, multipathing-aware kernels, and multi-level parallelism. The paper's strengths include the open-source availability under GPLv3, the companion PyTomoATT module, forward-model validation against analytic solutions and TauP (Sections 3.1-3.2), and the reproduction of several independently published structural features in the real-data images. However, as argued in the major comments, the verification of the inversion's physical accuracy is not yet complete, and several reproducibility-critical parameters are not reported.
major comments (4)
- [Section 4.1] The synthetic verification is an 'inverse-crime' test. Observational data are generated by the same Eikonal solver on the same grid as used in the inversion, with no added noise. This verifies that the inversion code can invert its own forward operator, but it does not verify robustness to modeling error, data noise, or discretization mismatch. The abstract's claim that 'successful recovery of the synthetic model ... verifies the effectiveness of TomoATT' is therefore too strong. I recommend adding a synthetic test where data are generated on a different (finer) grid or with a different forward solver, or with realistic noise and outlier contamination, and showing recovery statistics.
- [Sections 4.2-4.3] The real-data benchmarks lack resolution tests and uncertainty quantification. No checkerboard or spike recovery tests are shown for the Parkfield or Thailand geometries, and the images are presented without any measure of reliability such as model covariance or depth-resolution surfaces. Because the data selection criteria are deferred to Chen et al. (2023) and the regularization choices are not fully reported (see next comment), the reader cannot determine whether the imaged anomalies are required by the data. I recommend adding standard resolution tests (e.g., checkered/spike restorations with the actual station-event geometry) or at least discussing sensitivity to regularization.
- [Sections 4.2-4.3 (reproducibility)] The values of the objective-function weights alpha, beta, gamma; the kernel-density exponent zeta in Eq. (18); the multiple-grid configuration H; and the gradient-descent step size are not reported for the two real-data inversions. These parameters have a direct effect on the images (as shown for zeta in Section 3.3), and without them the claimed benchmarks cannot be reproduced, which is a central issue for an open-source package. Please provide the exact parameter files (or a table listing all parameters) for both case studies.
- [Section 4] The consistency of the real-data results with 'previous studies' partly refers to the authors' own earlier papers (Chen et al. 2023a,b), since the text states that the two cases were 'detailed in our previous studies.' The comparisons to independent references (e.g., Eberhart-Phillips and Michael, 1993; Thurber et al., 2006; Yang et al., 2015) are more persuasive, but the discussion should clearly separate those independent comparisons from self-comparisons, and ideally add quantitative misfit or correlation metrics rather than qualitative agreement.
minor comments (7)
- [Figure 7 caption] 'syntehtic' should be 'synthetic'.
- [Figure 6 caption] 'relative the number of processors' should be 'relative to the number of processors'.
- [Section 3.3] 'with a standard derivation of 0.1 s' should be 'standard deviation'.
- [Section 2.1] Equation numbering is duplicated: two separate equations are labeled (4), the second being the anisotropic Eikonal equation; renumber the equations.
- [Keywords] 'teleiseismic' is misspelled; it should be 'teleseismic'.
- [Figure 8 caption] 'Figure 8. Figure 8.' is duplicated; remove the repeated text.
- [Appendix B] Several equations (B5)-(B11) appear typeset with a heavy or bold font that is inconsistent with the main text; please ensure uniform notation.
Circularity Check
Mild self-referential synthetic benchmark; method equations and real-data comparisons retain independent support.
-
other
[Section 4.1 and Abstract]
"Observational traveltime data are generated using the true model and true earthquake locations. ... The successful recovery of the synthetic model, along with the imaging results that are consistent with previous studies and regional tectonics, verifies the effectiveness of TomoATT."
The synthetic benchmark generates the observations with the package's own Eikonal forward solver, starting from the true model, and then inverts them with the same forward operator to recover that same model. With no independent data or noise specified, the inversion is asked to invert the output of its own forward code, so the target model lies exactly in the representable solution space. A successful recovery therefore mainly demonstrates internal consistency of the forward and inverse routines, not an independent physical prediction; any systematic error in the forward solver is common to both data generation and inversion and cancels out.
full rationale
The paper is primarily a software description that carries the adjoint-state traveltime tomography equations over from the authors' prior publications; this is not circular because the current claims are about implementation performance, and the equations are not re-derived from the conclusions. The Eikonal solver is checked against an analytic solution (Section 3.1) and against TauP for the teleseismic test (Section 3.2), which are external references, and the real-data images are compared with independent studies (Eberhart-Phillips and Michael, Lippoldt et al., Thurber et al., etc.). The main self-referential element is the synthetic experiment in Section 4.1, where data generated with the same forward solver are used to verify recovery of the generating model; this is an inverse-crime style consistency check that would not expose errors shared by the forward and inverse operators. Because the paper does not rely solely on that test and includes independent comparisons, the circularity is mild and partial rather than load-bearing. No fitted parameter is renamed as a prediction, and no uniqueness theorem or ansatz is smuggled in via self-citation.
Assumptions & free parameters
free parameters (4)
- Kernel density normalization exponent zeta =
0.3, 0.6, 0.9 (tested in toy experiment)
- Objective function weights alpha, beta, gamma =
Not specified
- Multiple-grid parameterization H and grid node distributions =
H not specified; grid for Parkfield 5 km x 5 km x 1 km, Thailand 10 km x 10 km x 5 km
- Gradient descent step size =
Not specified
assumptions (5)
- domain assumption The anisotropic Eikonal equation with parameters (s, xi, eta) accurately describes first-arrival traveltimes in the crust and upper mantle, including multipathing situations.
- standard math The reciprocity principle is valid in the anisotropic medium, allowing station-source swapping to reduce computational cost.
- domain assumption The adjoint-state method computes correct sensitivity kernels, including in the presence of multipathing.
- standard math The fast sweeping method converges to the viscosity solution of the anisotropic Eikonal equation on the chosen meshes.
- domain assumption The traveltime picks and differential times from public data centers are accurate enough after the 'strict data selection criteria' to constrain the inverted structures.
Cite this review
Pith. "Pith review of TomoATT: An open-source package for Eikonal equation-based adjoint-state traveltime tomography for seismic velocity and azimuthal anisotropy." pith.science (2026). https://pith.science/paper/PKYQHAJD
@misc{pith2026241200031,
author = {Pith},
title = {Pith review of: TomoATT: An open-source package for Eikonal equation-based adjoint-state traveltime tomography for seismic velocity and azimuthal anisotropy},
year = {2026},
howpublished = {\url{https://pith.science/paper/PKYQHAJD}},
note = {Machine review of arXiv:2412.00031}
}
read the original abstract
TomoATT is an open-source software package, aiming at determining seismic velocity and azimuthal anisotropy based on adjoint-state traveltime tomography methods. Key features of TomoATT include Eikonal equation modeling, adjoint-state method, sensitivity kernel regularization, and multi-level parallelization. Through several toy experiments, we demonstrate TomoATT's capability in accurate forward modeling, handling multipathing phenomenon, delivering reliable tomographic results, and achieving high-performance parallelization. Additionally, TomoATT is benchmarked with a synthetic experiment and two real-data applications in central California near Parkfield and Thailand. The successful recovery of the synthetic model, along with the imaging results that are consistent with previous studies and regional tectonics, verifies the effectiveness of TomoATT. Each inversion starts with only three simple input files (about model, data, and parameters) and completes within 2 hours using 64 processors. Overall, TomoATT offers an efficient and user-friendly tool for regional and teleseismic traveltime tomography, empowering researchers to image subsurface structures and deepen our understanding of the Earth's interior.
Figures
Figures from the paper (14 more)
Reference graph
Works this paper leans on
-
[1]
Figure 1: The workflow of TomoATT to implement adjoint -state traveltime tomography, including anisotropic velocity model determination and earthquake location
-
[2]
(a) The true traveltime field 𝑇𝑡𝑟𝑢𝑒(𝑥) calculated in the velocity model
Figure 2: Validation of the Eikonal solver for calculating traveltime. (a) The true traveltime field 𝑇𝑡𝑟𝑢𝑒(𝑥) calculated in the velocity model. The red star indicates the earthquake. The black curves represent traveltime isochrones at an interval of 20 s. (b) Traveltime errors at surface stations (depth = 0 km) relative to epicenter distance. The blue, ye...
-
[3]
(a) The teleseismic earthquake (red star) and the study region (red box)
Figure 3: Validation of the Eikonal solver for teleseismic differential arrival time. (a) The teleseismic earthquake (red star) and the study region (red box). Black dashed circles denote epicenter distances of 30∘ and 60∘. (b) Calculated traveltime field within the study region. The blue triangles denote stations deployed on the surface. (c) Histogram of...
-
[4]
Figure 4: A toy experiment illustrating the multipathing phenomenon. (a) P -wave velocity model. The blue triangles denote stations, and the red star marks the earthquake. White curves represent traveltime isochrones at an interval of 1 s. (b) Sensitivity kernel comp uted with artificial adjoint sources 𝑅𝑛,𝑚 = 1. The adjoint -state short author name: Prep...
-
[5]
Figure 5: A toy experiment demonstrating multiple -grid parameterization and kernel density normalization in tomography. (a) Initial velocity model with 8 stations on the surface (blue triangles) and 10,000 unevenly distributed earthquakes. (b) Velocity perturbation of the target model relative to the initial model. (c) Original sensitivity kernel at the ...
-
[6]
Figure 6: Illustration of multi-level parallelization in TomoATT. (a) Level 1: Source parallelization demonstrates numerically solving Eikonal equations in parallel for two earthquakes. The blue triangles denote stations, and the red star marks the earthquake. Gray circles denote grid nodes discretizing the computational domain. Level 2: A 2-by-2 domain d...
-
[7]
(a) Velocity perturbation of the true model relative to the initial model
Figure 7: Model setting of a synthetic experiment. (a) Velocity perturbation of the true model relative to the initial model. Yellow bars represent azimuthal anisotropy, aligned with fast velocity directions. Blue triangles are stations on the surface. True earthquake hypocenters are evenly distributed at depths of 10 km (red dots), 20 km (green dots), an...
-
[8]
Test results in the synthetic experiment
Figure 8: Figure 8. Test results in the synthetic experiment. Notations follow Figure 7. (a) Test 1: Earthquake locations determined in the true model, verifying the relocation function. (b) Test 2: Earthquake locations determined in the initial model, showing slight deviation due to inaccurate velocity a nd anisotropy. (c) Test 3: Velocity and anisotropi...
Show all 10 references
-
[9]
(a) Topography map
Figure 9: Tectonic setting and imaging results in central California near Parkfield. (a) Topography map. Red box outlines the study region. Earthquakes and stations are denoted by red dots and blue triangles, respectively. Black lines mark active faults. (b) Horizontal section...
-
[10]
(a) Topography map
Figure 10: Tectonic setting and imaging results in Thailand and adjacent regions. (a) Topography map. Black dashed lines denote major faults: DBPF (Dien Bien Phu Fault), WCF (Wang -Chao Fault), and TPF (Three Pagodas Fault). The solid black line indicates the Khorat Plateau. S...
Reviewed August 12, 2026 · model on record in the stance chip above.
Discussion (0). Continue with ORCID to comment.