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

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. using System;
  17. using System.Collections.Generic;
  18. using System.Collections.ObjectModel;
  19. using System.Text;
  20. namespace SharpMap.CoordinateSystems
  21. {
  22. /// <summary>
  23. /// Base interface for all coordinate systems.
  24. /// </summary>
  25. /// <remarks>
  26. /// <para>A coordinate system is a mathematical space, where the elements of the space
  27. /// are called positions. Each position is described by a list of numbers. The length 
  28. /// of the list corresponds to the dimension of the coordinate system. So in a 2D 
  29. /// coordinate system each position is described by a list containing 2 numbers.</para>
  30. /// <para>However, in a coordinate system, not all lists of numbers correspond to a 
  31. /// position - some lists may be outside the domain of the coordinate system. For 
  32. /// example, in a 2D Lat/Lon coordinate system, the list (91,91) does not correspond
  33. /// to a position.</para>
  34. /// <para>Some coordinate systems also have a mapping from the mathematical space into 
  35. /// locations in the real world. So in a Lat/Lon coordinate system, the mathematical 
  36. /// position (lat, long) corresponds to a location on the surface of the Earth. This 
  37. /// mapping from the mathematical space into real-world locations is called a Datum.</para>
  38. /// </remarks>
  39. public abstract class CoordinateSystem : Info, ICoordinateSystem
  40. {
  41. /// <summary>
  42. /// Initializes a new instance of a coordinate system.
  43. /// </summary>
  44. /// <param name="name">Name</param>
  45. /// <param name="authority">Authority name</param>
  46. /// <param name="authorityCode">Authority-specific identification code.</param>
  47. /// <param name="alias">Alias</param>
  48. /// <param name="abbreviation">Abbreviation</param>
  49. /// <param name="remarks">Provider-supplied remarks</param>
  50. internal CoordinateSystem(string name, string authority, long authorityCode, string alias, string abbreviation, string remarks)
  51. : base (name,authority,authorityCode,alias,abbreviation,remarks)
  52. {
  53. }
  54. #region ICoordinateSystem Members
  55. /// <summary>
  56. /// Dimension of the coordinate system.
  57. /// </summary>
  58. public int Dimension
  59. {
  60. get { return _AxisInfo.Count; }
  61. }
  62. /// <summary>
  63. /// Gets the units for the dimension within coordinate system. 
  64. /// Each dimension in the coordinate system has corresponding units.
  65. /// </summary>
  66. public abstract IUnit GetUnits(int dimension);
  67. private Collection<AxisInfo> _AxisInfo;
  68. internal Collection<AxisInfo> AxisInfo
  69. {
  70. get { return _AxisInfo; }
  71. set { _AxisInfo = value; }
  72. }
  73. /// <summary>
  74. /// Gets axis details for dimension within coordinate system.
  75. /// </summary>
  76. /// <param name="dimension">Dimension</param>
  77. /// <returns>Axis info</returns>
  78. public AxisInfo GetAxis(int dimension)
  79. {
  80. if (dimension >= _AxisInfo.Count || dimension < 0)
  81. throw new ArgumentException("AxisInfo not available for dimension " + dimension.ToString());
  82. return _AxisInfo[dimension];
  83. }
  84. private SharpMap.Geometries.BoundingBox _DefaultEnvelope;
  85. /// <summary>
  86. /// Gets default envelope of coordinate system.
  87. /// </summary>
  88. /// <remarks>
  89. /// Coordinate systems which are bounded should return the minimum bounding box of their domain. 
  90. /// Unbounded coordinate systems should return a box which is as large as is likely to be used. 
  91. /// For example, a (lon,lat) geographic coordinate system in degrees should return a box from 
  92. /// (-180,-90) to (180,90), and a geocentric coordinate system could return a box from (-r,-r,-r)
  93. /// to (+r,+r,+r) where r is the approximate radius of the Earth.
  94. /// </remarks>
  95. public SharpMap.Geometries.BoundingBox DefaultEnvelope
  96. {
  97. get { return _DefaultEnvelope; }
  98. set { _DefaultEnvelope = value; }
  99. }
  100. #endregion
  101. }
  102. }