śĪĮĢ·NĪ      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ”¢£¤„¦§ Ø © Ŗ « ¬ ­ ® Æ ° ± ² ³ “ µ ¶ · ø ¹ ŗ » ¼ ½ ¾ æ Ą Į Ā Ć Ä Å Ę Ē Č É Ź Ė Ģ Ķ SafeSafe Parameters to build Ellipsoid. !Semi major and semi minor axises. &Semi major axis and eccentric squared. #To represent a reference ellipsoid. Semi major axis.Semi minor axis.Eccentricity squared. Flattening..Create an Ellipsoid with the given parameters.Pre-determined ellipsoids:$ Ellipsoid parameters.The created Ellipsoid. !"#$%&'()*+#  !"#$%&'()*$  + !"#$%&'()*   !"#$%&'()*+Safe -ÖTo represent a set of parameters for describing a particular datum, including a name, the reference ellipsoid used and the seven parameters required to translate co-ordinates in this datum to the WGS84 datum./The name of this Datum.03The reference ellipsoid associated with this Datum.1ĪTranslation along the x-axis for use in 7-parameter Helmert transformations. This value should be used to convert a co-ordinate in a given datum to the WGS84 datum.2ĪTranslation along the y-axis for use in 7-parameter Helmert transformations. This value should be used to convert a co-ordinate in a given datum to the WGS84 datum.3ĪTranslation along the z-axis for use in 7-parameter Helmert transformations. This value should be used to convert a co-ordinate in a given datum to the WGS84 datum.4¾Scale factor for use in 7-parameter Helmert transformations. This value should be used to convert a co-ordinate in a given datum to the WGS84 datum.5ĖRotation about the x-axis for use in 7-parameter Helmert transformations. This value should be used to convert a co-ordinate in a given datum to the WGS84 datum.6ĖRotation about the y-axis for use in 7-parameter Helmert transformations. This value should be used to convert a co-ordinate in a given datum to the WGS84 datum.7ĖRotation about the z-axis for use in 7-parameter Helmert transformations. This value should be used to convert a co-ordinate in a given datum to the WGS84 datum.8Pre-determined data:#-./0123456789:;<=>?@ABCDEFGHIJKLMNO#-.4/012356789:;<=>?@ABCDEFGHIJKLMNO#-./0123456789:;<=>?@ABCDEFGHIJKLMNO- ./0123456789:;<=>?@ABCDEFGHIJKLMNOSafeZiConvert this LatLng from the OSGB36 datum to the WGS84 datum using an approximate Helmert transformation.\iConvert this LatLng from the WGS84 datum to the OSGB36 datum using an approximate Helmert transformation.]\Calculate the surface distance in kilometres from this LatLngPoint to the given LatLngPoint.^WCalculate the surface distance in miles from this LatLngPoint to the given LatLngPoint.RSTUVWXYZ[\]^_`abcdefgRSTUVWXYZ[\]^_`abcdefgRSTUVWXYZ[\]^_`abcdefgRSTUVWXYZ[\]^_`abcdefgSafei’ŠECEF (earth-centred, earth-fixed) Cartesian co-ordinates are used to define a point in three-dimensional space. ECEF co-ordinates are defined relative to an x-axis (the intersection of the equatorial plane and the plane defined by the prime meridian), a y-axis (at 90&deg; to the x-axis and its intersection with the equator) and a z-axis (intersecting the North Pole). All the axes intersect at the point defined by the centre of mass of the Earth.oXCreate a new earth-centred, earth-fixed reference from the given latitude and longitude.p(Convert this ECEFRef object to a LatLng.ijklmnopijklmnopijklmnopijklmnopSafe tJThe easting in metres relative to the origin of the British National Grid.uKThe northing in metres relative to the origin of the British National Grid.|æCreate a new Ordnance Survey grid reference using a given easting and northing. The easting and northing must be in metres and must be relative to the origin of the British National Grid.}@Take a string formatted as a six-figure OS grid reference (e.g. TG514131É) and create a new OSRef object that represents that grid reference. The first character must be H, N, S, O or T. The second character can be any uppercase character from A through Z excluding I.~@Create an IrishRef object from the given latitude and longitude.oReturn a String representation of this Irish grid reference using the six-figure notation in the form X123456€ĒConvert this Irish grid reference to a latitude/longitude pair using the Ireland 1965 datum. Note that, the LatLng object may need to be converted to the WGS84 datum depending on the application.Validate the easting.‚Validate the northing.rstuvwxyz{|SThe easting in metres. Must be greater than or equal to 0.0 and less than 400000.0.`The northing in metres. Must be greater than or equal to 0.0 and less than or equal to 500000.0.FThrows an exception if either the easting or the northing are invalid.}WA String representing a six-figure Ordnance Survey grid reference in the form XY123456.7Throws an exception if ref is not of the form XY123456.~€?To represent Irish grid reference using the Ireland 1965 datum.SThe easting in metres. Must be greater than or equal to 0.0 and less than 400000.0..Throws an Exception if the easting is invalid.‚`The northing in metres. Must be greater than or equal to 0.0 and less than or equal to 500000.0./Throws an Exception if the northing is invalid.rsvtuwxyz{|}~€‚rstuvwxyz{|}~€‚ rstuvwxyz{|}~€‚Safe …AA six-figure representation this OSGB grid reference i.e XY123456†EA eight-figure representation this OSGB grid reference i.e XY12345678‰JThe easting in metres relative to the origin of the British National Grid.ŠKThe northing in metres relative to the origin of the British National Grid.‘æCreate a new Ordnance Survey grid reference using a given easting and northing. The easting and northing must be in metres and must be relative to the origin of the British National Grid.’@Take a string formatted as a six-figure OS grid reference (e.g. TG514131É) and create a new OSRef object that represents that grid reference. The first character must be H, N, S, O or T. The second character can be any uppercase character from A through Z excluding I.“^Convert latitude and longitude into an OSGB (Ordnance Survey of Great Britain) grid reference.–ĄConvert this OSGB grid reference to a latitude/longitude pair using the OSGB36 datum. Note that, the LatLng object may need to be converted to the WGS84 datum depending on the application.—Validate the easting.˜Validate the northing.„…†‡ˆ‰Š‹ŒŽ‘SThe easting in metres. Must be greater than or equal to 0.0 and less than 800000.0.UThe northing in metres. Must be greater than or equal to 0.0 and less than 1400000.0.FThrows an exception if either the easting or the northing are invalid.’Va String representing a six-figure Ordnance Survey grid reference in the form XY1234567Throws an exception if ref is not of the form XY123456.“”•–8To represent OSGB grid reference using the OSGB36 datum.—SThe easting in metres. Must be greater than or equal to 0.0 and less than 800000.0..Throws an Exception if the easting is invalid.˜UThe northing in metres. Must be greater than or equal to 0.0 and less than 1400000.0./Throws an Exception if the northing is invalid.„…†‡ˆ‹‰ŠŒŽ‘’“”•–—˜‡ˆ‰Š‹„…†ŒŽ‘’“”•–—˜„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜SafeEastingžNorthingŸLatitude zone character Longitude zone number¢’bCreate a new UTM reference object. Checks are made to make sure that the given parameters are roughly valid, but the checks are not exhaustive with regards to the easting value. Catching an exception does not necessarily mean that the UTM reference is well-formed. This is because that valid values for the easting vary depending on the latitude.£7Convert this UTM reference to a latitude and longitude.¤éConvert latitude and longitude to a UTM reference. If an attempt is made to convert a LatLng that falls outside the area covered by the UTM grid. The UTM grid is only defined for latitudes south of 84&deg;N and north of 80&deg;S.„1Work out the UTM latitude zone from the latitude. ›œžŸ ”¢The easting in metresThe northing in metresThe latitude zone characterThe longitude zone number’If any of the parameters are invalid. Be careful that a valid value for the easting does not necessarily mean that the UTM reference is well-formed. The current checks do not take into account the varying range of valid values for the easting for different latitudes.£¤„ ›œ”žŸ ¢£¤„ ›œžŸ ”¢£¤„›œžŸ ”¢£¤„ None Øprecision of 1m©precision of 10mŖprecision of 100m«precision of 1000m (1km)¬precision of 10000m (10km)øNorthing characters¹bReturn a String representation of this MGRS reference to 1m, 10m, 100m, 1000m or 10000m precision.ŗęCreate a new MGRS reference object from the given UTM reference. It is assumed that this MGRS reference represents a point using the GRS 1980, International or WGS84 ellipsoids. It is assumed that the UTMRef object is valid.¼Create a new MGRS reference object from the given String. Must be correctly formatted otherwise an IllegalArgumentException will be thrown.½;Convert this MGRS reference to an equivelent UTM reference.§Ø©Ŗ«¬­®Æ°±²³“µ¶·ø¹~One of MGRSRef.PRECISION_1M, MGRSRef.PRECISION_10M, MGRSRef.PRECISION_100M, MGRSRef.PRECISION_1000M, MGRSRef.PRECISION_10000M.I~ String representation of this MGRS reference to the required precision.ŗUTM reference.¾True if the parameters represent an MGRS reference using the Bessel 1841 ellipsoid; false is the parameters represent an MGRS reference using the GRS 1980, International or WGS84 ellipsoids.» QThe easting in metres. Must be greater than or equal to 0.0 and less than 100000.`The northing in metres. Must be greater than or equal to 0.0 and less than or equal to 500000.0.8The character representing the 100,000km easting square.9The character representing the 100,000km northing square./The UTM zone number representing the longitude.1The UTM zone character representing the latitude.0The precision of the given easting and northing.¾True if the parameters represent an MGRS reference using the Bessel 1841 ellipsoid; False is the parameters represent an MGRS reference using the GRS 1980, International or WGS84 ellipsoids.÷Throws an exception if any of the given parameters are invalid. Note that the parameters are only checked for the range of values that they can take on. Being able to create an MGRSRef object does not necessarily imply that the reference is valid.¼*A String to create an MGRS reference from.CThrows an exception if the given String is not correctly formatted.½¾æ§Ø©Ŗ«¬­®·Æ°µ±²³“¶ø¹ŗ»¼½­®Æ°±²³“µ¶·§Ø©Ŗ«¬æø¾¹ŗ»¼½ §Ø©Ŗ«¬­ ®Æ°±²³“µ¶·ø¹ŗ»¼½¾æ SafeČ(Longitude is east of the prime meridian.É(Longitude is west of the prime meridian.Ė!Latitude is north of the equator.Ģ!Latitude is south of the equator. ĀĆÄÅĘĒČÉŹĖĢĶ ĀĆÄÅĘĒČÉŹĖĢĶ ŹĖĢĒČÉĀĆÄÅĘĶĀĆÄÅĘĒČÉŹĖĢĶĪ    !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnop\qrstu\vwxyz{|}~r€‚ƒ„tu\vwxyz…†‡ˆ‰r€Š‹tuŒ\Žr‘ ‚ ’ “ ” • –   t u — ˜ ™ š › œ \  ž Ÿ   ”  ¢ £ ¤ „   ¦ § Ø © Ŗ « ¬ ­ ® rÆ%hcoord-1.0.0.0-HWNtg31BRy2KPToB2CQ5xhMathExtensions EllipsoidDatumLatLngECEFRefIrishRefOSRefUTMRefMGRSRefDMS toRadians toDegrees sinSquaredsinCubed cosSquaredcosCubed tanSquaredsecEllipsoidParamsSemiMajMinAxisesSemiMajAxisEccentricitySquared semiMajorAxis semiMinorAxiseccentricitySquared flattening mkEllipsoidairy1830EllipsoidaustralianNational1966Ellipsoidbessel1841Ellipsoidclarke1866Ellipsoidclarke1880Ellipsoideverest1830Ellipsoidfischer1960Ellipsoidfischer1968Ellipsoidgrs67Ellipsoidgrs75Ellipsoidgrs80Ellipsoidhayford1910Ellipsoidhelmert1906Ellipsoidhough1956Ellipsoidiers1989EllipsoidinternationalEllipsoidkrassovsky1940EllipsoidmodifiedAiryEllipsoidmodifiedEverestEllipsoidnewInternational1967EllipsoidsouthAmerican1969Ellipsoidwgs60Ellipsoidwgs66Ellipsoidwgs72Ellipsoidwgs84Ellipsoid$fShowEllipsoid $fEqEllipsoidname ellipsoiddxdydzdsrxryrz etrf89Datumireland1965Datum osgb36Datum wgs84Datumnad27GreenlandDatumnad27WesternUSDatumnad27AlaskaDatumnad27CentralAmericaDatumnad27SanSalvadorDatum nad27AlbertaBritishColumbiaDatumnad27CanadaEastDatumnad27ContiguousUSDatumnad27MexicoDatumnad27BahamasDatumnad27CanadaNWTerritoryDatumnad27CanadaManitobaOntarioDatumnad27CanadaDatumnad27CanadaYukonDatumnad27CubaDatumnad27AleutianWestDatumnad27AleutianEastDatumnad27CanalZoneDatumnad27EasternUSDatumnad27CaribbeanDatum $fEqDatum $fShowDatumlatitude longitudeheightdatummkLatLng calcPhiN'toWGS84toDatumtoOSGB36distance distanceMileslatitudeDegreeslongitudeDegrees calcDegreeslatitudeMinuteslongitudeMinutes calcMinuteslatitudeSecondslongitudeSeconds calcSeconds $fShowLatLngxyz toECEFReftoLatLng $fShowECEFRefeastingnorthing scaleFactorfalseOriginLatitudefalseOriginLongitudefalseOriginEastingfalseOriginNorthing mkIrishRef mkIrishRef' mkIrishRef''toSixFigureString evalEasting evalNorthing$fShowIrishRef Precision SixDigits EightDigitsmkOSRefmkOSRef'toOSRefgetOsRefWithPrecisionOf evalOsRef $fEqOSRef $fShowOSReflatZonelngZonemkUTMReftoUTMRefgetUTMLatitudeZoneLetter $fShowUTMRefM1M10M100M1000M10000 eastingId northingId utmZoneNumber utmZoneChar precisionisBessel northingIdsshowWithPrecision toMGRSRef mkMGRSRef mkMGRSRef' $fShowMGRSRef$fEnumPrecision $fEqPrecision $fEqMGRSRefdegreesminutesseconds LongitudeDMSEastWest LatitudeDMSNorthSouth