CFD Mesh Functions

This group of functions is used to setup and run the CFD Mesh tool through the API. Click here to return to the main page. More...

Functions
std::string	vsp::GetComputationFileName (int file_type)
void	vsp::SetComputationFileName (int file_type, const std::string &file_name)
void	vsp::ComputeCFDMesh (int set, int degenset, int file_export_types)
void	vsp::SetCFDMeshModeID (const std::string &mode_id)
std::string	vsp::GetCFDMeshModeID ()
void	vsp::SetIntersectModeID (const std::string &mode_id)
std::string	vsp::GetIntersectModeID ()
double	vsp::GetCFDMeshVal (int type)
void	vsp::SetCFDMeshVal (int type, double val)
bool	vsp::GetCFDWakeFlag (const std::string &geom_id)
void	vsp::SetCFDWakeFlag (const std::string &geom_id, bool flag)
void	vsp::SetCFDFarFieldGeomID (const std::string &geom_id)
std::string	vsp::GetCFDFarFieldGeomID ()
int	vsp::GetNumCFDSources (const std::string &geom_id)
std::string	vsp::GetCFDSourceName (const std::string &geom_id, int source_index)
std::string	vsp::GetCFDSourceNameByID (const std::string &source_id)
void	vsp::SetCFDSourceName (const std::string &geom_id, int source_index, const std::string &name)
void	vsp::SetCFDSourceNameByID (const std::string &source_id, const std::string &name)
int	vsp::GetCFDSourceType (const std::string &geom_id, int source_index)
int	vsp::GetCFDSourceTypeByID (const std::string &source_id)
void	vsp::DeleteCFDSource (const std::string &geom_id, int source_index)
void	vsp::DeleteCFDSourceByID (const std::string &source_id)
void	vsp::DeleteAllCFDSources ()
std::string	vsp::GetCFDSourceID (const std::string &geom_id, int source_index)
std::vector< std::string >	vsp::GetCFDSourceIDVec (const std::string &geom_id)
void	vsp::AdjustAllCFDSourceLen (double mult)
void	vsp::AdjustAllCFDSourceRad (double mult)
void	vsp::AddDefaultSources ()
std::string	vsp::AddCFDSource (int type, const std::string &geom_id, int surf_index, double l1, double r1, double u1, double w1, double l2=0, double r2=0, double u2=0, double w2=0)

Detailed Description

Function Documentation

AddCFDSource()

std::string vsp::AddCFDSource ( int type, const std::string & geom_id, int surf_index, double l1, double r1, double u1, double w1, double l2 = 0, double r2 = 0, double u2 = 0, double w2 = 0 )

extern

Add a CFD Mesh default source for the indicated Geom. Note, certain input params may not be used depending on the source type

//==== Add Pod Geom ====//
string pid = AddGeom( "POD", "" );
 
string src_id = AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );      // Add A Point Source
 
// The source lands on the Geom it was given, as the type it was given.
if ( GetNumCFDSources( pid ) != 1 || GetCFDSourceTypeByID( src_id ) != POINT_SOURCE )
{
    Print( "ERROR: AddCFDSource did not add a point source" );
    __failure++;
}
 
// A source attached to a Geom that does not exist has to be rejected.
AddCFDSource( POINT_SOURCE, "NOSUCHGEOM", 0, 0.25, 2.0, 0.5, 0.5 );
 
if ( GetNumTotalErrors() == 0 )
{
    Print( "ERROR: AddCFDSource accepted a bad Geom ID" );
    __failure++;
}
 
// That error was raised deliberately, so take it back off the queue.
while ( GetNumTotalErrors() > 0 )
{
    ErrorObj err = PopLastError();
}

See also

CFD_MESH_SOURCE_TYPE

Parameters

[in]	type	int CFD Mesh source type( i.e.BOX_SOURCE )
[in]	geom_id	string Geom ID
[in]	surf_index	int Main surface index
[in]	l1	double Source first edge length
[in]	r1	double Source first radius
[in]	u1	double Source first U location
[in]	w1	double Source first W location
[in]	l2	double Source second edge length
[in]	r2	double Source second radius
[in]	u2	double Source second U location
[in]	w2	double Source second W location

Returns

string ID of the new source

Here is the call graph for this function:

Here is the caller graph for this function:

AddDefaultSources()

void vsp::AddDefaultSources ( )

extern

Add default CFD Mesh sources for all Geoms

//==== Add Pod Geom ====//
string pid = AddGeom( "POD", "" );
 
AddDefaultSources(); // 3 Sources: Def_Fwd_PS, Def_Aft_PS, Def_Fwd_Aft_LS
 
// The three default sources arrive under the names in the comment.
if ( GetNumCFDSources( pid ) != 3 )
{
    Print( "ERROR: AddDefaultSources did not add three sources" );
    __failure++;
}
else
{
    if ( GetCFDSourceName( pid, 0 ) != "Def_Fwd_PS" ||
         GetCFDSourceName( pid, 1 ) != "Def_Aft_PS" ||
         GetCFDSourceName( pid, 2 ) != "Def_Fwd_Aft_LS" )
    {
        Print( "ERROR: AddDefaultSources did not add the expected sources" );
        __failure++;
    }
 
    // The first two are point sources and the third joins them with a line.
    if ( GetCFDSourceType( pid, 0 ) != POINT_SOURCE ||
         GetCFDSourceType( pid, 1 ) != POINT_SOURCE ||
         GetCFDSourceType( pid, 2 ) != LINE_SOURCE )
    {
        Print( "ERROR: AddDefaultSources did not add the expected source types" );
        __failure++;
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

AdjustAllCFDSourceLen()

void vsp::AdjustAllCFDSourceLen ( double mult )

extern

Scale the edge length of every CFD Mesh source in the model by a common factor. This is what the four global source length buttons on the CFD Mesh screen do, at 1/1.5, 1/1.1, 1.1 and 1.5. Sources are usually sized relative to one another, so scaling them together is how a mesh is refined or coarsened as a whole.

string pid = AddGeom( "POD", "" );
 
AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );
 
string src_id = GetCFDSourceID( pid, 0 );
 
AdjustAllCFDSourceLen( 2.0 );
 
if ( abs( GetParmVal( src_id, "SrcLen", "Source" ) - 0.5 ) > 1e-6 )
{
    Print( "ERROR: AdjustAllCFDSourceLen did not scale the source" );
    __failure++;
}

See also

AdjustAllCFDSourceRad, GetCFDSourceID

Parameters

[in]

mult

double Factor to scale every source length by

Here is the call graph for this function:

Here is the caller graph for this function:

AdjustAllCFDSourceRad()

void vsp::AdjustAllCFDSourceRad ( double mult )

extern

Scale the radius of influence of every CFD Mesh source in the model by a common factor. This is what the four global source radius buttons on the CFD Mesh screen do, at 1/1.5, 1/1.1, 1.1 and 1.5.

string pid = AddGeom( "POD", "" );
 
AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );
 
string src_id = GetCFDSourceID( pid, 0 );
 
AdjustAllCFDSourceRad( 0.5 );
 
if ( abs( GetParmVal( src_id, "SrcRad", "Source" ) - 1.0 ) > 1e-6 )
{
    Print( "ERROR: AdjustAllCFDSourceRad did not scale the source" );
    __failure++;
}

See also

AdjustAllCFDSourceLen, GetCFDSourceID

Parameters

[in]

mult

double Factor to scale every source radius by

Here is the call graph for this function:

Here is the caller graph for this function:

ComputeCFDMesh()

void vsp::ComputeCFDMesh ( int set, int degenset, int file_export_types )

extern

Create a CFD Mesh for the components in the set. This analysis cannot be run through the Analysis Manager. When the CFD Mesh UseMode flag is on, the sets of its mode replace set and degenset.

 //==== Add Pod Geometry ====//
 string pid = AddGeom( "POD" );
 
 Update();
 
 //==== Keep the mesh coarse so the example runs quickly ====//
 SetCFDMeshVal( CFD_MAX_EDGE_LEN, 1.0 );
 SetCFDMeshVal( CFD_MIN_EDGE_LEN, 0.1 );
 
 //==== CFDMesh Method Facet Export =====//
 SetComputationFileName( CFD_FACET_TYPE, "TestCFDMeshFacet_API.facet" );
 SetComputationFileName( CFD_STL_TYPE, "TestCFDMesh_API.stl" );
 
Print( "\tComputing CFDMesh..." );
 
 ComputeCFDMesh( SET_ALL, SET_NONE, CFD_FACET_TYPE | CFD_STL_TYPE );
 
 // CFD Mesh reports nothing through the Results Manager, so read the mesh it
 // just wrote back in to prove it produced one.
 string mesh_id = ImportFile( "TestCFDMesh_API.stl", IMPORT_STL, "" );
 
 if ( mesh_id.length() == 0 || GetGeomTypeName( mesh_id ) != "Mesh" )
 {
     Print( "ERROR: ComputeCFDMesh did not write a readable mesh" );
     __failure++;
 }
 else
 {
     DeleteGeom( mesh_id );
 }

See also

COMPUTATION_FILE_TYPE

Parameters

[in]	set	int Set index (i.e. SET_ALL)
[in]	degenset	int DegenSet index (i.e. SET_NONE)
[in]	file_export_types	int CFD Mesh file type to export (supports XOR i.e CFD_SRF_TYPE & CFD_STL_TYPE)

Here is the call graph for this function:

Here is the caller graph for this function:

DeleteAllCFDSources()

void vsp::DeleteAllCFDSources ( )

extern

Delete every CFD Mesh source on every Geom.

string pid = AddGeom( "POD" );
 
Update();
 
AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 1.0, 0.25, 0.5 );
 
DeleteAllCFDSources();
 
if ( GetNumCFDSources( pid ) != 0 )                  { Print( "ERROR: DeleteAllCFDSources" ); __failure++; }

See also

AddCFDSource, DeleteCFDSource

Here is the call graph for this function:

Here is the caller graph for this function:

DeleteCFDSource()

void vsp::DeleteCFDSource ( const std::string & geom_id, int source_index )

extern

Delete a single CFD Mesh source from the specified Geom

//==== Add Pod Geom ====//
string pid = AddGeom( "POD", "" );
 
AddDefaultSources(); // 3 Sources: Def_Fwd_PS, Def_Aft_PS, Def_Fwd_Aft_LS
 
string second_name = GetCFDSourceName( pid, 1 );
 
DeleteCFDSource( pid, 0 );
 
// Only the named source goes, and the rest slide down.
if ( GetNumCFDSources( pid ) != 2 )
{
    Print( "ERROR: DeleteCFDSource did not remove one source" );
    __failure++;
}
 
if ( GetCFDSourceName( pid, 0 ) != second_name )
{
    Print( "ERROR: DeleteCFDSource removed the wrong source" );
    __failure++;
}
 
// An index past the end has to be rejected.
DeleteCFDSource( pid, GetNumCFDSources( pid ) );
 
if ( GetNumTotalErrors() == 0 )
{
    Print( "ERROR: DeleteCFDSource accepted an index past the end" );
    __failure++;
}
 
// That error was raised deliberately, so take it back off the queue.
while ( GetNumTotalErrors() > 0 )
{
    ErrorObj err = PopLastError();
}

See also

AddCFDSource, AddDefaultSources, DeleteAllCFDSources, GetNumCFDSources, DeleteCFDSourceByID

Parameters

[in]	geom_id	string Geom ID
[in]	source_index	int Source index

Here is the call graph for this function:

Here is the caller graph for this function:

DeleteCFDSourceByID()

void vsp::DeleteCFDSourceByID ( const std::string & source_id )

extern

Delete a CFD Mesh source, by source ID.

string pid = AddGeom( "POD" );
 
string src_id = AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );
 
DeleteCFDSourceByID( src_id );
 
if ( GetNumCFDSources( pid ) != 0 )
{
    Print( "ERROR: DeleteCFDSourceByID did not delete the source" );
    __failure++;
}

See also

AddCFDSource, DeleteAllCFDSources, DeleteCFDSource

Parameters

[in]

source_id

string CFD Mesh source ID

Here is the call graph for this function:

Here is the caller graph for this function:

GetCFDFarFieldGeomID()

std::string vsp::GetCFDFarFieldGeomID ( )

extern

Get the Geom that stands in for the CFD Mesh far field box. Comes back empty when none has been named.

//==== Add Two Geoms To Choose Between ====//
string pid = AddGeom( "POD" );
string eid = AddGeom( "ELLIPSOID" );
 
SetCFDFarFieldGeomID( eid );
 
if ( GetCFDFarFieldGeomID() != eid )
{
    Print( "ERROR: GetCFDFarFieldGeomID did not report the Geom that was set" );
    __failure++;
}
 
// It follows the setting, so naming another Geom changes what comes back.
SetCFDFarFieldGeomID( pid );
 
if ( GetCFDFarFieldGeomID() != pid )
{
    Print( "ERROR: GetCFDFarFieldGeomID did not follow SetCFDFarFieldGeomID" );
    __failure++;
}
 
// With the choice cleared it comes back empty.
SetCFDFarFieldGeomID( "" );
 
if ( GetCFDFarFieldGeomID() != "" )
{
    Print( "ERROR: GetCFDFarFieldGeomID did not come back empty" );
    __failure++;
}

See also

SetCFDFarFieldGeomID

Returns

string Geom ID

Here is the call graph for this function:

Here is the caller graph for this function:

GetCFDMeshModeID()

std::string vsp::GetCFDMeshModeID ( )

extern

Get the mode CFD Mesh uses when its UseMode flag is on.

AddGeom( "POD" );
 
string mid = CreateAndAddMode( "Clean", SET_ALL, SET_NONE );
 
SetCFDMeshModeID( mid );
 
if ( GetCFDMeshModeID() != mid )
{
    Print( "ERROR: GetCFDMeshModeID did not return the mode set" );
    __failure++;
}

See also

SetCFDMeshModeID

Returns

string Mode ID, or an empty string for none

Here is the call graph for this function:

Here is the caller graph for this function:

GetCFDMeshVal()

double vsp::GetCFDMeshVal ( int type )

extern

Set the value of a specific CFD Mesh option

SetCFDMeshVal( CFD_MIN_EDGE_LEN, 1.0 );
 
// The control types are backed by Parms in the CFD grid density container,
// so the value that was set can be read back.
string dens_id = FindContainer( "CFDGridDensity", 0 );
 
string min_len_id = FindParm( dens_id, "MinLen", "CFDGridDensity" );
 
if ( !closeTo( GetParmVal( min_len_id ), 1.0, 1e-12 ) )
{
    Print( "ERROR: SetCFDMeshVal did not set CFD_MIN_EDGE_LEN" );
    __failure++;
}

See also

CFD_CONTROL_TYPE

Parameters

[in]	type	int CFD Mesh control type enum (i.e. CFD_GROWTH_RATIO)
[in]	val	double Value to set

Get the value of a specific CFD Mesh option

SetCFDMeshVal( CFD_MIN_EDGE_LEN, 1.0 );
 
if ( !closeTo( GetCFDMeshVal( CFD_MIN_EDGE_LEN ), 1.0, 1e-12 ) )
{
    Print( "ERROR: GetCFDMeshVal did not report the value that was set" );
    __failure++;
}
 
// Flags read back as zero or one.
SetCFDMeshVal( CFD_HALF_MESH_FLAG, 1.0 );
 
if ( !closeTo( GetCFDMeshVal( CFD_HALF_MESH_FLAG ), 1.0, 1e-12 ) )
{
    Print( "ERROR: GetCFDMeshVal did not report the half mesh flag" );
    __failure++;
}
 
// A control type that does not exist has to be rejected.
GetCFDMeshVal( -1 );
 
if ( GetNumTotalErrors() == 0 )
{
    Print( "ERROR: GetCFDMeshVal accepted an unknown control type" );
    __failure++;
}
 
// That error was raised deliberately, so take it back off the queue.
while ( GetNumTotalErrors() > 0 )
{
    ErrorObj err = PopLastError();
}

See also

CFD_CONTROL_TYPE, SetCFDMeshVal

Parameters

[in]

type

int CFD Mesh control type enum (i.e. CFD_GROWTH_RATIO)

Returns

double Value of the option

Here is the call graph for this function:

Here is the caller graph for this function:

GetCFDSourceID()

std::string vsp::GetCFDSourceID ( const std::string & geom_id, int source_index )

extern

Get the ParmContainer ID of a CFD Mesh source, so its size and placement can be read and driven after the source has been created. A source's Parms live in the "Source" group and are named SrcLen, SrcRad, U_Loc and W_Loc, with SrcLen2, SrcRad2 and the numbered locations on the source types that take two ends.

string pid = AddGeom( "POD", "" );
 
AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );
 
string src_id = GetCFDSourceID( pid, 0 );
 
if ( src_id.length() == 0 )
{
    Print( "ERROR: GetCFDSourceID returned no id" );
    __failure++;
}
 
// The source was created with a length of 0.25, and is editable from here.
if ( abs( GetParmVal( src_id, "SrcLen", "Source" ) - 0.25 ) > 1e-6 )
{
    Print( "ERROR: GetCFDSourceID did not reach the source" );
    __failure++;
}
 
SetParmVal( src_id, "SrcLen", "Source", 0.5 );

See also

AddCFDSource, GetCFDSourceName, GetCFDSourceType

Parameters

[in]	geom_id	string Geom ID
[in]	source_index	int CFD Mesh source index

Returns

string ParmContainer ID for the source

Here is the call graph for this function:

Here is the caller graph for this function:

GetCFDSourceIDVec()

std::vector< std::string > vsp::GetCFDSourceIDVec ( const std::string & geom_id )

extern

Get the IDs of the CFD Mesh sources of a Geom, in the order of their indexes.

string pid = AddGeom( "POD" );
 
string src_id = AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );
 
array< string > @ids = GetCFDSourceIDVec( pid );
 
if ( ids.size() != 1 || ids[0] != src_id )
{
    Print( "ERROR: GetCFDSourceIDVec did not return the source" );
    __failure++;
}

See also

GetCFDSourceID, GetNumCFDSources

Parameters

[in]

geom_id

string Geom ID

Returns

array<string> Array of CFD Mesh source IDs

Here is the call graph for this function:

Here is the caller graph for this function:

GetCFDSourceName()

std::string vsp::GetCFDSourceName ( const std::string & geom_id, int source_index )

extern

Get the name of a CFD Mesh source on the specified Geom

//==== Add Pod Geom ====//
string pid = AddGeom( "POD", "" );
 
AddDefaultSources(); // 3 Sources: Def_Fwd_PS, Def_Aft_PS, Def_Fwd_Aft_LS
 
if ( GetCFDSourceName( pid, 0 ) != "Def_Fwd_PS" )
{
    Print( "ERROR: GetCFDSourceName did not name the first default source" );
    __failure++;
}
 
// Every source the Geom counts has to be nameable.
for ( int i = 0; i < GetNumCFDSources( pid ); i++ )
{
    if ( GetCFDSourceName( pid, i ).length() == 0 )
    {
        Print( "ERROR: source " + i + " has no name" );
        __failure++;
    }
}
 
// An index past the end has to be rejected.
GetCFDSourceName( pid, GetNumCFDSources( pid ) );
 
if ( GetNumTotalErrors() == 0 )
{
    Print( "ERROR: GetCFDSourceName accepted an index past the end" );
    __failure++;
}
 
// That error was raised deliberately, so take it back off the queue.
while ( GetNumTotalErrors() > 0 )
{
    ErrorObj err = PopLastError();
}

See also

GetNumCFDSources, GetCFDSourceType, GetCFDSourceNameByID

Parameters

[in]	geom_id	string Geom ID
[in]	source_index	int Source index

Returns

string Source name

Here is the call graph for this function:

Here is the caller graph for this function:

GetCFDSourceNameByID()

std::string vsp::GetCFDSourceNameByID ( const std::string & source_id )

extern

Get the name of a CFD Mesh source, by source ID.

string pid = AddGeom( "POD" );
 
string src_id = AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );
 
SetCFDSourceName( pid, 0, "Nose" );
 
if ( GetCFDSourceNameByID( src_id ) != "Nose" )
{
    Print( "ERROR: GetCFDSourceNameByID did not return the name set" );
    __failure++;
}

See also

SetCFDSourceName, GetCFDSourceName

Parameters

[in]

source_id

string CFD Mesh source ID

Returns

string Source name

Here is the call graph for this function:

Here is the caller graph for this function:

GetCFDSourceType()

int vsp::GetCFDSourceType ( const std::string & geom_id, int source_index )

extern

Get the type of one CFD Mesh source on a Geom.

string pid = AddGeom( "POD" );
 
Update();
 
AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 1.0, 0.25, 0.5 );
 
if ( GetCFDSourceType( pid, 0 ) != POINT_SOURCE )    { Print( "ERROR: GetCFDSourceType" ); __failure++; }

See also

CFD_MESH_SOURCE_TYPE, AddCFDSource, GetCFDSourceTypeByID

Parameters

[in]	geom_id	string Geom ID
[in]	source_index	int Index of the source on that Geom

Returns

int CFD mesh source type enum (i.e. POINT_SOURCE)

Here is the call graph for this function:

Here is the caller graph for this function:

GetCFDSourceTypeByID()

int vsp::GetCFDSourceTypeByID ( const std::string & source_id )

extern

Get the type of a CFD Mesh source, by source ID.

string pid = AddGeom( "POD" );
 
string src_id = AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );
 
if ( GetCFDSourceTypeByID( src_id ) != POINT_SOURCE )
{
    Print( "ERROR: GetCFDSourceTypeByID did not return the source's type" );
    __failure++;
}

See also

CFD_MESH_SOURCE_TYPE, GetCFDSourceType

Parameters

[in]

source_id

string CFD Mesh source ID

Returns

int Source type enum (i.e. POINT_SOURCE)

Here is the call graph for this function:

Here is the caller graph for this function:

GetCFDWakeFlag()

bool vsp::GetCFDWakeFlag ( const std::string & geom_id )

extern

Activate or deactivate the CFD Mesh wake for a particular Geom. Note, the wake flag is only applicable for wing-type surfaces. Also, this function is simply an alternative to setting the value of the Parm with the available Parm setting API functions.

//==== Add Wing Geom ====//
string wid = AddGeom( "WING", "" );
 
SetCFDWakeFlag( wid, true );
 
if ( !closeTo( GetParmVal( wid, "Wake", "Shape" ), 1.0, 1e-12 ) )
{
    Print( "ERROR: SetCFDWakeFlag did not activate the wake" );
    __failure++;
}
 
SetCFDWakeFlag( wid, false );
 
if ( !closeTo( GetParmVal( wid, "Wake", "Shape" ), 0.0, 1e-12 ) )
{
    Print( "ERROR: SetCFDWakeFlag did not deactivate the wake" );
    __failure++;
}
 
// This is equivalent to SetParmValUpdate( wid, "Wake", "Shape", 1.0 );
// To change the scale: SetParmValUpdate( wid, "WakeScale", "WakeSettings", 10.0 );
// To change the angle: SetParmValUpdate( wid, "WakeAngle", "WakeSettings", -5.0 );

See also

SetParmVal, SetParmValUpdate

Parameters

[in]	geom_id	string Geom ID
[in]	flag	bool True to activate, false to deactivate

Get the CFD Mesh wake flag for a particular Geom

//==== Add Wing Geom ====//
string wid = AddGeom( "WING", "" );
 
// A new Geom starts with its wake off.
if ( GetCFDWakeFlag( wid ) )
{
    Print( "ERROR: a new Geom starts with its wake on" );
    __failure++;
}
 
SetCFDWakeFlag( wid, true );
 
if ( !GetCFDWakeFlag( wid ) )
{
    Print( "ERROR: GetCFDWakeFlag did not follow SetCFDWakeFlag" );
    __failure++;
}
 
// The flag is the Wake Parm, so the two have to agree.
if ( !closeTo( GetParmVal( wid, "Wake", "Shape" ), 1.0, 1e-12 ) )
{
    Print( "ERROR: the wake flag disagrees with its Parm" );
    __failure++;
}

See also

SetCFDWakeFlag

Parameters

[in]

geom_id

string Geom ID

Returns

bool True if the wake is active

Here is the call graph for this function:

Here is the caller graph for this function:

GetComputationFileName()

std::string vsp::GetComputationFileName ( int file_type )

extern

Get the file name of a specified file type. Note, this function cannot be used to set FEA Mesh file names.

//==== Add Pod Geometry ====//
string pid = AddGeom( "POD" );
 
//==== Set File Name ====//
SetComputationFileName( DEGEN_GEOM_CSV_TYPE, "TestDegenScript.csv" );
 
//==== Run Degen Geom ====//
ComputeDegenGeom( SET_ALL, DEGEN_GEOM_CSV_TYPE );
 
// The degenerate representation is reported through the Results Manager as
// well as written to file.  A Pod yields a surface, a plate and a stick.
if ( GetNumResults( "DegenGeom" ) != 1 )
{
    Print( "ERROR: ComputeDegenGeom produced no DegenGeom result" );
    __failure++;
}
 
if ( GetNumResults( "Degen_surf" ) < 1 || GetNumResults( "Degen_plate" ) < 1 || GetNumResults( "Degen_stick" ) < 1 )
{
    Print( "ERROR: ComputeDegenGeom did not produce the component results" );
    __failure++;
}

See also

COMPUTATION_FILE_TYPE, SetFeaMeshFileName

Parameters

[in]	file_type	int File type enum (i.e. CFD_TRI_TYPE, COMP_GEOM_TXT_TYPE)
[in]	file_name	string File name

Get the file name of a specified file type. Note, this function cannot be used to get FEA Mesh file names.

//==== Set File Name ====//
SetComputationFileName( DEGEN_GEOM_CSV_TYPE, "TestDegenScript.csv" );
 
if ( GetComputationFileName( DEGEN_GEOM_CSV_TYPE ) != "TestDegenScript.csv" )
{
    Print( "ERROR: GetComputationFileName did not report the name that was set" );
    __failure++;
}
 
// Each file type carries its own name.
SetComputationFileName( CFD_STL_TYPE, "TestCFDMesh.stl" );
 
if ( GetComputationFileName( CFD_STL_TYPE ) != "TestCFDMesh.stl" ||
     GetComputationFileName( DEGEN_GEOM_CSV_TYPE ) != "TestDegenScript.csv" )
{
    Print( "ERROR: setting one file name disturbed another" );
    __failure++;
}

See also

COMPUTATION_FILE_TYPE, SetComputationFileName, GetFeaMeshFileName

Parameters

[in]

file_type

int File type enum (i.e. CFD_TRI_TYPE, COMP_GEOM_TXT_TYPE)

Returns

string File name

Here is the call graph for this function:

Here is the caller graph for this function:

GetIntersectModeID()

std::string vsp::GetIntersectModeID ( )

extern

Get the mode Surface Intersection uses when its UseMode flag is on.

AddGeom( "POD" );
 
string mid = CreateAndAddMode( "Clean", SET_ALL, SET_NONE );
 
SetIntersectModeID( mid );
 
if ( GetIntersectModeID() != mid )
{
    Print( "ERROR: GetIntersectModeID did not return the mode set" );
    __failure++;
}

See also

SetIntersectModeID

Returns

string Mode ID, or an empty string for none

Here is the call graph for this function:

Here is the caller graph for this function:

GetNumCFDSources()

int vsp::GetNumCFDSources ( const std::string & geom_id )

extern

Delete all CFD Mesh sources for all Geoms

//==== Add Pod Geom ====//
string pid = AddGeom( "POD", "" );
 
AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );      // Add A Point Source
 
if ( GetNumCFDSources( pid ) != 1 )
{
    Print( "ERROR: the source was not added" );
    __failure++;
}
 
DeleteAllCFDSources();
 
if ( GetNumCFDSources( pid ) != 0 )
{
    Print( "ERROR: DeleteAllCFDSources left sources behind" );
    __failure++;
}

Get the number of CFD Mesh sources on the specified Geom

//==== Add Pod Geom ====//
string pid = AddGeom( "POD", "" );
 
if ( GetNumCFDSources( pid ) != 0 )
{
    Print( "ERROR: a new Geom starts with sources" );
    __failure++;
}
 
AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );      // Add A Point Source
 
if ( GetNumCFDSources( pid ) != 1 )
{
    Print( "ERROR: GetNumCFDSources did not count the source that was added" );
    __failure++;
}
 
AddDefaultSources(); // 3 Sources: Def_Fwd_PS, Def_Aft_PS, Def_Fwd_Aft_LS
 
if ( GetNumCFDSources( pid ) != 4 )
{
    Print( "ERROR: GetNumCFDSources did not count the default sources" );
    __failure++;
}
 
DeleteAllCFDSources();
 
if ( GetNumCFDSources( pid ) != 0 )
{
    Print( "ERROR: DeleteAllCFDSources left sources behind" );
    __failure++;
}

See also

AddCFDSource, AddDefaultSources, DeleteCFDSource, DeleteAllCFDSources

Parameters

[in]

geom_id

string Geom ID

Returns

int Number of CFD Mesh sources on the Geom

Here is the call graph for this function:

Here is the caller graph for this function:

SetCFDFarFieldGeomID()

void vsp::SetCFDFarFieldGeomID ( const std::string & geom_id )

extern

Set the Geom that stands in for the CFD Mesh far field box. Turning the far field on and choosing to use a component for it are separate settings; this one only names the component. Pass an empty string to clear it.

//==== Add Pod And A Sphere Around It ====//
string pid = AddGeom( "POD" );
string eid = AddGeom( "ELLIPSOID" );
 
SetParmVal( eid, "A_Radius", "Design", 12.0 );
 
SetCFDMeshVal( CFD_FAR_FIELD_FLAG, 1.0 );
SetParmVal( FindParm( FindContainer( "CFDMeshSettings", 0 ), "FarComp", "FarField" ), 1.0 );
 
SetCFDFarFieldGeomID( eid );
 
if ( GetCFDFarFieldGeomID() != eid )
{
    Print( "ERROR: SetCFDFarFieldGeomID did not name the Geom" );
    __failure++;
}
 
// An empty string puts the setting back the way it reads before a choice is made.
SetCFDFarFieldGeomID( "" );
 
if ( GetCFDFarFieldGeomID() != "" )
{
    Print( "ERROR: SetCFDFarFieldGeomID did not clear the choice" );
    __failure++;
}
 
// A Geom that does not exist has to be rejected.
SetCFDFarFieldGeomID( "NoSuchGeom" );
 
if ( GetNumTotalErrors() == 0 )
{
    Print( "ERROR: SetCFDFarFieldGeomID accepted a Geom that does not exist" );
    __failure++;
}
 
// That error was raised deliberately, so take it back off the queue.
while ( GetNumTotalErrors() > 0 )
{
    ErrorObj err = PopLastError();
}

See also

GetCFDFarFieldGeomID, SetCFDMeshVal

Parameters

[in]

geom_id

string Geom ID, or an empty string to clear

Here is the call graph for this function:

Here is the caller graph for this function:

SetCFDMeshModeID()

void vsp::SetCFDMeshModeID ( const std::string & mode_id )

extern

Set the mode CFD Mesh uses when its UseMode flag is on, or an empty string for none. The flag is the "UseMode" Parm, group "Global", of the "CFDMeshSettings" container.

AddGeom( "POD" );
 
string mid = CreateAndAddMode( "Clean", SET_ALL, SET_NONE );
 
SetCFDMeshModeID( mid );
 
if ( GetCFDMeshModeID() != mid )
{
    Print( "ERROR: SetCFDMeshModeID did not set the mode" );
    __failure++;
}

See also

GetCFDMeshModeID

Parameters

[in]

mode_id

string Mode ID, or an empty string

Here is the call graph for this function:

Here is the caller graph for this function:

SetCFDMeshVal()

void vsp::SetCFDMeshVal ( int type, double val )

extern

Set one of the CFD Mesh settings. The type is one of the CFD mesh setting enums, and the value is read as a double whatever the setting means.

SetCFDMeshVal( CFD_MIN_EDGE_LEN, 0.2 );
 
SetCFDMeshVal( CFD_MAX_EDGE_LEN, 1.0 );

See also

CFD_CONTROL_TYPE, ComputeCFDMesh

Parameters

[in]	type	int CFD mesh setting enum (i.e. CFD_MIN_EDGE_LEN)
[in]	val	double Value to set

Here is the call graph for this function:

Here is the caller graph for this function:

SetCFDSourceName()

void vsp::SetCFDSourceName ( const std::string & geom_id, int source_index, const std::string & name )

extern

Get the type of a CFD Mesh source on the specified Geom

//==== Add Pod Geom ====//
string pid = AddGeom( "POD", "" );
 
AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );      // Add A Point Source
 
if ( GetCFDSourceType( pid, 0 ) != POINT_SOURCE )
{
    Print( "ERROR: GetCFDSourceType did not report the type that was added" );
    __failure++;
}
 
// A source of a different type reports differently.
AddCFDSource( LINE_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5, 0.25, 2.0, 0.75, 0.75 );
 
if ( GetCFDSourceType( pid, 1 ) != LINE_SOURCE )
{
    Print( "ERROR: GetCFDSourceType did not report the second source" );
    __failure++;
}
 
// An index past the end has to be rejected.
GetCFDSourceType( pid, GetNumCFDSources( pid ) );
 
if ( GetNumTotalErrors() == 0 )
{
    Print( "ERROR: GetCFDSourceType accepted an index past the end" );
    __failure++;
}
 
// That error was raised deliberately, so take it back off the queue.
while ( GetNumTotalErrors() > 0 )
{
    ErrorObj err = PopLastError();
}

See also

CFD_MESH_SOURCE_TYPE, GetNumCFDSources, GetCFDSourceName

Parameters

[in]	geom_id	string Geom ID
[in]	source_index	int Source index

Returns

int CFD Mesh source type enum (i.e. POINT_SOURCE)

Set the name of a CFD Mesh source on the specified Geom

//==== Add Pod Geom ====//
string pid = AddGeom( "POD", "" );
 
AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );      // Add A Point Source
 
SetCFDSourceName( pid, 0, "ExampleSource" );
 
if ( GetCFDSourceName( pid, 0 ) != "ExampleSource" )
{
    Print( "ERROR: SetCFDSourceName did not take" );
    __failure++;
}
 
// An index past the end has to be rejected.
SetCFDSourceName( pid, GetNumCFDSources( pid ), "ExampleSource" );
 
if ( GetNumTotalErrors() == 0 )
{
    Print( "ERROR: SetCFDSourceName accepted an index past the end" );
    __failure++;
}
 
// That error was raised deliberately, so take it back off the queue.
while ( GetNumTotalErrors() > 0 )
{
    ErrorObj err = PopLastError();
}

See also

GetCFDSourceName, GetNumCFDSources, SetCFDSourceNameByID

Parameters

[in]	geom_id	string Geom ID
[in]	source_index	int Source index
[in]	name	string Source name

Here is the call graph for this function:

Here is the caller graph for this function:

SetCFDSourceNameByID()

void vsp::SetCFDSourceNameByID ( const std::string & source_id, const std::string & name )

extern

Set the name of a CFD Mesh source, by source ID.

string pid = AddGeom( "POD" );
 
string src_id = AddCFDSource( POINT_SOURCE, pid, 0, 0.25, 2.0, 0.5, 0.5 );
 
SetCFDSourceNameByID( src_id, "Nose" );
 
if ( GetCFDSourceName( pid, 0 ) != "Nose" )
{
    Print( "ERROR: SetCFDSourceNameByID did not name the source" );
    __failure++;
}

See also

GetCFDSourceName, SetCFDSourceName

Parameters

[in]	source_id	string CFD Mesh source ID
[in]	name	string New name for the source

Here is the call graph for this function:

Here is the caller graph for this function:

SetCFDWakeFlag()

void vsp::SetCFDWakeFlag ( const std::string & geom_id, bool flag )

extern

Say whether a Geom sheds a wake in CFD Mesh. This is the Wake check box on the CFD Mesh screen.

string wid = AddGeom( "WING" );
 
Update();
 
SetCFDWakeFlag( wid, true );
 
if ( GetParmVal( FindParm( wid, "Wake", "Shape" ) ) != 1.0 )    { Print( "ERROR: SetCFDWakeFlag" ); __failure++; }

See also

ComputeCFDMesh

Parameters

[in]	geom_id	string Geom ID
[in]	flag	bool True to shed a wake from this Geom

Here is the call graph for this function:

Here is the caller graph for this function:

SetComputationFileName()

void vsp::SetComputationFileName ( int file_type, const std::string & file_name )

extern

Set the file name a computation writes for one export type. The type is one of the computation file type enums, and each is remembered separately.

SetComputationFileName( CFD_STL_TYPE, "TestCFDMesh.stl" );
 
SetComputationFileName( CFD_TRI_TYPE, "TestCFDMesh.tri" );

See also

COMPUTATION_FILE_TYPE, ComputeCFDMesh

Parameters

[in]	file_type	int Computation file type enum (i.e. CFD_STL_TYPE)
[in]	file_name	string Name of the file to write

Here is the call graph for this function:

Here is the caller graph for this function:

SetIntersectModeID()

void vsp::SetIntersectModeID ( const std::string & mode_id )

extern

Set the mode Surface Intersection uses when its UseMode flag is on, or an empty string for none. The flag is the "UseMode" Parm, group "Global", of the "SurfaceIntersectSettings" container.

AddGeom( "POD" );
 
string mid = CreateAndAddMode( "Clean", SET_ALL, SET_NONE );
 
SetIntersectModeID( mid );
 
if ( GetIntersectModeID() != mid )
{
    Print( "ERROR: SetIntersectModeID did not set the mode" );
    __failure++;
}

See also

GetIntersectModeID

Parameters

[in]

mode_id

string Mode ID, or an empty string

Here is the call graph for this function:

Here is the caller graph for this function: