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

#include <Firehose.h>

Inheritance diagram for projects::Firehose:
Collaboration diagram for projects::Firehose:

Public Member Functions

 Firehose ()
virtual ~Firehose ()
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 Realf fillPhaseSpace (spatial_cell::SpatialCell *cell, const uint popID, const uint nRequested) const override
Real profile (creal top, creal bottom, creal x) const
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 Bx
Real By
Real Bz
Real lambda
Real amp
std::vector< FirehoseSpeciesParametersspeciesParams

Additional Inherited Members

Protected Member Functions inherited from projects::Project
virtual uint findBlocksToInitialize (spatial_cell::SpatialCell *cell, const uint popID) const
 Prepares a list of blocks to loop through when initialising.
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 42 of file Firehose.h.

Constructor & Destructor Documentation

◆ Firehose()

projects::Firehose::Firehose ( )

Definition at line 38 of file Firehose.cpp.

Here is the call graph for this function:

◆ ~Firehose()

projects::Firehose::~Firehose ( )
virtual

Definition at line 39 of file Firehose.cpp.

Member Function Documentation

◆ addParameters()

void projects::Firehose::addParameters ( void )
static

Definition at line 43 of file Firehose.cpp.

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

◆ calcCellParameters()

void projects::Firehose::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 163 of file Firehose.cpp.

◆ fillPhaseSpace()

Realf projects::Firehose::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 108 of file Firehose.cpp.

Here is the call graph for this function:

◆ getParameters()

void projects::Firehose::getParameters ( void )
overridevirtual

Get the value that was read in.

Reimplemented from projects::Project.

Definition at line 72 of file Firehose.cpp.

Here is the call graph for this function:

◆ initialize()

bool projects::Firehose::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 41 of file Firehose.cpp.

Here is the call graph for this function:

◆ profile()

Real projects::Firehose::profile ( creal top,
creal bottom,
creal x ) const

Definition at line 104 of file Firehose.cpp.

Here is the caller graph for this function:

◆ setProjectBField()

void projects::Firehose::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 165 of file Firehose.cpp.

Here is the call graph for this function:

Member Data Documentation

◆ amp

Real projects::Firehose::amp

Definition at line 66 of file Firehose.h.

◆ Bx

Real projects::Firehose::Bx

Definition at line 62 of file Firehose.h.

◆ By

Real projects::Firehose::By

Definition at line 63 of file Firehose.h.

◆ Bz

Real projects::Firehose::Bz

Definition at line 64 of file Firehose.h.

◆ lambda

Real projects::Firehose::lambda

Definition at line 65 of file Firehose.h.

◆ speciesParams

std::vector<FirehoseSpeciesParameters> projects::Firehose::speciesParams

Definition at line 67 of file Firehose.h.


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