Add by-cell averages of particle properties (#2892)

* Add ParticleReductionFunctor

* Adds a by-cell particle average diagnostic
* Averaged quantity is given by an input parser in (x,y,z,ux,uy,uz)
* Coordinates in these parsers are in the WarpX convention
* Users specify which species the averages are calculated for. The
averages are calculated for each given species individually.
* If there are no particles in a cell, the average will be zero.

* add documentation for ParticleReductionFunctor

* add test for cell-averaged particle diagnostics

* set benchmarks for praticle_fields_diags and particle_fields_diags_single_precision

* small changes to parameter docs and test script (addressing David's comments)

* Apply suggestions from code review

* remove unnecessary comments in python test script

* remove unused variable

* fixed inaccurate comments

* use static_cast<int> pattern

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* add comment in ParticleReductionFunctor.H

* warpx.serialize_ics -> warpx.serialize_initial_conditions

* AMREX_SPACEDIM to WARPX_DIM_3D and WARPX_DIM_XZ

* fix compile errors from dimensionality conditionals

* fix compile errors

* Apply suggestions from code review

* clarify docs

* add include headers

* update docs

Co-authored-by: Edoardo Zoni <59625522+EZoni@users.noreply.github.com>
Co-authored-by: Axel Huebl <axel.huebl@plasma.ninja>

0 files changed, 0 insertions, 0 deletions