#include <supg.h>

Inheritance diagram for oofem::SUPG:

Collaboration diagram for oofem::SUPG:

Public Member Functions
	SUPG (int i, EngngModel *_master=nullptr)
void	solveYourselfAt (TimeStep *tStep) override
void	updateYourself (TimeStep *tStep) override
double	giveUnknownComponent (ValueModeType mode, TimeStep tStep, Domain d, Dof *dof) override
void	updateComponent (TimeStep tStep, NumericalCmpn cmpn, Domain d) override
void	updateSolution (FloatArray &solutionVector, TimeStep tStep, Domain d) override
void	updateInternalRHS (FloatArray &answer, TimeStep tStep, Domain d, FloatArray *eNorm) override
void	updateMatrix (SparseMtrx &mat, TimeStep tStep, Domain d) override
double	giveReynoldsNumber () override
void	saveContext (DataStream &stream, ContextMode mode) override
void	restoreContext (DataStream &stream, ContextMode mode) override
void	updateDomainLinks () override
TimeStep *	giveNextStep () override
	Returns next time step (next to current step) of receiver.
TimeStep *	giveSolutionStepWhenIcApply (bool force=false) override
NumericalMethod *	giveNumericalMethod (MetaStep *mStep) override
	Returns reference to receiver's numerical method.
void	initializeFrom (InputRecord &ir) override
int	checkConsistency () override
const char *	giveClassName () const override
	Returns class name of the receiver.
const char *	giveInputRecordName () const
fMode	giveFormulation () override
void	printDofOutputAt (FILE stream, Dof iDof, TimeStep *tStep) override
int	requiresUnknownsDictionaryUpdate () override
bool	giveEquationScalingFlag () override
	Returns the Equation scaling flag, which is used to indicate that governing equation(s) are scaled, or non-dimensionalized.
double	giveVariableScale (VarScaleType varId) override
	Returns the scale factor for given variable type.
void	updateDofUnknownsDictionary (DofManager dman, TimeStep tStep) override
int	giveUnknownDictHashIndx (ValueModeType mode, TimeStep *tStep) override
MaterialInterface *	giveMaterialInterface (int n) override
Public Member Functions inherited from oofem::FluidModel
	FluidModel (int i, EngngModel *master)
int	forceEquationNumbering (int id) override
int	forceEquationNumbering () override
	EngngModel (int i, EngngModel *_master=NULL)
virtual	~EngngModel ()
	Destructor.
	EngngModel (const EngngModel &)=delete
EngngModel &	operator= (const EngngModel &)=delete
Domain *	giveDomain (int n)
void	setDomain (int i, Domain *ptr, bool iDeallocateOld=true)
int	giveNumberOfDomains ()
	Returns number of domains in problem.
const std::string &	giveDescription () const
const time_t &	giveStartTime ()
bool	giveSuppressOutput () const
virtual ErrorEstimator *	giveDomainErrorEstimator (int n)
void	setNumberOfEquations (int id, int neq)
FILE *	giveOutputStream ()
	Returns file descriptor of output file.
std::string	giveOutputBaseFileName ()
std::string	giveReferenceFileName ()
void	letOutputBaseFileNameBe (const std ::string &src)
ContextOutputMode	giveContextOutputMode () const
int	giveContextOutputStep () const
void	setContextOutputMode (ContextOutputMode contextMode)
void	setUDContextOutputMode (int cStep)
double	giveDeltaT ()
	Returns time step size from the time step controlelr.
void	setDeltaT (double dT)
	Returns time step size through the time step controlelr.
void	setProblemMode (problemMode pmode)
void	setParallelMode (bool newParallelFlag)
problemMode	giveProblemMode () const
	Returns domain mode.
void	setProblemScale (problemScale pscale)
problemScale	giveProblemScale () const
	Returns scale in multiscale simulation.
virtual void	setRenumberFlag ()
	Sets the renumber flag to true.
virtual void	resetRenumberFlag ()
	Sets the renumber flag to false.
double	giveSolutionStepTime ()
void	giveAnalysisTime (int &rhrs, int &rmin, int &rsec, int &uhrs, int &umin, int &usec)
void	terminateAnalysis ()
virtual void	solveYourself ()
virtual void	restartYourself (TimeStep *tS)
virtual void	terminate (TimeStep *tStep)
virtual void	doStepOutput (TimeStep *tStep)
void	saveStepContext (TimeStep *tStep, ContextMode mode)
virtual void	initializeYourself (TimeStep *tStep)
virtual int	initializeAdaptive (int tStepNumber)
virtual int	giveNumberOfDomainEquations (int di, const UnknownNumberingScheme &num)
virtual FieldPtr	giveField (FieldType key, TimeStep *)
virtual FieldPtr	giveField (InternalStateType key, TimeStep *)
EngngModel *	giveMasterEngngModel ()
	Returns the master engnmodel.
virtual double	giveLoadLevel ()
	Returns the current load level.
virtual double	giveEigenValue (int eigNum)
	Only relevant for eigen value analysis. Otherwise returns zero.
virtual void	setActiveVector (int i)
	Only relevant for eigen value analysis. Otherwise does noting.
int	updateSharedDofManagers (FloatArray &answer, const UnknownNumberingScheme &s, int ExchangeTag)
int	exchangeRemoteElementData (int ExchangeTag)
virtual int	giveCurrentNumberOfIterations ()
MPI_Comm	giveParallelComm ()
	Returns the communication object of reciever.
int	packRemoteElementData (ProcessCommunicator &processComm)
int	unpackRemoteElementData (ProcessCommunicator &processComm)
int	packDofManagers (ArrayWithNumbering *src, ProcessCommunicator &processComm)
int	unpackDofManagers (ArrayWithNumbering *dest, ProcessCommunicator &processComm)
ProblemCommunicator *	giveProblemCommunicator (EngngModelCommType t)
void	initializeCommMaps (bool forceInit=false)
virtual int	instanciateYourself (DataReader &dr, InputRecord &ir, const char outFileName, const char desc)
void	Instanciate_init ()
int	instanciateDomains (DataReader &dr)
	Instanciate problem domains by calling their instanciateYourself() service.
int	instanciateMetaSteps (DataReader &dr)
	Instanciate problem meta steps by calling their instanciateYourself() service.
virtual int	instanciateDefaultMetaStep (InputRecord &ir)
	Instanciate default metastep, if nmsteps is zero.
virtual void	updateAttributes (MetaStep *mStep)
void	initMetaStepAttributes (MetaStep *mStep)
MetaStep *	giveCurrentMetaStep ()
	Returns current meta step.
virtual TimeStep *	giveCurrentStep (bool force=false)
virtual void	adaptTimeStep (double nIter)
virtual TimeStep *	givePreviousStep (bool force=false)
virtual void	preInitializeNextStep ()
	Does a pre-initialization of the next time step (implement if necessarry).
virtual int	giveNumberOfFirstStep (bool force=false)
int	giveNumberOfMetaSteps ()
	Return number of meta steps.
MetaStep *	giveMetaStep (int i)
	Returns the i-th meta step.
int	giveNumberOfSteps (bool force=false)
virtual double	giveEndOfTimeOfInterest ()
	Returns end of time interest (time corresponding to end of time integration).
int	giveNumberOfTimeStepWhenIcApply ()
	Returns the time step number, when initial conditions should apply.
ExportModuleManager *	giveExportModuleManager ()
	Returns receiver's export module manager.
EngngModelTimer *	giveTimer ()
	Returns reference to receiver timer (EngngModelTimer).
virtual double	giveInitialTime ()
	return time at the begining of analysis
virtual double	giveFinalTime ()
virtual int	giveNewEquationNumber (int domain, DofIDItem)
virtual int	giveNewPrescribedEquationNumber (int domain, DofIDItem)
std::string	giveContextFileName (int tStepNumber, int stepVersion) const
std::string	giveDomainFileName (int domainNum, int domainSerNum) const
virtual void	initForNewIteration (Domain d, TimeStep tStep, int iterationNumber, const FloatArray &solution)
virtual void	initStepIncrements ()
virtual bool	requiresEquationRenumbering (TimeStep *tStep)
virtual bool	newDofHandling ()
virtual ParallelContext *	giveParallelContext (int n)
virtual void	initParallelContexts ()
virtual void	assemble (SparseMtrx &answer, TimeStep tStep, const MatrixAssembler &ma, const UnknownNumberingScheme &s, Domain domain)
virtual void	assemble (SparseMtrx &answer, TimeStep tStep, const MatrixAssembler &ma, const UnknownNumberingScheme &r_s, const UnknownNumberingScheme &c_s, Domain domain)
void	assembleVector (FloatArray &answer, TimeStep tStep, const VectorAssembler &va, ValueModeType mode, const UnknownNumberingScheme &s, Domain domain, FloatArray *eNorms=NULL)
void	assembleVectorFromDofManagers (FloatArray &answer, TimeStep tStep, const VectorAssembler &va, ValueModeType mode, const UnknownNumberingScheme &s, Domain domain, FloatArray *eNorms=NULL)
void	assembleVectorFromElements (FloatArray &answer, TimeStep tStep, const VectorAssembler &va, ValueModeType mode, const UnknownNumberingScheme &s, Domain domain, FloatArray *eNorms=NULL)
void	assembleVectorFromBC (FloatArray &answer, TimeStep tStep, const VectorAssembler &va, ValueModeType mode, const UnknownNumberingScheme &s, Domain domain, FloatArray *eNorms=NULL)
void	assembleExtrapolatedForces (FloatArray &answer, TimeStep tStep, CharType type, Domain domain)
void	assemblePrescribedExtrapolatedForces (FloatArray &answer, TimeStep tStep, CharType type, Domain domain)
virtual int	checkProblemConsistency ()
virtual void	init ()
virtual void	postInitialize ()
virtual void	printOutputAt (FILE file, TimeStep tStep)
virtual void	printOutputAt (FILE file, TimeStep tStep, const IntArray &nodeSets, const IntArray &elementSets)
void	outputNodes (FILE file, Domain &domain, TimeStep tStep, int setNum)
void	outputElements (FILE file, Domain &domain, TimeStep tStep, int setNum)
void	printYourself ()
	Prints state of receiver. Useful for debugging.
virtual int	useNonlocalStiffnessOption ()
	Returns nonzero if nonlocal stiffness option activated.
bool	isParallel () const
	Returns true if receiver in parallel mode.
int	giveRank () const
	Returns domain rank in a group of collaborating processes (0..groupSize-1).
int	giveNumberOfProcesses () const
	Returns the number of collaborating processes.
EngngModelContext *	giveContext ()
	Context requesting service.
virtual int	giveNumberOfSlaveProblems ()
	Returns number of slave problems.
virtual EngngModel *	giveSlaveProblem (int i)
	Returns i-th slave problem.
virtual int	estimateMaxPackSize (IntArray &commMap, DataStream &buff, int packUnpackType)
virtual void	balanceLoad (TimeStep *tStep)
virtual LoadBalancer *	giveLoadBalancer ()
virtual LoadBalancerMonitor *	giveLoadBalancerMonitor ()
void	initParallel ()
	Request domain rank and problem size.
EngngModel *	giveEngngModel ()
	Returns reference to itself -> required by communicator.h.
virtual bool	isElementActivated (int elemNum)
virtual bool	isElementActivated (Element *e)
TimeStepController *	giveTimeStepController ()
	Returns the time step controller.
virtual void	drawYourself (oofegGraphicContext &gc)
virtual void	drawElements (oofegGraphicContext &gc)
virtual void	drawNodes (oofegGraphicContext &gc)
virtual void	showSparseMtrxStructure (int type, oofegGraphicContext &gc, TimeStep *tStep)
std::string	errorInfo (const char *func) const
	Returns string for prepending output (used by error reporting macros).

Protected Member Functions
void	updateInternalState (TimeStep *tStep)
void	applyIC (TimeStep *tStep)
void	evaluateElementStabilizationCoeffs (TimeStep *tStep)
void	updateElementsForNewInterfacePosition (TimeStep *tStep)
void	updateDofUnknownsDictionary_predictor (TimeStep *tStep)
void	updateDofUnknownsDictionary_corrector (TimeStep *tStep)
void	updateSolutionVectors (FloatArray &solutionVector, FloatArray &accelerationVector, FloatArray &incrementalSolutionVector, TimeStep *tStep)
void	updateSolutionVectors_predictor (FloatArray &solutionVector, FloatArray &accelerationVector, TimeStep *tStep)
void	updateDofManVals (TimeStep *tStep)
virtual void	packMigratingData (TimeStep *tStep)
virtual void	unpackMigratingData (TimeStep *tStep)

Protected Attributes
std ::unique_ptr< SparseLinearSystemNM >	nMethod
	Numerical method used to solve the problem.
LinSystSolverType	solverType =LinSystSolverType::ST_Direct
SparseMtrxType	sparseMtrxType =SparseMtrxType::SMT_Skyline
std ::unique_ptr< SparseMtrx >	lhs
std ::unique_ptr< PrimaryField >	VelocityPressureField
FloatArray	accelerationVector
FloatArray	incrementalSolutionVector
FloatArray	internalForces
FloatArray	eNorm
double	deltaT = 1.
int	deltaTF = 0
double	atolv = 1.
	Convergence tolerance.
double	rtolv = 1.
int	maxiter = 0
	Max number of iterations.
bool	stopmaxiter = true
double	alpha = 0.
	Integration constant.
int	initFlag = 1
int	consistentMassFlag = 0
bool	equationScalingFlag = false
double	lscale = 1.
double	uscale = 1.
double	dscale = 1.
double	Re = 0.
	Reynolds number.
std ::unique_ptr< MaterialInterface >	materialInterface
Protected Attributes inherited from oofem::EngngModel
int	ndomains
	Number of receiver domains.
std ::vector< std ::unique_ptr< Domain > >	domainList
	List of problem domains.
int	numberOfSteps
	Total number of time steps.
int	numberOfEquations
	Total number of equation in current time step.
int	numberOfPrescribedEquations
	Total number or prescribed equations in current time step.
IntArray	domainNeqs
	Number of equations per domain.
IntArray	domainPrescribedNeqs
	Number of prescribed equations per domain.
bool	renumberFlag
	Renumbering flag (renumbers equations after each step, necessary if Dirichlet BCs change).
bool	profileOpt
	Profile optimized numbering flag (using Sloan's algorithm).
int	equationNumberingCompleted
	Equation numbering completed flag.
int	nMetaSteps
	Number of meta steps.
std ::vector< MetaStep >	metaStepList
	List of problem metasteps.
std ::unique_ptr< TimeStep >	stepWhenIcApply
	Solution step when IC (initial conditions) apply.
std ::unique_ptr< TimeStep >	currentStep
	Current time step.
std ::unique_ptr< TimeStep >	previousStep
	Previous time step.
int	number
	Receivers id.
std::string	dataOutputFileName
	Path to output stream.
std::string	coreOutputFileName
	String with core output file name.
FILE *	outputStream
	Output stream.
std::string	referenceFileName
	String with reference file name.
ContextOutputMode	contextOutputMode
	Domain context output mode.
int	contextOutputStep
ExportModuleManager	exportModuleManager
	Export module manager.
InitModuleManager	initModuleManager
	Initialization module manager.
MonitorManager	monitorManager
	Monitor manager.
problemMode	pMode
	Domain mode.
problemScale	pScale
	Multiscale mode.
time_t	startTime
	Solution start time.
EngngModel *	master
	Master e-model; if defined receiver is in maintained (slave) mode.
EngngModelContext *	context
	Context.
EngngModelTimer	timer
	E-model timer.
int	parallelFlag
	Flag indicating that the receiver runs in parallel.
enum fMode	nonLinFormulation
	Type of non linear formulation (total or updated formulation).
std::unique_ptr< ErrorEstimator >	defaultErrEstimator
	Error estimator. Useful for adaptivity, or simply printing errors output.
std::unique_ptr< TimeStepController >	timeStepController
	Time Step controller is responsible for collecting data from analysis, elements, and materials, and select the appropriate timestep size for the next step, or reduce the step in case of convergence problems.
int	rank
	Domain rank in a group of collaborating processes (0..groupSize-1).
int	numProcs
	Total number of collaborating processes.
int	nonlocalExt
	Flag indicating if nonlocal extension active, which will cause data to be sent between shared elements before computing the internal forces.
char	processor_name [PROCESSOR_NAME_LENGTH]
	Processor name.
MPI_Comm	comm
	Communication object for this engineering model.
std::unique_ptr< LoadBalancer >	lb
	Load Balancer.
std::unique_ptr< LoadBalancerMonitor >	lbm
bool	loadBalancingFlag
	If set to true, load balancing is active.
bool	force_load_rebalance_in_first_step
	Debug flag forcing load balancing after first step.
CommunicatorBuff *	commBuff
	Common Communicator buffer.
ProblemCommunicator *	communicator
	Communicator.
ProblemCommunicator *	nonlocCommunicator
	NonLocal Communicator. Necessary when nonlocal constitutive models are used.
std ::vector< ParallelContext >	parallelContextList
	List where parallel contexts are stored.
bool	suppressOutput
	Flag for suppressing output to file.
std::string	simulationDescription

Additional Inherited Members
Public Types inherited from oofem::EngngModel
enum	EngngModel_UpdateMode { EngngModel_Unknown_Mode , EngngModel_SUMM_Mode , EngngModel_SET_Mode }
enum	EngngModelCommType { PC_default , PC_nonlocal }
enum	InitialGuess { IG_None = 0 , IG_Tangent = 1 }
Protected Types inherited from oofem::EngngModel
enum	{ InternalForcesExchangeTag , MassExchangeTag , LoadExchangeTag , ReactionExchangeTag , RemoteElementExchangeTag }
	Message tags. More...

Detailed Description

This class represents transient incompressible flow problem. Solution is based on algorithm with SUPG/PSPG stabilization.

Definition at line 104 of file supg.h.

Constructor & Destructor Documentation

◆ SUPG()

oofem::SUPG::SUPG	(	int	i,
		EngngModel *	_master = nullptr )

Definition at line 210 of file supg.C.

References accelerationVector, oofem::FluidModel::FluidModel(), and oofem::EngngModel::ndomains.

Member Function Documentation

◆ applyIC()

void oofem::SUPG::applyIC ( TimeStep * tStep )

protected

Definition at line 934 of file supg.C.

References accelerationVector, oofem::FloatArray::at(), oofem::Domain::giveDofManager(), oofem::EngngModel::giveDomain(), oofem::Domain::giveElements(), oofem::Domain::giveNumberOfDofManagers(), oofem::EngngModel::giveNumberOfDomainEquations(), materialInterface, OOFEM_LOG_INFO, requiresUnknownsDictionaryUpdate(), oofem::FloatArray::resize(), updateElementsForNewInterfacePosition(), oofem::SUPGElement::updateInternalState(), oofem::Element::updateYourself(), VelocityPressureField, and oofem::FloatArray::zero().

Referenced by solveYourselfAt().

◆ checkConsistency()

int oofem::SUPG::checkConsistency ( )

overridevirtual

Allows programmer to test some receiver's internal data, before computation begins.

Returns: Nonzero if receiver check is o.k.

Reimplemented from oofem::EngngModel.

Definition at line 861 of file supg.C.

References equationScalingFlag, oofem::ForceLoadBVT, oofem::Domain::giveBcs(), oofem::EngngModel::giveDomain(), oofem::Domain::giveElements(), oofem::Domain::giveIcs(), giveVariableScale(), OOFEM_ERROR, OOFEM_WARNING, oofem::PressureBVT, uscale, oofem::VelocityBVT, oofem::VST_Force, and oofem::VST_Pressure.

◆ evaluateElementStabilizationCoeffs()

void oofem::SUPG::evaluateElementStabilizationCoeffs ( TimeStep * tStep )

protected

Definition at line 1019 of file supg.C.

References oofem::EngngModel::giveDomain(), oofem::Domain::giveElements(), and oofem::FMElement::updateStabilizationCoeffs().

Referenced by solveYourselfAt().

◆ giveClassName()

const char * oofem::SUPG::giveClassName ( ) const

inlineoverridevirtual

Returns class name of the receiver.

Implements oofem::EngngModel.

Definition at line 179 of file supg.h.

◆ giveEquationScalingFlag()

bool oofem::SUPG::giveEquationScalingFlag ( )

inlineoverridevirtual

Returns the Equation scaling flag, which is used to indicate that governing equation(s) are scaled, or non-dimensionalized.

Reimplemented from oofem::EngngModel.

Definition at line 188 of file supg.h.

References equationScalingFlag.

◆ giveFormulation()

fMode oofem::SUPG::giveFormulation ( )

inlineoverridevirtual

Indicates type of non linear computation (total or updated formulation). This is used for example on Nodal level to update coordinates if updated formulation is done, or on element level, when non linear contributions are computed.

Reimplemented from oofem::EngngModel.

Definition at line 182 of file supg.h.

References oofem::TL.

◆ giveInputRecordName()

const char * oofem::SUPG::giveInputRecordName ( ) const

inline

Definition at line 180 of file supg.h.

References _IFT_SUPG_Name.

◆ giveMaterialInterface()

MaterialInterface * oofem::SUPG::giveMaterialInterface ( int n )

inlineoverridevirtual

Returns material interface representation for given domain

Reimplemented from oofem::EngngModel.

Definition at line 194 of file supg.h.

References materialInterface.

◆ giveNextStep()

TimeStep * oofem::SUPG::giveNextStep ( )

overridevirtual

Returns next time step (next to current step) of receiver.

Reimplemented from oofem::EngngModel.

Definition at line 428 of file supg.C.

References oofem::SUPGElement::computeCriticalTimeStep(), oofem::EngngModel::currentStep, deltaT, deltaTF, oofem::Function::evaluateAtTime(), oofem::EngngModel::giveDomain(), oofem::Domain::giveElements(), oofem::Domain::giveFunction(), giveSolutionStepWhenIcApply(), giveVariableScale(), materialInterface, oofem::min(), OOFEM_LOG_INFO, oofem::EngngModel::previousStep, and oofem::VST_Time.

◆ giveNumericalMethod()

NumericalMethod * oofem::SUPG::giveNumericalMethod ( MetaStep * mStep )

overridevirtual

Returns reference to receiver's numerical method.

Reimplemented from oofem::EngngModel.

Definition at line 216 of file supg.C.

References oofem::classFactory, oofem::EngngModel::giveDomain(), nMethod, OOFEM_ERROR, and solverType.

Referenced by solveYourselfAt(), and updateDomainLinks().

◆ giveReynoldsNumber()

double oofem::SUPG::giveReynoldsNumber ( )

overridevirtual

Implements oofem::FluidModel.

Definition at line 401 of file supg.C.

References equationScalingFlag, and Re.

◆ giveSolutionStepWhenIcApply()

TimeStep * oofem::SUPG::giveSolutionStepWhenIcApply ( bool force = false )

overridevirtual

Returns the solution step when Initial Conditions (IC) apply.

Parameters

force when set to true then receiver reply is returned instead of master (default)

Reimplemented from oofem::EngngModel.

Definition at line 412 of file supg.C.

References deltaT, oofem::EngngModel::giveNumberOfTimeStepWhenIcApply(), giveVariableScale(), oofem::EngngModel::master, oofem::EngngModel::stepWhenIcApply, and oofem::VST_Time.

Referenced by giveNextStep().

◆ giveUnknownComponent()

double oofem::SUPG::giveUnknownComponent	(	ValueModeType	,
		TimeStep *	,
		Domain *	,
		Dof *	)

overridevirtual

Returns requested unknown. Unknown at give time step is characterized by its type and mode and by its equation number. This function is used by Dofs, when they are requested for their associated unknowns.

See also: Dof::giveUnknown

Reimplemented from oofem::EngngModel.

Definition at line 302 of file supg.C.

References oofem::Dof::__giveEquationNumber(), accelerationVector, giveUnknownDictHashIndx(), oofem::Dof::giveUnknowns(), OOFEM_ERROR, requiresUnknownsDictionaryUpdate(), and VelocityPressureField.

◆ giveUnknownDictHashIndx()

int oofem::SUPG::giveUnknownDictHashIndx	(	ValueModeType	mode,
		TimeStep *	tStep )

overridevirtual

This method is responsible for computing unique dictionary id (ie hash value) from given valueModeType and time step. This function is used by particular dofs to access unknown identified by given parameters from its dictionary using computed index. Usually the hash algorithm should produce index that depend on time step relatively to actual one to avoid storage of complete history.

Reimplemented from oofem::EngngModel.

Definition at line 1127 of file supg.C.

References oofem::EngngModel::giveCurrentStep(), oofem::TimeStep::giveNumber(), oofem::EngngModel::givePreviousStep(), and OOFEM_ERROR.

Referenced by giveUnknownComponent().

◆ giveVariableScale()

double oofem::SUPG::giveVariableScale ( VarScaleType varId )

overridevirtual

Returns the scale factor for given variable type.

Reimplemented from oofem::EngngModel.

Definition at line 995 of file supg.C.

References dscale, lscale, OOFEM_ERROR, uscale, oofem::VST_Density, oofem::VST_Force, oofem::VST_Length, oofem::VST_Pressure, oofem::VST_Time, oofem::VST_Velocity, and oofem::VST_Viscosity.

Referenced by checkConsistency(), giveNextStep(), and giveSolutionStepWhenIcApply().

◆ initializeFrom()

void oofem::SUPG::initializeFrom ( InputRecord & ir )

overridevirtual

Initializes receiver according to object description in input reader. InitString can be imagined as data record in component database belonging to receiver. Receiver may use value-name extracting functions to extract particular field from record.

Reimplemented from oofem::EngngModel.

Definition at line 228 of file supg.C.

References _IFT_EngngModel_lstype, _IFT_EngngModel_smtype, _IFT_SUPG_alpha, _IFT_SUPG_atolv, _IFT_SUPG_cmflag, _IFT_SUPG_deltat, _IFT_SUPG_deltatFunction, _IFT_SUPG_dscale, _IFT_SUPG_lscale, _IFT_SUPG_maxiter, _IFT_SUPG_miflag, _IFT_SUPG_rtolv, _IFT_SUPG_scaleflag, _IFT_SUPG_stopmaxiter, _IFT_SUPG_uscale, alpha, atolv, consistentMassFlag, deltaT, deltaTF, dscale, equationScalingFlag, oofem::EngngModel::giveContext(), oofem::EngngModel::giveDomain(), oofem::InputRecord::hasField(), IR_GIVE_FIELD, IR_GIVE_OPTIONAL_FIELD, lscale, materialInterface, maxiter, Re, oofem::FieldManager::registerField(), requiresUnknownsDictionaryUpdate(), rtolv, solverType, sparseMtrxType, stopmaxiter, uscale, and VelocityPressureField.

◆ printDofOutputAt()

void oofem::SUPG::printDofOutputAt	(	FILE *	stream,
		Dof *	iDof,
		TimeStep *	tStep )

overridevirtual

DOF printing routine. Called by DofManagers to print Dof specific part. Dof class provides component printing routines, but emodel is responsible for what will be printed at DOF level.

Parameters

stream	output stream
iDof	dof to be processed
tStep	solution step

Reimplemented from oofem::EngngModel.

Definition at line 919 of file supg.C.

References dscale, oofem::Dof::giveDofID(), OOFEM_ERROR, oofem::Dof::printSingleOutputAt(), and uscale.

◆ requiresUnknownsDictionaryUpdate()

int oofem::SUPG::requiresUnknownsDictionaryUpdate ( )

inlineoverridevirtual

Indicates if EngngModel requires Dofs dictionaries to be updated. If EngngModel does not support changes of static system, the dof forwards the requests for its unknowns to EngngModel, where unknowns are naturally kept. This is possible, because dof equation number is same during whole solution. But when changes of static system are allowed, several problem arise. For example by solving simple incremental static with allowed static changes, the incremental displacement vector of structure can not be added to total displacement vector of structure, because equation numbers may have changed, and one can not simply add these vector to obtain new total displacement vector, because incompatible displacement will be added. To solve this problem, unknown dictionary at dof level has been assumed. Dof then keeps its unknowns in its own private dictionary. After computing increment of solution, engngModel updates for each dof its unknowns in its dictionary (using updateUnknownsDictionary function). For aforementioned example engngModel updates incremental values but also total value by asking dof for previous total value (dof will use its dictionary, does not asks back EngngModel) adds corresponding increment and updates total value in dictionary.

Reimplemented from oofem::EngngModel.

Definition at line 186 of file supg.h.

References oofem::EngngModel::renumberFlag.

Referenced by applyIC(), giveUnknownComponent(), initializeFrom(), solveYourselfAt(), updateDofUnknownsDictionary_corrector(), updateDofUnknownsDictionary_predictor(), and updateInternalState().

◆ restoreContext()

void oofem::SUPG::restoreContext	(	DataStream &	stream,
		ContextMode	mode )

overridevirtual

Restores the state of model from output stream. Restores not only the receiver state, but also same function is invoked for all DofManagers and Elements in associated domain. Note that by restoring element context also contexts of all associated integration points (and material statuses) are restored. Each context is associated with unique time step. Only one context per time step is allowed. Restore context function will restore such context, which is related (through its step number) to time step number and version given in obj parameter. Restoring context will change current time step in order to correspond to newly restored context.

Parameters

stream	Context file.
mode	Determines amount of info in stream.

Exceptions

ContextIOERR exception if error encountered.

Reimplemented from oofem::EngngModel.

Definition at line 843 of file supg.C.

References accelerationVector, oofem::CIO_OK, materialInterface, THROW_CIOERR, and VelocityPressureField.

◆ saveContext()

void oofem::SUPG::saveContext	(	DataStream &	stream,
		ContextMode	mode )

overridevirtual

Stores the state of model to output stream. Stores not only the receiver state, but also same function is invoked for all DofManagers and Elements in associated domain. Note that by storing element context also contexts of all associated integration points (and material statuses) are stored.

Parameters

stream	Context stream.
mode	Determines amount of info in stream.

Exceptions

ContextIOERR If error encountered.

Reimplemented from oofem::EngngModel.

Definition at line 825 of file supg.C.

References accelerationVector, oofem::CIO_OK, materialInterface, THROW_CIOERR, and VelocityPressureField.

◆ solveYourselfAt()

void oofem::SUPG::solveYourselfAt ( TimeStep * tStep )

overridevirtual

Solves problem for given time step. Should assemble characteristic matrices and vectors if necessary and solve problem using appropriate numerical method. After finishing solution, this->updateYourself function for updating solution state and then this->terminate function (for updating nodal and element values) should be called.

Reimplemented from oofem::EngngModel.

Definition at line 466 of file supg.C.

◆ updateComponent()

void oofem::SUPG::updateComponent	(	TimeStep *	tStep,
		NumericalCmpn	cmpn,
		Domain *	d )

overridevirtual

Reimplemented from oofem::EngngModel.

Definition at line 340 of file supg.C.

References alpha, oofem::assemble(), oofem::EngngModel::assembleVector(), dscale, eNorm, oofem::Domain::giveElements(), internalForces, oofem::EngngModel::InternalForcesExchangeTag, oofem::InternalRhs, lhs, lscale, oofem::NonLinearLhs, OOFEM_ERROR, oofem::EngngModel::updateSharedDofManagers(), oofem::FMElement::updateStabilizationCoeffs(), and uscale.

◆ updateDofManVals()

void oofem::SUPG::updateDofManVals ( TimeStep * tStep )

protected

◆ updateDofUnknownsDictionary()

void oofem::SUPG::updateDofUnknownsDictionary	(	DofManager *	,
		TimeStep *	)

overridevirtual

Updates necessary values in Dofs unknown dictionaries.

See also: EngngModel::requiresUnknownsDictionaryUpdate; Dof::updateUnknownsDictionary

Reimplemented from oofem::EngngModel.

Definition at line 1045 of file supg.C.

Referenced by updateInternalState().

◆ updateDofUnknownsDictionary_corrector()

void oofem::SUPG::updateDofUnknownsDictionary_corrector ( TimeStep * tStep )

protected

Definition at line 1095 of file supg.C.

References alpha, oofem::Domain::giveDofManager(), oofem::EngngModel::giveDomain(), oofem::Domain::giveNumberOfDofManagers(), oofem::TimeStep::giveTimeIncrement(), incrementalSolutionVector, and requiresUnknownsDictionaryUpdate().

Referenced by solveYourselfAt().

◆ updateDofUnknownsDictionary_predictor()

void oofem::SUPG::updateDofUnknownsDictionary_predictor ( TimeStep * tStep )

protected

Definition at line 1059 of file supg.C.

References oofem::Domain::giveDofManager(), oofem::EngngModel::giveDomain(), oofem::Domain::giveNumberOfDofManagers(), oofem::TimeStep::givePreviousStep(), oofem::TimeStep::giveTimeIncrement(), and requiresUnknownsDictionaryUpdate().

Referenced by solveYourselfAt().

◆ updateDomainLinks()

void oofem::SUPG::updateDomainLinks ( )

overridevirtual

Updates domain links after the domains of receiver have changed. Used mainly after restoring context - the domains may change and this service is then used to update domain variables in all components belonging to receiver like error estimators, solvers, etc, having domains as attributes.

Reimplemented from oofem::EngngModel.

Definition at line 911 of file supg.C.

References oofem::EngngModel::giveCurrentMetaStep(), and giveNumericalMethod().

◆ updateElementsForNewInterfacePosition()

void oofem::SUPG::updateElementsForNewInterfacePosition ( TimeStep * tStep )

protected

Definition at line 1030 of file supg.C.

References oofem::EngngModel::giveDomain(), oofem::Domain::giveElements(), OOFEM_LOG_DEBUG, and oofem::SUPGElement::updateElementForNewInterfacePosition().

Referenced by applyIC(), and solveYourselfAt().

◆ updateInternalRHS()

void oofem::SUPG::updateInternalRHS	(	FloatArray &	answer,
		TimeStep *	tStep,
		Domain *	d,
		FloatArray *	eNorm )

overridevirtual

Updates the solution (guess) according to the new values. Callback for nonlinear solvers (e.g. Newton-Raphson).

Parameters

solutionVector	New solution.
tStep	Time when component is updated.
d	Domain.
eNorm	Optional per-element norm (for normalization).

Reimplemented from oofem::EngngModel.

Definition at line 378 of file supg.C.

References oofem::EngngModel::assembleVector(), dscale, oofem::EngngModel::InternalForcesExchangeTag, lscale, oofem::EngngModel::updateSharedDofManagers(), uscale, and oofem::FloatArray::zero().

Referenced by solveYourselfAt().

◆ updateInternalState()

void oofem::SUPG::updateInternalState ( TimeStep * tStep )

protected

Definition at line 808 of file supg.C.

References oofem::EngngModel::domainList, requiresUnknownsDictionaryUpdate(), and updateDofUnknownsDictionary().

Referenced by updateYourself().

◆ updateMatrix()

void oofem::SUPG::updateMatrix	(	SparseMtrx &	mat,
		TimeStep *	tStep,
		Domain *	d )

overridevirtual

Updates the solution (guess) according to the new values. Callback for nonlinear solvers (e.g. Newton-Raphson).

Note: For performance, the matrix should keep it's non-zero structure between calls, so the caller should make sure not to clear the matrix object before called.

Parameters

solutionVector	New solution.
tStep	Time when component is updated.
d	Domain.

Reimplemented from oofem::EngngModel.

Definition at line 387 of file supg.C.

References alpha, oofem::assemble(), dscale, lscale, uscale, and oofem::SparseMtrx::zero().

◆ updateSolution()

void oofem::SUPG::updateSolution	(	FloatArray &	solutionVector,
		TimeStep *	tStep,
		Domain *	d )

overridevirtual

Updates the solution (guess) according to the new values. Callback for nonlinear solvers (e.g. Newton-Raphson), and are called before new internal forces are computed.

Parameters

solutionVector	New solution.
tStep	Time when component is updated.
d	Domain.

Reimplemented from oofem::EngngModel.

Definition at line 368 of file supg.C.

References oofem::Domain::giveElements(), oofem::FMElement::updateStabilizationCoeffs(), and VelocityPressureField.

◆ updateSolutionVectors()

void oofem::SUPG::updateSolutionVectors	(	FloatArray &	solutionVector,
		FloatArray &	accelerationVector,
		FloatArray &	incrementalSolutionVector,
		TimeStep *	tStep )

protected

Definition at line 1183 of file supg.C.

References oofem::FloatArray::add(), alpha, oofem::FloatArray::at(), oofem::Domain::giveDofManagers(), oofem::EngngModel::giveDomain(), oofem::Domain::giveElements(), oofem::TimeStep::giveTimeIncrement(), and incrementalSolutionVector.

Referenced by solveYourselfAt().

◆ updateSolutionVectors_predictor()

void oofem::SUPG::updateSolutionVectors_predictor	(	FloatArray &	solutionVector,
		FloatArray &	accelerationVector,
		TimeStep *	tStep )

protected

Definition at line 1137 of file supg.C.

References oofem::FloatArray::at(), oofem::Domain::giveDofManagers(), oofem::EngngModel::giveDomain(), oofem::Domain::giveElements(), and oofem::TimeStep::giveTimeIncrement().

Referenced by solveYourselfAt().

◆ updateYourself()

void oofem::SUPG::updateYourself ( TimeStep * tStep )

overridevirtual

Updates internal state after finishing time step. (for example total values may be updated according to previously solved increments). Then element values are also updated (together with related integration points and material statuses).

Reimplemented from oofem::EngngModel.

Definition at line 795 of file supg.C.

References materialInterface, and updateInternalState().

Member Data Documentation

◆ accelerationVector

FloatArray oofem::SUPG::accelerationVector

protected

Definition at line 116 of file supg.h.

Referenced by applyIC(), giveUnknownComponent(), restoreContext(), saveContext(), solveYourselfAt(), and SUPG().

◆ alpha

double oofem::SUPG::alpha = 0.

protected

Integration constant.

Definition at line 135 of file supg.h.

Referenced by initializeFrom(), solveYourselfAt(), updateComponent(), updateDofUnknownsDictionary_corrector(), updateMatrix(), and updateSolutionVectors().

◆ atolv

double oofem::SUPG::atolv = 1.

protected

Convergence tolerance.

Definition at line 126 of file supg.h.

Referenced by initializeFrom(), and solveYourselfAt().

◆ consistentMassFlag

int oofem::SUPG::consistentMassFlag = 0

protected

Definition at line 138 of file supg.h.

Referenced by initializeFrom().

◆ deltaT

double oofem::SUPG::deltaT = 1.

protected

Todo: Use ScalarFunction here!

Definition at line 123 of file supg.h.

Referenced by giveNextStep(), giveSolutionStepWhenIcApply(), and initializeFrom().

◆ deltaTF

int oofem::SUPG::deltaTF = 0

protected

Definition at line 124 of file supg.h.

Referenced by giveNextStep(), and initializeFrom().

◆ dscale

double oofem::SUPG::dscale = 1.

protected

Definition at line 142 of file supg.h.

Referenced by giveVariableScale(), initializeFrom(), printDofOutputAt(), solveYourselfAt(), updateComponent(), updateInternalRHS(), and updateMatrix().

◆ eNorm

FloatArray oofem::SUPG::eNorm

protected

Definition at line 120 of file supg.h.

Referenced by solveYourselfAt(), and updateComponent().

◆ equationScalingFlag

bool oofem::SUPG::equationScalingFlag = false

protected

Definition at line 140 of file supg.h.

Referenced by checkConsistency(), giveEquationScalingFlag(), giveReynoldsNumber(), and initializeFrom().

◆ incrementalSolutionVector

FloatArray oofem::SUPG::incrementalSolutionVector

protected

Definition at line 117 of file supg.h.

Referenced by solveYourselfAt(), updateDofUnknownsDictionary_corrector(), and updateSolutionVectors().

◆ initFlag

int oofem::SUPG::initFlag = 1

protected

Definition at line 137 of file supg.h.

Referenced by solveYourselfAt().

◆ internalForces

FloatArray oofem::SUPG::internalForces

protected

Definition at line 119 of file supg.h.

Referenced by solveYourselfAt(), and updateComponent().

◆ lhs

std :: unique_ptr< SparseMtrx > oofem::SUPG::lhs

protected

Definition at line 113 of file supg.h.

Referenced by solveYourselfAt(), and updateComponent().

◆ lscale

double oofem::SUPG::lscale = 1.

protected

Definition at line 142 of file supg.h.

Referenced by giveVariableScale(), initializeFrom(), solveYourselfAt(), updateComponent(), updateInternalRHS(), and updateMatrix().

◆ materialInterface

std :: unique_ptr< MaterialInterface > oofem::SUPG::materialInterface

protected

Definition at line 147 of file supg.h.

Referenced by applyIC(), giveMaterialInterface(), giveNextStep(), initializeFrom(), restoreContext(), saveContext(), solveYourselfAt(), and updateYourself().

◆ maxiter

int oofem::SUPG::maxiter = 0

protected

Max number of iterations.

Definition at line 128 of file supg.h.

Referenced by initializeFrom(), and solveYourselfAt().

◆ nMethod

std :: unique_ptr< SparseLinearSystemNM > oofem::SUPG::nMethod

protected

Numerical method used to solve the problem.

Definition at line 108 of file supg.h.

Referenced by giveNumericalMethod(), and solveYourselfAt().

◆ Re

double oofem::SUPG::Re = 0.

protected

Reynolds number.

Definition at line 144 of file supg.h.

Referenced by giveReynoldsNumber(), and initializeFrom().

◆ rtolv

double oofem::SUPG::rtolv = 1.

protected

Definition at line 126 of file supg.h.

Referenced by initializeFrom(), and solveYourselfAt().

◆ solverType

LinSystSolverType oofem::SUPG::solverType =LinSystSolverType::ST_Direct

protected

Definition at line 110 of file supg.h.

Referenced by giveNumericalMethod(), and initializeFrom().

◆ sparseMtrxType

SparseMtrxType oofem::SUPG::sparseMtrxType =SparseMtrxType::SMT_Skyline

protected

Definition at line 111 of file supg.h.

Referenced by initializeFrom(), and solveYourselfAt().

◆ stopmaxiter

bool oofem::SUPG::stopmaxiter = true

protected

Flag if set to true (default), then when max number of iteration reached, computation stops otherwise computation continues with next step.

Definition at line 133 of file supg.h.

Referenced by initializeFrom(), and solveYourselfAt().

◆ uscale

double oofem::SUPG::uscale = 1.

protected

Definition at line 142 of file supg.h.

Referenced by checkConsistency(), giveVariableScale(), initializeFrom(), printDofOutputAt(), solveYourselfAt(), updateComponent(), updateInternalRHS(), and updateMatrix().

◆ VelocityPressureField

std :: unique_ptr< PrimaryField > oofem::SUPG::VelocityPressureField

protected

Definition at line 114 of file supg.h.

Referenced by applyIC(), giveUnknownComponent(), initializeFrom(), restoreContext(), saveContext(), solveYourselfAt(), and updateSolution().

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

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SUPG()

Member Function Documentation

◆ applyIC()

◆ checkConsistency()

◆ evaluateElementStabilizationCoeffs()

◆ giveClassName()

◆ giveEquationScalingFlag()

◆ giveFormulation()

◆ giveInputRecordName()

◆ giveMaterialInterface()

◆ giveNextStep()

◆ giveNumericalMethod()

◆ giveReynoldsNumber()

◆ giveSolutionStepWhenIcApply()

◆ giveUnknownComponent()

◆ giveUnknownDictHashIndx()

◆ giveVariableScale()

◆ initializeFrom()

◆ printDofOutputAt()

◆ requiresUnknownsDictionaryUpdate()

◆ restoreContext()

◆ saveContext()

◆ solveYourselfAt()

◆ updateComponent()

◆ updateDofManVals()

◆ updateDofUnknownsDictionary()

◆ updateDofUnknownsDictionary_corrector()

◆ updateDofUnknownsDictionary_predictor()

◆ updateDomainLinks()

◆ updateElementsForNewInterfacePosition()

◆ updateInternalRHS()

◆ updateInternalState()

◆ updateMatrix()

◆ updateSolution()

◆ updateSolutionVectors()

◆ updateSolutionVectors_predictor()

◆ updateYourself()

Member Data Documentation

◆ accelerationVector

◆ alpha

◆ atolv

◆ consistentMassFlag

◆ deltaT

◆ deltaTF

◆ dscale

◆ eNorm

◆ equationScalingFlag

◆ incrementalSolutionVector

◆ initFlag

◆ internalForces

◆ lhs

◆ lscale

◆ materialInterface

◆ maxiter

◆ nMethod

◆ Re

◆ rtolv

◆ solverType

◆ sparseMtrxType

◆ stopmaxiter

◆ uscale

◆ VelocityPressureField