TomoTree

Open source acoustic tomography of trees

Learn More

TomoTree

  • Open source software for acoustic tomography of trees.
  • Five reconstruction methods, detection of cracks, 3D scans of the stem, resistograph.
  • Reads Fakopp (.f3d), PiCUS (.pit) and Arbotom (.abt) measurements as well as CSV files.
  • Graphical user interface in the web browser, in seven languages, no programming needed.
  • The same computations as a Python library for Jupyter notebooks.
  • Available online, as a Python package or as a Docker container.
TomoTree
Five reconstruction methods

Five reconstruction methods

  • Rays (thin or fat rays), EBSI, ERSM, regularized SIRT with fat rays and filtered back projection (FBP).
  • The page Compare methods shows the tomograms of all methods side by side with the same settings and a common colour scale, with a table of the misfit of the measured times.
  • Anisotropy correction, bark thickness, rescaling of speeds and the correction by back projection.
  • No black box: each method is documented, the settings of every tomogram are shown in badges above it.
  • Changed settings do not recompute at once: the previous tomogram stays faded with the list of changes until you press Recompute tomogram.

Tomogram and the photo

  • The tomogram can be compared with the photo of the actual cross section by a slider.
  • The default colour scale is the percentage of the sound wood velocity, so a sound tree stays green; percentile and absolute scales are also available.
  • Static or interactive plots (plotly, bokeh), custom colormaps, statistics of the tomogram.
Tomogram and the photo
Acoustic rays

Acoustic rays

  • Visualization of the acoustic rays in the cross section, alone or over the photo.
  • Speed filter for rays allows to focus on the slowest or the fastest rays.
  • The Select rays dialog disables single rays by clicking and suggests suspicious rays: rays leaving the stem outline and pairs whose two directions disagree.
  • Angle plots show the ray speed as a function of the declination from the radial direction.

Cracks: dividing line

  • Linear defects such as cracks look like cavities in the tomogram. TomoTree can tell them apart.
  • The cross section is split by a chord between two sensors, each half is reconstructed from the sensors on its side and the halves are merged.
  • A defect along the line disappears in the merged tomogram, a cavity stays.
  • Metrics (delay of the rays crossing the line, change of the defect area) and an automatic search for the dividing line of a crack.
Cracks: dividing line
3D scans of the stem

3D scans of the stem

  • Load a 3D scan of the stem (OBJ, GLB) made e.g. by a phone app.
  • Red sensor markers are detected automatically and numbered around the stem; points can be added or moved by hand.
  • The sensor plane is fitted, the stem outline is cut from the scan and the sensor geometry is saved to the dataset.
  • The scan outline becomes the boundary of the tomogram; the tomogram or the photo can be shown on the cut.
  • Cross section tools compute the area and the mechanical characteristics of the scanned cross section.

Speed calibration

  • Speed calibration sets the sound speed in the sound wood. It is the reference for tomogram interpretation.
  • The sound speed is estimated from the cells influenced by the tangential rays.
  • The user can finetune the sound speed by excluding the rays close to the defect.
Speed calibration
Binary tomogram

Binary tomogram

  • Binary tomogram separates the sound wood from the degraded wood or the cavities.
  • The threshold can be set interactively and the effect on the binary tomogram is shown immediately.
  • The area of the sound wood, the wall thicknesses and the center of gravity are computed.
  • Given a neutral axis, the physical characteristics important for tree stability are estimated.

Photo assessment

  • Trace the sound wood, cavities and decay in the photo of the cross section (polygon or lasso).
  • Set the scale by a reference line and mark the sensors on the photo.
  • Areas and wall thicknesses from the photo can be compared with those from the tomogram.
Photo assessment
Resistograph

Resistograph

  • Visualization of resistograph curves, their mean and standard deviation.
  • Drilling paths are defined on the tomogram.
  • Combined plots draw the resistograph profiles directly over the tomogram.

Data sources

  • Measured data enter a dataset by an explicit import; every file is recorded with its date and checksum.
  • The page Data sources shows the files and lets you choose the geometry and the times in use, e.g. the sensor geometry from a 3D scan and the times from the tomograph file.
  • Changed or new files are detected and imported again.
Data sources
Reproduce in Jupyter

Reproduce in Jupyter

  • Every analysis page shows a Python snippet which gives the same result in Jupyter.
  • The snippet uses the same library functions with the same settings as the GUI.
  • Use the GUI to explore the data and the library for batch processing or publications.

Getting started

  • The stable GUI contains well tested code which allows to utilize TomoTree without programming skills.
  • The development version of the GUI contains new features which will be propagated to the stable branch after testing period.
  • You can also run TomoTree locally using Docker or Conda. See the documentation on GitHub.

    TomoTree online

Getting started
Share your analysis

Share your analysis

  • Running the GUI on public site you can share your data and analysis.
  • The data can be shared to the other users.
  • Private sharing with secret link is also possible.
  • Sessions can be saved and loaded again.

Source code

  • Source code is available on GitHub.
  • Feel free to report issues or contribute.
  • Documentation on GitHub Pages.
Source code
Support

Support

  • The development of TomoTree is supported by the Ministry of Education, Youth and Sports of the Czech Republic, project ERC CZ no. LL1909 “Tree Dynamics: Understanding of Mechanical Response to Loading (DYNATREE)” and MSCA FELLOWSHIP CZ MENDELU CZ.02.01.01/00/22_010/0008893 “Wood Degradation in the Urban Environment (WooDU)”.
  • Access to CESNET storage facilities provided by the project “e-INFRA CZ” under the programme “Projects of Large Research, Development, and Innovations Infrastructures” LM2023054), is greatly appreciated.