-
Notifications
You must be signed in to change notification settings - Fork 46
/
jpleph.cpp
1028 lines (899 loc) · 44.6 KB
/
jpleph.cpp
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
/* jpleph.cpp: JPL ephemeris functions
Copyright (C) 2011, Project Pluto
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301, USA. */
/*****************************************************************************
* ***** jpl planetary and lunar ephemerides ***** C ver.1.2 *
******************************************************************************
* *
* This program was written in standard fortran-77 and it was manually *
* translated to C language by Piotr A. Dybczynski ([email protected]), *
* subsequently revised heavily by Bill J Gray ([email protected]), just short *
* of a total re-write. *
* *
******************************************************************************
* Last modified: July 23, 1997 by PAD *
******************************************************************************
21 Apr 2010: Revised by Bill J. Gray. The code now determines the kernel
size, then allocates memory accordingly. This should 'future-proof' us in
case JPL (or someone else) creates kernels that are larger than the previously
arbitrary MAX_KERNEL_SIZE parameter. 'swap_long' and 'swap_double' have
been replaced with 'swap_32_bit_val' and 'swap_64_bit_val'. It also works
on 64-bit compiles now.
16 Mar 2001: Revised by Bill J. Gray. You can now use binary
ephemerides with either byte order ('big-endian' or 'small-endian');
the code checks to see if the data is in the "wrong" order for the
current platform, and swaps bytes on-the-fly if needed. (Yes, this
can result in a slowdown... sometimes as much as 1%. The function is
so mathematically intensive that the byte-swapping is the least of our
troubles.) You can also use DE-200, 403, 404, 405, or 406 without
recompiling (the constan( ) function now determines which ephemeris is
in use and its byte order).
Also, I did some minor optimization of the interp( ) (Chebyshev
interpolation) function, resulting in a bit of a speedup.
The code has been modified to be a separately linkable component, with
details of the implementation encapsulated.
*****************************************************************************/
#include <stdio.h>
#include <assert.h>
#include <math.h>
#include <string.h>
#include <stdlib.h>
#include <stdint.h>
/**** include variable and type definitions, specific for this C version */
#if !defined( __has_include)
#define __has_include(X) (1)
#endif
#if !(__has_include("get_bin.h"))
#error \
'get_bin.h' not found. This project depends on the 'lunar'\
library. See www.github.com/Bill-Gray/lunar .\
Clone that repository, 'make' and 'make install' it.
/* Just to make the error message cleaner, we'll suppress */
/* some warnings that cascade from lack of get_bin.h. */
#define get32bits(d) 0
#define get_double( iptr) 0.
#endif
#include "get_bin.h"
#include "jpleph.h"
#include "jpl_int.h"
#define TRUE 1
#define FALSE 0
double DLL_FUNC jpl_get_double( const void *ephem, const int value)
{
const struct jpl_eph_data *tptr = (const struct jpl_eph_data *)ephem;
double rval;
switch( value)
{
case JPL_EPHEM_START_JD:
rval = tptr->ephem_start;
break;
case JPL_EPHEM_END_JD:
rval = tptr->ephem_end;
break;
case JPL_EPHEM_STEP:
rval = tptr->ephem_step;
break;
case JPL_EPHEM_AU_IN_KM:
rval = tptr->au;
break;
case JPL_EPHEM_EARTH_MOON_RATIO:
rval = tptr->emrat;
break;
default:
rval = -1;
break;
}
return( rval);
}
long DLL_FUNC jpl_get_long( const void *ephem, const int value)
{
const struct jpl_eph_data *tptr = (const struct jpl_eph_data *)ephem;
long rval;
switch( value)
{
case JPL_EPHEM_N_CONSTANTS:
rval = tptr->ncon;
break;
case JPL_EPHEM_EPHEMERIS_VERSION:
rval = tptr->ephemeris_version;
break;
case JPL_EPHEM_KERNEL_SIZE:
rval = tptr->kernel_size;
break;
case JPL_EPHEM_KERNEL_RECORD_SIZE:
rval = tptr->recsize;
break;
case JPL_EPHEM_KERNEL_NCOEFF:
rval = tptr->ncoeff;
break;
case JPL_EPHEM_KERNEL_SWAP_BYTES:
rval = tptr->swap_bytes;
break;
default:
{
const int tval = value - JPL_EPHEM_IPT_ARRAY;
if( tval >= 0 && tval < 45)
rval = tptr->ipt[tval / 3][tval % 3];
else
{
rval = -1;
assert( rval);
}
}
break;
}
return( rval);
}
/*****************************************************************************
** jpl_pleph( ephem,et,ntar,ncent,rrd,calc_velocity) **
******************************************************************************
** **
** This subroutine reads the jpl planetary ephemeris **
** and gives the position and velocity of the point 'ntarg' **
** with respect to 'ncent'. **
** **
** Calling sequence parameters: **
** **
** et = (double) julian ephemeris date at which interpolation **
** is wanted. **
** **
** ntarg = integer number of 'target' point. **
** **
** ncent = integer number of center point. **
** **
** The numbering convention for 'ntarg' and 'ncent' is: **
** **
** 1 = mercury 8 = neptune **
** 2 = venus 9 = pluto **
** 3 = earth 10 = moon **
** 4 = mars 11 = sun **
** 5 = jupiter 12 = solar-system barycenter **
** 6 = saturn 13 = earth-moon barycenter **
** 7 = uranus 14 = nutations (longitude and obliq) **
** 15 = librations, if on eph. file **
** 16 = lunar mantle omega_x,omega_y,omega_z**
** 17 = TT-TDB, if on eph. file **
** **
** (If nutations are wanted, set ntarg = 14. **
** For librations, set ntarg = 15. set ncent= 0. **
** For TT-TDB, set ntarg = 17. I've not actually **
** seen an ntarg = 16 case yet.) **
** **
** rrd = output 6-element, double array of position and velocity **
** of point 'ntarg' relative to 'ncent'. The units are au and **
** au/day. For librations the units are radians and radians **
** per day. In the case of nutations the first four words of **
** rrd will be set to nutations and rates, having units of **
** radians and radians/day. **
** **
** The option is available to have the units in km and km/sec. **
** for this, set km=TRUE at the beginning of the program. **
** **
** calc_velocity = integer flag; if nonzero, velocities will be **
** computed, otherwise not. **
** **
*****************************************************************************/
int DLL_FUNC jpl_pleph( void *ephem, const double et, const int ntarg,
const int ncent, double rrd[], const int calc_velocity)
{
struct jpl_eph_data *eph = (struct jpl_eph_data *)ephem;
double pv[13][6];/* pv is the position/velocity array
NUMBERED FROM ZERO: 0=Mercury,1=Venus,...
8=Pluto,9=Moon,10=Sun,11=SSBary,12=EMBary
First 10 elements (0-9) are affected by
jpl_state(), all are adjusted here. */
int rval = 0;
const int list_val = (calc_velocity ? 2 : 1);
unsigned i;
int list[14]; /* list is a vector denoting, for which "body"
ephemeris values should be calculated by
jpl_state(): 0=Mercury,1=Venus,2=EMBary,...,
8=Pluto, 9=geocentric Moon, 10=nutations in
long. & obliq. 11= lunar librations;
12 = TT-TDB, 13=lunar mantle omegas */
for( i = 0; i < 6; ++i) rrd[i] = 0.0;
if( ntarg == ncent) return( 0);
for( i = 0; i < sizeof( list) / sizeof( list[0]); i++)
list[i] = 0;
/* Because of the whacko indexing in JPL ephemerides, we need */
/* to work out way through the following indexing schemes : */
/* ntarg ipt list */
/* 14 11 10 Nutations */
/* 15 12 11 Librations */
/* 16 13 12 Lunar mantle angular vel */
/* 17 14 13 TT - TDB */
for( i = 0; i < 4; i++)
if( ntarg == (int)i + 14)
{
if( eph->ipt[i + 11][1] > 0) /* quantity is in ephemeris */
{
list[i + 10] = list_val;
rval = jpl_state( ephem, et, list, pv, rrd, 0);
}
else /* quantity doesn't exist in the ephemeris file */
rval = JPL_EPH_QUANTITY_NOT_IN_EPHEMERIS;
return( rval);
}
if( ntarg > 13 || ncent > 13 || ntarg < 1 || ncent < 1)
return( JPL_EPH_INVALID_INDEX);
/* force barycentric output by 'state' */
/* set up proper entries in 'list' array for state call */
for( i = 0; i < 2; i++) /* list[] IS NUMBERED FROM ZERO ! */
{
const unsigned k = (i ? ncent : ntarg) - 1;
if( k <= 9) list[k] = list_val; /* Major planets */
if( k == 9) list[2] = list_val; /* for moon, earth state is needed */
if( k == 2) list[9] = list_val; /* for earth, moon state is needed */
if( k == 12) list[2] = list_val; /* EMBary state additionally */
}
/* make call to state */
rval = jpl_state( eph, et, list, pv, rrd, 1);
/* Solar System barycentric Sun state goes to pv[10][] */
if( ntarg == 11 || ncent == 11)
for( i = 0; i < 6; i++)
pv[10][i] = eph->pvsun[i];
/* Solar System Barycenter coordinates & velocities equal to zero */
if( ntarg == 12 || ncent == 12)
for( i = 0; i < 6; i++)
pv[11][i] = 0.0;
/* Solar System barycentric EMBary state: */
if( ntarg == 13 || ncent == 13)
for( i = 0; i < 6; i++)
pv[12][i] = pv[2][i];
/* if moon from earth or earth from moon ..... */
if( (ntarg*ncent) == 30 && (ntarg+ncent) == 13)
for( i = 0; i < 6; ++i) pv[2][i]=0.0;
else
{
if( list[2]) /* calculate earth state from EMBary */
for( i = 0; i < list[2] * 3u; ++i)
pv[2][i] -= pv[9][i]/(1.0+eph->emrat);
if(list[9]) /* calculate Solar System barycentric moon state */
for( i = 0; i < list[9] * 3u; ++i)
pv[9][i] += pv[2][i];
}
for( i = 0; i < list_val * 3u; ++i)
rrd[i] = pv[ntarg-1][i] - pv[ncent-1][i];
return( rval);
}
/* Some notes about the information stored in 'iinfo': the posn_coeff[]
array contains the Chebyshev polynomials for tc,
posn_coeff[i]=T (tc).
i
The vel_coeff[] array contains the derivatives of the same polynomials,
vel_coeff[i]=T'(tc).
i
Evaluating these polynomials is a little expensive, and we don't want
to evaluate any more than we have to. (Some planets require many more
Chebyshev polynomials than others.) So if 'tc' is unchanged, we can
rest assured that 'n_posn_avail' Chebyshev polynomials, and 'n_vel_avail'
derivatives of Chebyshev polynomials, have already been evaluated, and
we start from there, using the recurrence formulae
T (x) = 1 T (x) = x T (x) = 2xT (x) - T (x)
0 1 n+1 n n-1
T'(x) = 0 T'(x) = 1 T' (x) = 2xT'(x) + 2T (x) - T' (x)
0 1 n+1 n n n-1
(the second set being just the derivatives of the first). To get the
_acceleration_ of an object, we just keep going and get the second
derivatives as
T"(x) = 0 T"(x) = 1 T" (x) = 2xT"(x) + 4T'(x) - T" (x)
0 1 n+1 n n n-1
At present, i can range from 0 to 17. If future JPL ephems require
Chebyshev polynomials beyond T , those arrays may need to be expanded.
17 */
/*****************************************************************************
** interp(buf,t,ncf,ncm,na,ifl,pv) **
******************************************************************************
** **
** this subroutine differentiates and interpolates a **
** set of chebyshev coefficients to give position and velocity **
** **
** calling sequence parameters: **
** **
** input: **
** **
** iinfo stores certain chunks of interpolation info, in hopes **
** that if you call again with similar parameters, the **
** function won't have to re-compute all coefficients/data. **
** **
** coef 1st location of array of d.p. chebyshev coefficients **
** of position **
** **
** t t[0] is double fractional time in interval covered by **
** coefficients at which interpolation is wanted **
** (0 <= t[0] <= 1). t[1] is dp length of whole **
** interval in input time units. **
** **
** ncf # of coefficients per component **
** **
** ncm # of components per set of coefficients **
** **
** na # of sets of coefficients in full array **
** (i.e., # of sub-intervals in full interval) **
** **
** ifl integer flag: =1 for positions only **
** =2 for pos and vel **
** =3 for pos, vel, accel (currently used for **
** pvsun only) **
** **
** output: **
** **
** posvel interpolated quantities requested. dimension **
** expected is posvel[ncm*ifl], double precision. **
** **
*****************************************************************************/
static void interp( struct interpolation_info *iinfo,
const double coef[], const double t[2], const unsigned ncf, const unsigned ncm,
const unsigned na, const int velocity_flag, double posvel[])
{
const double dna = (double)na;
const double temp = dna * t[0];
unsigned l = (unsigned)temp;
double vfac, unused_temp1;
double tc = 2.0 * modf( temp, &unused_temp1) - 1.0;
unsigned i, j;
assert( ncf < MAX_CHEBY);
if( l == na)
{
l--;
tc = 1.;
}
assert( tc >= -1.);
assert( tc <= 1.);
/* check to see whether chebyshev time has changed, and compute new
polynomial values if it has.
(the element iinfo->posn_coeff[1] is the value of t1[tc] and hence
contains the value of tc on the previous call.) */
if( tc != iinfo->posn_coeff[1])
{
iinfo->n_posn_avail = 2;
iinfo->n_vel_avail = 2;
iinfo->posn_coeff[1] = tc;
iinfo->twot = tc+tc;
}
/* be sure that at least 'ncf' polynomials have been evaluated and are
stored in the array 'iinfo->posn_coeff'. Note that we start out with
posn_coeff[0] = 1. and posn_coeff[1] = tc (see 'jpl_init_ephemeris'
below), and vel_coeff[0] and [1] are similarly preset. We do that
because you need the first two coeffs of those series to start the
Chebyshev recurrence; see the comments above this function. */
if( iinfo->n_posn_avail < ncf)
{
double *pc_ptr = iinfo->posn_coeff + iinfo->n_posn_avail;
for( i=ncf - iinfo->n_posn_avail; i; i--, pc_ptr++)
*pc_ptr = iinfo->twot * pc_ptr[-1] - pc_ptr[-2];
iinfo->n_posn_avail=ncf;
}
/* interpolate to get position for each component */
for( i = 0; i < ncm; ++i) /* ncm is a number of coordinates */
{
const double *coeff_ptr = coef + ncf * (i + l * ncm + 1);
const double *pc_ptr = iinfo->posn_coeff + ncf;
*posvel = 0.0;
for( j = ncf; j; j--)
*posvel += (*--pc_ptr) * (*--coeff_ptr);
posvel++;
}
if( velocity_flag <= 1) return;
/* if velocity interpolation is wanted, be sure enough
derivative polynomials have been generated and stored. */
if( iinfo->n_vel_avail < ncf)
{
double *vc_ptr = iinfo->vel_coeff + iinfo->n_vel_avail;
const double *pc_ptr = iinfo->posn_coeff + iinfo->n_vel_avail - 1;
for( i = ncf - iinfo->n_vel_avail; i; i--, vc_ptr++, pc_ptr++)
*vc_ptr = iinfo->twot * vc_ptr[-1] + *pc_ptr + *pc_ptr - vc_ptr[-2];
iinfo->n_vel_avail = ncf;
}
/* interpolate to get velocity for each component */
vfac = (dna + dna) / t[1];
for( i = 0; i < ncm; ++i)
{
double tval = 0.;
const double *coeff_ptr = coef + ncf * (i + l * ncm + 1);
const double *vc_ptr = iinfo->vel_coeff + ncf;
for( j = ncf - 1; j; j--)
tval += (*--vc_ptr) * (*--coeff_ptr);
*posvel++ = tval * vfac;
}
/* Accelerations are rarely computed -- at present, only */
/* for pvsun -- so we don't get so tricky in optimizing. */
/* The accel_coeffs (the second derivative of the Chebyshev */
/* polynomials) are not stored for repeated use, for example. */
if( velocity_flag == 3)
{
double accel_coeffs[MAX_CHEBY];
accel_coeffs[0] = accel_coeffs[1] = 0.;
for( i = 2; i < ncf; i++) /* recurrence for T"(x) */
accel_coeffs[i] = 4. * iinfo->vel_coeff[i - 1]
+ iinfo->twot * accel_coeffs[i - 1]
- accel_coeffs[i - 2];
for( i = 0; i < ncm; ++i) /* ncm is a number of coordinates */
{
double tval = 0.;
const double *coeff_ptr = coef + ncf * (i + l * ncm + 1);
const double *ac_ptr = accel_coeffs + ncf;
for( j = ncf; j; j--)
tval += (*--ac_ptr) * (*--coeff_ptr);
*posvel++ = tval * vfac * vfac;
}
}
return;
}
/* swap_32_bit_val() and swap_64_bit_val() are used when reading a binary
ephemeris that was created on a machine with 'opposite' byte order to
the currently-used machine (signalled by the 'swap_bytes' flag in the
jpl_eph_data structure). In such cases, every double and integer
value read from the ephemeris must be byte-swapped by these two functions. */
#define SWAP_MACRO( A, B, TEMP) { TEMP = A; A = B; B = TEMP; }
static void swap_32_bit_val( void *ptr)
{
char *tptr = (char *)ptr, tchar;
SWAP_MACRO( tptr[0], tptr[3], tchar);
SWAP_MACRO( tptr[1], tptr[2], tchar);
}
static void swap_64_bit_val( void *ptr, long count)
{
char *tptr = (char *)ptr, tchar;
while( count--)
{
SWAP_MACRO( tptr[0], tptr[7], tchar);
SWAP_MACRO( tptr[1], tptr[6], tchar);
SWAP_MACRO( tptr[2], tptr[5], tchar);
SWAP_MACRO( tptr[3], tptr[4], tchar);
tptr += 8;
}
}
/* Most ephemeris quantities have a dimension of three. Planet positions
have an x, y, and z; librations and lunar mantle angles have three Euler
angles. But TDT-TT is a single quantity, and nutation is expressed as
two angles. */
static int dimension( const int idx)
{
int rval;
if( idx == 11) /* Nutations */
rval = 2;
else if( idx == 14) /* TDT - TT */
rval = 1;
else /* planets, lunar mantle angles, librations */
rval = 3;
return( rval);
}
/*****************************************************************************
** jpl_state(ephem,et2,list,pv,nut,bary) **
******************************************************************************
** This subroutine reads and interpolates the jpl planetary ephemeris file **
** **
** Calling sequence parameters: **
** **
** Input: **
** **
** et2[] double, 2-element JED epoch at which interpolation **
** is wanted. Any combination of et2[0]+et2[1] which falls **
** within the time span on the file is a permissible epoch. **
** **
** a. for ease in programming, the user may put the **
** entire epoch in et2[0] and set et2[1]=0.0 **
** **
** b. for maximum interpolation accuracy, set et2[0] = **
** the most recent midnight at or before interpolation **
** epoch and set et2[1] = fractional part of a day **
** elapsed between et2[0] and epoch. **
** **
** c. as an alternative, it may prove convenient to set **
** et2[0] = some fixed epoch, such as start of integration,**
** and et2[1] = elapsed interval between then and epoch. **
** **
** list 13-element integer array specifying what interpolation **
** is wanted for each of the "bodies" on the file. **
** **
** list[i]=0, no interpolation for body i **
** =1, position only **
** =2, position and velocity **
** **
** the designation of the astronomical bodies by i is: **
** **
** i = 0: mercury **
** = 1: venus **
** = 2: earth-moon barycenter **
** = 3: mars **
** = 4: jupiter **
** = 5: saturn **
** = 6: uranus **
** = 7: neptune **
** = 8: pluto **
** = 9: geocentric moon **
** =10: nutations in lon & obliq (if on file) **
** =11: lunar librations (if on file) **
** =12: lunar mantle omegas **
** =13: TT-TDB (if on file) **
** **
** Note that I've not actually seen case 12 yet. It probably doesn't work. **
** **
** output: **
** **
** pv[][6] double array that will contain requested interpolated **
** quantities. The body specified by list[i] will have its **
** state in the array starting at pv[i][0] (on any given **
** call, only those words in 'pv' which are affected by the **
** first 10 'list' entries (and by list(11) if librations are **
** on the file) are set. The rest of the 'pv' array **
** is untouched.) The order of components in pv[][] is: **
** pv[][0]=x,....pv[][5]=dz. **
** **
** All output vectors are referenced to the earth mean **
** equator and equinox of epoch. The moon state is always **
** geocentric; the other nine states are either heliocentric **
** or solar-system barycentric, depending on the setting of **
** global variables (see below). **
** **
** Lunar librations, if on file, are put into pv[10][k] if **
** list[11] is 1 or 2. **
** **
** nut dp 4-word array that will contain nutations and rates, **
** depending on the setting of list[10]. the order of **
** quantities in nut is: **
** **
** d psi (nutation in longitude) **
** d epsilon (nutation in obliquity) **
** d psi dot **
** d epsilon dot **
** **
*****************************************************************************/
int DLL_FUNC jpl_state( void *ephem, const double et, const int list[14],
double pv[][6], double nut[4], const int bary)
{
struct jpl_eph_data *eph = (struct jpl_eph_data *)ephem;
unsigned i, j, n_intervals;
uint32_t nr;
double *buf = eph->cache;
double t[2];
const double block_loc = (et - eph->ephem_start) / eph->ephem_step;
bool recompute_pvsun;
const double aufac = 1.0 / eph->au;
/* error return for epoch out of range */
if( et < eph->ephem_start || et > eph->ephem_end)
return( JPL_EPH_OUTSIDE_RANGE);
/* calculate record # and relative time in interval */
nr = (uint32_t)block_loc;
t[0] = block_loc - (double)nr;
if( !t[0] && nr)
{
t[0] = 1.;
nr--;
}
/* read correct record if not in core (static vector buf[]) */
if( nr != eph->curr_cache_loc)
{
eph->curr_cache_loc = nr;
/* Read two blocks ahead to account for header: */
if( fseek( eph->ifile, (nr + 2) * eph->recsize, SEEK_SET))
return( JPL_EPH_FSEEK_ERROR);
if( fread( buf, sizeof( double), (size_t)eph->ncoeff, eph->ifile)
!= (size_t)eph->ncoeff)
return( JPL_EPH_READ_ERROR);
if( eph->swap_bytes)
swap_64_bit_val( buf, eph->ncoeff);
}
t[1] = eph->ephem_step;
if( eph->pvsun_t != et) /* If several calls are made for the same et, */
{ /* don't recompute pvsun each time... only on */
recompute_pvsun = true; /* the first run through. */
eph->pvsun_t = et;
}
else
recompute_pvsun = false;
/* Here, i loops through the "traditional" 14 listed items -- 10
solar system objects, nutations, librations, lunar mantle angles,
and TT-TDT -- plus a fifteenth: the solar system barycenter. That
last is quite different: it's computed 'as needed', rather than
from list[]; the output goes to pvsun rather than the pv array;
and three quantities (position, velocity, acceleration) are
computed (nobody else gets accelerations at present.) */
for( n_intervals = 1; n_intervals <= 8; n_intervals *= 2)
for( i = 0; i < 15; i++)
{
unsigned quantities;
uint32_t *iptr;
if( i == 14)
{
quantities = (recompute_pvsun ? 3 : 0);
iptr = &eph->ipt[10][0];
}
else
{
quantities = list[i];
iptr = &eph->ipt[i < 10 ? i : i + 1][0];
}
if( n_intervals == iptr[2] && quantities)
{
double *dest;
if( i < 10)
dest = pv[i];
else if( i == 14)
dest = eph->pvsun;
else
dest = nut;
interp( &eph->iinfo, &buf[iptr[0]-1], t, (int)iptr[1],
dimension( i + 1),
n_intervals, quantities, dest);
if( i < 10 || i == 14) /* convert km to AU */
for( j = 0; j < quantities * 3; j++)
dest[j] *= aufac;
}
}
if( !bary) /* gotta correct everybody for */
for( i = 0; i < 9; i++) /* the solar system barycenter */
for( j = 0; j < (unsigned)list[i] * 3; j++)
pv[i][j] -= eph->pvsun[j];
return( 0);
}
static int init_err_code = JPL_INIT_NOT_CALLED;
int DLL_FUNC jpl_init_error_code( void)
{
return( init_err_code);
}
/* DE-430 has 572 constants. That's more than the 400 constants */
/* originally expected. The remaining 172 are stored after the */
/* other header data : */
#define START_400TH_CONSTANT_NAME (84 * 3 + 400 * 6 + 5 * sizeof( double) \
+ 41 * sizeof( int32_t))
/* ...which comes out to 2856. See comments in 'jpl_int.h'. */
/* A JPL binary ephemeris header contains five doubles and */
/* (up to) 41 int32_t integers, so: */
#define JPL_HEADER_SIZE (5 * sizeof( double) + 41 * sizeof( int32_t))
/* ...also known as 5 * 8 + 41 * 4 = 204 bytes. */
/****************************************************************************
** jpl_init_ephemeris( ephemeris_filename, nam, val, n_constants) **
*****************************************************************************
** **
** this function does the initial prep work for use of binary JPL **
** ephemerides. **
** const char *ephemeris_filename = full path/filename of the binary **
** ephemeris (on the Willmann-Bell CDs, this is UNIX.200, 405, **
** or 406) **
** char nam[][6] = array of constant names (max 6 characters each) **
** You can pass nam=NULL if you don't care about the names **
** double *val = array of values of constants **
** You can pass val=NULL if you don't care about the constants **
** Return value is a pointer to the jpl_eph_data structure **
** NULL is returned if the file isn't opened or memory isn't alloced **
** Errors can be determined with the above jpl_init_error_code( ) **
****************************************************************************/
void * DLL_FUNC jpl_init_ephemeris( const char *ephemeris_filename,
char nam[][6], double *val)
{
unsigned i, j;
long de_version;
char title[84];
FILE *ifile = fopen( ephemeris_filename, "rb");
struct jpl_eph_data *rval;
struct jpl_eph_data temp_data;
char header[JPL_HEADER_SIZE];
init_err_code = 0;
temp_data.ifile = ifile;
if( !ifile)
init_err_code = JPL_INIT_FILE_NOT_FOUND;
else if( fread( title, 84, 1, ifile) != 1)
init_err_code = JPL_INIT_FREAD_FAILED;
else if( fseek( ifile, 2652L, SEEK_SET))
init_err_code = JPL_INIT_FSEEK_FAILED;
else if( fread( header, JPL_HEADER_SIZE, 1, ifile) != 1)
init_err_code = JPL_INIT_FREAD2_FAILED;
temp_data.ephem_start = get_double( header);
temp_data.ephem_end = get_double( header + 8);
temp_data.ephem_step = get_double( header + 16);
temp_data.ncon = get32bits( header + 24);
temp_data.au = get_double( header + 28);
temp_data.emrat = get_double( header + 36);
temp_data.pvsun_t = -1e+80; /* a time we can't use anyway */
for( i = 0; i < 40; i++)
temp_data.ipt[i / 3][i % 3] = get32bits( header + 44 + i * 4);
if( init_err_code)
{
if( ifile)
fclose( ifile);
return( NULL);
}
if( !memcmp( title, "INPOP", 5))
{
de_version = atoi( title + 5);
title[30] = '\0';
sscanf( title, "%s", temp_data.name);
}
else
{
de_version = atoi( title + 26);
title[54] = '\0';
sscanf( title + 24, "%s", temp_data.name);
}
/* A small piece of trickery: in the binary file, data is stored */
/* for ipt[0...11], then the ephemeris version, then the */
/* remaining ipt[12] data. A little switching is required to get */
/* the correct order. */
temp_data.ipt[12][0] = temp_data.ipt[12][1];
temp_data.ipt[12][1] = temp_data.ipt[12][2];
temp_data.ipt[12][2] = temp_data.ipt[13][0];
temp_data.ephemeris_version = de_version;
temp_data.swap_bytes = (temp_data.ncon > 65536L);
if( temp_data.swap_bytes) /* byte order is wrong for current platform */
{
swap_64_bit_val( &temp_data.ephem_start, 1);
swap_64_bit_val( &temp_data.ephem_end, 1);
swap_64_bit_val( &temp_data.ephem_step, 1);
swap_32_bit_val( &temp_data.ncon);
swap_64_bit_val( &temp_data.au, 1);
swap_64_bit_val( &temp_data.emrat, 1);
}
/* It's a little tricky to tell if an ephemeris really has */
/* TT-TDB data (with offsets in ipt[13][] and ipt[14][]). */
/* Essentially, we read the data and sanity-check it, and */
/* zero it if it "doesn't add up" correctly. */
/* Also: certain ephems I've generated with ncon capped */
/* at 400 have no TT-TDB data. So if ncon == 400, don't */
/* try to read such data; you may get garbage. */
if( de_version >= 430 && temp_data.ncon != 400)
{
/* If there are 400 or fewer constants, data for ipt[13][0...2] */
/* immediately follows that for ipt[12][0..2]; i.e., we don't */
/* need to fseek(). Otherwise, we gotta skip 6*(n_constants-400) */
/* bytes. */
if( temp_data.ncon > 400)
fseek( ifile, (size_t)( temp_data.ncon - 400) * 6, SEEK_CUR);
if( fread( &temp_data.ipt[13][0], sizeof( int32_t), 6, ifile) != 6)
init_err_code = JPL_INIT_FREAD5_FAILED;
}
else /* mark header data as invalid */
temp_data.ipt[13][0] = (uint32_t)-1;
if( temp_data.swap_bytes) /* byte order is wrong for current platform */
for( j = 0; j < 3; j++)
for( i = 0; i < 15; i++)
swap_32_bit_val( &temp_data.ipt[i][j]);
if( temp_data.ipt[13][0] != /* if these don't add up correctly, */
temp_data.ipt[12][0] + temp_data.ipt[12][1] * temp_data.ipt[12][2] * 3
|| temp_data.ipt[14][0] != /* zero them out (they've garbage data) */
temp_data.ipt[13][0] + temp_data.ipt[13][1] * temp_data.ipt[13][2] * 3)
{ /* not valid pointers to TT-TDB data */
for( i = 13; i < 15; i++)
for( j = 0; j < 3; j++)
temp_data.ipt[i][j] = 0;
}
/* A sanity check: if the earth-moon ratio is outside reasonable */
/* bounds, we must be looking at a wrong or corrupted file. */
/* In DE-102, emrat = 81.3007; in DE-405/406, emrat = 81.30056. */
/* Those are the low and high ranges. We'll allow some slop in */
/* case the earth/moon mass ratio changes: */
if( temp_data.emrat > 81.3008 || temp_data.emrat < 81.30055)
init_err_code = JPL_INIT_FILE_CORRUPT;
if( init_err_code)
{
fclose( ifile);
return( NULL);
}
/* Once upon a time, the kernel size was determined from the */
/* DE version. This was not a terrible idea, except that it */
/* meant that when the code faced a new version, it broke. */
/* Now we use some logic to compute the kernel size. */
temp_data.kernel_size = 4;
for( i = 0; i < 15; i++)
temp_data.kernel_size +=
2 * temp_data.ipt[i][1] * temp_data.ipt[i][2] * dimension( i);
// for( i = 0; i < 13; i++)
// temp_data.kernel_size +=
// temp_data.ipt[i][1] * temp_data.ipt[i][2] * ((i == 11) ? 4 : 6);
// /* ...and then add in space required for the TT-TDB data : */
// temp_data.kernel_size += temp_data.ipt[14][1] * temp_data.ipt[14][2] * 2;
temp_data.recsize = temp_data.kernel_size * 4L;
temp_data.ncoeff = temp_data.kernel_size / 2L;
/* Rather than do two separate allocations, everything */
/* we need is allocated in _one_ chunk, then parceled out. */
/* This looks a little weird, but it simplifies error */
/* handling and cleanup. */
rval = (struct jpl_eph_data *)calloc( sizeof( struct jpl_eph_data)
+ temp_data.recsize, 1);
if( !rval)
{
init_err_code = JPL_INIT_MEMORY_FAILURE;
fclose( ifile);
return( NULL);
}
memcpy( rval, &temp_data, sizeof( struct jpl_eph_data));
rval->iinfo.posn_coeff[0] = 1.0;
/* Seed a bogus value here. The first and subsequent calls to */
/* 'interp' will correct it to a value between -1 and +1. */
rval->iinfo.posn_coeff[1] = -2.0;
rval->iinfo.vel_coeff[0] = 0.0;
rval->iinfo.vel_coeff[1] = 1.0;
rval->curr_cache_loc = (uint32_t)-1;
/* The 'cache' data is right after the 'jpl_eph_data' struct: */
rval->cache = (double *)( rval + 1);
/* If there are more than 400 constants, the names of */
/* the extra constants are stored in what would normally */
/* be zero-padding after the header record. However, */
/* older ephemeris-reading software won't know about that. */
/* So we store ncon=400, then actually check the names to */
/* see how many constants there _really_ are. Older readers */
/* will just see 400 names and won't know about the others. */
/* But on the upside, they won't crash. */
if( rval->ncon == 400)
{
char buff[7];
buff[6] = '\0';
fseek( ifile, START_400TH_CONSTANT_NAME, SEEK_SET);
while( fread( buff, 6, 1, ifile) && strlen( buff) == 6)
rval->ncon++;
}
if( val)
{
fseek( ifile, rval->recsize, SEEK_SET);
if( fread( val, sizeof( double), (size_t)rval->ncon, ifile)
!= (size_t)rval->ncon)
init_err_code = JPL_INIT_FREAD3_FAILED;
else if( rval->swap_bytes) /* gotta swap the constants, too */
swap_64_bit_val( val, rval->ncon);
}
if( !init_err_code && nam)
{
fseek( ifile, 84L * 3L, SEEK_SET); /* just after the 3 'title' lines */
for( i = 0; i < rval->ncon && !init_err_code; i++)
{
if( i == 400)
fseek( ifile, START_400TH_CONSTANT_NAME, SEEK_SET);
if( fread( nam[i], 6, 1, ifile) != 1)
init_err_code = JPL_INIT_FREAD4_FAILED;
}
}
return( rval);
}
/****************************************************************************
** jpl_close_ephemeris( ephem) **
*****************************************************************************
** **
** this function closes files and frees up memory allocated by the **
** jpl_init_ephemeris( ) function. **
****************************************************************************/
void DLL_FUNC jpl_close_ephemeris( void *ephem)
{
struct jpl_eph_data *eph = (struct jpl_eph_data *)ephem;
fclose( eph->ifile);
free( ephem);
}
/* Added 2011 Jan 18: random access to any desired JPL constant */
double DLL_FUNC jpl_get_constant( const int idx, void *ephem, char *constant_name)
{
struct jpl_eph_data *eph = (struct jpl_eph_data *)ephem;
double rval = 0.;