Drift-kinetic island/layer solver#318
Draft
logan-nc wants to merge 7 commits into
Draft
Conversation
…an under src/islands Design bundle for ISLET (Integrated SoLver for Evolving Tearing), a planned steady-state multi-species drift-kinetic solver for the resonant island/layer region, generalizing the Modified Rutherford Equation the way SLAYER generalized linear layer theory. Revised against the full Imada/Dudkovskaia/Leigh reference set in docs/resources/Drift_Kinetic_Island_References (see REVISION-2026-07-07). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…uthor-title convention Renames the nine PDFs under docs/resources/Drift_Kinetic_Island_References to the YEAR-Author-Title convention used by the rest of docs/resources, and extends the .gitignore resources-PDF negation to subdirectories (!docs/resources/**/*.pdf) so these tracked references match the existing docs/resources/*.pdf policy. Syncs the filename references in the ISLET reference-library doc (docs/08). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…e convention) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…n into in-repo layout
Drop the working acronym ISLET in favour of the plain module name Islands, and
record the module-naming convention (simple intuitive names, not standalone-code
acronyms) in the repo-root CLAUDE.md.
Reconcile the design bundle from its standalone-package assumptions into the
in-repo layout:
- module conventions -> src/Islands/CLAUDE.md
- overview -> docs/src/islands/index.md
- design docs 00-08 -> docs/src/islands/design/
- Physics Book / state / derivations / papers / notes / LOG / QUESTIONS
-> docs/src/islands/{,state,derivations,papers,notes}
- benchmarks + figures -> benchmarks/islands/{,figures}
- verify harness -> src/Islands/verify/
- tests -> test/runtests_islands_*.jl (top-level test/)
- regression cases -> integrated under regression-harness/ (islands_*)
Islands is a submodule of the GeneralizedPerturbedEquilibrium package (no separate
Project.toml), not a standalone subpackage; docs/03/06 updated accordingly.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
logan-nc
changed the title
… infrastructure Stand up the Islands submodule and the infrastructure the autonomous-run protocol (design doc 06) assumes: - src/Islands/Islands.jl (module Islands, skeleton) wired into the package - docs/src/islands/LOG.md + QUESTIONS.md (session memory + blocker queue; Q1 records that julia is not on the automation shell PATH) - .claude/settings.json + hooks (guard-bash PreToolUse, stop-check Stop) for unattended dontAsk runs; physics-verifier subagent as the [VERIFY] backstop - docs/src/islands/design/M1-launch-prompt.md (the milestone contract fed to the overnight loop) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…docs The exported Islands module carries a docstring, which checkdocs=:exports requires be covered in the manual. Add docs/src/islands.md with an @autodocs block and wire it into make.jl (API Reference), matching the other submodule pages. Fixes the missing_docs docs-build failure introduced by the module stub. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Design plan (docs only) for Islands, a new GPEC submodule (
src/Islands/): a steady-state, multi-species drift-kinetic solver for the resonant island/layer region that returns the growth moment Δ_cos(w, ω; p) and torque moment Δ_sin(w, ω; p) for arbitrary parameters — replacing the sum of regime-specific Modified Rutherford Equation terms with a single calculation, and in its small-amplitude limit reducing to the linear layer response so that error-field shielding, penetration, seeded-NTM onset, and island saturation become faces of one solution manifold.Draft: this PR lands the design docs (
docs/src/islands/, module conventions insrc/Islands/CLAUDE.md) and the drift-kinetic reference library, revised against the Imada / Dudkovskaia / Leigh source set. No solver code yet.🤖 Generated with Claude Code