eXtended Triton Format (XTF) file interface
A python library for reading eXtended Triton Format (XTF) files (revision 44)
Installation from pypi
pip3 install pyxtf
Installation from source
Clone or download the repository and run the following command. This requires setuptools to be installed.
python3 setup.py install
The project depends on setuptools and numpy. Matplotlib is used for plotting, but is not required for basic functionality.
import pyxtf input_file = 'yourfile.xtf' (file_header, packets) = pyxtf.xtf_read(input_file, verbose=True)
The file_header is of type XTFFileHeader, which is a c-structure that starts off every XTF file. The packets object is a dictionary of the packets that follow the file header. The key is of type XTFHeaderType, which is an enumerated class. The value is a list of objects that belong to that type of header type. E.g usage might look as the following.
... # Retrieve a list of all sonar packets sonar_packets = packets[pyxtf.XTFHeaderType.sonar] # Print the first sonar packet (ping) print(sonar_packets)
Examples can be found in the examples directory on github.
If you find an XTF-file that does not work, either submit a patch or new packet type, or be prepared to send an example XTF-file when submitting the bug-report.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.