Mercator.cs
上传用户:sex100000
上传日期:2013-11-09
资源大小:1377k
文件大小:13k
源码类别:

GIS编程

开发平台:

C#

  1. // Copyright 2005, 2006 - Morten Nielsen (www.iter.dk)
  2. //
  3. // This file is part of SharpMap.
  4. // SharpMap is free software; you can redistribute it and/or modify
  5. // it under the terms of the GNU Lesser General Public License as published by
  6. // the Free Software Foundation; either version 2 of the License, or
  7. // (at your option) any later version.
  8. // 
  9. // SharpMap is distributed in the hope that it will be useful,
  10. // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12. // GNU Lesser General Public License for more details.
  13. // You should have received a copy of the GNU Lesser General Public License
  14. // along with SharpMap; if not, write to the Free Software
  15. // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA 
  16. // SOURCECODE IS MODIFIED FROM ANOTHER WORK AND IS ORIGINALLY BASED ON GeoTools.NET:
  17. /*
  18.  *  Copyright (C) 2002 Urban Science Applications, Inc. 
  19.  *
  20.  *  This library is free software; you can redistribute it and/or
  21.  *  modify it under the terms of the GNU Lesser General Public
  22.  *  License as published by the Free Software Foundation; either
  23.  *  version 2.1 of the License, or (at your option) any later version.
  24.  *
  25.  *  This library is distributed in the hope that it will be useful,
  26.  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  27.  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  28.  *  Lesser General Public License for more details.
  29.  *
  30.  *  You should have received a copy of the GNU Lesser General Public
  31.  *  License along with this library; if not, write to the Free Software
  32.  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  33.  *
  34.  */
  35. using System;
  36. using System.Collections.Generic;
  37. using System.Collections.ObjectModel;
  38. using SharpMap.CoordinateSystems;
  39. using SharpMap.CoordinateSystems.Transformations;
  40. namespace SharpMap.CoordinateSystems.Projections
  41. {
  42. /// <summary>
  43. /// Implements the Mercator projection.
  44. /// </summary>
  45. /// <remarks>
  46. /// <para>This map projection introduced in 1569 by Gerardus Mercator. It is often described as a cylindrical projection,
  47. /// but it must be derived mathematically. The meridians are equally spaced, parallel vertical lines, and the
  48. /// parallels of latitude are parallel, horizontal straight lines, spaced farther and farther apart as their distance
  49. /// from the Equator increases. This projection is widely used for navigation charts, because any straight line
  50. /// on a Mercator-projection map is a line of constant true bearing that enables a navigator to plot a straight-line
  51. /// course. It is less practical for world maps because the scale is distorted; areas farther away from the equator
  52. /// appear disproportionately large. On a Mercator projection, for example, the landmass of Greenland appears to be
  53. /// greater than that of the continent of South America; in actual area, Greenland is smaller than the Arabian Peninsula.
  54. /// </para>
  55. /// </remarks>
  56. internal class Mercator : MapProjection
  57. {
  58. double _falseEasting;
  59. double _falseNorthing;
  60. double lon_center; //Center longitude (projection center)
  61. double lat_origin; //center latitude
  62. double e,e2; //eccentricity constants
  63. double k0; //small value m
  64. /// <summary>
  65. /// Initializes the MercatorProjection object with the specified parameters to project points. 
  66. /// </summary>
  67. /// <param name="parameters">ParameterList with the required parameters.</param>
  68. /// <remarks>
  69. /// </remarks>
  70. public Mercator(Collection<ProjectionParameter> parameters)
  71. : this(parameters, false)
  72. {
  73. }
  74. /// <summary>
  75. /// Initializes the MercatorProjection object with the specified parameters.
  76. /// </summary>
  77. /// <param name="parameters">List of parameters to initialize the projection.</param>
  78. /// <param name="isInverse">Indicates whether the projection forward (meters to degrees or degrees to meters).</param>
  79. /// <remarks>
  80. /// <para>The parameters this projection expects are listed below.</para>
  81. /// <list type="table">
  82. /// <listheader><term>Items</term><description>Descriptions</description></listheader>
  83. /// <item><term>central_meridian</term><description>The longitude of the point from which the values of both the geographical coordinates on the ellipsoid and the grid coordinates on the projection are deemed to increment or decrement for computational purposes. Alternatively it may be considered as the longitude of the point which in the absence of application of false coordinates has grid coordinates of (0,0).</description></item>
  84. /// <item><term>latitude_of_origin</term><description>The latitude of the point from which the values of both the geographical coordinates on the ellipsoid and the grid coordinates on the projection are deemed to increment or decrement for computational purposes. Alternatively it may be considered as the latitude of the point which in the absence of application of false coordinates has grid coordinates of (0,0).</description></item>
  85. /// <item><term>scale_factor</term><description>The factor by which the map grid is reduced or enlarged during the projection process, defined by its value at the natural origin.</description></item>
  86. /// <item><term>false_easting</term><description>Since the natural origin may be at or near the centre of the projection and under normal coordinate circumstances would thus give rise to negative coordinates over parts of the mapped area, this origin is usually given false coordinates which are large enough to avoid this inconvenience. The False Easting, FE, is the easting value assigned to the abscissa (east).</description></item>
  87. /// <item><term>false_northing</term><description>Since the natural origin may be at or near the centre of the projection and under normal coordinate circumstances would thus give rise to negative coordinates over parts of the mapped area, this origin is usually given false coordinates which are large enough to avoid this inconvenience. The False Northing, FN, is the northing value assigned to the ordinate.</description></item>
  88. /// </list>
  89. /// </remarks>
  90. public Mercator(Collection<ProjectionParameter> parameters, bool isInverse)
  91. : base(parameters, isInverse)
  92. {
  93. this.Authority = "EPSG";
  94. ProjectionParameter central_meridian = GetParameter("central_meridian");
  95. ProjectionParameter latitude_of_origin = GetParameter("latitude_of_origin");
  96. ProjectionParameter scale_factor = GetParameter("scale_factor");
  97. ProjectionParameter false_easting = GetParameter("false_easting");
  98. ProjectionParameter false_northing = GetParameter("false_northing");
  99. //Check for missing parameters
  100. if (central_meridian == null)
  101. throw new ArgumentException("Missing projection parameter 'central_meridian'");
  102. if (latitude_of_origin == null)
  103. throw new ArgumentException("Missing projection parameter 'latitude_of_origin'");
  104. if (false_easting == null)
  105. throw new ArgumentException("Missing projection parameter 'false_easting'");
  106. if (false_northing == null)
  107. throw new ArgumentException("Missing projection parameter 'false_northing'");
  108. lon_center = Degrees2Radians(central_meridian.Value);
  109. lat_origin = Degrees2Radians(latitude_of_origin.Value);
  110. _falseEasting = false_easting.Value;
  111. _falseNorthing = false_northing.Value;
  112. double temp = this._semiMinor / this._semiMajor;
  113. e2 = 1 - temp * temp;
  114. e = Math.Sqrt(e2);
  115. if (scale_factor == null) //This is a two standard parallel Mercator projection (2SP)
  116. {
  117. k0 = Math.Cos(lat_origin) / Math.Sqrt(1.0 - e2 * Math.Sin(lat_origin) * Math.Sin(lat_origin));
  118. this.AuthorityCode = 9805;
  119. this.Name = "Mercator_2SP";
  120. }
  121. else //This is a one standard parallel Mercator projection (1SP)
  122. {
  123. k0 = scale_factor.Value;
  124. this.Name = "Mercator_1SP";
  125. }
  126. this.Authority = "EPSG";
  127. }
  128. /// <summary>
  129. /// Converts coordinates in decimal degrees to projected meters.
  130. /// </summary>
  131. /// <remarks>
  132. /// <para>The parameters this projection expects are listed below.</para>
  133. /// <list type="table">
  134. /// <listheader><term>Items</term><description>Descriptions</description></listheader>
  135. /// <item><term>longitude_of_natural_origin</term><description>The longitude of the point from which the values of both the geographical coordinates on the ellipsoid and the grid coordinates on the projection are deemed to increment or decrement for computational purposes. Alternatively it may be considered as the longitude of the point which in the absence of application of false coordinates has grid coordinates of (0,0).  Sometimes known as ""central meridian""."</description></item>
  136. /// <item><term>latitude_of_natural_origin</term><description>The latitude of the point from which the values of both the geographical coordinates on the ellipsoid and the grid coordinates on the projection are deemed to increment or decrement for computational purposes. Alternatively it may be considered as the latitude of the point which in the absence of application of false coordinates has grid coordinates of (0,0).</description></item>
  137. /// <item><term>scale_factor_at_natural_origin</term><description>The factor by which the map grid is reduced or enlarged during the projection process, defined by its value at the natural origin.</description></item>
  138. /// <item><term>false_easting</term><description>Since the natural origin may be at or near the centre of the projection and under normal coordinate circumstances would thus give rise to negative coordinates over parts of the mapped area, this origin is usually given false coordinates which are large enough to avoid this inconvenience. The False Easting, FE, is the easting value assigned to the abscissa (east).</description></item>
  139. /// <item><term>false_northing</term><description>Since the natural origin may be at or near the centre of the projection and under normal coordinate circumstances would thus give rise to negative coordinates over parts of the mapped area, this origin is usually given false coordinates which are large enough to avoid this inconvenience. The False Northing, FN, is the northing value assigned to the ordinate .</description></item>
  140. /// </list>
  141. /// </remarks>
  142. /// <param name="lonlat">The point in decimal degrees.</param>
  143. /// <returns>Point in projected meters</returns>
  144. public override SharpMap.Geometries.Point DegreesToMeters(SharpMap.Geometries.Point lonlat)
  145. {
  146. if (double.IsNaN(lonlat.X) || double.IsNaN(lonlat.Y))
  147. return null;
  148. double dLongitude = Degrees2Radians(lonlat.X);
  149. double dLatitude = Degrees2Radians(lonlat.Y);
  150. /* Forward equations */
  151. if (Math.Abs(Math.Abs(dLatitude) - HALF_PI)  <= EPSLN)
  152. {
  153. throw new ApplicationException("Transformation cannot be computed at the poles.");
  154. }
  155. else
  156. {
  157. double esinphi = e*Math.Sin(dLatitude);
  158. double x = _falseEasting + this._semiMajor * k0 * (dLongitude - lon_center);
  159. double y = _falseNorthing + this._semiMajor * k0 * Math.Log(Math.Tan(PI * 0.25 + dLatitude * 0.5) * Math.Pow((1 - esinphi) / (1 + esinphi), e * 0.5));
  160. return new SharpMap.Geometries.Point(x, y);
  161. }
  162. }
  163. /// <summary>
  164. /// Converts coordinates in projected meters to decimal degrees.
  165. /// </summary>
  166. /// <param name="p">Point in meters</param>
  167. /// <returns>Transformed point in decimal degrees</returns>
  168. public override SharpMap.Geometries.Point MetersToDegrees(SharpMap.Geometries.Point p)
  169. {
  170. double dLongitude =Double.NaN ; 
  171. double dLatitude =Double.NaN ;
  172. /* Inverse equations
  173.   -----------------*/
  174. double dX = p.X - this._falseEasting;
  175. double dY = p.Y - this._falseNorthing;
  176. double ts = Math.Exp(-dY/(this._semiMajor * k0)); //t
  177. double chi = HALF_PI - 2 * Math.Atan(ts);
  178. double e4 = Math.Pow(e, 4);
  179. double e6 = Math.Pow(e, 6);
  180. double e8 = Math.Pow(e, 8);
  181. dLatitude = chi + (e2 * 0.5 + 5 * e4 / 24 + e6 / 12 + 13 * e8 / 360) * Math.Sin(2 * chi)
  182. + (7 * e4 / 48 + 29 * e6 / 240 + 811 * e8 / 11520) * Math.Sin(4 * chi) +
  183. +(7 * e6 / 120 + 81 * e8 / 1120) * Math.Sin(6 * chi) +
  184. +(4279 * e8 / 161280) * Math.Sin(8 * chi);
  185. //dLatitude = phi2z(e,ts,out flag);
  186. /*if (flag != 0)
  187. {
  188. throw new ApplicationException();
  189. }*/
  190. dLongitude = (p.X - this._falseEasting) / (this._semiMajor * k0) + lon_center;
  191. //dLongitude = adjust_lon(lon_center + dX/(this._semiMajor * k0));
  192. return new SharpMap.Geometries.Point(Radians2Degrees(dLongitude), Radians2Degrees(dLatitude));
  193. }
  194. /// <summary>
  195. /// Returns the inverse of this projection.
  196. /// </summary>
  197. /// <returns>IMathTransform that is the reverse of the current projection.</returns>
  198. public override IMathTransform Inverse()
  199. {
  200. if (_inverse==null)
  201. {
  202. _inverse = new Mercator(this._Parameters, ! _isInverse);
  203. }
  204. return _inverse;
  205. }
  206. }
  207. }