The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


Parse::SpectrumDirect::RadioFrequency - Parse Industry Canada "Spectrum Direct" radio frequency search output


Version 0.100


This module provides a parser for the "Radio Frequency Search" text-format output from Industry Canada's Spectrum Direct service. This service provides information on the location of RF spectrum licensing, transmitter locations, etc.

The service is available at

The text export is a series of fixed-width fields, with field locations and descriptions present in a legend at the end of the data file.


    my $parser = Parse::SpectrumDirect::RadioFrequency->new();

    $parser->parse( $prefetched_output );

    my $legend_hash = $parser->get_legend();

    my $stations = $parser->get_stations();


new ( )

Creates a new parser.

parse ( $raw )

Parses the raw data provided. Returns a true value if successful, a false if not.

Parsed data can be obtained with get_legend() and get_stations() (see below).

get_legend ()

Returns the description of fields as parsed from the input data.

Return value is an array reference containing one hash reference per field.

Each hashref contains:


As in source legend, stripped of trailing spaces


Units for data value, if determinable from legend.


Key used in station hashes. Generated from name stripped of unit information, and whitespaces converted to _.


Column index to start extracting data value


Column width, used for data extraction.

get_stations ()

Returns station information as parsed from the input data.


Dave O'Neill, <dmo at>


Please report any bugs or feature requests to bug-parse-spectrumdirect at, or through the web interface at I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.


You can find documentation for this module with the perldoc command.

    perldoc Parse::SpectrumDirect::RadioFrequency

You can also look for information at:


Copyright 2010 Dave O'Neill, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.