Skip to main content

Installation

Once published on PyPI (prebuilt wheels for Linux x86_64/aarch64 and macOS, any Python >= 3.10, no compiler needed):

pip install indiflight_log_tools            # add [rerun] for bfl2rerun

From the git repo (compiles the C decoder, so needs gcc/clang):

pip install "git+https://github.com/tudelft/indiflight#subdirectory=support/LogAnalysis/indiflight_log_tools"

From a local checkout (-e for development):

pip install -e support/LogAnalysis/indiflight_log_tools

Test it

cd ~/    # or anywhere else, but not the source folder
python -c "from indiflight_log_tools import IndiflightLog; print(IndiflightLog.LIBRARY_SO)"

Releasing

Bump version in pyproject.toml, then push a tag log-tools-v<version>. .github/workflows/log-tools-wheels.yml builds the wheels and uploads them to PyPI.

Usage

from indiflight_log_tools import IndiflightLog

log = IndiflightLog("/path/to/log.bfl", logId=3)                                  # if multiple logs in the same logfile, use this to select the one you want. default 1
log = IndiflightLog("/path/to/log.bfl", resetTime=False)                          # resetTime maintains the flight controller time as the time basis in the dataframe (default True)
log = IndiflightLog("/path/to/log.bfl", resetTime=False, timeRange=(1000, 3000))  # crop the data to timeRange (given in ms)

log.raw                                                                           # pandas dataframe in raw units
log.data                                                                          # pandas dataframe in SI units
log.modeToText(log.data["flightModeFlags"])                                       # convert flight mode flag(s) into human-readable format
log.flags                                                                         # flight mode changes with timestamp
[(t, log.modeToText(x), log.modeToText(y)) for t, x, y in zip(log.flags["timeUs"], log.flags["enable"], log.flags["disable"])] # flight mode changes in human readable format

log.outputCsv("raw")                                                              # output raw data as csv, comparable to outputting from BB log explorer
log.outputCsv("si")                                                               # output SI data as csv
log.outputCsv("si", path="my/path/for/logOutput/")                                # output SI data into a specific path

log.addToRerun(name="BFL", clockOffsetSeconds=0.)                                 # send data Rerun (does not do init, connect, etc. just adding data)

There are also command line tools you can use after installing the wheel:

$ bfl2csv --help     # shorthand for the log.outputCsv() above
$ bfl2rerun --help   # shorthand for the log.addToRerun() above

Metadata

Release files for indiflight-log-tools 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for indiflight-log-tools 0.3.0
File Size Uploaded Provenance Actions
indiflight_log_tools-0.3.0.tar.gz 53.1 kB With provenance Details for indiflight_log_tools-0.3.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for indiflight-log-tools 0.3.0
File Actions
indiflight_log_tools-0.3.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64, Linux glibc 2.17+ x86-64 Details for indiflight_log_tools-0.3.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl
indiflight_log_tools-0.3.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64, Linux glibc 2.28+ ARM64 Details for indiflight_log_tools-0.3.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl
indiflight_log_tools-0.3.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for indiflight_log_tools-0.3.0-py3-none-macosx_11_0_arm64.whl
indiflight_log_tools-0.3.0-py3-none-macosx_10_13_x86_64.whl Python 3 none macOS 10.13+ x86-64 Details for indiflight_log_tools-0.3.0-py3-none-macosx_10_13_x86_64.whl

Total release size: 376.8 kB

Release files / indiflight_log_tools-0.3.0.tar.gz

Download URL indiflight_log_tools-0.3.0.tar.gz
Size 53.1 kB
Tags Source
SHA-256 checksum
How to use checksums
9a1bc00ef2b6cc3627ca3da8b7b75c7cba37449b2fe3b70e40e6cf9039fc2c3e
BLAKE2b-256 checksum
How to use checksums
e0b6498f21aad5d29bfa5a61524a6451fade9821c5aa9e4aaef8f16649284da9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / indiflight_log_tools-0.3.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl

Download URL indiflight_log_tools-0.3.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl
Size 113.7 kB
Tags Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
7c5c22e72124dbdfc46f5e3a7c539e5a03a17c08987a394cd4039c67a856a4d2
BLAKE2b-256 checksum
How to use checksums
b1a4268a9b69e15ffe8ce27d5a182a7c39fb7a5564a217d7a8dd34c9e5d449d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / indiflight_log_tools-0.3.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl

Download URL indiflight_log_tools-0.3.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl
Size 116.1 kB
Tags Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
0526cfefb76590c5bf6a6fa90d976cfbfaf74fe2066432ad96ed6d95a95ccec3
BLAKE2b-256 checksum
How to use checksums
bec1e54d6ddabb1f0faa2f78660909c7672c61c1366d00fe23a48781a6ecad1e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / indiflight_log_tools-0.3.0-py3-none-macosx_11_0_arm64.whl

Download URL indiflight_log_tools-0.3.0-py3-none-macosx_11_0_arm64.whl
Size 47.2 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
95f1885745f48568847ba464f624503748bc2e6301a94f23e9401cc6b0e20769
BLAKE2b-256 checksum
How to use checksums
7667c885852c23d9d066daaeb3708a50940c5c00ecde3c11c8ce6209274ac1cc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / indiflight_log_tools-0.3.0-py3-none-macosx_10_13_x86_64.whl

Download URL indiflight_log_tools-0.3.0-py3-none-macosx_10_13_x86_64.whl
Size 46.8 kB
Tags Python 3 macOS 10.13+ x86-64
SHA-256 checksum
How to use checksums
d9d1d579b306c163cc213afd4cc72c57fc4ceceea26aa2f6ebb7f02961864236
BLAKE2b-256 checksum
How to use checksums
2c8adcd79a7f8581781b5789079505a4427a219bdc3ee383821a34c050420d36
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Security for indiflight-log-tools 0.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 5 files in this release have been uploaded with provenance metadata.

Select from 5 files

Attestation for indiflight_log_tools-0.3.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page