-
Notifications
You must be signed in to change notification settings - Fork 0
/
Changes
2511 lines (1673 loc) · 83.1 KB
/
Changes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
0.131 2024-03-16 T. R. Wyant
Deprecate Astro::Coord::ECI::Utils subroutines date2epoch() and
epoch2datetime().
Deal with POSIX::strftime() behavior change in Perl 5.38.9, which
made formatting GMT times problematic.
Refurbish some of the eg/* scripts which have not kept track with
API changes of various sorts.
Correct bug in ::TLE->__make_tle_epoch(). The fractional part was
wrong for negative epochs.
Updates to canned magnitude table.
Move all tests that BAIL_OUT() into t/basic.t.
0.130 2023-10-07 T. R. Wyant
Update magnitude table to track Kelso visual.txt.
Track Mike McCants' web site move.
0.129 2023-03-11 T. R. Wyant
Add 53807 Bluewalker 3 to canned magnitudes.
Conditionalize canned magnitude test on environment variable so it
does not run every time I want to do an authortest.
Correct handling of Celestrak-format JSON TLE data. This mostly
involved the OBJECT_ID (International designator), and the fact that
Celestrak does not provide EPOCH_MICROSECONDS, instead merging it
into the EPOCH item as an ISO date/time with a decimal fraction on
the end.
0.128 2022-10-02 T. R. Wyant
Localize $_ before while(<>).
0.127 2022-08-12 T. R. Wyant
Heavens-Above updates magnitude of Chinese Space Station.
Kelso adds 29093 to his visual satellite list.
0.126 2022-07-03 T. R. Wyant
Kelso drops OID 26102, adds 51842 to his visible objects lists,
which forms the basis for the canned magnitude table. The latter has
no magnitude yet.
0.125 2022-06-14 T. R. Wyant
Add canned magnitude of 26102 (MTI)
0.124 2022-05-21 T. R. Wyant
Use Heavens Above as the source of canned absolute magnitudes.
0.123 2022-04-09 T. R. Wyant
Fix truncation problem in rad2dms(). You can now specify your own
degree sign as the third argument to this subroutine. The default
is the Unicode degree sign, "\N{U+00B0}".
Fix similar potential truncation problem in rad2hms().
0.122 2021-11-10 T. R. Wyant
Add CONTRIBUTING file
Document demise of Willmann-Bell and the transfer of their assets to
Sky and Telescope.
0.121 2021-08-08 T. R. Wyant
Fix implementation of Borkowski's algorithm for converting
geocentric to geodetic coordinates. An edge case in my
implementation resulted in a divide-by-zero error at geocentric
latitude 90 degrees. Thanks to Jason Venner for reporting this
issue.
Address divide-by-zero in azel() velocity calculation when range is
0. Because some effort has been made to provide a position result
in this case (rather than an error), I decided that since the
velocity is undefined in this case I would just not return it.
Thanks to Jason Venner for reporting this issue.
Correct generation of 'provides' metadata. Thanks to Favio Poletti
for blogging
https://github.polettix.it/ETOOBUSY/2021/06/15/the-real-pause-workaround/,
and ultimately to Joel Berger for the pointer to
https://metacpan.org/pod/CPAN::Meta::Spec#no_index
0.120 2021-05-20 T. R. Wyant
Use Heavens-Above intrinsic magnitude for Tianhe and the ISS.
Tweak Math Doctors acknowledgement for haversine article recovery.
0.119 2021-04-16 T. R. Wyant
Update haversine link to point to "The Math Doctors" web site
Fix clone(), and test to ensure it stays fixed.
0.118 2021-04-01 T. R. Wyant
Add rt.cpan.org back to bug reporting methods. Long live RT!
Refactor authortest into three, to eliminate the need for stub files
to test without optional modules.
Remove references to the NASA Human Space Flight web site, since it
has been taken down.
Fix broken POD links. Most were in script/satpass, but the "Ask Dr.
Math" link on haversines is also gone, because the teachers'
association that took it over from Drexel has decided that their
function is to restrict knowledge, not disiseminate it.
Get prerequisites up to snuff, and add xt/author/prereq.t to ensure
they stay that way.
0.117 2021-01-01 T. R. Wyant
Fix bug in Astro::Coord::ECI::Sun next_quarter(). This bug was
introduced in version 0.089 (released 2018-02-02) when I replaced an
iterative calculation with Meeus' closed-form algorithm. The bug was
in my interface to Meeus' algorithm, and manifested only between the
last quarter and the end of the year. It did not manifest if you set
Sun attribute 'iterate_for_quarters', which caused the old algorithm
to be used.
Use GitHub as bug tracker. R.I.P. rt.cpan.org.
Add Travis CI testing.
Remove Tiangong 2 from canned magnitude table
0.116 2020-09-10 T. R. Wyant
Remove all mention of subs nutation_*, obliquity, and friends, which
were defined in Astro::Coord::ECI::Utils. These were replaced by
methods.
0.115 2020-08-19 T. R. Wyant
Remove prototypes from testing subroutines defined in t/*.t and
inc/My/Module/Test/*.pm
Update canned satellite magnitude table.
0.114 2020-06-25 T. R. Wyant
Document undef as argument to equation_of_time()
Update canned magnitude table per Kelso.
Correct heliocentric_ecliptic*(), I hope. I don't have worked
examples, but at least the current computation is sane in that the
heliocentric coordinates of the Earth are the complement of the
geocentric coordinates of the Sun.
0.113 2020-03-07 T. R. Wyant
Subroutines equation_of_time(), nutation_in_longitude(),
nutation_in_obliquity(), and obliquity() are now fatal. They were
deprecated in favor of Astro::Coord::ECI methods equation_of_time(),
nutation(), and obliquity(). The reason for the change was to allow
classes access to higher-precision versions of these calculations if
desired (e.g. the Astro::Coord::ECI::VSOP87D::* classes).
0.112 2020-01-26 T. R. Wyant
Add Astro::Coord::ECI::Utils subroutines greg_time_gm() and
greg_time_local(), which convert date and time into epoch time.
Unlike time_gm() and time_local() (which interpret the year however
Time::Local timegm() and timelocal() do), the new routines always
interpret the year as Gregorian. The older routines are now
discouraged, and have been eliminated in this package's code.
0.111 2020-01-11 T. R. Wyant
Fix Y2020 bug.
The problem here was Time::Local's weird handling of years less 100,
which is inconsistent with the gmtime() and localtime() built-ins, to
wit: years less than 100 are considered to be within 50 years of the
current year. As of January 1 2020, 70 became no longer 1970 (the usual
epoch year) but 2070.
As far as I can determine the only impact was in a test that contained
an adjustment for systems that might have a non-Unix epoch.
The solution was to specify a four-digit year in the test, and to use
Time::Local's timegm_modern() and timelocal_modern() where available.
Thanks to Chris Williams (BINGOS), who uncovered this in one of his CPAN
tester systems.
CPAN TESTERS ROCK!
Suppress 'Ambiguous use of -PIOVER2' under 5.10.1. Thanks to Chris
Williams (BINGOS) for finding this.
Eliminate redirections in POD URL links
0.110 2019-10-04 T. R. Wyant
Validate horizon and almanac_horizon. This is pretty much the same
situation as twilight -- they were completely unvalidated, but are
now restricted to the range - PI/2 to PI/2 radians, inclusive.
0.109 2019-09-08 T. R. Wyant
Further deprecate nutation and obliquity subroutines in favor of the
same-named methods. Subroutine calls now always result in a warning.
In six months they will be fatal.
0.108 2019-08-29 T. R. Wyant
Validate 'twilight' attribute. It must be between -PI/2 and PI/2
inclusive. Thanks to Kay Kilpatrick for bringing this to my
attention.
Correct eval() check in load_module().
0.107 2019-08-03 T. R. Wyant
Fix broken POD links and add a test to ensure they stay fixed.
Add low-level subroutine position_angle() to
Astro::Coord::ECI::Utils.
Allow station argument to equatorial_apparent() method.
0.106 2019-05-13 T. R. Wyant
Added some canned satellite magnitudes, mostly in the range of 4.5
to 5 or so.
0.105 2019-03-19 T. R. Wyant
Require at least Scalar::Util 1.22. With profound thanks to Nigel
Horne for testing on versions of Perl old enough to expose the need
for this.
0.104 2019-03-09 T. R. Wyant
Correct error message definition in sgp4r().
Have the null model return its invocant.
Nutation and obquity subroutines now warn on first use. These (and
equation_of_time(), which uses them) are deprecated in favor of the
relevant methods. The motivation was to allow higher-accuracy
implementations where appropriate (e.g.
Astro::Coord::ECI::VSOP87D::*).
Try to kill undef errs in 'brightest' calc.
Correct version in Southern-hemisphere and ::Utils deprecation
notices.
Add eg/maidenhead
Make ::TLE::Iridium optional in script/satpass
0.103 2018-11-03 T. R. Wyant
RT 127488: Load default Sun class before use
This actually manifested in RT 127463 against SVG-Calendar. The smallest
self-contained piece of code to tickle this is
use Astro::Coord::ECI;
Astro::Coord::ECI->new()->get( 'sun' );
The bug was introduced (or maybe just exacerbated) in version 0.100_01,
which was where I added support for alternate Sun classes. In the course
of this, 'use Astro::Coord::ECI::Sun' was dropped from
Astro::Coord::ECI::Moon and Astro::Coord::ECI::Star. The former is
involved in the SVG-Calendar problem.
Thanks to Slaven Rezic for spotting this in his smoker, submitting the
original RT ticket, and adding me to it with the note that it seemed
only to be a problem with recent versions of Astro-satpass.
0.102 2018-09-24 T. R. Wyant
Almanac descriptions are now sensitive to object name. That is to
say, if for some reason you designate a different name for the Sun,
almanac descriptions will reflect that.
The mutator for the 'sun' attribute now requires the new value to be
a member of $self->SUN_CLASS(), rather than SUN_CLASS. This way a
subclass can place more stringent restrictions on it.
Also it turns out that the 'sun' attribute was never documented. So it
is now.
0.101 2018-09-07 T. R. Wyant
Move nutation, obliquity, equation_of_time to Astro::Coord::ECI.
They become methods rather than subroutines so that they can be
overridden when higher accuracy is needed.
Install @CARP_NOT in all modules.
Have Moon and Star use correct Sun object for phase, aberration
Have the Sun's 'sun' attribute be itself. Access to it returns the
invocant, and mutations are ignored.
Add Utils functions rad2dms() and rad2hms()
In the script/satpass script, update all contained objects when the
'illum' or 'sun' settings are changed.
0.100 2018-07-22 T. R. Wyant
Add non-TLE attributes as optional hash reference to parse().
Actually, this already worked for traditional TLEs, it just needed
to be documented. But it needed to be added to the JSON code.
Fix $eci->set( sun => ... ). The mutator was not in fact setting the
new value of the attribute. Included in this is support for changing
the static (i.e. default) value of the attribute.
Make singleton Sun & Moon per-class. This is so that you always get
back the same class you requested if there is more than one class
that can represent each body (say, at different accuracies).
Pull out Astro::Coord::ECI::TLE::Iridium as separate distribution.
The canned statuses went with it.
0.099 2018-06-29 T. R. Wyant
Canned status update:
- Iridium 41 failed
- Iridium 65 spare
- Iridium 67 failed
- Iridium 75 failed
- Iridium 81 failed
Move iridium status setup to Astro::Coord::ECI::TLE::Iridium. This
is in preparation for spinning off that module into its own package.
0.098 2018-06-16 T. R. Wyant
Canned status update:
- Iridium 18 failed
- Iridium 67 spare
- Iridium 68 decayed
- Iridium 75 spare
0.097 2018-06-04 T. R. Wyant
Large canned status update:
- Iridium 7 failed
- Iridium 11 spare
- Iridium 15 spare
- Iridium 18 spare
- Iridium 21 decayed
- Iridium 31 spare
- Iridium 37 decayed
- Iridium 39 failed
- Iridium 46 failed
- Iridium 47 spare
- Iridium 55 spare
- Iridium 58 spare
- Iridium 61 spare
- Iridium 62 spare
- Iridium 68 failed
- Iridium 81 spare
- Iridium 90 failed
- Iridium 96 failed
- Iridium 97 spare
Decays are from Space Track. Other status changes are from Dr. T. S.
Kelso's Celestrak web site. "Spare" conflates several Celestrak
statuses; the above spares are typically "[B]" (backup) or "[P]" (partly
operational).
0.096 2018-05-23 T. R. Wyant
Link to metacpan.org rather than search.cpan.org.
Canned status updates:
- Decay of Iridium 25
- Decay of Iridium 72
- Iridium 64 now spare per Kelso
- Iridium 66 now spare per Kelso
- Iridium 68 now spare per Kelso
- Iridium 71 now spare per Kelso
0.095 2018-05-08 T. R. Wyant
Iridium 13 decayed. Canned status update.
0.094 2018-04-27 T. R. Wyant
Kelso drops Tiangong 1 from visual.txt. This results in a change to
the canned magnitude table.
Update canned Iridium status table for:
- Decay of Iridium 19 and 94;
- Mark Iridiums 29, 33, and 72 spare per Kelso.
Prefer /[0-9]/ to /\d/ for matching digits. The latter matches
non-ASCII digits as well as ASCII ones, but the former is what I
want, because usually once there is a match numeric conversion
happens.
0.093 2018-04-05 T. R. Wyant
Iridium 23 decayed March 28 2018. This necessitates updating all the
canned Iridium status tables.
Kelso marks Iridiums 12, 13 & 76 partly operational. This translates
to "SPARE" in the Iridium status table.
0.091 2018-03-10 T. R. Wyant
Kelso marks Iridium 94 as partly operational. Updated canned status
to call it spare.
Use manifest constants for reference types. That is, instead of
'ARRAY', use ARRAY_REF, defined using 'use constant', and so on.
0.090 2018-02-22 T. R. Wyant
Update canned Iridium status table for decay of Iridiums 3, 43 and
49, and making 3, 23, and 46 spare per Kelso.
0.089 2018-02-02 T. R. Wyant
Kelso marks Iridiums 3, 37, 49 as "P" ("partly operational"). This
is "spare" in my classification. Sladen calls 3 failed, but I'm
using the Kelso data in the canned status table in
Astro::Coord::ECI::TLE.
Fix problem with Astro::Coord::ECI::Sun when Time::y2038 used.
New algorithm for equinoxes and solstices. The new algorithm is from
Jean Meeus' "Astronomical Algorithms." 2nd edition, chapter 27
("Equinoxes and Solstices"), and should be more accurate, at least
for reasonably current times.
If you want the old iterative algorithm back, you can set new
attribute 'iterate_for_quarters' to a true value.
Correct typo in calculation of Sun's postion. The correction
produced no change in the equinoxes and solstices calculated by
iteration.
Add eg/usno-seasons. This displays equinoxes and solstices for a
given year, both as computed by Astro::Coord::ECI::Sun and as
downloaded from the United States Naval Observatory.
0.088 2018-01-16 T. R. Wyant
Iridium 34 decayed January 8 2017. So marked in canned status.
0.087 2017-12-30 T. R. Wyant
Iridium 6 decayed December 23 2017. Update canned status for this.
Kelso marks Iridium 34 tumbling, 96 partial December 22 2017. Update
canned status for this.
Kelso marks Iridiums 6, 19 & 22 as tumbling. Canned status table
updated to reflect this.
0.086 2017-12-06 T. R. Wyant
Mark Iridium 8 as decayed in canned status table.
0.085 2017-11-24 T. R. Wyant
Kelso says Iridiums 5, 8, and 51 are tumbling. Canned status updated
to reflect this.
0.084 2017-10-12 T. R. Wyant
Add support for decayed Iridium satellites:
* Carry them in canned status table
* Have can_flare( 'all' ) return true regardless of satellite
status.
All this was triggered by Kelso's recognition that Iridium 77 had
decayed.
0.083 2017-09-13 T. R. Wyant
Add -decayed to eg/visual.
This eliminates decayed bodies. I decided not to remove these from
the magnitude table because of historical interest.
Kelso removes 38253 from visual.txt. Decayed 2017-08-18.
Kelso marks 25471 Iridium 77 failed
Kelso marks 24949 Iridium 30 failed
Kelso adds 33411 to visual.txt.
Kelso adds 11251 METEOR 1-29 to visual.txt
Use qsmag instead of mcnames to suppliment magnitudes in the canned
magnitude table. As of July 24 2017 mcnames appeared to be
double-compressed and corrupt besides. Both are maintained by Mike
McCants, but the former is input to his QuickSat program and so
likely to be less fragile. I hope. The mcnames file was eventually
corrected, but I am sticking with qsmag for now.
Kelso reports decay of Iridium 74.
0.082 2017-06-14 T. R. Wyant
Kelso reports Iridium 79 out of service.
0.081 2017-05-26 T. R. Wyant
Update canned magnitude table.
Deprecate McCants' status. His web page notes itself as no longer
maintained.
Document impending changes in Iridium support.
Kelso reports Iridiums 43 & 82 tumbling. Canned status changed in
Astro::Coord::ECI::TLE to reflect this.
0.079 2017-04-26 T. R. Wyant
Move satpass script from bin/ to script/
Mark OID 25041 (Iridium 40) tumbling, and 25042 (Iridium 41) spare
per Kelso. The latter appears to have actually been declared spare
in July 2016, but somehow I missed updating the canned status table.
Kelso added OID 16719 (COSMOS 1743) to magnitudes
0.078 2017-02-10 T. R. Wyant
Fix L<> links, and things that should have been L<> but were not.
Thanks to Ben Bullock for the pull request.
Add 'provides' data to ExtUtils::MakeMaker output
Add 'base' to dependencies.
0.077 2016-12-03 T. R. Wyant
Remove leading 0 from Space Track 3le names
Handle year incompatibility between Time::Local and Time::y2038
This is the same problem as RT #118861 on Astro-App-Satpass2, and I
applied the same solution. As a result of this,
Astro::App::Satpass2::Utils now exports time_gm() and time_local().
0.076 2016-11-06 T. R. Wyant
Clean up Changes file. Version 0.075 had raw Git log for changes.
Oops.
0.075 2016-11-06 T. R. Wyant
Add estimated magnitude for Tiangong 2.
Since I believe (per Wikipedia) that it is the same size as Tiangong 1,
I am estimating the same absolute magnitude (4.0).
0.074 2016-09-04 T. R. Wyant
Add HISTORICAL CALCULATIONS section to OVERVIEW.
Correct almanac_hash() methods when station is defaulted to the body's
station attribute rather than explicitly passed.
Add eg/solstice
0.073 2016-08-07 T. R. Wyant
Update Celestrak visual.txt date. No data change.
Update canned Iridium statuses and magnitudes in
Astro::Coord::ECI::TLE.
Tweak satpass script geocoding heuristics.
Tweak eg/visual for Perl 5.6.2.
0.072 2016-07-02 T. R. Wyant
Set canned status for Iridium 57 (OID 25273) failed per Kelso.
0.071 2016-01-06 T. R. Wyant
Add GitHub repository to metadata.
Change satpass script to geocode using OSM.
Also fix apparent bit rot in show command.
Correct Astro::Coord::ECI->next_elevation(). Elevation was being
calculated inconsistently, resulting in incorrect rise/set and
begin/end twilight results inside the Arctic and Antarctic Circles
on days when the Sun did not rise or set. This error may have been
introduced in March 2012 with version 0.049_01, though it may go
back to the original release. Thanks to Adam Osuchowski for finding
this.
0.070 2015-06-25 T. R. Wyant
The Astro::Coord::ECI::Sun almanac() method now returns the correct
quarter descriptions (equinox, solstice) when the 'station'
attribute is set to a location south of the Equator. The event
detail (which is encoded as a number) does not change, but is now
documented to refer to 'March equinox', and so on.
Add -date option to eg/almanac
0.069 2015-06-07 T. R. Wyant
Update canned status of Iridium 63 (OID 25286)
0.068 2015-03-26 T. R. Wyant
Make the satpass script time zone functionality work with Date::Manip
versions 6.49 and greater.
Track changes in Mike McCants' magnitude data.
0.067 2014-11-10 T. R. Wyant
Fix failure in t/tle_support.t. I hope.
Add OID 15494 to canned magnitude table.
0.066 2014-10-16 T. R. Wyant
Update Iridium 42 (OID 25077) to failed, per Kelso.
Regenerate canned magnitude table.
Croak on encountering JSON key SATNAME. This was replaced by
OBJECT_NAME during the REST interface's beta.
Remove installer question about installing satpass, per documented
deprecation schedule.
0.065 2014-07-27 T. R. Wyant
Prevent TLE manufacture for oddball objects.
Add TLE pass variant PASS_VARIANT_TRUNCATE, which truncates passes to
the beginning and end times given to pass(), rather then computing
complete passes (and therefore requiring the satellite to rise and
set).
Expose Space Track time formatting and decoding routines for possible
use by subclasses. The key routines __to_json() and __from_json()
are still undocumented and considered highly experimental, though.
Sorry.
Add OID 00694 to Astro::Coord::ECI::TLE canned magnitudes.
0.064 2014-05-29 T. R. Wyant
Add Astro::Coord::ECI::TLE method illuminated()
0.063 2014-05-02 T. R. Wyant
Allow PASS_VARIANT_BRIGHTEST event even if the 'visible' attribute is
false.
Document magnitude functionality in satpass script.
Add pass variant PASS_VARIANT_BRIGHTEST. If this is set, an event
representing the time the satellite is brightest will be added to
the pass. This is ignored if the calculation can not be made (e.g.
if 'visible' is false, or 'intrinsic_magnitude' is undefined).
Clarify Astro::Coord::ECI::Moon phase() docs.
Eliminate uses of each() built-in.
Add magnitude functionality to satpass script.
0.062 2014-04-01 T. R. Wyant
Update canned status for Iridium 29 (24944). Kelso says it's tumbling.
t/tle_json.t now only dumps versions on an error.
Require correct Perl version in t/tle_mag.t
In t/tle_json.t, work around problem that occurs when JSON::XS encodes
a number in a locale that uses a comma as the decimal point, such as
'de_DE.UTF-8'. Make a note of this in Astro::Coord::ECI::TLE, since
there is nothing I can do in my code to actually fix the problem.
The 'unpack' built-in does not default to $_ as the buffer to unpack
under Perls before 5.10.
Have Astro::Coord::ECI::TLE magnitude() method set the station's time.
Correct logic for building the fold_case() utliity subroutine under
Perls before 5.16.
Computation of (perhaps very) approximate magnitudes for satellites is
now supported. Changes to support this include:
- A magnitude() method on all classes that represent satellites;
- An intrinsic_magnitude attribute (defaulting to undef) on
Astro::Coord::ECI::TLE objects;
- Default intrinsic_magnitude to 7 on
Astro::Coord::ECI::TLE::Iridium objects;
- A canned table of intrinsic magnitudes in Astro::Coord::ECI::TLE
which includes most of the objects in the Celestrak visual list,
with magnitudes from Mike McCants' mcnames.zip and vsnames.zip
files;
- Support in the Astro::Coord::ECI::TLE parse() method to set the
magnitude of satellites that are in the table;
- Static method magnitude_table() on Astro::Coord::ECI::TLE to
maintain the canned magnitude table;
- Modify the Astro::Coord::ECI::Sun magnitude() method to take an
observing station argument (which is ignored) to be consistent
with the same-named Astro::Coord::ECI::TLE method.
The precess() and precess_dynamical() methods now do nothing to
objects set to Earth-fixed coordinates. Previously they were
converted to Ecliptic (and therefore inertial) coordinates, which
manifested as a bug when the observing station was an attribute of a
star.
Support new (to us) Space Track JSON keys FILE, OBJECT_TYPE, ORDINAL
and ORIGINATOR with same-named (except for being lower case)
attributes.
Method body_type() now returns the 'object_type' attribute if that is
defined. If not it computes its return from the object name, like it
always has.
0.061 2014-01-13 T. R. Wyant
On install, warn that I intend to remove the 'install satpass'
question asked by Build.PL and Makefile.PL. The only way to install
the satpass script will be to run Build.PL or Makefile.PL with the
'-y' option. Also warn of eventual package name change, from
'Astro-satpass' to 'Astro-Coord-ECI'.
Warn every time Astro::Coord::ECI::TLE->parse() encounters JSON key
SATNAME. This was removed while Space Track's REST interface is
still in beta.
Computation of a Doppler shift based on the station's 'frequency'
attribute is now fatal. The body's 'frequency' attribute should be
set instead.
Remove all references to the satpass 'lit' setting and the
corresponding Astro::Coord::ECI 'limb' attribute, which were
deprecated out long since.
Remove all mention of the 'upper' argument to the Astro::Coord::ECI
azel() method. It's still an exception to pass a second argument,
though.
Remove all references to SOAP::Lite in the satpass code, except for
POD saying it was gone.
Various changes to Astro::Coord::ECI::TLE to try to support
prospective classes representing non-orbiting objects. These are
experimental, and may change or be retracted with little or no
notice. The hope is a class that can represent the objects in one of
NASA's .kmz files that are published for certain launches. These
include:
* Refactoring illumination and periodic position calculations in the
pass() method;
* Add public method intrinsic_events(), which returns events
intrinsic to the body, rather than observational ones like rise
and set, and call it in the pass() method;
* Add protected (and therefore doubly experimental) method
__pass_backup_earliest() to limit how hard the pass() method tries
to find a rise time when the pass starts with the body above the
horizon.
I have no idea whether the class this is in support of will ever see
the light of day.
Improve Astro::Coord::ECI::Utils::find_first_true() documentation.
0.060 2013-12-18 T. R. Wyant
In eg/almanac, correct the handling of -sun and -moon when exactly one
is specified. The erroneous processing forced both to be asserted
in all circumstances. Thanks to Mike Donn for reporting the
problem. and pointing out the solution.
0.059 2013-12-03 T. R. Wyant
Make the zero-argument form of the maidenhead() method conform to the
docs.
0.058 2013-11-25 T. R. Wyant
Handle undef period in pass(). At the moment it's handled by fudging in
90 minutes, which is bogus, but lets me experiment objects whose
motion is defined by a list of positions.
Add a paragraph on how passes are detected to the
Astro::Coord::ECI::TLE pass() documentation.
In the satpass script, implement 'sky lookup' in terms of
Astro::SIMBAD::Client script() rather than query(), so that we do not
need SOAP::Lite.
0.057 2013-07-08 T. R. Wyant
Deprecate the satpass script.
Modify the appulse algorithm when the appulsing body is a satellite,
since the original algorithm did not necessarily converge to the
correct time for satellites in similar orbits. Thanks to Vidar
Tyldum for bringing this to my attention, and working with me on it.
Go back to simply allowing invalid international launch designators.
They started getting rejected about release 0.051_01 (2012-08-18).
Thanks to Vidar Tyldum for bringing this to my attention, and
working with me on it.
Take spaces as equivalent to zeroes in numeric fields (which I believe
is the old FORTRAN behavior), and in the numeric portions of the
international launch designator.
As a consequence of the above, the 'international' attribute will be
zero-filled on retrieval.
Update docs. Replace 'location' by 'station' where that is what is
meant. Add a (very brief) explanation of times to the overview. Also
add information on the Space Track REST interface to the overview.
Deprecations:
* The two-argument form of azel() is now fatal.
* The satpass script fails if you try to geocode without
Geo::Coder::Geocoder::US.
* Use of the satpass script 'lit' setting is now fatal; instead use
'edge_of_earths_shadow'.
* Use of the Astro::Coord::ECI::TLE 'limb' attribute is now fatal;
instead use 'edge_of_earths_shadow'.
* Feeding a JSON file to Astro::Coord::ECI::TLE->parse() which uses
the SATNAME key is deprecated, and produces a warning. This warning
will become fatal in the future. Instead use OBJECT_NAME.
* Warn every time a Doppler shift is computed using the station's
frequency. This will become fatal in the future. The frequency
should be set on the orbiting object.
0.056 2012-12-08 T. R. Wyant
Deprecation warnings:
* The Doppler calculation warns the first time the frequency comes
from the station rather than the satellite.
* The satpass script warns every time geocoding is done if
Geo::Coder::Geocoder::US is not installed.
0.055 2012-10-27 T. R. Wyant
Workaround for problem with Date::Manip clobbering $ENV{PATH} when it
is loaded.
T. S. Kelso recorded Iridium 4 (OID 24796) as being out of service
about midnight 20-Oct-2012 GMT. I have updated the canned status,
since I know he calls Iridium LLC to get the status.
Have the Astro::Coord::ECI::TLE status() method take optional OID
arguments for the 'show' subcommand.
0.054 2012-10-09 T. R. Wyant
Correct field TLE_LINE0 in the JSON TLE generated by
Astro::Coord::ECI::TLE to include the leading '0 '.
INCOMPATIBLE CHANGE: In the JSON representaion of a TLE, the common
name of the body is now OBJECT_NAME, not SATNAME. This was done to
track the usage of Space Track, which did not previously have the
common name in its TLE data. The SATNAME field will still be used if
it appears in input, but is being put through a deprecation cycle.
0.053 2012-09-10 T. R. Wyant
Suppress the 'OK' after an st( set => ...) in the satpass script.
Address satpass script Term::ReadLine load failures under the test
harness by doing the load in an eval, and falling back to the
non-ReadLine case.
Update the canned status table in Astro::Coord::ECI for the fact that
both Sladen and McCants call Iridium 51 (OID 25262) in service.
0.052 2012-09-05 T. R. Wyant
Per schedule, the following deprecated items will produce a warning on
each use:
* The 'upper' argument of the Astro::Coord::ECI azel() method;
* The Astro::Coord::ECI::TLE 'limb' attribute;
* The satpass 'lit' setting.
All these warnings will become fatal in the first release on or after
March 1 2013.
Remove support for the 'horizon' setting of the Astro::Coord::ECI
'almanac_horizon' attribute. This was introdiced in 0.051_01, but on
second thought I decided the 'horizon' logic was ill-conceived.
Change the JSON representation of the International Launch Designator
to track Space Track change by Space Track to REST predicate
INTLDES.
Further corrections to t/tle_json.t for OS-dependant failures.
Enhance Astro::Coord::ECI::TLE->parse() to parse Iridium status off
the name if it is present.
Fudge the JSON in t/tle_json.t for system-to-system differences in
floating point representations (2-digit vs 3-digit exponent).
Remove the -json output formatting option from the satpass tle()
command. Instead, provide eg/convert_tle.
Add attribute almanac_horizon to Astro::Coord::ECI. This sets the
horizon for almanac calculations. The default is 0 (radians), but
other values are possible, as well as 'horizon' (meaning, use the
value of the 'horizon' attribute) and 'height' (meaning, depress the
horizon for the height of the observer above sea level). The satpass
script allows access to this.
Add JSON support for Astro::Coord::ECI::TLE and
Astro::Coord::ECI::TLE::Iridium. This includes the ability of
Astro::Coord::ECI::TLE->parse() to handle JSON orbital elements from
the Space Track REST interface (provided the optional JSON module
can be loaded), and hooks in both classes for them to serialize
themselves into Space-Track-like JSON.
Add -json option to the satpass script's tle() command, to get
canonical JSON output.
Make use of DateTime (if available) to interpret a non-numeric
Astro::Coord::ECI::TLE::Iridium zone attribute. If DateTime is not
available, fall back to the old implementation of setting $ENV{TZ}
and hoping localtime() responds to this.
Correct the documentation of the Astro::Coord::ECI 'twilight'
attribute, which really can not be set to 'civil', etc.
0.051 2012-06-08 T. R. Wyant
Use YAML instead of YAML::Any, since they are both in the same distro,
and YAML does not suffer from deprecation warnings.
Add pass variant PASS_VARIANT_NO_ILLUMINATION. If attribute 'visible'
is false, this causes no illumination calculations at all to be
done. This seems to save 20% in calculation time, but your mileage
may vary, especially inside the Arctic or Antarctic Circles.
Have bin/satpass warn the first time it geocodes if geocoding is done
directly using SOAP::Lite.
Make the Astro::Coord::ECI azel_offset() Doppler calculation
contingent on the availability of a radial velocity value.
Reinstate the Doppler calculation in Astro::Coord::ECI's
azel_offset(). Thanks to Vidar Tyldum for finding this omission.
While in the Doppler code, made the satellite the primary source of
the frequency. Getting the frequency from the observer object is
being put through a deprecation cycle, and will eventually result in
an error.
0.050 2012-05-04 T. R. Wyant
The 'status iridium' command in the 'satpass' script is now fatal;
it has been deprecated in favor of 'status show' for some time,
issued a warning on every use since version 0.044.
Have Astro::Coord::ECI method heliocentric_ecliptic_cartesian() set
the object's {inertial} to true.
Add module Astro::Coord::ECI::Mixin to provide common-logic methods
which do not seem to fit the object hierarchy.
Promote method ecliptic_longitude() from Astro::Coord::ECI::Sun to
Astro::Coord::ECI.
In Astro::Coord::ECI:
* Add attribute 'sun', to hold the object used to convert to and
from Heliocentric coordinates.
* Add methods ecliptic_cartesian(), heliocentric_ecliptic(), and
heliocentric_ecliptic_cartesian().
* Consolidate code for conversion between Cartesian and spherical
coordinates.
In Astro::Coord::ECI::Set:
* Have the aggregate() method _not_ aggregate TLEs that have a blank
ID and model 'null'. This piece of ad-hocery was necessary to
prevent aggregation of "fake" TLEs representing different fixed
points in space (e.g. as created by the satpass or satpass2
'geodetic' command).
0.049 2012-03-12 T. R. Wyant
In the Astro::Coord::ECI precess_dynamical() method, set the time of
the station attribute (if any) before precessing it.
In Astro::Coord::ECI::TLE, throw an exception if the Sun never rises.
This should not happen, but was encountered while sorting out the
precess_dynamical() bug.
Independently test appulses of all relevant classes, since this is how
the precess_dynamical() bug manifested.
In Astro::Coord::ECI::TLE::Set, override the get() method, and have
get( 'tle' ) return the concatenated TLEs of all members.
In Astro::Coord::ECI::TLE::Iridium reflection() method, fix
two-argument azel() call.
0.048 2012-03-08 T. R. Wyant
Add keplers_equation() to Astro::Coord::ECI::Utils.
In the 'satpass' script's pass() subroutine, set the 'station'
attribute of all bodies in the @sky array before passing them to the
Astro::Coord::ECI::TLE pass() method.
In the Astro::Coord::ECI::TLE::Iridium flare() method, set the
'station' attribute of the object that represents the center of the
flare.
Have the first use of the Astro::Coord::ECI::TLE 'limb' attribute, the
satpass script 'lit' setting, and the Astro::Coord::ECI azel()
method with an 'upper' argument display a warning. These were
deprecated in September 2011.
In Astro::Coord::ECI:
* Have next_azimuth(), next_elevation(), and next_meridian() make use
of the 'station' attribute if the invocant is the only
Astro::Coord::ECI argument.