perl/DXBearing.pm

   1 #
   2 # bearing and distance calculations together with
   3 # locator convertions to lat/long and back
   4 #
   5 # some of this is nicked from 'Amateur Radio Software' by
   6 # John Morris GM4ANB and tranlated into perl from the original
   7 # basic by me - I have factorised it where I can be bothered
   8 #
   9 # Copyright (c) 1998 - Dirk Koopman G1TLH
  10 #
  11 # $Id$
  12 #
  13
  14 package DXBearing;
  15
  16 use POSIX;
  17 use DXUtil;
  18
  19 use strict;
  20 use vars qw($pi);
  21
  22 $pi = 3.14159265358979;
  23
  24 # convert a qra locator into lat/long in DEGREES
  25 sub qratoll
  26 {
  27         my $qra = uc shift;
  28         my ($p1, $p2, $p3, $p4, $p5, $p6) = unpack 'AAAAAA', $qra;
  29         ($p1, $p2, $p3, $p4, $p5, $p6) = (ord($p1)-ord('A'), ord($p2)-ord('A'), ord($p3)-ord('0'), ord($p4)-ord('0'), ord($p5)-ord('A'), ord($p6)-ord('A') );
  30
  31         my $long = ($p1*20) + ($p3*2) + (($p5+0.5)/12) - 180;
  32     my $lat = ($p2*10) + $p4 + (($p6+0.5)/24) - 90;
  33         return ($lat, $long);
  34 }
  35
  36 # convert a lat, long in DEGREES to a qra locator
  37 sub lltoqra
  38 {
  39         my $lat = shift;
  40         my $long = shift;
  41
  42         my $v;
  43         my ($p1, $p2, $p3, $p4, $p5, $p6);
  44
  45         $lat += 90;
  46         $long += 180;
  47         $v = int($long / 20);
  48         $long -= ($v * 20);
  49         $p1 = chr(ord('A') + $v);
  50         $v = int($lat / 10);
  51         $lat -= ($v * 10);
  52         $p2 = chr(ord('A') + $v);
  53         $p3 = int($long/2);
  54         $p4 = int($lat);
  55         $long -= $p3*2;
  56         $lat -= $p4;
  57         $p3 = chr(ord('0')+$p3);
  58         $p4 = chr(ord('0')+$p4);
  59         $p5 = int((12 * $long) );
  60         $p6 = int((24 * $lat) );
  61         $p5 = chr(ord('A')+$p5);
  62         $p6 = chr(ord('A')+$p6);
  63
  64         return "$p1$p2$p3$p4$p5$p6";
  65 }
  66
  67 # radians to degrees
  68 sub rd
  69 {
  70         my $n = shift;
  71         return ($n / $pi) * 180;
  72 }
  73
  74 # degrees to radians
  75 sub dr
  76 {
  77         my $n = shift;
  78         return ($n / 180) * $pi;
  79 }
  80
  81 # does it look like a qra locator?
  82 sub is_qra
  83 {
  84         my $qra = shift;
  85         return $qra =~ /^[A-Za-z][A-Za-z]\d\d[A-Za-z][A-Za-z]$/o;
  86 }
  87
  88 # calc bearing and distance, with arguments in DEGREES
  89 # home lat/long -> lat/long
  90 # returns bearing (in DEGREES) & distance in KM
  91 sub bdist
  92 {
  93         my $hn = dr(shift);
  94         my $he = dr(shift);
  95         my $n = dr(shift);
  96         my $e = dr(shift);
  97         return (0, 0) if $hn == $n && $he == $e;
  98         my $co = cos($he-$e)*cos($hn)*cos($n)+sin($hn)*sin($n);
  99         my $ca = atan(abs(sqrt(1-$co*$co)/$co));
 100         $ca = $pi-$ca if $co < 0;
 101         my $dx = 6367*$ca;
 102         my $si = sin($e-$he)*cos($n)*cos($hn);
 103         $co = sin($n)-sin($hn)*cos($ca);
 104         my $az = atan(abs($si/$co));
 105         $az = $pi - $az if $co < 0;
 106         $az = -$az if $si < 0;
 107         $az = $az+2*$pi if $az < 0;
 108         return (rd($az), $dx);
 109 }
 110
 111 # turn a lat long string into floating point lat and long
 112 sub stoll
 113 {
 114         my ($latd, $latm, $latl, $longd, $longm, $longl) = split /\s+/, shift;
 115
 116         $longd += ($longm/60);
 117         $longd = 0-$longd if (uc $longl) eq 'W';
 118         $latd += ($latm/60);
 119         $latd = 0-$latd if (uc $latl) eq 'S';
 120         return ($latd, $longd);
 121 }
 122
 123 # turn a lat and long into a string
 124 sub lltos
 125 {
 126         my ($lat, $long) = @_;
 127         my $slat = slat($lat);
 128         my $slong = slong($long);
 129         return "$slat $slong";
 130 }
 131 1;