v2.9.6.1

Improves GeoFence efficiency by replicating Coordinate eager loading settings.

v2.9.5.1

-Parser improvements.

MGRS strings will fail correctly vs attempting to fix an incorrect string. For example "SMART" would parse as "0ART00". This bug was introduced when meter specification was removed to improve the parser.

v.2.9.4.2

• Fixes binary serialization issues with new celestial coordinates.
• Adds publicly available subscribable "CoordinateChanged" event in preparation for new library extensions.
• Releases CoordinateSharp.Magnetic extension package. This package will allow for magnetic field calculations.

Magnetic Guide
Magnetic Package

Coordinate c = Coordinate(25,25, new DateTime(2020,1,1));
Magnetic m = new Magnetic(c, DataModel.WMM2020);

v2.9.4.1

• Fixes UTM parser issue that can occur when Easting and Northing string length are not consistent.

v2.9.3.1

• Fixes UPS parser issue that can occur when Easting and Northing string length are not consistent.

v2.9.2.1

-Fixes issue with subsolar/sublunar points jumping to wrong position during tracking. Only effects new features in v2.9.#.#.

v2.9.1.3

• Fixes critical parsing bug with MGRS coordinates at identifiers MN and ME Issue 171.
• Fixes float point rounding bug causing seconds and decimal minutes to display "60" instead of "0" Issue 170.
• Prepares library for optional extension packages coming soon (magnetic declination, NodaTime handles).
• Adds ability to get solar and lunar coordinates, useful for creating over Earth tracks Issue 164.

//Accessible through Coordinate
Coordinate c = new Coordinate(45, 45, new DateTime(2020, 11, 19, 12, 30, 0));
Console.WriteLine(c.CelestialInfo.LunarCoordinates.SublunarLatitude);//-24.0341
Console.WriteLine(c.CelestialInfo.LunarCoordinates.SublunarLongitude);//51.6318

//Static Method
lc = Celestial.Get_Lunar_Coordinate(new DateTime(2020, 11, 19, 12, 30, 0));
Console.WriteLine(lc.SublunarLatitude);//-24.0341
Console.WriteLine(lc.SublunarLongitude);//51.6318

v2.8.1.1

• Adds Condition property to AltitudeEvents class, allowing users to determine the sun's rise/set condition for a date at specified altitudes.

Example:

Coordinate c = new Coordinate(47.40615, -122.24517, new DateTime(2020, 8, 11));

//Determine times the sun passes through 57.8 degrees.
var t = Celestial.Get_Time_at_Solar_Altitude(c, 57.8);
t.Rising; //Null
t.Setting; //Null;

//Should show DownAllDay as the sun never reaches a height of 57.8 degree at the specified location and date.
t.Condition; //DownAllDay

• Adds ability to output UTM/MGRS rounded and centimeter strings.

UTM/MGRS coordinates are truncated per standard. Though this makes sense in terms of operating in those systems, it can have adverse impacts when converting back and forth between UTM/MGRS and Lat/Long as precision loss will occur. Rounded and Centimeter versions of these systems are also available for output. These values may be more reliable if converting back and forth between UTM/MGRS and Lat/Long systems.

Example:

Coordinate c = new Coordinate(40.57682, -70.75678);
c.MGRS.ToRoundedString(); // Outputs 19T CE 51308 93265
c.MGRS.ToCentimterString(); // Outputs 19T CE 51307.55707 93264.83597

• Improves parsers.

Uneven spacing should no longer effect parsers: "N45 E 45" will now parse.

• Adds CoordinateSharp.Formatters namespace containing useful mathematical functions to convert things such as radians, degrees, HMS, etc.

• Completes unit tests port.

v2.7.3.2

• Improves MGRS_GridBox Marching/Scanning Algorithm.
• Various XML Fixes.

v2.7.2.1

• Exposes solar noon property allowing users to obtain solar noon data points.
• Adds ability to get time of day from a provided sun altitude and position.
• Adds ability to get MGRS square identifier corner points for specified MGRS coordinate.
• Parser/XML improvements.

Solar Noon Example

var c = new Coordinate(45.2,-112.4);
c.CelestialInfo.SolarNoon;

Getting Time of Day from Position, Date and Solar Altitude

//lat, long, date, altitude in degrees, UTC offset (if desired).
AltitudeEvents aev = Celestial.Get_Time_at_Solar_Altitude(47.4, -122.6, new DateTime(2020,8,11), 41.6, -7);

//Altitude point crossed time during solar rising
if(aev.Rising.HasValue)
{
     aev.Rising; //8/11/2020 10:22:12 AM 
}

//Altitude point crossed time during solar setting
if(aev.Setting.HasValue)
{
     aev.Setting; //8/11/2020 4:11:33 PM

Obstaining MGRS 100km Square Points/Boundaries

//Create MGRS Coordinate at a Grid Zone Junction Point (partial square)
MilitaryGridReferenceSystem mgrs = new MilitaryGridReferenceSystem("N", 21, "SA", 66037, 61982);

//Set EagerLoad to MGRS only for efficiency
//Only applicable if pulling Lat/Long Coordinate values from box corners
EagerLoad el = new EagerLoad(EagerLoadType.UTM_MGRS);

var gb = mgrs.Get_Box_Boundaries(el);

//Check if box is Valid first (if not corners will be null)
if(!gb.IsBoxValid){return;}

//Get Bottom Left MGRS Object
gb.Bottom_Left_MGRS_Point; //21N SA 66022 00000

//Get Bottom Left Corodinate Object
//Will throw exception if MGRS is not valid.
gb.Bottom_Left_Coordinate_Point; //N 0º 0' 0" W 59º 59' 59.982"