/
shread2.html
167 lines (109 loc) · 5.86 KB
/
shread2.html
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>SHTOOLS - Spherical harmonic I/O and storage routines</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="../CSS/sh.css">
<link rel="icon" type="image/vnd.microsoft.icon" href="../Figures/favicon.ico">
</head>
<body>
<div class="main">
<p class="centeredimage"><img src="../Figures/logo.jpg" width=894 height=135 alt="SHTOOLS --- Tools for working with spherical harmonics"></p>
<table class="menu">
<tbody>
<tr>
<td><a href="http://shtools.ipgp.fr/">HOME</a></td>
<td><a href="http://sourceforge.net/projects/shtools/">DOWNLOAD</a></td>
<td class="selected"><a href="../documentation.html">DOCUMENTATION</a></td>
<td><a href="https://sourceforge.net/p/shtools/discussion/">FORUM</a></td>
<td><a href="../faq.html">FAQ</a> </td>
</tr>
</tbody>
</table>
<p class="dir">
> <a href="../../SHTOOLS.html" class="dir">Home</a> > <a href="../documentation.html" class="dir">Documentation</a> > <a href="../io.html" class="dir">Spherical Harmonic I/O and Storage</a></p>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
<B>SHREAD2(1)</B> SHTOOLS 2.9 <B>SHREAD2(1)</B>
</PRE>
<H2 class="man">SHRead2</H2 class="man"><PRE>
SHRead2 - Read spherical harmonic coefficients from a CHAMP or GRACE-like ASCII file.
</PRE>
<H2 class="man">SYNOPSIS</H2 class="man"><PRE>
SUBROUTINE SHRead2 ( FILENAME, CILM, LMAX, GM, R0_POT, ERROR, DOT, DOYSTART, DOYEND, EPOCH )
CHARACTER(*) FILENAME
REAL*8 CILM(2, LMAX+1, LMAX+1), GM, R0_POT
INTEGER LMAX
REAL*8, OPTIONAL ERROR(2, LMAX+1, LMAX+1), DOT(2, :, :), DOYSTART, DOYEND, EPOCH
</PRE>
<H2 class="man">DESCRIPTION</H2 class="man"><PRE>
<B>SHRead2</B> will read spherical harmonic coefficients from a CHAMP or GRACE-like ASCII formatted
file into an array CILM. The errors and time derivatives associated with the coefficients
will be read if the optional arrays ERROR and DOT are specified, respectively. The staring
and ending date of the solution are specified by the optional parameters DOYSTART and DOYEND,
and the epoch of the time derivates is specified by the optional parameter EPOCH. The maximum
spherical harmonic degree is read from the file, and the file does not need to be ordered by
angular degree or order.
This routine does not read and output all parameters in the file. Records that are read (and
at least partially output) include: EARTH, GGM, SHM, GRCOF2, GRDOTA, CALSDV, gfc, gfct, and
dot. Comments specified by the record CMMNT will be print out to the screen, as will the
record names that are not currently implemented.
</PRE>
<H2 class="man">ARGUMENTS</H2 class="man"><PRE>
FILENAME (input) CHARACTER(*)
The ASCII filename containing the spherical harmonic coefficients.
CILM (output) REAL*8, DIMENSION (2, LMAX+1, LMAX+1)
The spherical harmonic coefficients contained in FILENAME.
LMAX (output) INTEGER
The maximum spherical harmonic degree of CILM.
GM (output) REAL*8
The mass-gravitational constant.
R0_POT (output) REAL*8
The reference radius of the potential coefficients.
ERROR (output) REAL*8, OPTIONAL, DIMENSION (2, LMAX+1, LMAX+1)
The errors corresponding to the spherical harmonic coefficients CILM.
DOT (output) REAL*8, OPTIONAL, DIMENSION (2, :, :)
The time derivatives of the spherical harmonic coefficients. The dimension of
this array can be smaller than LMAX+1.
item DOYSTART
(output) REAL*8, OPTIONAL
The starting time of the solution.
item DOYEND
(output) REAL*8, OPTIONAL
The ending time of the solution
item EPOCH
(output) REAL*8, OPTIONAL
The EPOCH time for the time derivates.
</PRE>
<H2 class="man">NOTES</H2 class="man"><PRE>
Each line of the file starts with a character string describing what follows.
1. "EARTH" or "GGM": GM, R0_POT
2. "SHM": Maximum spherical harmonic degree of file.
3. "GRCOF2", "CALSDV", or "gfc": spherical harmonic coefficients, formatted as (l, m, clm,
slm) or (l, m, clm, slm, clm_error, slm_error).
</PRE>
<H2 class="man">SEE ALSO</H2 class="man"><PRE>
<B>shread(1)</B>, <B>shreadgrace(1)</B>, <B>shreadjpl(1)</B>
<http://shtools.ipgp.fr/>
</PRE>
<H2 class="man">COPYRIGHT AND LICENSE</H2 class="man"><PRE>
Copyright 2012 by Mark Wieczorek <wieczor@ipgp.fr>.
This is free software; you can distribute and modify it under the terms of the revised BSD
license.
SHTOOLS 2.9 2012-03-08 <B>SHREAD2(1)</B>
</PRE>
<p class="dir">
> <a href="../../SHTOOLS.html" class="dir">Home</a> > <a href="../documentation.html" class="dir">Documentation</a> > <a href="../io.html" class="dir">Spherical Harmonic I/O</a></p>
<table class="footer2" summary = "Mark Wieczorek">
<tbody>
<tr>
<td class="c1"><a href="http://www.ipgp.fr/">Institut de Physique du Globe de Paris</a></td>
<td class="c2"><a href="http://www.sorbonne-paris-cite.fr/index.php/en">University of Sorbonne Paris Cité</a></td>
<td class="c3">© 2014 <a href="http://www.ipgp.fr/~wieczor">Mark Wieczorek</a></td>
</tr>
</tbody>
</table>
</div>
</body>
</html>