Skip to main content

Common Fluids Format 2025 R2

ansys::Project::RunGroup Class Reference

Last update: 16.07.2025

Optional concept - Virtual folder with a list of Run. More...

#include "RunGroup.hpp"

Inheritance diagram for ansys::Project::RunGroup:
ansys::Project::Run

Public Member Functions

 RunGroup (Iterator pIter)
 
virtual ~RunGroup ()
 
virtual Error isValid () const
 Returns error with message if invalid. More...
 
virtual bool setRunOutputType (Run::RunOutputType pType)
 Set the run output type, will add automatically the mandatory variables (if any) More...
 
Error addRun (Iterator pRun)
 Register a Run in the RunGroup. More...
 
std::vector< IteratorgetRuns () const
 Returns the list of runs for this RunGroup. More...
 
Iterator getIterator () const
 
bool addVariable (const std::string &pVar)
 Register an input variable for this run. More...
 
bool setVariables (const std::vector< std::string > &pVars)
 Set/replace the list of variables for this run. More...
 
bool removeVariable (const std::string &pVar)
 Remove a variable from the list of inputs. More...
 
std::vector< std::string > getVariables () const
 Return the list of input variables for this Run. More...
 
bool addOutputVariable (const std::string &pVar)
 Register an output variable for this run. More...
 
bool setOutputVariables (const std::vector< std::string > &pVars)
 Set/replace the list of output variables. More...
 
bool removeOutputVariable (const std::string &pVar)
 Remove an output variable. More...
 
std::vector< std::string > getOutputVariables () const
 Returns the list of output variables. More...
 
std::vector< std::string > getAllVariables () const
 Returns the list of all variables ( input and output ) More...
 
void addVarIndex ()
 Add the Index variable (not required if mandatory for the run type) More...
 
void addVarTime ()
 Add the Time variable (not required if mandatory for the run type) More...
 
void addVarSolverIteration ()
 Add the SolverIteration variable (not required if mandatory for the run type) More...
 
void addVarCrankAngle ()
 Add the built-in variable. More...
 
void addVarMeshId ()
 Add the MeshId variable - Id should be incremented when the mesh has changed. More...
 
void addVarDomainTransformationId ()
 Add the DomainTransformationId variable - Id should be incremented when the mesh transformation metadata has changed. More...
 
void addVarPhysicsId ()
 Add the PhysicsId variable - Id should be incremented when the physics settings have changed. More...
 
void addVarTopologyId ()
 Add the TopologyId variable - Id should be incremented when the topology (list of boundaries, domains) has changed. More...
 
void addVarCoordinatesId ()
 Add the CoordinatesId variable - Id should be incremented when the node locations of a mesh have changed. More...
 
void addVarConnectivityId ()
 Add the ConnectivityId variable - Id should be incremented when the cells of a mesh are changed (number changed, connectivity changed, ...) More...
 
void addVarCaseId ()
 Add the CaseId variable - Id is incremented when the case settings are changed. More...
 
void addVarInputSettingsId ()
 Add the InputSettings variable - Id is incremented when the input case settings are changed. More...
 
void addVarOutputSettingsId ()
 Add the OutputSettings variable - Id is incremented when the case output settings are changed. More...
 
void setRunStatus (RunStatus pStatus)
 Set the RunStatus state for this Run. More...
 
RunStatus getRunStatus () const
 Returns the RunStatus state for this Output. See setRunStatus() More...
 
RunOutputType getRunOutputType () const
 Return the RunOutputType as the enum. More...
 
std::string getRunOutputTypeAsString () const
 Return the RunOutputType as a string. More...
 

Detailed Description

Optional concept - Virtual folder with a list of Run.

Can be used to regroup multiple runs part of a larger parametric analysis. The RunGroup is a subclass of Run and provides the same services ( RunOutputType, input/output variables, etc. )

Constructor & Destructor Documentation

◆ RunGroup()

ansys::Project::RunGroup::RunGroup ( Iterator  pIter)

◆ ~RunGroup()

virtual ansys::Project::RunGroup::~RunGroup ( )
inlinevirtual

Member Function Documentation

◆ addOutputVariable()

bool ansys::Project::Run::addOutputVariable ( const std::string &  pVar)

Register an output variable for this run.

All Output subfolders should define a specific value for this variable.

◆ addRun()

Error ansys::Project::RunGroup::addRun ( Iterator  pRun)

Register a Run in the RunGroup.

The Run is referenced as a project Link in the virtual subfolder

◆ addVarCaseId()

void ansys::Project::Run::addVarCaseId ( )

Add the CaseId variable - Id is incremented when the case settings are changed.

◆ addVarConnectivityId()

void ansys::Project::Run::addVarConnectivityId ( )

Add the ConnectivityId variable - Id should be incremented when the cells of a mesh are changed (number changed, connectivity changed, ...)

◆ addVarCoordinatesId()

void ansys::Project::Run::addVarCoordinatesId ( )

Add the CoordinatesId variable - Id should be incremented when the node locations of a mesh have changed.

◆ addVarCrankAngle()

void ansys::Project::Run::addVarCrankAngle ( )

Add the built-in variable.

◆ addVarDomainTransformationId()

void ansys::Project::Run::addVarDomainTransformationId ( )

Add the DomainTransformationId variable - Id should be incremented when the mesh transformation metadata has changed.

◆ addVariable()

bool ansys::Project::Run::addVariable ( const std::string &  pVar)

Register an input variable for this run.

This registration is not required for automatic variables (Transient=Time, etc.)

All Output subfolders should define a specific value for this variable.

◆ addVarIndex()

void ansys::Project::Run::addVarIndex ( )

Add the Index variable (not required if mandatory for the run type)

◆ addVarInputSettingsId()

void ansys::Project::Run::addVarInputSettingsId ( )

Add the InputSettings variable - Id is incremented when the input case settings are changed.

If provided, this should be incremented when any of the dependent input settings are changed, such as PhysicsId or DomainTransformationId

◆ addVarMeshId()

void ansys::Project::Run::addVarMeshId ( )

Add the MeshId variable - Id should be incremented when the mesh has changed.

◆ addVarOutputSettingsId()

void ansys::Project::Run::addVarOutputSettingsId ( )

Add the OutputSettings variable - Id is incremented when the case output settings are changed.

◆ addVarPhysicsId()

void ansys::Project::Run::addVarPhysicsId ( )

Add the PhysicsId variable - Id should be incremented when the physics settings have changed.

◆ addVarSolverIteration()

void ansys::Project::Run::addVarSolverIteration ( )

Add the SolverIteration variable (not required if mandatory for the run type)

◆ addVarTime()

void ansys::Project::Run::addVarTime ( )

Add the Time variable (not required if mandatory for the run type)

◆ addVarTopologyId()

void ansys::Project::Run::addVarTopologyId ( )

Add the TopologyId variable - Id should be incremented when the topology (list of boundaries, domains) has changed.

◆ getAllVariables()

std::vector< std::string > ansys::Project::Run::getAllVariables ( ) const

Returns the list of all variables ( input and output )

◆ getIterator()

Iterator ansys::Project::Run::getIterator ( ) const
inlinevirtual

Reimplemented from ansys::Project::Run.

◆ getOutputVariables()

std::vector< std::string > ansys::Project::Run::getOutputVariables ( ) const

Returns the list of output variables.

◆ getRunOutputType()

Run::RunOutputType ansys::Project::Run::getRunOutputType ( ) const

Return the RunOutputType as the enum.

◆ getRunOutputTypeAsString()

std::string ansys::Project::Run::getRunOutputTypeAsString ( ) const

Return the RunOutputType as a string.

◆ getRuns()

std::vector< Iterator > ansys::Project::RunGroup::getRuns ( ) const

Returns the list of runs for this RunGroup.

◆ getRunStatus()

RunStatus ansys::Project::Run::getRunStatus ( ) const

Returns the RunStatus state for this Output. See setRunStatus()

◆ getVariables()

std::vector< std::string > ansys::Project::Run::getVariables ( ) const

Return the list of input variables for this Run.

◆ isValid()

Error ansys::Project::RunGroup::isValid ( ) const
virtual

Returns error with message if invalid.

Reimplemented from ansys::Project::Run.

◆ removeOutputVariable()

bool ansys::Project::Run::removeOutputVariable ( const std::string &  pVar)

Remove an output variable.

◆ removeVariable()

bool ansys::Project::Run::removeVariable ( const std::string &  pVar)

Remove a variable from the list of inputs.

Mandatory variables cannot be removed

◆ setOutputVariables()

bool ansys::Project::Run::setOutputVariables ( const std::vector< std::string > &  pVars)

Set/replace the list of output variables.

◆ setRunOutputType()

bool ansys::Project::RunGroup::setRunOutputType ( Run::RunOutputType  pType)
virtual

Set the run output type, will add automatically the mandatory variables (if any)

The RunOutputType::Simple cannot be used for a RunGroup

◆ setRunStatus()

void ansys::Project::Run::setRunStatus ( RunStatus  pStatus)

Set the RunStatus state for this Run.

(Optional API) The run status permits to indicate if a Run is running, completed, waiting for execution, etc. This status can also be defined at the Output level

◆ setVariables()

bool ansys::Project::Run::setVariables ( const std::vector< std::string > &  pVars)

Set/replace the list of variables for this run.

The operation will fail if the list of variables does not contain the mandatory variable for the RunOutputType

All Output subfolders should define a specific value for each variable.

Connect with Ansys