/// <summary> /// Standard constructor. /// </summary> /// <param name="degLat">Latitude in degrees (negative south).</param> /// <param name="degLon">Longitude in degrees (negative west).</param> /// <param name="kmAlt">Altitude in kilometers.</param> /// <param name="model">The earth ellipsoid model.</param> public Site(double degLat, double degLon, double kmAlt, string name = "") { Geo = new Geo(Globals.ToRadians(degLat), Globals.ToRadians(degLon), kmAlt); Name = name; }
/// <summary> /// Converts the given TLE field to the requested units. /// </summary> /// <param name="valNative">Value to convert (native units).</param> /// <param name="fld">Field ID of the value being converted.</param> /// <param name="units">Units to convert to.</param> /// <returns>The converted value.</returns> protected static double ConvertUnits(double valNative, Field fld, Unit units) { if (fld == Field.Inclination || fld == Field.Raan || fld == Field.ArgPerigee || fld == Field.MeanAnomaly) { // The native TLE format is degrees if (units == Unit.Radians) { return(Globals.ToRadians(valNative)); } } // unconverted native format return(valNative); }
/// <summary> /// Returns the topo-centric (azimuth, elevation, etc.) coordinates for /// a target object described by the given ECI coordinates. /// </summary> /// <param name="eci">The ECI coordinates of the target object.</param> /// <returns>The look angle to the target object.</returns> public TopoTime GetLookAngle(EciTime eci) { // Calculate the ECI coordinates for this Site object at the time // of interest. Julian date = eci.Date; EciTime eciSite = PositionEci(date); Vector vecRgRate = new Vector(eci.Velocity.X - eciSite.Velocity.X, eci.Velocity.Y - eciSite.Velocity.Y, eci.Velocity.Z - eciSite.Velocity.Z); double x = eci.Position.X - eciSite.Position.X; double y = eci.Position.Y - eciSite.Position.Y; double z = eci.Position.Z - eciSite.Position.Z; double w = Math.Sqrt(Globals.Sqr(x) + Globals.Sqr(y) + Globals.Sqr(z)); Vector vecRange = new Vector(x, y, z, w); // The site's Local Mean Sidereal Time at the time of interest. double theta = date.ToLmst(LongitudeRad); double sin_lat = Math.Sin(LatitudeRad); double cos_lat = Math.Cos(LatitudeRad); double sin_theta = Math.Sin(theta); double cos_theta = Math.Cos(theta); double top_s = sin_lat * cos_theta * vecRange.X + sin_lat * sin_theta * vecRange.Y - cos_lat * vecRange.Z; double top_e = -sin_theta * vecRange.X + cos_theta * vecRange.Y; double top_z = cos_lat * cos_theta * vecRange.X + cos_lat * sin_theta * vecRange.Y + sin_lat * vecRange.Z; double az = Math.Atan(-top_e / top_s); if (top_s > 0.0) { az += Globals.Pi; } if (az < 0.0) { az += 2.0 * Globals.Pi; } double el = Math.Asin(top_z / vecRange.W); double rate = (vecRange.X * vecRgRate.X + vecRange.Y * vecRgRate.Y + vecRange.Z * vecRgRate.Z) / vecRange.W; TopoTime topo = new TopoTime(az, // azimuth, radians el, // elevation, radians vecRange.W, // range, km rate, // rate, km / sec eci.Date); #if WANT_ATMOSPHERIC_CORRECTION // Elevation correction for atmospheric refraction. // Reference: Astronomical Algorithms by Jean Meeus, pp. 101-104 // Note: Correction is meaningless when apparent elevation is below horizon topo.ElevationRad += Globals.ToRadians((1.02 / Math.Tan(Globals.ToRadians(Globals.ToDegrees(el) + 10.3 / (Globals.ToDegrees(el) + 5.11)))) / 60.0); if (topo.ElevationRad < 0.0) { topo.ElevationRad = el; // Reset to true elevation } if (topo.ElevationRad > (Math.PI / 2.0)) { topo.ElevationRad = (Math.PI / 2.0); } #endif return(topo); }
/// <summary> /// Standard constructor. /// </summary> /// <param name="degLat">Latitude in degrees (negative south).</param> /// <param name="degLon">Longitude in degrees (negative west).</param> /// <param name="kmAlt">Altitude in kilometers.</param> /// <param name="model">The earth ellipsoid model.</param> public Site(double degLat, double degLon, double kmAlt) { Geo = new Geo(Globals.ToRadians(degLat), Globals.ToRadians(degLon), kmAlt); }