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
|
/* ../src/dehanttideinel.f -- translated by f2c (version 20090411).
You must link the resulting object file with libf2c:
on Microsoft Windows system, link with libf2c.lib;
on Linux or Unix systems, link with .../path/to/libf2c.a -lm
or, if you install libf2c.a in a standard place, with -lf2c -lm
-- in that order, at the end of the command line, as in
cc *.o -lf2c -lm
Source for libf2c is in /netlib/f2c/libf2c.zip, e.g.,
http://www.netlib.org/f2c/libf2c.zip
*/
#include "f2c.h"
/* Subroutine */ int dehanttideinel_(doublereal *xsta, integer *yr, integer *
month, integer *day, doublereal *fhr, doublereal *xsun, doublereal *
xmon, doublereal *dxtide)
{
/* Initialized data */
static doublereal h20 = .6078;
static doublereal l20 = .0847;
static doublereal h3 = .292;
static doublereal l3 = .015;
/* System generated locals */
doublereal d__1, d__2;
/* Builtin functions */
double sqrt(doublereal);
/* Local variables */
static doublereal mass_ratio_moon__;
extern /* Subroutine */ int step2diu_(doublereal *, doublereal *,
doublereal *, doublereal *), step2lon_(doublereal *, doublereal *,
doublereal *);
static integer i__;
extern /* Subroutine */ int zero_vec8__(doublereal *);
static doublereal t, h2, l2, re;
extern /* Subroutine */ int dat_(integer *, integer *, integer *,
doublereal *, doublereal *, integer *);
static doublereal scm, scs, dtt, jjm0, jjm1;
extern /* Subroutine */ int st1l1_(doublereal *, doublereal *, doublereal
*, doublereal *, doublereal *, doublereal *);
static doublereal rsta, rmon, rsun, p2mon, p3mon, x2mon, x3mon, p2sun,
p3sun, x2sun, x3sun, scmon;
extern /* Subroutine */ int sprod_(doublereal *, doublereal *, doublereal
*, doublereal *, doublereal *);
static doublereal scsun;
extern /* Subroutine */ int cal2jd_(integer *, integer *, integer *,
doublereal *, doublereal *, integer *);
static doublereal cosphi;
static integer statut;
static doublereal fac2mon, fac3mon, fac2sun, fac3sun;
extern /* Subroutine */ int st1idiu_(doublereal *, doublereal *,
doublereal *, doublereal *, doublereal *, doublereal *);
static doublereal mass_ratio_sun__;
extern /* Subroutine */ int st1isem_(doublereal *, doublereal *,
doublereal *, doublereal *, doublereal *, doublereal *);
static doublereal xcorsta[3];
/* + */
/* - - - - - - - - - - - - - - - */
/* D E H A N T T I D E I N E L */
/* - - - - - - - - - - - - - - - */
/* This routine is part of the International Earth Rotation and */
/* Reference Systems Service (IERS) Conventions software collection. */
/* This subroutine computes the tidal corrections of station displacements */
/* caused by lunar and solar gravitational attraction (see References). */
/* The computations are calculated by the following steps: */
/* Step 1): General degree 2 and degree 3 corrections + CALL ST1IDIU */
/* + CALL ST1ISEM + CALL ST1L1. */
/* Step 2): CALL STEP2DIU + CALL STEP2LON */
/* It has been decided that the Step 3 non-correction for permanent tide */
/* would not be applied in order to avoid a jump in the reference frame. */
/* This Step 3 must be added in order to get the non-tidal station position */
/* and to conform with the IAG Resolution. */
/* In general, Class 1, 2, and 3 models represent physical effects that */
/* act on geodetic parameters while canonical models provide lower-level */
/* representations or basic computations that are used by Class 1, 2, or */
/* 3 models. */
/* Status: Class 1 */
/* Class 1 models are those recommended to be used a priori in the */
/* reduction of raw space geodetic data in order to determine */
/* geodetic parameter estimates. */
/* Class 2 models are those that eliminate an observational */
/* singularity and are purely conventional in nature. */
/* Class 3 models are those that are not required as either Class */
/* 1 or 2. */
/* Canonical models are accepted as is and cannot be classified as a */
/* Class 1, 2, or 3 model. */
/* Given: */
/* XSTA d(3) Geocentric position of the IGS station (Note 1) */
/* XSUN d(3) Geocentric position of the Sun (Note 2) */
/* XMON d(3) Geocentric position of the Moon (Note 2) */
/* YR i Year (Note 3) */
/* MONTH i Month (Note 3) */
/* DAY i Day of Month (Note 3) */
/* FHR d Hour in the day (Note 4) */
/* Returned: */
/* DXTIDE d(3) Displacement vector (Note 5) */
/* Notes: */
/* 1) The IGS station is in ITRF co-rotating frame. All coordinates, */
/* X, Y, and Z, are expressed in meters. */
/* 2) The position is in Earth Centered Earth Fixed (ECEF) frame. All */
/* coordinates are expressed in meters. */
/* 3) The values are expressed in Coordinated Universal Time (UTC). */
/* 4) The fractional hours in the day is computed as the hour + minutes/60.0 */
/* + sec/3600.0. The unit is expressed in Universal Time (UT). */
/* 5) The displacement vector is in the geocentric ITRF. All components are */
/* expressed in meters. */
/* Called: */
/* SPROD Finds the scalar product and unit vector of two vectors */
/* ZERO_VEC8 Returns the zero vector */
/* ST1IDIU Corrects for the out-of-phase part of Love numbers */
/* for the diurnal band */
/* ST1ISEM Same as above for the semi-diurnal band */
/* ST1L1 Corrects for the latitude dependence of Love numbers */
/* CAL2JD Computes Julian Date from Gregorian calendar date */
/* DAT Computes the difference TAI-UTC */
/* STEP2DIU Computes in-phase and out-of-phase corrections in */
/* the diurnal band */
/* STEP2LON Same as above for the long period band */
/* Test case: */
/* given input: XSTA(1) = 4075578.385D0 meters */
/* XSTA(2) = 931852.890D0 meters */
/* XSTA(3) = 4801570.154D0 meters */
/* XSUN(1) = 137859926952.015D0 meters */
/* XSUN(2) = 54228127881.4350D0 meters */
/* XSUN(3) = 23509422341.6960D0 meters */
/* XMON(1) = -179996231.920342D0 meters */
/* XMON(2) = -312468450.131567D0 meters */
/* XMON(3) = -169288918.592160D0 meters */
/* YR = 2009 */
/* MONTH = 4 */
/* DAY = 13 */
/* FHR = 0.00D0 seconds */
/* expected output: DXTIDE(1) = 0.7700420357108125891D-01 meters */
/* DXTIDE(2) = 0.6304056321824967613D-01 meters */
/* DXTIDE(3) = 0.5516568152597246810D-01 meters */
/* References: */
/* Groten, E., 2000, Geodesists Handbook 2000, Part 4, */
/* http://www.gfy.ku.dk/~iag/HB2000/part4/groten.htm. See also */
/* ''Parameters of Common Relevance of Astronomy, Geodesy, and */
/* Geodynamics," J. Geod., 74, pp. 134-140 */
/* Mathews, P. M., Dehant, V., and Gipson, J. M., 1997, ''Tidal station */
/* displacements," J. Geophys. Res., 102(B9), pp. 20,469-20,477 */
/* Petit, G. and Luzum, B. (eds.), IERS Conventions (2010), */
/* IERS Technical Note No. 36, BKG (2010) */
/* Pitjeva, E. and Standish, E. M., 2009, ''Proposals for the masses */
/* of the three largest asteroids, the Moon-Earth mass ratio and the */
/* Astronomical Unit," Celest. Mech. Dyn. Astr., 103, pp. 365-372 */
/* Ries, J. C., Eanes, R. J., Shum, C. K. and Watkins, M. M., 1992, */
/* ''Progress in the Determination of the Gravitational Coefficient */
/* of the Earth," Geophys. Res. Lett., 19(6), pp. 529-531 */
/* Revisions: */
/* 1996 March 23 V. Dehant Original code */
/* P. M. Mathews */
/* J. Gipson */
/* 2000 May 17 V. Dehant Last modifications */
/* P. M. Mathews */
/* 2006 February 06 J. Ray Header comments modified to clarify */
/* input/output units and systems */
/* 2006 February 06 J. Ray Subroutine DUTC modified for leap */
/* second on 2006.0 and to correct */
/* do 5 i=1,87 from 84 to 87 */
/* 2006 August 31 G. Petit Correct DUTC for dates after 2007 */
/* 2007 June 20 H. Manche Modified DUTC to correct past mistake */
/* and corrected DE line in subroutine */
/* STEP2DIU */
/* 2007 October 23 H. Manche Replace subroutines DUTC and FJLDY with */
/* G. Petit SOFA subroutines iau_CAL2JD and iau_DAT */
/* and correct time arguments of subroutine */
/* STEP2DIU */
/* 2009 February 19 G. Petit Update routine iau_DAT for 2009.0 leap */
/* second */
/* 2009 August 06 B.E. Stetzler Initial standardization of code */
/* 2009 August 07 B.E. Stetzler Updated MASS_RATIO_SUN, */
/* MASS_RATIO_MOON and RE to CBEs and */
/* provided a test case */
/* 2009 August 07 B.E. Stetzler Capitalized all variables for Fortran */
/* 77 compatibility */
/* 2009 September 01 B.E. Stetzler Removed 'iau_' from redistributed SOFA */
/* subroutines */
/* ----------------------------------------------------------------------- */
/* ---------------------------------------------------------------------- */
/* NOMINAL SECOND DEGREE AND THIRD DEGREE LOVE NUMBERS AND SHIDA NUMBERS */
/* ---------------------------------------------------------------------- */
/* Parameter adjustments */
--dxtide;
--xmon;
--xsun;
--xsta;
/* Function Body */
/* ---------------------------------------------------------------------- */
/* SCALAR PRODUCT OF STATION VECTOR WITH SUN/MOON VECTOR */
/* ---------------------------------------------------------------------- */
sprod_(&xsta[1], &xsun[1], &scs, &rsta, &rsun);
sprod_(&xsta[1], &xmon[1], &scm, &rsta, &rmon);
scsun = scs / rsta / rsun;
scmon = scm / rsta / rmon;
/* ---------------------------------------------------------------------- */
/* COMPUTATION OF NEW H2 AND L2 */
/* ---------------------------------------------------------------------- */
/* Computing 2nd power */
d__1 = xsta[1];
/* Computing 2nd power */
d__2 = xsta[2];
cosphi = sqrt(d__1 * d__1 + d__2 * d__2) / rsta;
/* Computing 2nd power */
d__1 = cosphi;
h2 = h20 - (1. - d__1 * d__1 * 1.5) * 6e-4;
/* Computing 2nd power */
d__1 = cosphi;
l2 = l20 + (1. - d__1 * d__1 * 1.5) * 2e-4;
/* P2 term */
/* Computing 2nd power */
d__1 = scsun;
p2sun = (h2 / 2. - l2) * 3. * (d__1 * d__1) - h2 / 2.;
/* Computing 2nd power */
d__1 = scmon;
p2mon = (h2 / 2. - l2) * 3. * (d__1 * d__1) - h2 / 2.;
/* P3 term */
/* Computing 3rd power */
d__1 = scsun;
p3sun = (h3 - l3 * 3.) * 2.5 * (d__1 * (d__1 * d__1)) + (l3 - h3) * 1.5 *
scsun;
/* Computing 3rd power */
d__1 = scmon;
p3mon = (h3 - l3 * 3.) * 2.5 * (d__1 * (d__1 * d__1)) + (l3 - h3) * 1.5 *
scmon;
/* ---------------------------------------------------------------------- */
/* TERM IN DIRECTION OF SUN/MOON VECTOR */
/* ---------------------------------------------------------------------- */
x2sun = l2 * 3. * scsun;
x2mon = l2 * 3. * scmon;
/* Computing 2nd power */
d__1 = scsun;
x3sun = l3 * 3. / 2. * (d__1 * d__1 * 5. - 1.);
/* Computing 2nd power */
d__1 = scmon;
x3mon = l3 * 3. / 2. * (d__1 * d__1 * 5. - 1.);
/* ---------------------------------------------------------------------- */
/* FACTORS FOR SUN/MOON USING IAU CURRENT BEST ESTIMATES (SEE REFERENCES) */
/* ---------------------------------------------------------------------- */
mass_ratio_sun__ = 332946.0482;
mass_ratio_moon__ = .0123000371;
re = 6378136.6;
/* Computing 3rd power */
d__1 = re / rsun;
fac2sun = mass_ratio_sun__ * re * (d__1 * (d__1 * d__1));
/* Computing 3rd power */
d__1 = re / rmon;
fac2mon = mass_ratio_moon__ * re * (d__1 * (d__1 * d__1));
fac3sun = fac2sun * (re / rsun);
fac3mon = fac2mon * (re / rmon);
/* TOTAL DISPLACEMENT */
for (i__ = 1; i__ <= 3; ++i__) {
dxtide[i__] = fac2sun * (x2sun * xsun[i__] / rsun + p2sun * xsta[i__]
/ rsta) + fac2mon * (x2mon * xmon[i__] / rmon + p2mon * xsta[
i__] / rsta) + fac3sun * (x3sun * xsun[i__] / rsun + p3sun *
xsta[i__] / rsta) + fac3mon * (x3mon * xmon[i__] / rmon +
p3mon * xsta[i__] / rsta);
/* L10: */
}
zero_vec8__(xcorsta);
/* +--------------------------------------------------------------------- */
/* CORRECTIONS FOR THE OUT-OF-PHASE PART OF LOVE NUMBERS (PART H_2^(0)I */
/* AND L_2^(0)I ) */
/* ---------------------------------------------------------------------- */
/* FIRST, FOR THE DIURNAL BAND */
st1idiu_(&xsta[1], &xsun[1], &xmon[1], &fac2sun, &fac2mon, xcorsta);
for (i__ = 1; i__ <= 3; ++i__) {
dxtide[i__] += xcorsta[i__ - 1];
/* L11: */
}
/* SECOND, FOR THE SEMI-DIURNAL BAND */
st1isem_(&xsta[1], &xsun[1], &xmon[1], &fac2sun, &fac2mon, xcorsta);
for (i__ = 1; i__ <= 3; ++i__) {
dxtide[i__] += xcorsta[i__ - 1];
/* L12: */
}
/* +--------------------------------------------------------------------- */
/* CORRECTIONS FOR THE LATITUDE DEPENDENCE OF LOVE NUMBERS (PART L^(1) ) */
/* ---------------------------------------------------------------------- */
st1l1_(&xsta[1], &xsun[1], &xmon[1], &fac2sun, &fac2mon, xcorsta);
for (i__ = 1; i__ <= 3; ++i__) {
dxtide[i__] += xcorsta[i__ - 1];
/* L13: */
}
/* CONSIDER CORRECTIONS FOR STEP 2 */
/* +--------------------------------------------------------------------- */
/* CORRECTIONS FOR THE DIURNAL BAND: */
/* FIRST, WE NEED TO KNOW THE DATE CONVERTED IN JULIAN CENTURIES */
/* 1) CALL THE SUBROUTINE COMPUTING THE JULIAN DATE */
/* ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */
cal2jd_(yr, month, day, &jjm0, &jjm1, &statut);
t = (jjm0 - 2451545. + jjm1 + *fhr / 24.) / 36525.;
/* ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */
/* 2) CALL THE SUBROUTINE COMPUTING THE CORRECTION OF UTC TIME */
/* ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */
dat_(yr, month, day, fhr, &dtt, &statut);
/* ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */
dtt += 32.184;
/* CONVERSION OF T IN TT TIME */
t += dtt / 3.15576e9;
/* SECOND, WE CAN CALL THE SUBROUTINE STEP2DIU, FOR THE DIURNAL BAND */
/* CORRECTIONS, (in-phase and out-of-phase frequency dependence): */
step2diu_(&xsta[1], fhr, &t, xcorsta);
for (i__ = 1; i__ <= 3; ++i__) {
dxtide[i__] += xcorsta[i__ - 1];
/* L14: */
}
/* CORRECTIONS FOR THE LONG-PERIOD BAND, */
/* (in-phase and out-of-phase frequency dependence): */
step2lon_(&xsta[1], &t, xcorsta);
for (i__ = 1; i__ <= 3; ++i__) {
dxtide[i__] += xcorsta[i__ - 1];
/* L15: */
}
/* CONSIDER CORRECTIONS FOR STEP 3 */
/* ---------------------------------------------------------------------- */
/* UNCORRECT FOR THE PERMANENT TIDE */
/* SINPHI=XSTA(3)/RSTA */
/* COSPHI=DSQRT(XSTA(1)**2+XSTA(2)**2)/RSTA */
/* COSLA=XSTA(1)/COSPHI/RSTA */
/* SINLA=XSTA(2)/COSPHI/RSTA */
/* DR=-DSQRT(5D0/4D0/PI)*H2*0.31460D0*(3D0/2D0*SINPHI**2-0.5D0) */
/* DN=-DSQRT(5D0/4D0/PI)*L2*0.31460D0*3D0*COSPHI*SINPHI */
/* DXTIDE(1)=DXTIDE(1)-DR*COSLA*COSPHI+DN*COSLA*SINPHI */
/* DXTIDE(2)=DXTIDE(2)-DR*SINLA*COSPHI+DN*SINLA*SINPHI */
/* DXTIDE(3)=DXTIDE(3)-DR*SINPHI -DN*COSPHI */
/* ----------------------------------------------------------------------- */
return 0;
/* Finished. */
/* +---------------------------------------------------------------------- */
/* Copyright (C) 2008 */
/* IERS Conventions Center */
/* ================================== */
/* IERS Conventions Software License */
/* ================================== */
/* NOTICE TO USER: */
/* BY USING THIS SOFTWARE YOU ACCEPT THE FOLLOWING TERMS AND CONDITIONS */
/* WHICH APPLY TO ITS USE. */
/* 1. The Software is provided by the IERS Conventions Center ("the */
/* Center"). */
/* 2. Permission is granted to anyone to use the Software for any */
/* purpose, including commercial applications, free of charge, */
/* subject to the conditions and restrictions listed below. */
/* 3. You (the user) may adapt the Software and its algorithms for your */
/* own purposes and you may distribute the resulting "derived work" */
/* to others, provided that the derived work complies with the */
/* following requirements: */
/* a) Your work shall be clearly identified so that it cannot be */
/* mistaken for IERS Conventions software and that it has been */
/* neither distributed by nor endorsed by the Center. */
/* b) Your work (including source code) must contain descriptions of */
/* how the derived work is based upon and/or differs from the */
/* original Software. */
/* c) The name(s) of all modified routine(s) that you distribute */
/* shall be changed. */
/* d) The origin of the IERS Conventions components of your derived */
/* work must not be misrepresented; you must not claim that you */
/* wrote the original Software. */
/* e) The source code must be included for all routine(s) that you */
/* distribute. This notice must be reproduced intact in any */
/* source distribution. */
/* 4. In any published work produced by the user and which includes */
/* results achieved by using the Software, you shall acknowledge */
/* that the Software was used in obtaining those results. */
/* 5. The Software is provided to the user "as is" and the Center makes */
/* no warranty as to its use or performance. The Center does not */
/* and cannot warrant the performance or results which the user may */
/* obtain by using the Software. The Center makes no warranties, */
/* express or implied, as to non-infringement of third party rights, */
/* merchantability, or fitness for any particular purpose. In no */
/* event will the Center be liable to the user for any consequential, */
/* incidental, or special damages, including any lost profits or lost */
/* savings, even if a Center representative has been advised of such */
/* damages, or for any claim by any third party. */
/* Correspondence concerning IERS Conventions software should be */
/* addressed as follows: */
/* Gerard Petit */
/* Internet email: gpetit[at]bipm.org */
/* Postal address: IERS Conventions Center */
/* Time, frequency and gravimetry section, BIPM */
/* Pavillon de Breteuil */
/* 92312 Sevres FRANCE */
/* or */
/* Brian Luzum */
/* Internet email: brian.luzum[at]usno.navy.mil */
/* Postal address: IERS Conventions Center */
/* Earth Orientation Department */
/* 3450 Massachusetts Ave, NW */
/* Washington, DC 20392 */
/* ----------------------------------------------------------------------- */
} /* dehanttideinel_ */
|
