diff --git a/Source/Particles/AddPlasmaUtilities.H b/Source/Particles/AddPlasmaUtilities.H index 4f7558fa8bb..3e6ea99901d 100644 --- a/Source/Particles/AddPlasmaUtilities.H +++ b/Source/Particles/AddPlasmaUtilities.H @@ -16,17 +16,30 @@ #include #include +/* + Finds the overlap region between the given tile_realbox and part_realbox, returning true + if an overlap exists and false if otherwise. This also sets the parameters overlap_realbox, + overlap_box, and shifted to the appropriate values. + */ bool find_overlap (const amrex::RealBox& tile_realbox, const amrex::RealBox& part_realbox, const amrex::GpuArray& dx, const amrex::GpuArray& prob_lo, amrex::RealBox& overlap_realbox, amrex::Box& overlap_box, amrex::IntVect& shifted); +/* + Finds the overlap region between the given tile_realbox, part_realbox and the surface used for + flux injection, returning true if an overlap exists and false if otherwise. This also sets the + parameters overlap_realbox, overlap_box, and shifted to the appropriate values. + */ bool find_overlap_flux (const amrex::RealBox& tile_realbox, const amrex::RealBox& part_realbox, const amrex::GpuArray& dx, const amrex::GpuArray& prob_lo, const PlasmaInjector& plasma_injector, amrex::RealBox& overlap_realbox, amrex::Box& overlap_box, amrex::IntVect& shifted); +/* + This computes the scale_fac (used for setting the particle weights) on a volumetric basis. + */ AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real compute_scale_fac_volume (const amrex::GpuArray& dx, const amrex::Long pcount) { @@ -34,6 +47,10 @@ amrex::Real compute_scale_fac_volume (const amrex::GpuArray& dx, const amrex::Real num_ppc_real, const int flux_normal_axis) { @@ -71,6 +92,10 @@ amrex::Real compute_scale_fac_area (const amrex::GpuArray