Skip to content

New spacecraft charging dynamics module (integration method)#1365

Merged
leahkiner merged 29 commits into
developfrom
feature/1359-sc-charging-dynamics-module
Apr 28, 2026
Merged

New spacecraft charging dynamics module (integration method)#1365
leahkiner merged 29 commits into
developfrom
feature/1359-sc-charging-dynamics-module

Conversation

@leahkiner
Copy link
Copy Markdown
Contributor

@leahkiner leahkiner commented Apr 21, 2026

Description

The spacecraftChargingDynamics class is derived from the the parent class DynamicObject. The module integrates the electric potential of two spacecraft (a servicer and a target) in a plasma environment using a first order ordinary differential equation for each spacecraft. The charging model includes plasma electron current, plasma ion current, photoelectric current, and an optional electron beam current.

Verification

The test verifies that the spacecraft charging dynamics module correctly computes the different types of currents
impacting both a target and servicer spacecraft. Specifically, this test checks that the module
correctly computes the photoelectric current, electron beam current, plasma electron current, and plasma ion
current acting on both spacecraft. While the module defaults many required variables, the user has the ability
to configure all information describing the electrons, ions, and photons using setter methods.

The test varies the servicer and target size, the electron beam parameters, and the bulk plasma ion velocity. The test
checks that the module correctly computes the photoelectric current, electron beam current, plasma electron current,
and plasma ion current acting on both spacecraft.

Documentation

RST documentation is added for the new module.

Future work

N/A

@leahkiner leahkiner self-assigned this Apr 21, 2026
@leahkiner leahkiner added the enhancement New feature or request label Apr 21, 2026
@leahkiner leahkiner requested a review from a team as a code owner April 21, 2026 23:38
@leahkiner leahkiner linked an issue Apr 21, 2026 that may be closed by this pull request
@leahkiner leahkiner moved this to 🏗 In progress in Basilisk Apr 21, 2026
@leahkiner leahkiner marked this pull request as draft April 21, 2026 23:42
@leahkiner leahkiner force-pushed the feature/1359-sc-charging-dynamics-module branch from 52b6400 to e507e24 Compare April 22, 2026 16:54
@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: 76ccdd98d8

ℹ️ 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/spacecraftCharging/spacecraftCharging.cpp Outdated
@leahkiner leahkiner force-pushed the feature/1359-sc-charging-dynamics-module branch 2 times, most recently from 07756ec to c942c27 Compare April 22, 2026 19:29
@leahkiner
Copy link
Copy Markdown
Contributor Author

@codex review

@leahkiner leahkiner marked this pull request as ready for review April 22, 2026 19:33
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: cba844afb5

ℹ️ 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/spacecraftChargingDynamics/spacecraftChargingDynamics.cpp Outdated
Comment thread src/simulation/dynamics/spacecraftChargingDynamics/spacecraftChargingDynamics.cpp Outdated
@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: 42a12e9b51

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

@leahkiner
Copy link
Copy Markdown
Contributor Author

@schaubh This branch is ready for your review.

Comment thread src/architecture/utilities/astroConstants.h
Comment thread src/architecture/msgPayloadDefC/CurrentMsgPayload.h Outdated
@schaubh
Copy link
Copy Markdown
Contributor

schaubh commented Apr 24, 2026

Just pushed some early review comments. Will do a more detailed review later.

@leahkiner leahkiner force-pushed the feature/1359-sc-charging-dynamics-module branch 5 times, most recently from e566150 to ddaa70b Compare April 24, 2026 20:34
@schaubh schaubh force-pushed the feature/1359-sc-charging-dynamics-module branch from 8ef5485 to b237acc Compare April 25, 2026 20:07
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 work. Just some small items to wrap up. I pushed some suggested fixes to your branch with the [squash] label.

Add a module-local CMake dependency on dynamicsLib so the
spacecraftChargingDynamics SWIG target resolves DynamicObject,
DynParamManager, and RK4 integrator symbols on Windows.
@leahkiner leahkiner force-pushed the feature/1359-sc-charging-dynamics-module branch from 513b1cf to 8024208 Compare April 28, 2026 20:45
@leahkiner leahkiner merged commit 459ef89 into develop Apr 28, 2026
7 checks passed
@leahkiner leahkiner deleted the feature/1359-sc-charging-dynamics-module branch April 28, 2026 23:13
@github-project-automation github-project-automation Bot moved this from 👀 In review to ✅ Done in Basilisk Apr 28, 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 Spacecraft Charging Dynamics Module

2 participants