GPS::OID(3pm)

1GPS::OID(3)           User Contributed Perl Documentation          GPS::OID(3)
2
3
4

NAME

6       GPS::OID - Package for GPS PRN - Object ID conversions.
7

SYNOPSIS

9         use GPS::OID;
10         my $obj = GPS::OID->new();
11         print "PRN: ", $obj->prn_oid(22231), "\n";
12         print "OID: ", $obj->oid_prn(1), "\n";
13

DESCRIPTION

15       This module maps GPS PRN number to Satellite OID and vice versa.
16
17   Object Identification Number (OID)
18       The catalog number assigned to the object by the US Air Force. The
19       numbers are assigned sequentially as objects are cataloged. This is the
20       most common way to search for TLE data on this site.
21
22       Object numbers less then 10000 are always aligned to the right, and
23       padded with zeros or spaces to the left.
24
25   Pseudo Random Numbers (PRNs)
26       GPS satellites are identified by the receiver by means of PRN-numbers.
27       Real GPS satellites are numbered from 1 - 32. WAAS/EGNOS satellites and
28       other pseudolites are assigned higher numbers.  The PRN-numbers of the
29       satellites appear on the satellite view screens of many GPS receivers.
30

CONVENTIONS

32       Function naming convention is "format of the return" underscore "format
33       of the parameters."
34

CONSTRUCTOR

36   new
37       The new() constructor
38
39         my $obj = GPS::OID->new();
40

METHODS

42   initialize
43   prn_oid
44       PRN given Object ID.
45
46         my $prn=prn_oid(22231);
47
48   oid_prn
49       Object ID given PRN.
50
51         my $oid=oid_prn(1);
52
53   listprn
54       List all known PRNs.
55
56         my @prn=$obj->listprn;
57         my $prn=$obj->listprn;
58
59   listoid
60       List all known OIDs.
61
62         my @oid=$obj->listoid;
63         my $oid=$obj->listoid;
64
65   data
66       OID to PRN hash reference
67
68         my $data=$self->data;
69
70   overload
71       Adds or overloads new OID/PRN pairs.
72
73         $obj->overload($oid=>$prn);
74
75   reset
76       Resets overloaded OID/PRN pairs to package defaults.
77
78         $obj->reset;
79

TODO

BUGS

82       Please send issues to the gpsd-dev email list.
83

LIMITS

AUTHOR

86       Michael R. Davis qw/perl michaelrdavis com/
87

LICENSE

89       Copyright (c) 2006 Michael R. Davis (mrdvt92)
90
91       This library is free software; you can redistribute it and/or modify it
92       under the same terms as Perl itself.
93