Parse::SpectrumDirect::RadioFrequency - Parse Industry Canada "Spectrum Direct" radio frequency search output
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.
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.
<dmo at dmo.ca>
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.
You can find documentation for this module with the perldoc command.
You can also look for information at:
RT: CPAN's request tracker
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.