AlongTrackSimulator

Simulate and manipulate satellite along-track ground tracks for altimetry missions.

---

Declaration

classdef AlongTrackSimulator < AlongTrackSimulatorBase

Overview

AlongTrackSimulator provides utilities to compute orbit ground tracks (optionally with nodal precession), enforce exact repeat cycles for supported missions, and project tracks into a local Cartesian box for along-track sampling and modeling workflows.

Topics

• Initialization
  • AlongTrackSimulator Create an AlongTrackSimulator instance.
• Constant orbital parameters
  • J2 Earth’s second zonal harmonic coefficient J2.
  • RE Earth’s equatorial radius (km).
  • T_sidereal Length of a sidereal day (seconds).
  • mu Earth’s standard gravitational parameter μ (\(km^3/s^2\)).
• Mission catalog
  • currentMissions List mission keys for currently operating satellites.
  • missionParameters Mission parameter dictionary keyed by mission abbreviation.
  • missions List all mission keys in the catalog.
  • summarizeMissionWithName Display a table summarizing one or more missions.
  • Fetching parameters
    • nodalPeriodForMissionWithName Return the nodal period for a mission (including J2 nodal precession).
    • orbitalPeriodForMissionWithName Return the orbital period for a mission.
    • repeatCycleForMissionWithName Return the mission repeat cycle length in seconds.
• Ground tracks
  • groundTrackForMissionWithName Compute the ground track for a mission over one or more orbits.
  • projectedPointsForMissionWithName Project mission ground-track points into a local Transverse Mercator box.
  • projectedPointsForRepeatMissionWithName Project repeat-cycle ground-track points into a local Transverse Mercator box.
  • repeatGroundTrackForMissionWithName Compute the full repeat-cycle ground track for a mission.
• Utilities
  • Working with alongtrack data
    • convertAlongTrackStructureToPass Convert a flat alongtrack struct into a cell array of passes.
  • WaveVortexModel integration
    • wvmOutputGroupForRepeatMissionWithName Build a WaveVortexModel output group for an along-track sampling pattern.
  • Computing orbital parameters
    • computeNodalPeriod Computes the nodal precession period from orbital parameters
  • Forcing exact repeat orbits
    • eccentricityForExactRepeatForMission Return the eccentricity used in exact-repeat calculations.
    • inclinationForExactRepeatForMission Compute inclination required for an exact repeat orbit for the mission.
    • j2ForExactRepeatForMission Return the J2 value used in exact-repeat calculations.
    • semimajorAxisForExactRepeatForMission Solve for semi-major axis that yields an exact repeat cycle for the mission.
  • Groundtrack algorithms
    • computeGroundTrack computes the ground track of a satellite given including the nodal precession (unoptimized version)
    • computeGroundTrackCircularOrbit computes the ground track assuming a circular orbit
    • computeGroundTrackWithNodalPrecession computes the ground track of a satellite given including the nodal precession
    • computeGroundTrackWithNodalPrecessionSimple computes the ground track of a satellite given including the nodal precession (unoptimized version)
  • Solving Kepler’s equation
    • kepler1 Solve Kepler’s equation for eccentric anomaly E.
    • kepler2 Solve Kepler’s equation for eccentric anomaly E.
    • kepler2vec Solve Kepler’s equation for eccentric anomaly E (fastest version)
    • kepler3 Solve Kepler’s equation for eccentric anomaly E.
    • kepler4 Solve Kepler’s equation for eccentric anomaly E.
    • kepler5 Solve Kepler’s equation for eccentric anomaly E.
  • Mission catalog
    • missionParametersCatalog Create a dictionary for satellite altimetry missions
• Other
  • InverseMeridionalArcPROJ4 These are the defined values for WGS84
  • LatitudeLongitudeBoundsForTransverseMercatorBox
  • LatitudeLongitudeToTransverseMercator
  • MeridionalArcPROJ4 These are the defined values for WGS84
  • TransverseMercatorToLatitudeLongitude
  • projectedPointsForReferenceOrbit

---