Skip to main content

Collection of Python tools for working with CCSDS Space Packets

Project description

Contributor Covenant

SPaC-Kit

✨ Introduction

SpaC-Kit is a collection of Python tools for working with CCSDS Space Packet. It can generically:

  • Parse data files into Pandas DataFrames or Excel spreadsheets
  • (Scheduled Feb 2026) – Generate documentation in multiple formats (HTML, Markdown, reStructuredText, PDF)
  • (Scheduled Apr 2026) – Generate simulated packets

SpaC-Kit supports mission- or instrument-specific CCSDS packet structures via plugin packages built on the CCSDSPy library.

🔌 Available Plugins

Users

Requirement

Tested with python 3.9.

Optionnally, but recommended, create a virtual environment:

python3 -m venv my_virtual_env
sournce my_virtual_env/bin/activate

Install

Install you plugin library first, for example Europa-Clipper CCSDS packets definitions:

git clone https://github.com/joshgarde/europa-cliper-ccsds-plugin.git
cd europa-cliper-ccsds-plugin   
pip install .

Install the SPaC-Kit package:

pip install spac_kit

Use

parse-downlink --file {your ccsds file}

See more options with:

parse-downlink --help

Developers

Requirements

Python 3.9

Create a virtual environment

For example in command line:

python3 -m venv venv
source venv/bin/activate

Install CCSDSPy

To install the latest version of CCSDSPy:

pip install git+https://github.com/CCSDSPy/ccsdspy.git

Deploy the project, for developers

Clone the repository

Install the package

pip install -e '.[dev]'
pre-commit install && pre-commit install -t pre-push

Run an example:

python src/spa_kit/parse/downlink_to_excel.py

or

spac-parse --help

or

spac-parse --file ./data/ecm_mag_testcase6_cmds_split_out.log --bdsem --header

Build and publish the package

Update the version number in file setup.cfg

Create a tag in the repository

Build the project:

python3 -m pip install --upgrade build
rm -rf dist/
python3 -m build

Publish the project:

twine upload dist/*

Acknowledgment

This package heavily relies on ccsdspy library (see https://github.com/CCSDSPy/ccsdspy).

Project details


Download files

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

Source Distribution

spac_kit-0.1.0.dev0.tar.gz (21.5 kB view details)

Uploaded Source

Built Distribution

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

spac_kit-0.1.0.dev0-py3-none-any.whl (20.9 kB view details)

Uploaded Python 3

File details

Details for the file spac_kit-0.1.0.dev0.tar.gz.

File metadata

  • Download URL: spac_kit-0.1.0.dev0.tar.gz
  • Upload date:
  • Size: 21.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.20

File hashes

Hashes for spac_kit-0.1.0.dev0.tar.gz
Algorithm Hash digest
SHA256 5e165c61ab8d34dff1f792aa76e16d956820a1f06872a41c9140286fed9ab56b
MD5 b06eac6b4459bed1081f8e6072093e27
BLAKE2b-256 a0e83b0ebee7561489726a94969b6ea628c175bc1cd384ecac7fd2dd3ce97112

See more details on using hashes here.

File details

Details for the file spac_kit-0.1.0.dev0-py3-none-any.whl.

File metadata

  • Download URL: spac_kit-0.1.0.dev0-py3-none-any.whl
  • Upload date:
  • Size: 20.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.20

File hashes

Hashes for spac_kit-0.1.0.dev0-py3-none-any.whl
Algorithm Hash digest
SHA256 8d44a6aed5a49c06696880dad3d6a1ecaccf993bf3c737d6ec5c713e12461eae
MD5 c60ccfa201e29a29c46c0f9f004d442d
BLAKE2b-256 628bda7a6f323fd43757a1841d4f064550e3610525495113d8e9e3aa181d06ba

See more details on using hashes here.

Supported by

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