Vlasiator ebf0dd394 on dev (v5.4.0 + 1054 commits)
Loading...
Searching...
No Matches
projects::Fluctuations Class Reference

#include <Fluctuations.h>

Inheritance diagram for projects::Fluctuations:
Collaboration diagram for projects::Fluctuations:

Public Member Functions

 Fluctuations ()
virtual ~Fluctuations ()
virtual bool initialize (void) override
virtual void getParameters (void) override
virtual void setProjectBField (fsgrids::perbspan perb, fsgrids::bgbspan bgb, fsgrids::technicalspan technical, FieldSolverGrid &fsgrid) override
virtual std::vector< std::array< Real, 3 > > getV0 (creal x, creal y, creal z, const uint popID) const override
 Return a vector containing the velocity coordinate of the centre of each ion population in the distribution.
virtual Realf fillPhaseSpace (spatial_cell::SpatialCell *cell, const uint popID, const uint nRequested) const override
virtual Realf probePhaseSpace (spatial_cell::SpatialCell *cell, const uint popID, Real vx_in, Real vy_in, Real vz_in) const override
virtual void calcCellParameters (spatial_cell::SpatialCell *cell, creal &t) override
Public Member Functions inherited from projects::Project
 Project ()
virtual ~Project ()
virtual Real getCorrectNumberDensity (spatial_cell::SpatialCell *cell, const uint popID) const
virtual void hook (cuint &stage, const dccrg::Dccrg< spatial_cell::SpatialCell, dccrg::Cartesian_Geometry > &mpiGrid, fsgrids::perbspan perb, fsgrids::technicalspan technical, FieldSolverGrid &fsgrid) const
bool initialized ()
virtual void setupBeforeSetCell (const std::vector< CellID > &cells)
void setCell (spatial_cell::SpatialCell *cell)
 Set the perturbed fields and distribution of a cell according to the default simulation settings. This is used for the NOT_SYSBOUNDARY cells and some other system boundary conditions (e.g. Outflow).
virtual bool canRefine (spatial_cell::SpatialCell *cell) const
virtual bool shouldRefineCell (dccrg::Dccrg< spatial_cell::SpatialCell, dccrg::Cartesian_Geometry > &mpiGrid, CellID id, Real r_max2) const
virtual bool shouldUnrefineCell (dccrg::Dccrg< spatial_cell::SpatialCell, dccrg::Cartesian_Geometry > &mpiGrid, CellID id, Real r_max2) const
virtual bool refineSpatialCells (dccrg::Dccrg< spatial_cell::SpatialCell, dccrg::Cartesian_Geometry > &mpiGrid) const
virtual uint64_t adaptRefinement (dccrg::Dccrg< spatial_cell::SpatialCell, dccrg::Cartesian_Geometry > &mpiGrid) const
 Adapts refinement by one level according to the project. Returns true if any cells were refined, false if not.
virtual bool forceRefinement (dccrg::Dccrg< spatial_cell::SpatialCell, dccrg::Cartesian_Geometry > &mpiGrid, int n) const
 Refine/unrefine spatial cells one level to the static criteria in the config.
virtual bool filterRefined (dccrg::Dccrg< spatial_cell::SpatialCell, dccrg::Cartesian_Geometry > &mpiGrid) const
 Boxcar filters spatial cells that were recently refined.

Static Public Member Functions

static void addParameters (void)
Static Public Member Functions inherited from projects::Project
static void addParameters ()

Public Attributes

Real BX0
Real BY0
Real BZ0
Real magXPertAbsAmp
Real magYPertAbsAmp
Real magZPertAbsAmp
uint seed
std::vector< FluctuationsSpeciesParametersspeciesParams

Static Public Attributes

static Real rndRho
static Real rndVel [3]

Additional Inherited Members

Protected Member Functions inherited from projects::Project
void setVelocitySpace (const uint popID, spatial_cell::SpatialCell *cell) const
 Sets the distribution function in a cell.
void printPopulations ()
virtual bool rescalesDensity (const uint popID) const
void rescaleDensity (spatial_cell::SpatialCell *cell, const uint popID) const
Real getRandomNumber (std::default_random_engine &randGen) const
void setRandomSeed (uint64_t seedModifier, std::default_random_engine &randGen) const
void setRandomCellSeed (spatial_cell::SpatialCell *cell, std::default_random_engine &randGen) const

Detailed Description

Definition at line 43 of file Fluctuations.h.

Constructor & Destructor Documentation

◆ Fluctuations()

projects::Fluctuations::Fluctuations ( )

Definition at line 43 of file Fluctuations.cpp.

◆ ~Fluctuations()

projects::Fluctuations::~Fluctuations ( )
virtual

Definition at line 44 of file Fluctuations.cpp.

Member Function Documentation

◆ addParameters()

void projects::Fluctuations::addParameters ( void )
static

Definition at line 47 of file Fluctuations.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ calcCellParameters()

void projects::Fluctuations::calcCellParameters ( spatial_cell::SpatialCell * cell,
creal & t )
overridevirtual

Calculate potentially needed parameters for the given spatial cell at the given time.

Currently this function is only called during initialization.

The following array indices contain the coordinates of the "lower left corner" of the cell: CellParams::XCRD, CellParams::YCRD, and CellParams::ZCRD. The cell size is given in the following array indices: CellParams::DX, CellParams::DY, and CellParams::DZ.

Parameters
cellPointer to the spatial cell to be handled.
tThe current value of time. This is passed as a convenience. If you need more detailed information of the state of the simulation, you can read it from Parameters.

Print a warning message to stderr and abort, one should not use the base class functions.

Reimplemented from projects::Project.

Definition at line 181 of file Fluctuations.cpp.

Here is the call graph for this function:

◆ fillPhaseSpace()

Realf projects::Fluctuations::fillPhaseSpace ( spatial_cell::SpatialCell * cell,
const uint popID,
const uint nRequested ) const
overridevirtual

Calculates the distribution function contents for the spatial cell and population in question NOTE: This function is called inside parallel region so it must be declared as const. This function will contain a loop over nRequested velocity blocks, with the block GlobalIDs provided in the GIDlist buffer, storing phase-space densities in the bufferData buffer.

Parameters
popIDParticle species ID.
Returns
The total stored number density of the cell for this population The physical unit of this quantity is 1/m^3.

Implements projects::Project.

Definition at line 97 of file Fluctuations.cpp.

Here is the call graph for this function:

◆ getParameters()

void projects::Fluctuations::getParameters ( void )
overridevirtual

Get the value that was read in.

Reimplemented from projects::Project.

Definition at line 70 of file Fluctuations.cpp.

Here is the call graph for this function:

◆ getV0()

std::vector< std::array< Real, 3 > > projects::Fluctuations::getV0 ( creal x,
creal y,
creal z,
const uint popID ) const
overridevirtual

Return a vector containing the velocity coordinate of the centre of each ion population in the distribution.

This function is used by findBlocksToInitialize() to start the search of the extent of the distribution along each axis. The extension to a vector allows to have more than one population in each spatial cell.

See also
findBlocksToInitialize

Implements projects::TriAxisSearch.

Definition at line 232 of file Fluctuations.cpp.

◆ initialize()

bool projects::Fluctuations::initialize ( void )
overridevirtual

Initialize project. Can be used, e.g., to read in parameters from the input file.

Initialize the Project. Velocity mesh and particle population parameters are read from the configuration file, and corresponding internal variables are created here. NOTE: Each project must call this function!

Returns
If true, particle species and velocity meshes were created successfully.

Reimplemented from projects::Project.

Definition at line 45 of file Fluctuations.cpp.

Here is the call graph for this function:

◆ probePhaseSpace()

Realf projects::Fluctuations::probePhaseSpace ( spatial_cell::SpatialCell * cell,
const uint popID,
Real vx_in,
Real vy_in,
Real vz_in ) const
overridevirtual

Implements projects::TriAxisSearch.

Definition at line 156 of file Fluctuations.cpp.

Here is the call graph for this function:

◆ setProjectBField()

void projects::Fluctuations::setProjectBField ( fsgrids::perbspan perb,
fsgrids::bgbspan bgb,
fsgrids::technicalspan technical,
FieldSolverGrid & fsgrid )
overridevirtual

Set the background and perturbed magnetic fields for this project.

Parameters
perBGridGrid on which values of the perturbed field can be set if needed.
BgBGridGrid on which values for the background field can be set if needed, e.g. using the background field functions.
technicalTechnical fsgrid, available if some of its data is necessary.
See also
setBackgroundField, setBackgroundFieldToZero

Print a warning message to stderr and abort, one should not use the base class functions.

Reimplemented from projects::Project.

Definition at line 193 of file Fluctuations.cpp.

Here is the call graph for this function:

Member Data Documentation

◆ BX0

Real projects::Fluctuations::BX0

Definition at line 72 of file Fluctuations.h.

◆ BY0

Real projects::Fluctuations::BY0

Definition at line 73 of file Fluctuations.h.

◆ BZ0

Real projects::Fluctuations::BZ0

Definition at line 74 of file Fluctuations.h.

◆ magXPertAbsAmp

Real projects::Fluctuations::magXPertAbsAmp

Definition at line 75 of file Fluctuations.h.

◆ magYPertAbsAmp

Real projects::Fluctuations::magYPertAbsAmp

Definition at line 76 of file Fluctuations.h.

◆ magZPertAbsAmp

Real projects::Fluctuations::magZPertAbsAmp

Definition at line 77 of file Fluctuations.h.

◆ rndRho

Real projects::Fluctuations::rndRho
static

Definition at line 81 of file Fluctuations.h.

◆ rndVel

Real projects::Fluctuations::rndVel
static

Definition at line 81 of file Fluctuations.h.

◆ seed

uint projects::Fluctuations::seed

Definition at line 78 of file Fluctuations.h.

◆ speciesParams

std::vector<FluctuationsSpeciesParameters> projects::Fluctuations::speciesParams

Definition at line 79 of file Fluctuations.h.


The documentation for this class was generated from the following files: