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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>GeographicTranslator: C:/master/geotrans3.7/CCS/src/dtcc/CoordinateSystems/trcyleqa/TransverseCylindricalEqualArea.h Source File</title>
<b><p style="text-align:center;color:green;font-size:20px">UNCLASSIFIED</p></b>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">GeographicTranslator
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.2 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>File Members</span></a></li>
</ul>
</div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Friends</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Macros</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_edf3df7db5b0053f7cba67b155deccfc.html">master</a></li><li class="navelem"><a class="el" href="dir_8b3490cac915c107683d68df3d9c98a6.html">geotrans3.7</a></li><li class="navelem"><a class="el" href="dir_d0951f0e396e7f3ab5db438f6b9f5363.html">CCS</a></li><li class="navelem"><a class="el" href="dir_3b11bca187df89c3daa83d17707827d4.html">src</a></li><li class="navelem"><a class="el" href="dir_ce1728a50ed0f8e5fbefa80fc2874faa.html">dtcc</a></li><li class="navelem"><a class="el" href="dir_5d8cc6cdb4437c7c87ccad9605085cdb.html">CoordinateSystems</a></li><li class="navelem"><a class="el" href="dir_aecd488e034c7675fe764c1bf6aaf071.html">trcyleqa</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">TransverseCylindricalEqualArea.h</div> </div>
</div><!--header-->
<div class="contents">
<a href="_transverse_cylindrical_equal_area_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">// CLASSIFICATION: UNCLASSIFIED</span></div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="preprocessor">#ifndef TransverseCylindricalEqualArea_H</span></div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="preprocessor"></span><span class="preprocessor">#define TransverseCylindricalEqualArea_H</span></div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment">/***************************************************************************/</span></div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment">/* RSC IDENTIFIER: TRANSVERSE CYLINDRICAL EQUAL AREA</span></div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment"> * ABSTRACT</span></div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment"> * This component provides conversions between Geodetic coordinates</span></div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment"> * (latitude and longitude in radians) and Transverse Cylindrical Equal Area</span></div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment"> * projection coordinates (easting and northing in meters).</span></div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment"> * ERROR HANDLING</span></div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment"> * This component checks parameters for valid values. If an invalid value</span></div>
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment"> * is found, the error code is combined with the current error code using</span></div>
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment"> * the bitwise or. This combining allows multiple error codes to be</span></div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment"> * returned. The possible error codes are:</span></div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment"> * TCEA_NO_ERROR : No errors occurred in function</span></div>
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment"> * TCEA_LAT_ERROR : Latitude outside of valid range</span></div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment"> * (-90 to 90 degrees)</span></div>
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="comment"> * TCEA_LON_ERROR : Longitude outside of valid range</span></div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="comment"> * (-180 to 360 degrees)</span></div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="comment"> * TCEA_EASTING_ERROR : Easting outside of valid range</span></div>
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="comment"> * (False_Easting +/- ~6,500,000 m,</span></div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="comment"> * depending on ellipsoid parameters</span></div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="comment"> * and Origin_Latitude)</span></div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="comment"> * TCEA_NORTHING_ERROR : Northing outside of valid range</span></div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="comment"> * (False_Northing +/- ~20,000,000 m,</span></div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="comment"> * depending on ellipsoid parameters</span></div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="comment"> * and Origin_Latitude)</span></div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="comment"> * TCEA_ORIGIN_LAT_ERROR : Origin latitude outside of valid range</span></div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="comment"> * (-90 to 90 degrees)</span></div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="comment"> * TCEA_CENT_MER_ERROR : Central meridian outside of valid range</span></div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="comment"> * (-180 to 360 degrees)</span></div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="comment"> * TCEA_A_ERROR : Semi-major axis less than or equal to zero</span></div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="comment"> * TCEA_INV_F_ERROR : Inverse flattening outside of valid range</span></div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment"> * (250 to 350)</span></div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment"> * TCEA_SCALE_FACTOR_ERROR : Scale factor outside of valid</span></div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment"> * range (0.3 to 3.0)</span></div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment"> * TCEA_LON_WARNING : Distortion will result if longitude is more</span></div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment"> * than 90 degrees from the Central Meridian</span></div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment"> * REUSE NOTES</span></div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment"> * TRANSVERSE CYLINDRICAL EQUAL AREA is intended for reuse by any application that</span></div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment"> * performs a Transverse Cylindrical Equal Area projection or its inverse.</span></div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment"> * REFERENCES</span></div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment"> * Further information on TRANSVERSE CYLINDRICAL EQUAL AREA can be found in the Reuse Manual.</span></div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment"> * TRANSVERSE CYLINDRICAL EQUAL AREA originated from :</span></div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment"> * U.S. Army Topographic Engineering Center</span></div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="comment"> * Geospatial Information Division</span></div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="comment"> * 7701 Telegraph Road</span></div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="comment"> * Alexandria, VA 22310-3864</span></div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="comment"> * LICENSES</span></div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="comment"> * None apply to this component.</span></div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="comment"> * RESTRICTIONS</span></div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="comment"> * TRANSVERSE CYLINDRICAL EQUAL AREA has no restrictions.</span></div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="comment"> * ENVIRONMENT</span></div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="comment"> * TRANSVERSE CYLINDRICAL EQUAL AREA was tested and certified in the following environments:</span></div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="comment"> * 1. Solaris 2.5 with GCC, version 2.8.1</span></div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span> <span class="comment"> * 2. Windows 95 with MS Visual C++, version 6</span></div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="comment"> * MODIFICATIONS</span></div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span> <span class="comment"> * Date Description</span></div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span> <span class="comment"> * ---- -----------</span></div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span> <span class="comment"> * 3-1-07 Original C++ Code</span></div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> </div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span> </div>
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span> <span class="preprocessor">#include "<a class="code" href="_coordinate_system_8h.html">CoordinateSystem.h</a>"</span></div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span> </div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span> </div>
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span> <span class="keyword">namespace </span>MSP</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span> {</div>
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  <span class="keyword">namespace </span>CCS</div>
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  {</div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  <span class="keyword">class </span>MapProjection5Parameters;</div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  <span class="keyword">class </span>MapProjectionCoordinates;</div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="keyword">class </span>GeodeticCoordinates;</div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span> </div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span> </div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  <span class="comment">/***************************************************************************/</span></div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <span class="comment">/*</span></div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span> <span class="comment"> * DEFINES</span></div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span> </div>
<div class="line"><a name="l00103"></a><span class="lineno"><a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html"> 103</a></span>  <span class="keyword">class </span><a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html">TransverseCylindricalEqualArea</a> : <span class="keyword">public</span> <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_coordinate_system.html">CoordinateSystem</a></div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  {</div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  <span class="keyword">public</span>:</div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span> </div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="comment">/*</span></div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span> <span class="comment"> * The constructor receives the ellipsoid parameters and</span></div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span> <span class="comment"> * Transverse Cylindrical Equal Area projection parameters as inputs, and sets the</span></div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span> <span class="comment"> * corresponding state variables. If any errors occur, an exception is thrown with a description </span></div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span> <span class="comment"> * of the error.</span></div>
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span> <span class="comment"> * ellipsoidSemiMajorAxis : Semi-major axis of ellipsoid, in meters (input)</span></div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span> <span class="comment"> * ellipsoidFlattening : Flattening of ellipsoid (input)</span></div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="comment"> * centralMeridian : Longitude in radians at the center of (input)</span></div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span> <span class="comment"> * the projection</span></div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span> <span class="comment"> * latitudeOfTrueScale : Latitude in radians at which the (input)</span></div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="comment"> * point scale factor is 1.0</span></div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span> <span class="comment"> * falseEasting : A coordinate value in meters assigned to the</span></div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span> <span class="comment"> * central meridian of the projection. (input)</span></div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span> <span class="comment"> * falseNorthing : A coordinate value in meters assigned to the</span></div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <span class="comment"> * origin latitude of the projection (input)</span></div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span> <span class="comment"> * scaleFactor : Multiplier which reduces distances in the</span></div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span> <span class="comment"> * projection to the actual distance on the</span></div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="comment"> * ellipsoid (input)</span></div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="comment"> * errorStatus : Error status (output) </span></div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span> </div>
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html#a6418c4613a9c5da6d2fc77564276fc5a">TransverseCylindricalEqualArea</a>( <span class="keywordtype">double</span> ellipsoidSemiMajorAxis, <span class="keywordtype">double</span> ellipsoidFlattening, <span class="keywordtype">double</span> centralMeridian, <span class="keywordtype">double</span> latitudeOfTrueScale, <span class="keywordtype">double</span> falseEasting, <span class="keywordtype">double</span> falseNorthing, <span class="keywordtype">double</span> scaleFactor );</div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span> </div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span> </div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html#a6418c4613a9c5da6d2fc77564276fc5a">TransverseCylindricalEqualArea</a>( <span class="keyword">const</span> <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html">TransverseCylindricalEqualArea</a> &tcea );</div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span> </div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span> </div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html#a70a893ddb6b661cc39ba9b91c682cb72">~TransverseCylindricalEqualArea</a>( <span class="keywordtype">void</span> );</div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> </div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span> </div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html">TransverseCylindricalEqualArea</a>& <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html#addb7c1ac29fe212dcc39192d8123f38f">operator=</a>( <span class="keyword">const</span> <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html">TransverseCylindricalEqualArea</a> &tcea );</div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span> </div>
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span> </div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <span class="comment">/*</span></div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span> <span class="comment"> * The function getParameters returns the current ellipsoid</span></div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span> <span class="comment"> * parameters, Transverse Cylindrical Equal Area projection parameters, and scale factor.</span></div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span> <span class="comment"> * ellipsoidSemiMajorAxis : Semi-major axis of ellipsoid, in meters (output)</span></div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span> <span class="comment"> * ellipsoidFlattening : Flattening of ellipsoid (output)</span></div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span> <span class="comment"> * centralMeridian : Longitude in radians at the center of (output)</span></div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span> <span class="comment"> * the projection</span></div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span> <span class="comment"> * latitudeOfTrueScale : Latitude in radians at which the (output)</span></div>
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span> <span class="comment"> * point scale factor is 1.0</span></div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span> <span class="comment"> * falseEasting : A coordinate value in meters assigned to the</span></div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span> <span class="comment"> * central meridian of the projection. (output)</span></div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span> <span class="comment"> * falseNorthing : A coordinate value in meters assigned to the</span></div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span> <span class="comment"> * origin latitude of the projection (output)</span></div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span> <span class="comment"> * scaleFactor : Multiplier which reduces distances in the</span></div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span> <span class="comment"> * projection to the actual distance on the</span></div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span> <span class="comment"> * ellipsoid (output)</span></div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span> </div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_map_projection5_parameters.html">MapProjection5Parameters</a>* <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html#abc4149063378c965f6cc58855a31f474">getParameters</a>() <span class="keyword">const</span>;</div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span> </div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span> </div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  <span class="comment">/*</span></div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span> <span class="comment"> * The function convertFromGeodetic converts geodetic (latitude and</span></div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span> <span class="comment"> * longitude) coordinates to Transverse Cylindrical Equal Area projection (easting and</span></div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span> <span class="comment"> * northing) coordinates, according to the current ellipsoid and Transverse Cylindrical</span></div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span> <span class="comment"> * Equal Area projection parameters. If any errors occur, an exception is thrown with a </span></div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span> <span class="comment"> * description of the error.</span></div>
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span> <span class="comment"> * longitude : Longitude (lambda) in radians (input)</span></div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span> <span class="comment"> * latitude : Latitude (phi) in radians (input)</span></div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span> <span class="comment"> * easting : Easting (X) in meters (output)</span></div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span> <span class="comment"> * northing : Northing (Y) in meters (output)</span></div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span> </div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_map_projection_coordinates.html">MSP::CCS::MapProjectionCoordinates</a>* <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html#a69a96a78f229e444ce859f38843180b7">convertFromGeodetic</a>( <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_geodetic_coordinates.html">MSP::CCS::GeodeticCoordinates</a>* geodeticCoordinates );</div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span> </div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span> </div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <span class="comment">/*</span></div>
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span> <span class="comment"> * The function convertToGeodetic converts Transverse</span></div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span> <span class="comment"> * Cylindrical Equal Area projection (easting and northing) coordinates</span></div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span> <span class="comment"> * to geodetic (latitude and longitude) coordinates, according to the</span></div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span> <span class="comment"> * current ellipsoid and Transverse Cylindrical Equal Area projection</span></div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span> <span class="comment"> * coordinates. If any errors occur, an exception is thrown with a </span></div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span> <span class="comment"> * description of the error.</span></div>
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span> <span class="comment"> * easting : Easting (X) in meters (input)</span></div>
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span> <span class="comment"> * northing : Northing (Y) in meters (input)</span></div>
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span> <span class="comment"> * longitude : Longitude (lambda) in radians (output)</span></div>
<div class="line"><a name="l00190"></a><span class="lineno"> 190</span> <span class="comment"> * latitude : Latitude (phi) in radians (output)</span></div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span> </div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_geodetic_coordinates.html">MSP::CCS::GeodeticCoordinates</a>* <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_transverse_cylindrical_equal_area.html#a5ecc8e788bbde44047e8128396f1b421">convertToGeodetic</a>( <a class="code" href="class_m_s_p_1_1_c_c_s_1_1_map_projection_coordinates.html">MSP::CCS::MapProjectionCoordinates</a>* mapProjectionCoordinates );</div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span> </div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  <span class="keyword">private</span>:</div>
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  </div>
<div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  <span class="comment">/* Ellipsoid Parameters, default to WGS 84 */</span></div>
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  <span class="keywordtype">double</span> es2; <span class="comment">/* Eccentricity (0.08181919084262188000) squared */</span></div>
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  <span class="keywordtype">double</span> es4; <span class="comment">/* es2 * es2 */</span></div>
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  <span class="keywordtype">double</span> es6; <span class="comment">/* es4 * es2 */</span></div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  <span class="keywordtype">double</span> es; <span class="comment">/* sqrt(es2) */</span></div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  <span class="keywordtype">double</span> M0;</div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  <span class="keywordtype">double</span> qp;</div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="keywordtype">double</span> One_MINUS_es2; <span class="comment">/* 1.0 - es2 */</span></div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  <span class="keywordtype">double</span> One_OVER_2es; <span class="comment">/* 1.0 / (2.0 * es) */</span></div>
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="keywordtype">double</span> a0; <span class="comment">/* es2 / 3.0 + 31.0 * es4 / 180.0 + 517.0 * es6 / 5040.0 */</span></div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  <span class="keywordtype">double</span> a1; <span class="comment">/* 23.0 * es4 / 360.0 + 251.0 * es6 / 3780.0 */</span></div>
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <span class="keywordtype">double</span> a2; <span class="comment">/* 761.0 * es6 / 45360.0 */</span></div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <span class="keywordtype">double</span> b0; <span class="comment">/* 3.0 * e1 / 2.0 - 27.0 * e3 / 32.0 */</span></div>
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <span class="keywordtype">double</span> b1; <span class="comment">/* 21.0 * e2 / 16.0 - 55.0 * e4 / 32.0 */</span></div>
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  <span class="keywordtype">double</span> b2; <span class="comment">/* 151.0 * e3 / 96.0 */</span></div>
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  <span class="keywordtype">double</span> b3; <span class="comment">/* 1097.0 * e4 / 512.0 */</span></div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  <span class="keywordtype">double</span> c0; <span class="comment">/* 1.0 - es2 / 4.0 - 3.0 * es4 / 64.0 - 5.0 * es6 / 256.0 */</span></div>
<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="keywordtype">double</span> c1; <span class="comment">/* 3.0 * es2 / 8.0 + 3.0 * es4 / 32.0 + 45.0 * es6 / 1024.0 */</span></div>
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  <span class="keywordtype">double</span> c2; <span class="comment">/* 15.0 * es4 / 256.0 + 45.0 * es6 / 1024.0 */</span></div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <span class="keywordtype">double</span> c3; <span class="comment">/* 35.0 * es6 / 3072.0 */</span></div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span> </div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  <span class="comment">/* Transverse Cylindrical Equal Area projection Parameters */</span></div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  <span class="keywordtype">double</span> Tcea_Origin_Lat; <span class="comment">/* Latitude of origin in radians */</span></div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="keywordtype">double</span> Tcea_Origin_Long; <span class="comment">/* Longitude of origin in radians */</span></div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  <span class="keywordtype">double</span> Tcea_False_Northing; <span class="comment">/* False northing in meters */</span></div>
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  <span class="keywordtype">double</span> Tcea_False_Easting; <span class="comment">/* False easting in meters */</span></div>
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  <span class="keywordtype">double</span> Tcea_Scale_Factor; <span class="comment">/* Scale factor */</span></div>
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span> </div>
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  <span class="comment">/* Maximum variance for easting and northing values for WGS 84.</span></div>
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</span>  <span class="keywordtype">double</span> Tcea_Min_Easting;</div>
<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  <span class="keywordtype">double</span> Tcea_Max_Easting;</div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  <span class="keywordtype">double</span> Tcea_Min_Northing;</div>
<div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  <span class="keywordtype">double</span> Tcea_Max_Northing;</div>
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span> </div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span> </div>
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  <span class="keywordtype">double</span> TCEA_Q( <span class="keywordtype">double</span> sinlat, <span class="keywordtype">double</span> x );</div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  </div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  <span class="keywordtype">double</span> TCEA_COEFF_TIMES_SIN( <span class="keywordtype">double</span> coeff, <span class="keywordtype">double</span> x, <span class="keywordtype">double</span> latit ); </div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span> </div>
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  <span class="keywordtype">double</span> TCEA_M( <span class="keywordtype">double</span> c0lat, <span class="keywordtype">double</span> c1lat, <span class="keywordtype">double</span> c2lat, <span class="keywordtype">double</span> c3lat ); </div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span> </div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  <span class="keywordtype">double</span> TCEA_L( <span class="keywordtype">double</span> Beta, <span class="keywordtype">double</span> c0lat, <span class="keywordtype">double</span> c1lat, <span class="keywordtype">double</span> c2lat ); </div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span> </div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  };</div>
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span>  }</div>
<div class="line"><a name="l00243"></a><span class="lineno"> 243</span> }</div>
<div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  </div>
<div class="line"><a name="l00245"></a><span class="lineno"> 245</span> <span class="preprocessor">#endif </span></div>
<div class="line"><a name="l00246"></a><span class="lineno"> 246</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00247"></a><span class="lineno"> 247</span> </div>
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span> <span class="comment">// CLASSIFICATION: UNCLASSIFIED</span></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Tue Feb 16 2016 14:54:02 for GeographicTranslator by doxygen 1.8.2
</small></address>
</body>
</html>
|
