Description

This package is a bundle of C++/Python libraries providing functionality for reading/writing adtfdat files, processing streams and (de)serialize sample (container for timestamped streamed data).

Overview

Libraries

Library	Description
adtf_file	Create/read adtfdat files (indexed files with samples) using C++.
adtf_file_python_bindings	Create/read adtfdat files (indexed files with samples) and process streams using python.
adtfdat_processing	Process streams from/to adtfdat files.
ifhd_file	Create/read indexed files (no samples, just chunks).
utils5extension	Helper classes to create indexed files.

Tools & Applications

Tool	Description
adtf_dattool	Extendable CLI tool to to handle and access .adtfdat files for reading, writing and processing containing streams.
canwriter	Example application creating an adtfdat file containing a CAN stream.
fileaccess	Example application reading file and stream information.
referencedfiles	Example application accessing referenced_files extension.

ADTF File Plugins

ADTF File Plugin	Description
csv_exporter	Export DDL based stream to csv file using adtfdat_processing.
csv_reader	Import DDL based stream from csv file using adtf_file.
python_processor	Process stream using adtf_file_python_bindings.
trigonometry_reader	Example reader creating a sine, cosine and tangent stream using adtf_file.

Python Scripts

Python Script	Description
demo_exporter	Example script for python_processor
export_csv	Example script using csv_exporter.
export_python	Example script using python_processor with demo_exporter.
read_dat_file_content	Example script accessing file and streams using python directly.

Please have a look at Release Notes

How to build

If for any reason you do not make use of our delivered prebuild packages, we recommend using cmake together with conan on which the source code is based. You will find the required scripts/conan/build/conanfile.py within the source package.

Build Environment

The libraries are build and tested only under following compilers and operating systems:

Windows Desktop (x86_64)

We recommend our used and tested platform Microsoft Windows 10 64 Bit. On any other Windows 64 Bit platform (e.g. Windows 7 or 11) make sure that it fulfills the following requirements

Visual C++ 2019 (at least CXX Compiler MSVC 19.29) / Visual C++ 14.2 (VC142 Toolchain at least 14.29)
MSBuild Version 16.x (at least 16.11)
MSBuild Tools only or full Visual Studio IDE installation which covers this requirements
Windows Kit 10 (at least 10.0.19041.0)
CMake >= 3.23.2

Linux Desktop (x86_64)

We recommend our used and tested platform Ubuntu 18.04 LTS 64 Bit. On any other distributions (e.g. Fedora, Debian) make sure that it fulfills the following requirements

gcc >= 7
libc >= 2.27
libstdc++ >= 6.0.25
CMake >= 3.23.2
build-essential libarchive-dev mesa-common-dev mesa-utils libglib2.0-0 libxcb-xinerama0

Linux for ARMv8 (AArch64)

We recommend our used and tested platform Ubuntu 18.04 LTS 64 Bit. On any other distributions (e.g. Fedora, Debian) make sure that it fulfills the following requirements Our reference hardware is nVidia Jetson TX2 Board (compatible to e.g. nVidia Drive PX 2 or Jetson AGX XAVIER)

gcc >= 7
libc >= 2.27
libstdc++ >= 6.0.25
CMake >= 3.23.2
build-essential libarchive-dev mesa-common-dev mesa-utils libglib2.0-0

Note: Our entire code is prepared for cross-compiling (as we do as well). See cmake/conan documentation for how to.

License Information

For any license information have a look at LICENSE.

Furthermore please refer to Used Open Source Software for an overview of 3rd party packages we are glad to use.