v1.6.1 Bluefile Converter

Bluefile Converter

In this release we are excited to announce the addition of a converter for the MIDAS Blue and Platinum BLUE RF recording formats (commonly .cdif files). This allows you to seamlessly integrate BLUE file recordings into your SigMF workflows.

The converter automatically detects BLUE file formats and can create standard SigMF file pairs, archives, or Non-Conforming Datasets (NCDs) that reference the original recording. Original BLUE header information is preserved in the SigMF metadata under the blue: namespace.

Python API Example

You can use the converter directly within your Python scripts. If no output path is provided, a metadata-only SigMFFile object for a Non-Conforming Dataset (NCD) is returned without writing any files.

from sigmf.convert.blue import blue_to_sigmf

# Convert a BLUE file to a standard SigMF file pair
meta = blue_to_sigmf(blue_path="recording.cdif", out_path="recording")

# Create an NCD object in memory (no files written)
meta = blue_to_sigmf(blue_path="recording.cdif")

# Access samples and metadata
all_samples = meta.read_samples()
sample_rate = meta.sample_rate

# Original bluefile metadata preserved (in `fixed`, `adjunct`, and `extended` keys)
meta.get_global_field('blue:adjunct')

{'xstart': 0.025, 'xdelta': 5.5555555555555555e-08, 'xunits': 1}

Command-Line Example

The converter is also integrated into the unified sigmf_convert command-line tool, which automatically detects the input file format.

# Convert a .cdif file to a SigMF archive
sigmf_convert recording.cdif recording.sigmf --archive

# Create a non-conforming dataset (metadata only, references original data)
sigmf_convert recording.cdif recording --ncd

What's Changed

• Feature: Blue Support by @Teque5 and @KelseyCreekSoftware in #122
• Expand support to python 3.14 (π) by @Teque5 in #127

Thanks

Special thanks for the initial BLUE converter implementation and testing by @KelseyCreekSoftware.

Full Changelog: v1.5.1...v1.6.1