1Astro-SpaceTrack is Copyright (C) 2005-2021 by Thomas R. Wyant, III 2 3DESCRIPTION 4 5This library logs in to the Space Track web site and downloads orbital 6elements. It is also capable of accessing other sources of satellite 7orbital elements. It does nothing that you can't do with a web browser, 8but it does give you a way to automate things. 9 10Note that you are required to register for a username and password before 11making use of the Space Track web site. 12 13FEDERAL LAW FORBIDS THE REDISTRIBUTION OF DOWNLOADED ORBITAL ELEMENTS 14TO THIRD PARTIES WITHOUT PRIOR PERMISSION. 15 16At some point along its career, this module has been seen to work under 17the following operating systems (or, more correctly, values of $^O): 18cygwin, darwin, MacOS, MSWin32, and VMS. CPAN Testers 19(http://testers.cpan.org/) adds Linux and Freebsd to the list. 20 21INSTALLATION 22 23This module is installable by the usual incantation: 24 25 gunzip Astro-SpaceTrack-9.999.tar.gz 26 tar -xf Astro-SpaceTrack-9.999.tar 27 perl Makefile.PL 28 make 29 make test 30 make install 31 32You should substitute the appropriate program name for 'make', eg nmake 33(typically) under MSWin32, or mms or mmk under VMS. See 34ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe for a copy of 35nmake for MSWin32 if you need it. 36 37If your tar supports it, you can use the -z qualifier (i.e. 'tar -xzf') 38and skip the 'gunzip' step. You can also skip 'make' if you do 'make 39test', since 'make test' implies 'make'. 40 41The 'make test' step of the installation will ask you for your Space 42Track username and password. This prompt can be supressed in a number 43of ways: 44 * Set environment variable AUTOMATED_TESTING to a true value. This 45 will cause all tests that access the Space Track web site to be 46 skipped. 47 * Set environment variable SPACETRACK_USER to your username, a slash, 48 and your password. If you do this incorrectly, the tests that access 49 the Space Track website will fail. 50 51If you do not have a Space Track account, a return when prompted for 52your username will also cause the tests that access the Space Track 53database to be skipped. 54 55Note that once you have done the "make" step you can play with either of 56the two specimen applications provided (SpaceTrack for a command-line 57version, or SpaceTrackTk for the Perl/Tk windowed version). If you want 58to do this before installing, you need to invoke them as (e.g.) 59 $ perl -Mblib script/SpaceTrack 60Under VMS, you'll need to quote the -M thus: 61 $ perl "-Mblib" script/SpaceTrack 62 63By default, Makefile.PL will ask you whether you want the SpaceTrack 64and/or SpaceTrackTk applications installed. It supports two 65command-line qualifiers: 66 -n to answer all questions "no", and 67 -y to answer all questions "yes". 68You must not specify both of these, because if you do it will confuse 69the bejeebers out of Makefile.PL, and it will die horribly. 70 71Of course, since it's pure Perl, you can just expand the kit and drop 72SpaceTrack.pm and the SpaceTrack folder into the Astro directory 73(creating it if necessary) in the appropriate place in your @INC 74directories. Read Makefile.PL for how to generate the applications. 75 76LICENSING INFORMATION 77 78This package is free software; you can redistribute it and/or modify it 79under the same terms as Perl 5.10.0. For more details, see the full text 80of the licenses in the directory LICENSES. 81 82This program is distributed in the hope that it will be useful, but 83without any warranty; without even the implied warranty of 84merchantability or fitness for a particular purpose. 85