Skip to content

new facet srp effector module#1340

Merged
leahkiner merged 7 commits intodevelopfrom
feature/1332-new-facet-srp-effector-module
Apr 15, 2026
Merged

new facet srp effector module#1340
leahkiner merged 7 commits intodevelopfrom
feature/1332-new-facet-srp-effector-module

Conversation

@leahkiner
Copy link
Copy Markdown
Contributor

@leahkiner leahkiner commented Mar 27, 2026

Overview

This new faceted solar radiation pressure dynamic effector module is created to utilize the two new modules recently added to the repository: facetedSpacecraftModel and facetedSpacecraftProjectedArea. The original facetSRPDynamicEffector module is complicated in that it contains several different calculations which are now isolated and checked in these new modules. This new SRP module now perform a compact SRP calculation that does not include any auxiliary calculations.

Description

This module computes the aggregate force and torque acting on the spacecraft due to impinging photons from the Sun. The inertial Sun state information must be subscribed to the module SpicePlanetStateMsgPayload input message. The module assumes the spacecraft is modeled as a collection of facets, where the facet geometry information is passed as a vector of FacetElementBodyMsgPayload input messages to the module. The facet geometry information is required to be provided in the spacecraft body frame. This SRP module does not make any assumptions regarding whether the facets are rigid or articulate. The facetedSpacecraftModel module can be connected upstream and used to transform the facet geometry data from the facet frames to the spacecraft body frame. This upstream module can also be used to configure articulating facets.Finally, this SRP module also requires the sunlit area of all facets to be pre-computed and connected to the module vector of ProjectedAreaMsgPayload input messages. This information can be passed to the SRP module by connecting the facet geometry information to the facetedSpacecraftProjectedArea module upstream.

Verification

The module unit test verifies that the module correctly computes the aggregate SRP force and torque acting on the spacecraft due to impinging photons from the Sun. The test sets up a simulation with a faceted spacecraft modeled as a cubic hub with two attached circular solar arrays. Six square facets represent the cubic hub and four circular facets represent the two solar arrays. The test varies the initial state information of the spacecraft, the initial state information of the Sun, and the Sun illumination factor.

Documentation

RST documentation is added for the new module.

Future work

N/A

@leahkiner leahkiner requested a review from schaubh March 27, 2026 19:45
@leahkiner leahkiner self-assigned this Mar 27, 2026
@leahkiner leahkiner added the enhancement New feature or request label Mar 27, 2026
@leahkiner leahkiner requested a review from a team as a code owner March 27, 2026 19:45
@leahkiner leahkiner moved this to 👀 In review in Basilisk Mar 27, 2026
@leahkiner leahkiner force-pushed the feature/1332-new-facet-srp-effector-module branch from 8f62d83 to 4a975ac Compare March 27, 2026 19:48
@leahkiner
Copy link
Copy Markdown
Contributor Author

@codex review

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4a975ac706

ℹ️ 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".

Comment thread src/simulation/dynamics/facetedSRPEffector/facetedSRPEffector.cpp
Comment thread src/simulation/dynamics/facetedSRPEffector/facetedSRPEffector.cpp
@leahkiner leahkiner force-pushed the feature/1332-new-facet-srp-effector-module branch from 4a975ac to b6eb459 Compare March 27, 2026 20:52
@schaubh schaubh changed the title Feature/1332 new facet srp effector module new facet srp effector module Mar 27, 2026
Copy link
Copy Markdown
Contributor

@schaubh schaubh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice PR. Mostly small stuff to address.

Comment thread src/simulation/dynamics/facetedSRPEffector/facetedSRPEffector.rst
Comment thread src/simulation/dynamics/facetedSRPEffector/facetedSRPEffector.cpp Outdated
Comment thread src/simulation/dynamics/facetedSRPEffector/_UnitTest/test_facetedSRPEffector.py Outdated
Comment thread src/simulation/dynamics/facetedSRPEffector/facetedSRPEffector.cpp
Comment thread src/simulation/dynamics/facetedSRPEffector/facetedSRPEffector.cpp Outdated
@leahkiner leahkiner linked an issue Mar 30, 2026 that may be closed by this pull request
@leahkiner leahkiner force-pushed the feature/1332-new-facet-srp-effector-module branch 4 times, most recently from e7827d6 to 93b8d06 Compare April 13, 2026 23:29
Copy link
Copy Markdown
Contributor

@schaubh schaubh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just some minor stuff now.

Comment thread src/simulation/dynamics/facetedSRPEffector/facetedSRPEffector.cpp
Comment thread src/simulation/dynamics/facetedSRPEffector/facetedSRPEffector.cpp Outdated
Comment thread src/simulation/dynamics/facetedSRPEffector/facetedSRPEffector.rst Outdated
@leahkiner leahkiner force-pushed the feature/1332-new-facet-srp-effector-module branch from 93b8d06 to c3b6343 Compare April 14, 2026 22:40
Copy link
Copy Markdown
Contributor

@schaubh schaubh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All good to go! Thanks for the nice work on this module.

@leahkiner leahkiner merged commit 8b21bc6 into develop Apr 15, 2026
7 checks passed
@leahkiner leahkiner deleted the feature/1332-new-facet-srp-effector-module branch April 15, 2026 04:48
@github-project-automation github-project-automation bot moved this from 👀 In review to ✅ Done in Basilisk Apr 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

New facetSRPEffector module

2 participants