Add MuJoCo formation-flying scenario with OE feedback

[juan-g-bonilla]

• Tickets addressed: closes Add scenario demonstrating formation flying with drag with MuJoCo #1195
• Review: By commit
• Merge strategy: Merge (no squash)

Description

This branch adds a MuJoCo-based formation-flying scenario and the supporting modules needed to command deputy control forces from orbital-element feedback.

Commits are organized by feature:

• 8dce47d adds CmdForceInertialToForceAtSite (module, SWIG, unit test, docs).
• 47ad1cb adds orbElemOffset (module, SWIG, unit test, docs).
• 2f609d8 adds OrbitalElementControl as a LinearTimeInvariantSystem subclass (module, SWIG update, unit test, docs).
• b65cf2a adds examples/mujoco/scenarioFormationFlyingWithDrag.py and indexes it in examples/_default.rst.
• ec94c1e updates docs/source/Support/bskReleaseNotes.rst with the new modules/scenario.

Verification

Validation artifacts included in this branch:

• Added unit test: src/simulation/mujocoDynamics/cmdForceInertialToForceAtSite/_UnitTest/test_cmdForceInertialToForceAtSite.py
• Added unit test: src/fswAlgorithms/orbitControl/orbElemOffset/_UnitTest/test_orbElemOffset.py
• Added unit test: src/simulation/mujocoDynamics/linearTimeInvariantSystem/_UnitTest/test_orbitalElementControl.py
• test_scenarioMujoco.py runs the new scenario.

Test intent:

• cmdForceInertialToForceAtSite: verifies inertial-to-site force rotation and source-priority behavior (NavAtt over fallback SCStates).
• orbElemOffset: verifies element-wise offset mode and mean-anomaly-offset mode.
• orbitalElementControl: verifies force output consistency against meanOEFeedback (near-zero J2) for proportional and integral configurations.
• Assert test runs and produces figures for documentation.

Documentation

Documentation updated for all added components:

• src/simulation/mujocoDynamics/cmdForceInertialToForceAtSite/cmdForceInertialToForceAtSite.rst
• src/fswAlgorithms/orbitControl/orbElemOffset/orbElemOffset.rst
• src/simulation/mujocoDynamics/linearTimeInvariantSystem/orbitalElementControl.rst
• examples/mujoco/scenarioFormationFlyingWithDrag.py (scenario narrative and figures in docstring)
• examples/_default.rst (scenario indexing)
• docs/source/Support/bskReleaseNotes.rst (release-note entries)

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ec94c1e045

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[schaubh]

mostly small stuff, nice PR!

[schaubh]

I left one comment to consider. The RigidBodyKinematics.c/h library has the wrapToPi() method that is more general than your angleWarp method. Want to just use it? I'll leave it up to you.