Skip to main content

flysight2csv

CI Status Documentation Status Test coverage percentage

Poetry black pre-commit

PyPI Version Supported Python versions License


Documentation: https://flysight2csv.readthedocs.io

Source Code: https://github.com/yoleg/flysight2csv


Utilities for finding and reformatting FlySight 2 CSV files (SENSOR.CSV and TRACK.CSV).

💡 This is an early release. Please let me know how you use this tool and what features you would like to see.

Features

Functionality:

  • Find all the FlySight 2 CSV files in one or more directories or possible file paths.
  • View metadata (vars, sensors, columns, units, and first row) for each CSV file.
  • Copy matching files to a single directory, prepending the parent directory names to the filename.
  • Reformat the CSV files for easier use with other tools, such as Pandas dataframes.
    • Calculates ISO timestamps for non-GPS sensors from $TIME field values, if available.
    • Available formats:
      • Flat CSV (single header row)
      • JSON lines (one JSON object per line)
    • Available filters:
      • Select only the columns you need.
      • Select only the sensors you need.
  • Merge the reformatted files from each directory into an additional MERGED.csv (or .jsonl) file, sorted by timestamp.

Compatibility:

  • Works with Python 3.10+
  • Tested on Windows, Mac, and Linux
  • May be used as a Python library or command-line tool

Possible future features

Let me know if you would like to see any of these added.

  • Filter the CSV files by date/time, altitude, or other criteria.
  • Show a summary of date ranges and altitudes for the discovered CSV files.
  • Add units to the flattened CSV files.
  • FlySight 1 output format.
  • Trim the CSV files to just the descent or ascent portion of a flight.
  • Installers for Windows, Mac, and Linux.
  • Simple graphical user interface (GUI) for selecting options and running the command.

Installation

The package is published on PyPI and can be installed with pip (or any equivalent):

pip install flysight2csv

For complete installation instructions, see the installation documentation.

Usage

💡 Please note that this is an early release, and the API may change in future versions.

Preview the files to be processed:

flysight2csv source/files/or/directories/
flysight2csv source/files/or/directories/ --info=metadata

Copy just the TRACK.CSV files (unchanged) to a single directory, prepending the date and time to the filename:

flysight2csv source/files/or/directories/ -o output/path/ '--glob=**/TRACK.CSV'

Reformat all the FlySight 2 CSVs into a "flat" CSV (single header) for use with other tools:

flysight2csv source/files/or/directories/ -o output/path/ -f csv-flat

To see all available options, run flysight2csv --help or see the documentation.

Troubleshooting

See the troubleshooting section of the documentation.

Contributors ✨

Contributions of any kind welcome! Please see the contributing guide.

Credits

This package was created with Copier and the browniebroke/pypackage-template project template.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flysight2csv-0.2.4.tar.gz (24.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

flysight2csv-0.2.4-py3-none-any.whl (24.7 kB view details)

Uploaded Python 3

File details

Details for the file flysight2csv-0.2.4.tar.gz.

File metadata

  • Download URL: flysight2csv-0.2.4.tar.gz
  • Upload date:
  • Size: 24.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for flysight2csv-0.2.4.tar.gz
Algorithm Hash digest
SHA256 e659425ce17812d7640997a9d9aade6f5f5d667f1e72a6c6593d93f83cd8c0d4
MD5 243fc5dd2025695c06e525d4b9d850ad
BLAKE2b-256 c2a2f2cba01a4fee35045aad315550dd46090aba69386e2b8e3a5698f8a50691

See more details on using hashes here.

Provenance

The following attestation bundles were made for flysight2csv-0.2.4.tar.gz:

Publisher: ci.yml on yoleg/flysight2csv

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file flysight2csv-0.2.4-py3-none-any.whl.

File metadata

  • Download URL: flysight2csv-0.2.4-py3-none-any.whl
  • Upload date:
  • Size: 24.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for flysight2csv-0.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 2cb6447318ecb0eabeb8b92790631a6550c9863d7d2679baab5c6f3ee27bce76
MD5 c6dffb902dd55c4301c1c59801f65189
BLAKE2b-256 09cdb62a4e786f20cf3b8050faec417ff2891587141133e8b236259dde6ac65c

See more details on using hashes here.

Provenance

The following attestation bundles were made for flysight2csv-0.2.4-py3-none-any.whl:

Publisher: ci.yml on yoleg/flysight2csv

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.4 This release

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page