File Coverage

lib/Astro/Montenbruck.pm
Criterion Covered Total %
statement 8 8 100.0
branch n/a
condition n/a
subroutine 3 3 100.0
pod n/a
total 11 11 100.0


line stmt bran cond sub pod time code
1             package Astro::Montenbruck;
2 1     1   92322 use 5.22.0;
  1         3  
3 1     1   4 use strict;
  1         2  
  1         17  
4 1     1   4 use warnings;
  1         1  
  1         47  
5              
6             our $VERSION = 1.26;
7              
8             1;
9             __END__
10              
11              
12             =pod
13              
14             =encoding UTF-8
15              
16             =head1 NAME
17              
18             Montenbruck - Lightweight Ephemeris
19              
20             =head1 DESCRIPTION
21              
22             Library of astronomical calculations, based mainly on
23             I<"Astronomy On The Personal Computer"> by I<O.Montenbruck> and I<T.Phleger>,
24             I<Fourth Edition, Springer-Verlag, 2000>.
25              
26             There are many astronomical libraries available in the public domain. While
27             giving accurate results, they often suffer from lack of convenient API,
28             documentation and maintainability. Most of the source code is written in C, C++
29             or Java, and not dynamic languages. So, it is not easy for a layman to customize
30             them for her custom application, be it an online lunar calendar, or tool for
31             amateur sky observations. This library is an attempt to find a middle-ground
32             between precision on the one hand and compact, well organized code on the other.
33              
34             =head2 Accuracy
35              
36             As authors of the book state, they have tried to obtain an accuracy that is
37             approximately the same as that found in astronomical yearbooks.
38              
39             "The errors in the fundamental routines for determining the coordinates
40             of the Sun, the Moon, and the planets amount to about 1″-3″."
41              
42             -- Introduction to the 4-th edition, p.2.
43              
44             =head1 MODULES
45              
46             =over
47              
48             =item * L<Astro::Montenbruck::MathUtils> — Core mathematical routines.
49              
50             =item * L<Astro::Montenbruck::Time> — Time-related routines.
51              
52             =item * L<Astro::Montenbruck::Ephemeris> — Positions of celestial bodies.
53              
54             =item * L<Astro::Montenbruck::CoCo> — Coordinates conversions.
55              
56             =item * L<Astro::Montenbruck::NutEqu> — Nutation and obliquity of ecliptic.
57              
58             =item * L<Astro::Montenbruck::RiseSet> — Rise, set, transit and twilight times.
59              
60             =item * L<Astro::Montenbruck::Lunation> — Lunar phases.
61              
62             =item * L<Astro::Montenbruck::SolEqu> — Solstices and equinoxes
63              
64             =back
65              
66              
67             =head1 HOW TO CONTRIBUTE
68              
69             The project is also hosted on Github. Please, visit L<https://github.com/skrushinsky/astro-montenbruck>.
70             You may contribute to the project by many different ways, starting from refining and correcting its documentation,
71             especially if you are a native English speaker, and ending with improving the code base. Any kind of testing and
72             suggestions are welcome.
73              
74             You may follow the standard Github procedures or, in case you are not comfortable with them, just send your suggestions
75             to the author by email.
76              
77             =head1 AUTHOR
78              
79             Sergey Krushinsky, C<< <krushi at cpan.org> >>
80              
81             =head1 COPYRIGHT AND LICENSE
82              
83             Copyright (C) 2010-2022 by Sergey Krushinsky
84              
85             This library is free software; you can redistribute it and/or modify
86             it under the same terms as Perl itself.
87              
88             =cut