David O'Neill > Parse-SpectrumDirect-RadioFrequency > Parse::SpectrumDirect::RadioFrequency

Download:
Parse-SpectrumDirect-RadioFrequency-0.100.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.100   Source   Latest Release: Parse-SpectrumDirect-RadioFrequency-0.101-TRIAL

NAME ^

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

VERSION ^

Version 0.100

DESCRIPTION ^

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 http://www.ic.gc.ca/eic/site/sd-sd.nsf/eng/home

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.

SYNOPSIS ^

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

    $parser->parse( $prefetched_output );

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

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

METHODS ^

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:

name

As in source legend, stripped of trailing spaces

units

Units for data value, if determinable from legend.

key

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

start

Column index to start extracting data value

len

Column width, used for data extraction.

get_stations ()

Returns station information as parsed from the input data.

AUTHOR ^

Dave O'Neill, <dmo at dmo.ca>

BUGS ^

Please report any bugs or feature requests to bug-parse-spectrumdirect at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Parse-SpectrumDirect-RadioFrequency. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT ^

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

    perldoc Parse::SpectrumDirect::RadioFrequency

You can also look for information at:

COPYRIGHT & LICENSE ^

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.

syntax highlighting: