blib/lib/Geo/GoogleEarth/Pluggable/Plugin/GreatCircle.pm

filter: Statementstmt 50.0% 20 / 40 Branchbran 0.0% 0 / 2 Conditioncond 0.0% 0 / 2 MC/DCmcdc 0.0% 0 / 1 Subroutinesub 85.7% 6 / 7 Podpod 100% 1 / 1 totaltotal 50.9% 27 / 53 CC 4 SCAR 19.0
CC
4
Cov
45%
GreatCircleArcSegment
15.2
BEGIN
1.0
BEGIN
1.0
CRAP 6.7
↑ Summary
1 package Geo::GoogleEarth::Pluggable::Plugin::GreatCircle;
2 1 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
3 1 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 1 ▶use GPS::Point;
Subroutine BEGIN: called CC=1 SCAR=0.0
5 1 ▶use Geo::Forward;
Subroutine BEGIN: called CC=1 SCAR=0.0
6 1 ▶use Geo::Inverse; #fail at complie time if you don't have it
Subroutine BEGIN: called CC=1 SCAR=0.0
7  
8 1 our $VERSION='0.01';
9  
10 =head1 NAME
11  
12 Geo::GoogleEarth::Pluggable::Plugin::GreatCircle - Great Circle plugin for Geo::GoogleEarth::Pluggable
13  
14 =head1 SYNOPSIS
15  
16 use Geo::GoogleEarth::Pluggable;
17 my $document=Geo::GoogleEarth::Pluggable->new;
18 my $arc=$document->GreatCircleArcSegment(%data);
19  
20 =head1 DESCRIPTION
21  
22 Calculates the Great Circle Arc between two points and creates points in between so that Google Earth can display it as "straight" lines and it still looks like a Great Circle Arc.
23  
24 =head1 USAGE
25  
26 =head1 METHODS
27  
28 =head2 GreatCircleArcSegment
29  
30 Returns a LineString object.
31  
32 my $list=$folder->GreatCircleArcSegment(
33 startPoint=>{lat=>39,lon=>-77},
34 endPoint=>{lat=>40,lon=>-76});
35 my @list=$folder->GreatCircleArcSegment(
36 name=>"My Great Circle", #name passed through to LineString
37 startPoint=>{lat=>39,lon=>-77},
38 endPoint=>{lat=>40,lon=>-76},
39 span=>5000);
40  
41 startPoint and endPoint can be any valid scalar structure supported by GPS::Point->newMulti() constructor
42  
43 =cut
44  
45 0 ▶sub GreatCircleArcSegment {
Subroutine GreatCircleArcSegment: not called CC=4 SCAR=27.2
Pod documented
46 0 my $self=shift; #$self isa Geo::GoogleEarth::Pluggable::Folder object
47 0 my %data=@_;
48 0 ▶ my $span=delete($data{"span"})||10000; #meters
Condition0%0/2
delete $data{'span'} || 10000
l!l
00
MC/DC0%0/1
delete $data{'span'} || 10000
delete $data{'span'}
Truth table0%0/2
A
A= delete $data{'span'}
Aresult
11
00
49  
50 0 my $pt=[]; #list of GPS::Point objects
51 0 $pt->[0] = GPS::Point->newMulti(delete($data{"startPoint"}));
52 0 my $end = GPS::Point->newMulti(delete($data{"endPoint"}));
53  
54 0 my ($faz, $baz, $dist)=$pt->[0]->distance($end); #requires Geo::Inverse
55 0 $pt->[0]->heading($faz);
56 0 $end->heading($baz-180);
57  
58 0 my $n=int($dist/$span);
59 0 ▶ $n=2 if $n < 2;
Branch: 1 branch
BranchTrueFalseTotal
if $n < 2 0 0 0
60 0 $span=$dist/$n;
61  
62 1 ▶ use Geo::Forward;
Subroutine BEGIN: called CC=1 SCAR=0.0
63 0 my $gf=Geo::Forward->new;
64 0 foreach my $i (1 .. $n-1) {
65 0 my ($lat,$lon,$baz) = $gf->forward($pt->[$i-1]->latlon,$faz,$span);
66 0 $pt->[$i]=GPS::Point->new(lat=>$lat, lon=>$lon);
67 0 $faz=$baz+180;
68 }
69  
70 0 $pt->[$n]=$end;
71 0 $data{"coordinates"}=$pt;
72 0 return $self->LineString(%data);
73 }
74  
75 =head1 BUGS
76  
77 Log on RT and send to geo-perl email list
78  
79 =head1 SUPPORT
80  
81 =head1 AUTHOR
82  
83 Michael R. Davis
84 CPAN ID: MRDVT
85 STOP, LLC
86 domain=>michaelrdavis,tld=>com,account=>perl
87 http://www.stopllc.com/
88  
89 =head1 COPYRIGHT
90  
91 This program is free software licensed under the...
92  
93 The BSD License
94  
95 The full text of the license can be found in the
96 LICENSE file included with this module.
97  
98 =head1 SEE ALSO
99  
100 =cut
101  
102 1 1;
↑ Summary