radiomana is an open-source PyTorch library developed by The Aerospace Corporation for manipulating radio signals.

pip install --editable .

1. Download the Spectrum Highway Dataset 2
2. Set the DSET_FIOT_HIGHWAY2 environment variable in your .bashrc file to point to the location of the dataset.

# example
export DSET_FIOT_HIGHWAY2=/tmp/highway2

import radiomana

# inspect a single item
dset = radiomana.Highway2Dataset()
some_psd, some_label = dset[0]

# inspect a whole batch from loader
dmodule = radiomana.HighwayDataModule()
dmodule.setup()
some_batch = next(iter(dmodule.train_datamodule()))

./examples/train_baseline.py

With provided basic models and augmentations, we achieve the following performance. Observe that when un-augmented we overfit rapidly to the training set and our model doesn't generalize well.

This project is approved for public release with unlimited distribution by Aerospace under OSS Project Ref #OSS25-0006.

Do you have code you would like to contribute to this Aerospace project?

We are excited to work with you. We are able to accept small changes immediately and require a Contributor License Agreement (CLA) for larger changesets. Generally documentation and other minor changes less than 10 lines do not require a CLA. The Aerospace Corporation CLA is based on the well-known Harmony Agreements CLA created by Canonical, and protects the rights of The Aerospace Corporation, our customers, and you as the contributor. You can find our CLA here.

Please complete the CLA and send us the executed copy. Once a CLA is on file we can accept pull requests on GitHub or GitLab. If you have any questions, please e-mail us at oss@aero.org.

The Aerospace Corporation supports Free & Open Source Software and we publish our work with GPL-compatible licenses. If the license attached to the project is not suitable for your needs, our projects are also available under an alternative license. An alternative license can allow you to create proprietary applications around Aerospace products without being required to meet the obligations of the GPL. To inquire about an alternative license, please get in touch with us at oss@aero.org.