ADEPT

ADEPT is a set of A utomatic D ifferentiation E nabled P lasma T ransport solvers.

Examples

Examples can be found in the tests folder or in the adept-notebooks repository - http://github.com/ergodicio/adept-notebooks. Example configuration files are also provided in configs/

Documentation

Getting Started

Usage

Solvers

Available Solvers
- Kinetic Solvers
- Spectral Solvers
- Particle Solvers
- Envelope Solvers
- Fluid Solvers
- External Code Wrappers
Vlasov 1D1V Solver
- Things You Might Care About
- Equations and Quantities
- Multispecies Support
- Solver Options
- Boundary Conditions
- Forcing and Drivers
- What Gets Saved
- Running on Multiple GPUs
- Practical Notes
- Configuration Reference
Vlasov 1D2V Solver
- Things You Might Care About
- Equations and Quantities
- Collisions
- Boundary Conditions
- Forcing and Drivers
- What Gets Saved
- Solver Options
- Practical Notes
- Configuration Reference
Vlasov-2D Overview
- Numerics
- Time-step ordering (one full dt)
- Boundary Conditions
- Forcing and Drivers
- What Gets Saved
- See also
Vlasov-Fokker-Planck 1D Solver
- Equations and Quantities
- Staggered Spatial Grid
- Boundary Conditions
- Collision Operators
- Electric Field Solver
- Solver Algorithm
- Boundary Conditions
- Forcing and Drivers
- What Gets Saved
- Configuration Reference
Vlasov-Fokker-Planck 2D Solver
- Explicit preparation and execution
- Harmonic storage
- Physics
- Time integration
- Current limitations
- Ion-fluid verification gates
Joglekar 2014 reconstruction and hydro coupling
- What the benchmark requires
- Long-timescale field modes
- The 2.5D Biermann source
- Recommended ion-fluid coupling
- Delivery sequence
Periodic MAGPIE carbon-flow initialization
- Spatial fields and units
- Divergence-free magnetic fields and initial current
- Importing an experimental or GORGON-derived plane
- Outputs and reconnection-rate normalization
- Initial numerical scales and a path to convergence
Review trigger: this page defines the physical-unit geometry contract for MAGPIE inputs.
Driven interaction-region reservoirs
- Configuration
- Source map and invariant accounting
- Verification
Review trigger: this page defines the externally driven periodic reservoir scope.
MAGPIE reference scales and flow analysis
- A reproducible carbon reference
- Diagnostics in moments.nc
- A fixed-line Faraday budget
- What a comparison can establish
Review trigger: this page defines the analysis contract for MAGPIE-scale comparisons.
Discrete electric work
- Centered-stencil identity
- Local correction and supported scope
- Coupled verification and remaining errors
Review trigger: this page records the discrete electric-work correction and its limits.
Spectrax 1D Solver
- Equations and Quantities
- Solver Options
- Entry Points
- Boundary Conditions
- Forcing and Drivers
- What Gets Saved
- Configuration Reference
Mixed Hermite-Legendre 1D Solver
- Equations and Quantities
- Numerics
- Initialization
- Boundary Conditions
- Forcing and Drivers
- What Gets Saved
- Configuration Reference
PIC 1D Solver
- Equations and Quantities
- Solver Options
- Transverse Drivers
- Limitations
- Boundary Conditions
- Forcing and Drivers
- What Gets Saved
- Practical Notes
- Configuration Reference
FARSIGHT-1D
- Numerical method
- Adaptive panels
- Conservation and resolution
- Barycentric field treecode
- Run an example
- Verification
- Attribution
LPSE 2D (Envelope-2D) Solver
- Equations and Quantities
- Boundary Conditions
- Forcing and Drivers
- What Gets Saved
- Configuration Reference
Two-Fluid 1D Solver
- Equations and Quantities
- Closures
- Machine-Learned Closures
- Things You Might Care About
- Boundary Conditions
- Forcing and Drivers
- What Gets Saved
- Practical Notes
- Configuration Reference
OSIRIS adept module — usage overview
- File structure
- End-to-end data flow
- How to run
- Manifest schema
- What lands in MLflow
- Concurrent H5 → NetCDF conversion (osiris.stream_convert)
- Ramdisk staging (osiris.stage_root)
- Canned plots (plots/ artifacts)
- Programmatic use
- Adding new metrics
- Adding a new test problem

Configuration Reference

Reference

Note

This project is under active development.

Contributing Guide

The contributing guide is in development but for now, just make an issue / pull request and we can go from there :)

Citation

If you are using this package for your research, please cite

A. Joglekar and A. Thomas, “ADEPT - automatic differentiation enabled plasma transport,” ICML - SynS & ML Workshop (https://syns-ml.github.io/2023/contributions/), 2023

References

[1] A. S. Joglekar & A. G. R. Thomas. “Unsupervised discovery of nonlinear plasma physics using differentiable kinetic simulations.” J. Plasma Phys. 88, 905880608 (2022).

[2] A. S. Joglekar and A. G. R. Thomas, “Machine learning of hidden variables in multiscale fluid simulation,” Mach. Learn.: Sci. Technol., vol. 4, no. 3, p. 035049, Sep. 2023, doi: 10.1088/2632-2153/acf81a.