f3d library reference guide

Library to analyze f3d files. This module provides functions to extract and analyze time of flight and distance data from F3D files used in tomographic imaging. It includes utilities to read XML data from zipped F3D files, convert distance data to node coordinates, and create distance and time matrices.

tomotree.analyze_f3d.df_nodes(df_distances, save=False, filename='nodes_coordinates.csv')

Convert distance data to node coordinates. Also test if save is True, then save the coordinates to a CSV file. Ask if overwrite if the file already exists.

tomotree.analyze_f3d.distance_matrix(df_nodes)

Create a distance matrix from node coordinates.

tomotree.analyze_f3d.extract_distance_data(root, layer=0)

Extract distance data of one layer (0-based) from the XML root.

tomotree.analyze_f3d.extract_time_data(root, layer=0)

Extract time of flight data of one layer (0-based) from the XML root.

Rows of the blind sensors (labelled “L1”, “L2”, …) are skipped.

tomotree.analyze_f3d.get_root(zip_path, inner_xml_filename='project.f3d')
tomotree.analyze_f3d.get_xml_root(zip_path, inner_xml_filename)

Extract XML root from the F3D file.

tomotree.analyze_f3d.parse_layer(root, layer=0)

Parsed data of one layer (0-based) of the F3D file, see f3d_to_yaml.parse_layer().