General Computation Functions

The following group of API functions are available for general computations. In general, it is best practice to perform computations through the the Analysis group instead of calling these functions directly. Click here to return to the main page. More...

Functions
std::string	vsp::ComputeMassProps (int set, int num_slices, int idir)
std::string	vsp::ComputeCompGeom (int set, bool half_mesh, int file_export_types)
std::string	vsp::ComputePlaneSlice (int set, int num_slices, const vec3d &norm, bool auto_bnd, double start_bnd=0, double end_bnd=0, bool measureduct=false)
void	vsp::ComputeDegenGeom (int set, int file_export_types)
double	vsp::IntegrateEllipsoidFlow (const vec3d &abc_rad, const int &abc_index)

Detailed Description

Function Documentation

ComputeCompGeom()

std::string vsp::ComputeCompGeom ( int set, bool half_mesh, int file_export_types )

extern

Mesh, intersect, and trim components in the set. Alternatively can be run through the Analysis Manager with 'CompGeom'.

//==== Add Pod Geom ====//
string pid = AddGeom( "POD", "" );
 
//==== Run CompGeom And Get Results ====//
string mesh_id = ComputeCompGeom( SET_ALL, false, 0 );                      // Half Mesh false and no file export
if ( mesh_id.length() == 0 )
{
    Print( "ERROR: ComputeCompGeom returned no id" );
    __failure++;
}
 
 
string comp_res_id = FindLatestResultsID( "Comp_Geom" );                    // Find Results ID
 
array<double> @double_arr = GetDoubleResults( comp_res_id, "Wet_Area" );    // Extract Results

See also

SetAnalysisInputDefaults, PrintAnalysisInputs, ExecAnalysis, COMPUTATION_FILE_TYPE

Parameters

[in]	set	int Set index (i.e. SET_ALL)
[in]	half_mesh	bool Flag to ignore surfaces on the negative side of the XZ plane (e.g. symmetry)
[in]	file_export_types	int CompGeom file type to export (supports XOR i.e. COMP_GEOM_CSV_TYPE & COMP_GEOM_TXT_TYPE )

Returns

string MeshGeom ID

Here is the call graph for this function:

Here is the caller graph for this function:

ComputeDegenGeom()

void vsp::ComputeDegenGeom ( int set, int file_export_types )

extern

Compute the degenerate geometry representation for the components in the set. Alternatively can be run through the Analysis Manager with 'DegenGeom' or 'VSPAERODegenGeom'.

//==== 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

SetAnalysisInputDefaults, PrintAnalysisInputs, ExecAnalysis, COMPUTATION_FILE_TYPE

Parameters

[in]	set	int Set index (i.e. SET_ALL)
[in]	file_export_types	int DegenGeom file type to export (supports XOR i.e DEGEN_GEOM_M_TYPE & DEGEN_GEOM_CSV_TYPE)

Here is the call graph for this function:

Here is the caller graph for this function:

ComputeMassProps()

std::string vsp::ComputeMassProps ( int set, int num_slices, int idir )

extern

Compute mass properties for the components in the set. Alternatively can be run through the Analysis Manager with 'MassProp'.

//==== Test Mass Props ====//
string pid = AddGeom( "POD", "" );
 
string mesh_id = ComputeMassProps( SET_ALL, 20, X_DIR );
 
string mass_res_id = FindLatestResultsID( "Mass_Properties" );
 
array<double> @double_arr = GetDoubleResults( mass_res_id, "Total_Mass" );
 
if ( double_arr.size() != 1 )                                    { Print( "---> Error: API ComputeMassProps" ); __failure++; }

See also

SetAnalysisInputDefaults, PrintAnalysisInputs, ExecAnalysis

Parameters

[in]	set	int Set index (i.e. SET_ALL)
[in]	num_slices	int Number of slices
[in]	idir	int Direction of slicing for integration

Returns

string MeshGeom ID

Here is the call graph for this function:

Here is the caller graph for this function:

ComputePlaneSlice()

std::string vsp::ComputePlaneSlice ( int set, int num_slices, const vec3d & norm, bool auto_bnd, double start_bnd = 0, double end_bnd = 0, bool measureduct = false )

extern

Slice and mesh the components in the set. Alternatively can be run through the Analysis Manager with 'PlanarSlice'.

//==== Add Pod Geom ====//
string pid = AddGeom( "POD", "" );
 
//==== Test Plane Slice ====//
string slice_mesh_id = ComputePlaneSlice( 0, 6, vec3d( 0.0, 0.0, 1.0 ), true );
 
string pslice_results = FindLatestResultsID( "Slice" );
 
array<double> @double_arr = GetDoubleResults( pslice_results, "Slice_Area" );
 
if ( double_arr.size() != 6 )                                    { Print( "---> Error: API ComputePlaneSlice" ); __failure++; }

See also

SetAnalysisInputDefaults, PrintAnalysisInputs, ExecAnalysis

Parameters

[in]	set	int Set index (i.e. SET_ALL)
[in]	num_slices	int Number of slices
[in]	norm	vec3d Normal axis for all slices
[in]	auto_bnd	bool Flag to automatically set the start and end bound locations
[in]	start_bnd	double Location of the first slice along the normal axis (default: 0.0)
[in]	end_bnd	double Location of the last slice along the normal axis (default: 0.0)
[in]	measureduct	bool Flag to measure negative area inside positive area (default: false)

Returns

string MeshGeom ID

Here is the call graph for this function:

Here is the caller graph for this function:

IntegrateEllipsoidFlow()

double vsp::IntegrateEllipsoidFlow ( const vec3d & abc_rad, const int & abc_index )

extern

Integrate the analytic potential flow solution over an ellipsoid. Used to check a panel or surface solution against a case with a known answer.

double val = IntegrateEllipsoidFlow( vec3d( 1.0, 2.0, 3.0 ), 0 );
 
if ( val == 0.0 )                                    { Print( "ERROR: IntegrateEllipsoidFlow" ); __failure++; }

See also

GetEllipsoidSurfPnts

Parameters

[in]	abc_rad	vec3d Semi-axis lengths of the ellipsoid
[in]	abc_index	int Index of the axis the flow is along, 0, 1 or 2

Returns

double Integrated value

Here is the call graph for this function:

Here is the caller graph for this function: