#include <Flowthrough.h>

Inheritance diagram for projects::Flowthrough:

[legend]

Collaboration diagram for projects::Flowthrough:

[legend]

Public Member Functions
	Flowthrough ()
virtual	~Flowthrough ()
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 bool	rescalesDensity (const uint popID) const override
virtual Real	getCorrectNumberDensity (spatial_cell::SpatialCell *cell, const uint popID) const override
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
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.
Public Member Functions inherited from projects::Project
	Project ()
virtual	~Project ()
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
bool	emptyBox
Real	densityWidth
bool	rescaleDensityFlag
Real	Bx
Real	By
Real	Bz
std::vector< FlowthroughSpeciesParameters >	speciesParams

Additional Inherited Members
Protected Member Functions inherited from projects::TriAxisSearch
virtual uint	findBlocksToInitialize (spatial_cell::SpatialCell *cell, const uint popID) const
	Find blocks above the threshold centred isotropically around a bulk velocity.
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 ()
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 41 of file Flowthrough.h.

Constructor & Destructor Documentation

◆ Flowthrough()

projects::Flowthrough::Flowthrough ( )

Definition at line 53 of file Flowthrough.cpp.

◆ ~Flowthrough()

projects::Flowthrough::~Flowthrough ( )

virtual

Definition at line 54 of file Flowthrough.cpp.

Member Function Documentation

◆ addParameters()

void projects::Flowthrough::addParameters ( void )

static

Definition at line 60 of file Flowthrough.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ calcCellParameters()

void projects::Flowthrough::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

cell	Pointer to the spatial cell to be handled.
t	The 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 254 of file Flowthrough.cpp.

◆ fillPhaseSpace()

Realf projects::Flowthrough::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

popID Particle 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 172 of file Flowthrough.cpp.

Here is the call graph for this function:

◆ getCorrectNumberDensity()

Real projects::Flowthrough::getCorrectNumberDensity	(	spatial_cell::SpatialCell *	cell,
		const uint	popID ) const

overridevirtual

Get correct number density base class function?

Reimplemented from projects::Project.

Definition at line 121 of file Flowthrough.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getParameters()

void projects::Flowthrough::getParameters ( void )

overridevirtual

Get the value that was read in.

Reimplemented from projects::Project.

Definition at line 82 of file Flowthrough.cpp.

Here is the call graph for this function:

◆ getV0()

std::vector< std::array< Real, 3 > > projects::Flowthrough::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 264 of file Flowthrough.cpp.

◆ initialize()

bool projects::Flowthrough::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 56 of file Flowthrough.cpp.

Here is the call graph for this function:

◆ probePhaseSpace()

Realf projects::Flowthrough::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 232 of file Flowthrough.cpp.

Here is the call graph for this function:

◆ rescalesDensity()

virtual bool projects::Flowthrough::rescalesDensity ( const uint popID ) const

inlineoverridevirtual

Check if the project wants to rescale densities.

Parameters

popID ID of the particle species.

Returns: If true, rescaleDensity is called for this species.

Reimplemented from projects::Project.

Definition at line 55 of file Flowthrough.h.

◆ setProjectBField()

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

overridevirtual

Set the background and perturbed magnetic fields for this project.

Parameters

perBGrid	Grid on which values of the perturbed field can be set if needed.
BgBGrid	Grid on which values for the background field can be set if needed, e.g. using the background field functions.
technical	Technical 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 256 of file Flowthrough.cpp.

Here is the call graph for this function:

Member Data Documentation

◆ Bx

Real projects::Flowthrough::Bx

Definition at line 74 of file Flowthrough.h.

◆ By

Real projects::Flowthrough::By

Definition at line 75 of file Flowthrough.h.

◆ Bz

Real projects::Flowthrough::Bz

Definition at line 76 of file Flowthrough.h.

◆ densityWidth

Real projects::Flowthrough::densityWidth

Definition at line 72 of file Flowthrough.h.

◆ emptyBox

bool projects::Flowthrough::emptyBox

If true, then the simulation domain is empty initially and matter will flow in only through the boundaries.

Definition at line 69 of file Flowthrough.h.

◆ rescaleDensityFlag

bool projects::Flowthrough::rescaleDensityFlag

Definition at line 73 of file Flowthrough.h.

◆ speciesParams

std::vector<FlowthroughSpeciesParameters> projects::Flowthrough::speciesParams

Definition at line 77 of file Flowthrough.h.

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

projects/Flowthrough/Flowthrough.h
projects/Flowthrough/Flowthrough.cpp

Public Member Functions

Static Public Member Functions

Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Flowthrough()

◆ ~Flowthrough()

Member Function Documentation

◆ addParameters()

◆ calcCellParameters()

◆ fillPhaseSpace()

◆ getCorrectNumberDensity()

◆ getParameters()

◆ getV0()

◆ initialize()

◆ probePhaseSpace()

◆ rescalesDensity()

◆ setProjectBField()

Member Data Documentation

◆ Bx

◆ By

◆ Bz

◆ densityWidth

◆ emptyBox

◆ rescaleDensityFlag

◆ speciesParams