1Astro-App-Satpass2 is Copyright (C) 2009-2021 by Thomas R. Wyant, III 2 3This package contains an application to predict satellite visibility, 4using the Astro::Coord::ECI classes. The following classes are included: 5 6Astro::App::Satpass2 - The application class; 7Astro::App::Satpass2::ParseTime - Base class for time parsing; 8Astro::App::Satpass2::ParseTime::ISO8601 - Standalone ISO-8601-ish time parser; 9Astro::App::Satpass2::ParseTime::Date::Manip - Date::Manip parser base; 10Astro::App::Satpass2::ParseTime::Date::Manip::v5 - Date::Manip v5 parser; 11Astro::App::Satpass2::ParseTime::Date::Manip::v6 - Date::Manip v6 parser; 12Astro::App::Satpass2::Copier - Base class for the helper classes; 13Astro::App::Satpass2::Format - Base class for the output formatters; 14Astro::App::Satpass2::Format::Dump - Output dumper (for debugging); 15Astro::App::Satpass2::FormatTime - Base class for formatting times; 16Astro::App::Satpass2::FormatTime::Cldr - Manifest constants for cldr formatting; 17Astro::App::Satpass2::FormatTime::DateTime - DateTime common code; 18Astro::App::Satpass2::FormatTime::DateTime::Cldr - DateTime cldr formatting; 19Astro::App::Satpass2::FormatTime::DateTime::Strftime - DateTime strftime fmtg; 20Astro::App::Satpass2::FormatTime::POSIX::Strftime - POSIX strftime fmtg; 21Astro::App::Satpass2::FormatTime::Strftime - Manifest const for strftime fmtg; 22Astro::App::Satpass2::Utils - Utility functions needed by other modules; 23Astro::App::Satpass2::Warner - Manage how warnings are formatted. 24 25In addition, a 'satpass2' script is included, which simply uses 26Astro::App::Satpass2 and passes @ARGV to its run() method. 27 28There is also an Astro::App::Satpass2::TUTORIAL to help get started. 29 30There were several motivations for this package: 31 32* There was no good way to test the 'satpass' script that was included 33 in the Astro-satpass package. Restructuring it as an object made 34 testing easier; in fact, several bugs were found in 'satpass' while 35 writing this module. 36 37* Making a break with the old 'satpass' script gave the opportunity to 38 rethink a couple implementation decisions in the light of experience, 39 and drop obsolete functionality such as the SIMBAD 3 interface and the 40 associated setting to determine which SIMBAD interface to use. This 41 means that 'satpass2' is not quite command-compatable with 'satpass'. 42 The Astro::App::Satpass2 documentation describes the differences. 43 44* The output formatting of the 'satpass' script is not very flexable. 45 46* The dependencies of the 'satpass' script are significantly different 47 than those of the Astro::Coord::ECI classes. Separating the two (with 48 eventual abandonment of the Astro-satpass package in favor of an 49 Astro-Coord-ECI package without the 'satpass' script) means that 50 people only interested in the Astro::Coord::ECI classes will not have 51 to drag along the dependencies of the script. 52 53INSTALLATION 54 55Most Perl users will want to install using their favorite of either 56'cpan' or 'cpanp'. For either of these, installing Astro::App::Satpass2 57gets you everything. ActivePerl users will want to use ActiveState's 58'ppi', and install Astro-App-Satpass2. 59 60If for some reason none of these works for you, you can download the 61distribution and expand it using something like 62 63 tar -xzf Astro-App-Satpass2-9.999.tar.gz 64 65Users of MSWin32 (and perhaps other operating systems) may need to 66convert the line endings in the expanded files from Unix to their native 67system before proceeding. 68 69Then, issue one of the following two incantations: 70 71 perl Makefile.PL 72 make 73 make test 74 sudo make install 75 76or 77 78 perl Build.PL 79 ./Build 80 ./Build test 81 sudo ./Build install 82 83You should substitute the appropriate program name for 'make', eg nmake 84(typically) under MSWin32, or mms or mmk under VMS. See 85ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe for a copy of 86nmake for MSWin32 if you need it. 87 88Unix users may want to use 'su' rather than 'sudo' for the install. 89Non-unix users may need to be logged in to an administrative or 90otherwise privileged accout, and turn on privileges (if applicable) for 91the install. 92 93Of course, since it's pure Perl, you can just expand the kit and drop 94the .pm files into the App directory (creating it if necessary) in the 95appropriate place in your @INC directories. 96 97LICENSING INFORMATION 98 99This package is free software; you can redistribute it and/or modify it 100under the same terms as Perl 5.10.0. For more details, see the full text 101of the licenses in the directory LICENSES. 102 103This program is distributed in the hope that it will be useful, but 104without any warranty; without even the implied warranty of 105merchantability or fitness for a particular purpose. 106