source: trunk/SRC/Documentation/idldoc_html_output/Interpolation/ll_narcs_distances.html @ 338

Last change on this file since 338 was 338, checked in by smasson, 16 years ago

update documentation

File size: 7.1 KB
Line 
1
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
5<!-- Generated by IDLdoc 2.0 -->
6
7<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
8  <head>
9    <title>ll_narcs_distances.pro (SAXO Documentation)</title>
10
11   
12    <link rel="stylesheet" type="text/css" media="all" href="./../main_files.css" />
13    <link rel="stylesheet" type="text/css" media="print" href="./../main_files_print.css" />
14   
15
16    <script type="text/javascript">
17      function setTitle() {
18        parent.document.title="ll_narcs_distances.pro (SAXO Documentation)";
19      }
20    </script>
21  </head>
22
23  <body onload="setTitle();">
24
25    <div id="navbar_title">
26  <h1>SAXO Documentation</h1>
27</div>
28
29
30<div id="main_navbar">
31
32  <table cellspacing="0">
33    <tr>
34     
35      <td><a href="./../overview.html" title="Overview of library">Overview</a></td>
36     
37
38     
39      <td >Directory</td>
40     
41
42     
43      <td><a href="./../idldoc-categories.html" title="Browse library by category">Categories</a></td>
44     
45
46     
47      <td><a href="./../idldoc-index.html" title="Index of files, routines, and parameters">Index</a></td>
48     
49
50     
51      <td><a href="./../search-page.html" title="Search library">Search</a></td>
52     
53
54      <td id="selected">File</td>
55
56     
57      <td><a href="../../../Interpolation//ll_narcs_distances.pro" title="Source code of a file">Source</a></td>
58     
59
60     
61      <td><a href="./../idldoc-help.html" title="Help on IDLdoc">Help</a></td>
62     
63
64      <td >Etc</td>
65
66      <td id="flexible">Developer&nbsp;documentation</td>
67    </tr>
68  </table>
69
70</div>
71
72<div id="secondary_navbar">
73
74<a href="lbcorca.html">&lt;&lt;prev file</a> | <a href="map_npoints.html">next file &gt;&gt;</a>&nbsp;&nbsp;&nbsp;&nbsp;<a href="ll_narcs_distances.html" target="_TOP">view single page</a> | <a href="./../index.html" target="_TOP">view frames</a>&nbsp;&nbsp;&nbsp;&nbsp;summary: fields | routine&nbsp;&nbsp;&nbsp;&nbsp;details: <a href="#routine_details">routine</a>
75
76</div>
77
78
79    <div id="container">
80
81      <h1 class="directory"><a href="directory-overview.html">Interpolation/</a></h1>
82      <h2 class="pro_file">ll_narcs_distances.pro</h2>
83
84      <div id="file_attr">
85        <dl>
86        </dl>
87      </div>
88
89      <div id="file_comments">
90 This function returns the longitude and latitude [lon, lat] of
91 a point a given arc distance (-pi <= Arc_Dist <= pi), and azimuth (Az),
92 from a specified location Lon0, Lat0.
93 Same as <a href="/Applications/itt/idl64/help/online_help/LL_ARC_DISTANCE.html">LL_ARC_DISTANCE</a> but for n points without do loop.
94
95 Formula from Map Projections - a working manual.  USGS paper
96 1395. Equations (5-5) and (5-6).
97</div>
98
99     
100
101     
102
103     
104
105     
106
107      <div id="routine_details">
108       
109
110        <div class="routine_details" id="_ll_narcs_distances">
111
112          <h2><a class="top" href="#container">top</a>ll_narcs_distances <span class="categories">
113 Mapping, geography
114</span></h2>
115       
116          <p class="header">
117            <span class="result">result = </span>ll_narcs_distances(<span class="result"><a href="#_ll_narcs_distances_param_lon0">lon0</a>, <a href="#_ll_narcs_distances_param_lat0">lat0</a>, <a href="#_ll_narcs_distances_param_arc_dist">arc_dist</a>, <a href="#_ll_narcs_distances_param_az">az</a></span>, <a href="#_ll_narcs_distances_keyword_DEGREES">DEGREES</a>=<span class="result">DEGREES</span>)</p>
118       
119          <div class="comments">
120</div>
121
122          <h3>Return value</h3><div class="preformat">
123 a (2,n) array containing the longitude/latitude of the resulting points.
124 Values are in radians unless the keyword DEGREES is set.
125</div>
126
127         
128            <h3>Parameters</h3>
129       
130           
131            <h4 id="_ll_narcs_distances_param_lon0">lon0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
132              <span class="attr">in</span>
133             
134             
135              <span class="attr">required</span>
136             
137             
138             
139             
140            </h4>
141       
142          <div class="comments">
143 An array containing the longitude of the starting point.
144 Values are assumed to be in radians unless the keyword DEGREES is set.
145</div>
146           
147            <h4 id="_ll_narcs_distances_param_lat0">lat0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
148              <span class="attr">in</span>
149             
150             
151              <span class="attr">required</span>
152             
153             
154             
155             
156            </h4>
157       
158          <div class="comments">
159 An array containing the latitude of the starting point.
160 Values are assumed to be in radians unless the keyword DEGREES is set.
161</div>
162           
163            <h4 id="_ll_narcs_distances_param_arc_dist">arc_dist&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
164              <span class="attr">in</span>
165             
166             
167              <span class="attr">required</span>
168             
169             
170             
171             
172            </h4>
173       
174          <div class="comments">
175 The arc distance from Lon_lat0. The value must be between
176 -!PI and +!PI. To express distances in arc units, divide
177  by the radius of the globe expressed in the original units.
178  For example, if the radius of the earth is 6371 km, divide
179  the distance in km by 6371 to obtain the arc distance.
180</div>
181           
182            <h4 id="_ll_narcs_distances_param_az">az&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
183              <span class="attr">in</span>
184             
185             
186              <span class="attr">required</span>
187             
188             
189             
190             
191            </h4>
192       
193          <div class="comments">
194 The azimuth from Lon_lat0. The value is assumed to be in
195 radians unless the keyword DEGREES is set.
196</div>
197           
198
199         
200
201         
202
203            <h3>Keywords</h3>
204           
205            <h4 id="_ll_narcs_distances_keyword_DEGREES">DEGREES&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
206             
207             
208             
209             
210             
211             
212             
213             
214            </h4>
215       
216            <div class="comments">
217 Set this keyword to express all measurements and results in degrees.
218</div>
219           
220         
221
222          <h3>Examples</h3><div class="preformat">
223 IDL> Lon_lat0 = [1.0, 2.0]; Initial point specified in radians
224 IDL> Arc_Dist = 2.0; Arc distance in radians
225 IDL> Az = 1.0; Azimuth in radians
226 IDL> Result = LL_ARC_DISTANCE(Lon_lat0, Arc_Dist, Az)
227 IDL> PRINT, Result
228       2.91415    -0.622234
229
230 IDL> lon0 = [-10, 20, 100]
231 IDL> lat0 = [0, -10, 45]
232 IDL> lon1 = [10, 60, 280]
233 IDL> lat1 = [0, 10, 45]
234 IDL> dist = map_npoints(lon0, lat0, lon1, lat1, azimuth = azi, /two_by_two)
235 IDL> earthradius = 6378206.4d0
236 IDL> res = ll_narcs_distances(lon0, lat0, dist/earthradius, azi, /degrees)
237 IDL> print, reform(res[0, *])
238       10.000000       60.000000       280.00000
239 IDL> print, reform(res[1, *])
240           1.1999280e-15       10.000000       45.000000
241</div>
242          <h3>Version history</h3>
243         
244          <h4>Version</h4><div class="preformat">
245 $Id: ll_narcs_distances.pro 327 2007-12-13 16:22:35Z pinsard $
246</div>
247          <h4>History</h4><div class="preformat">
248       Based on the IDL function ll_arc_distance.pro,v 1.11 2003/02/03
249 Sebastien Masson (smasson@lodyc.jussieu.fr)
250                  August 2005
251</div>
252         
253         
254         
255         
256         
257         
258         
259       
260         
261         
262         
263         
264         
265         
266         
267       
268          <h3>Statistics</h3>
269          <table class="statistics">
270            <tr><td>McCabe cyclic</td><td>           5</td></tr>
271            <tr><td>McCabe essential</td><td>           1</td></tr>
272            <tr><td>McCabe modular design</td><td>           1</td></tr>
273          </table>
274         
275       
276        </div>
277       
278      </div>
279
280     
281
282      <div id="tagline">Produced by IDLdoc 2.0.</div>
283
284    </div>
285
286  </body>
287</html>
Note: See TracBrowser for help on using the repository browser.