OpenVSP API Documentation 3.50.0
Loading...
Searching...
No Matches
Functions
Results Manager Functions

This group is for functions included in the Results Manager. The Results Manager stores analysis results and provides methods to get, print, and export them. Click here to return to the main page. More...

Functions

std::vector< std::string > vsp::GetAllResultsNames ()
std::vector< std::string > vsp::GetAllDataNames (const std::string &results_id)
int vsp::GetNumResults (const std::string &name)
std::string vsp::GetResultsName (const std::string &results_id)
std::string vsp::GetResultsSetDoc (const std::string &results_id)
std::string vsp::FindResultsID (const std::string &name, int index=0)
std::string vsp::FindLatestResultsID (const std::string &name)
int vsp::GetNumData (const std::string &results_id, const std::string &data_name)
int vsp::GetResultsType (const std::string &results_id, const std::string &data_name)
const std::vector< int > & vsp::GetIntResults (const std::string &id, const std::string &name, int index=0)
const std::vector< double > & vsp::GetDoubleResults (const std::string &id, const std::string &name, int index=0)
const std::vector< std::vector< double > > & vsp::GetDoubleMatResults (const std::string &id, const std::string &name, int index=0)
const std::vector< std::string > & vsp::GetStringResults (const std::string &id, const std::string &name, int index=0)
const std::vector< vec3d > & vsp::GetVec3dResults (const std::string &id, const std::string &name, int index=0)
std::string vsp::CreateGeomResults (const std::string &geom_id, const std::string &name)
void vsp::DeleteAllResults ()
void vsp::DeleteResult (const std::string &id)
void vsp::WriteResultsCSVFile (const std::string &id, const std::string &file_name)
void vsp::PrintResults (const std::string &results_id)
void vsp::PrintResultsDocs (const std::string &results_id)
void vsp::WriteTestResults ()

Detailed Description

Function Documentation

◆ CreateGeomResults()

std::string vsp::CreateGeomResults ( const std::string & geom_id,
const std::string & name )
extern

Create a new result for a Geom

//==== Test Comp Geom ====//
string gid1 = AddGeom( "POD", "" );
string mesh_id = ComputeCompGeom( 0, false, 0 );
//==== Test Comp Geom Mesh Results ====//
string mesh_geom_res_id = CreateGeomResults( mesh_id, "Comp_Mesh" );
array<int> @int_arr = GetIntResults( mesh_geom_res_id, "Num_Tris" );
if ( int_arr[0] < 4 ) { Print( "---> Error: API CreateGeomResults" ); }
vsp::ComputeCompGeom
std::string ComputeCompGeom(int set, bool half_mesh, int file_export_types)
vsp::AddGeom
std::string AddGeom(const std::string &type, const std::string &parent=std::string())
vsp::GetIntResults
const std::vector< int > & GetIntResults(const std::string &id, const std::string &name, int index=0)
vsp::CreateGeomResults
std::string CreateGeomResults(const std::string &geom_id, const std::string &name)
Parameters
[in]geom_idstring Geom ID
[in]namestring Result name
Returns
string Result ID

◆ DeleteAllResults()

void vsp::DeleteAllResults ( )
extern

Delete all results

//==== Test Comp Geom ====//
string gid1 = AddGeom( "POD", "" );
string mesh_id = ComputeCompGeom( 0, false, 0 );
//==== Test Comp Geom Mesh Results ====//
string mesh_geom_res_id = CreateGeomResults( mesh_id, "Comp_Mesh" );
DeleteAllResults();
if ( GetNumResults( "Comp_Mesh" ) != 0 ) { Print( "---> Error: API DeleteAllResults" ); }
vsp::GetNumResults
int GetNumResults(const std::string &name)
vsp::DeleteAllResults
void DeleteAllResults()

◆ DeleteResult()

void vsp::DeleteResult ( const std::string & id)
extern

Delete a particular result

//==== Test Comp Geom ====//
string gid1 = AddGeom( "POD", "" );
string mesh_id = ComputeCompGeom( 0, false, 0 );
//==== Test Comp Geom Mesh Results ====//
string mesh_geom_res_id = CreateGeomResults( mesh_id, "Comp_Mesh" );
DeleteResult( mesh_geom_res_id );
if ( GetNumResults( "Comp_Mesh" ) != 0 ) { Print( "---> Error: API DeleteResult" ); }
vsp::DeleteResult
void DeleteResult(const std::string &id)
Parameters
[in]idstring Result ID

◆ FindLatestResultsID()

std::string vsp::FindLatestResultsID ( const std::string & name)
extern

Find the latest results ID for particular result name

//==== Write Some Fake Test Results =====//
WriteTestResults();
array< string > @results_array = GetAllResultsNames();
for ( int i = 0; i < int( results_array.size() ); i++ )
{
string resid = FindLatestResultsID( results_array[i] );
PrintResults( resid );
}
vsp::PrintResults
void PrintResults(const std::string &results_id)
vsp::GetAllResultsNames
std::vector< std::string > GetAllResultsNames()
vsp::FindLatestResultsID
std::string FindLatestResultsID(const std::string &name)
vsp::WriteTestResults
void WriteTestResults()
Parameters
[in]namestring Result name
Returns
string Result ID

◆ FindResultsID()

std::string vsp::FindResultsID ( const std::string & name,
int index = 0 )
extern

Find a results ID given its name and index

//==== Write Some Fake Test Results =====//
WriteTestResults();
string res_id = FindResultsID( "Test_Results" );
if ( res_id.size() == 0 ) { Print( "---> Error: API FindResultsID" ); }
vsp::FindResultsID
std::string FindResultsID(const std::string &name, int index=0)
Parameters
[in]namestring Result name
[in]indexint Result index
Returns
string Result ID

◆ GetAllDataNames()

std::vector< std::string > vsp::GetAllDataNames ( const std::string & results_id)
extern

Get all data names for a particular result

//==== Write Some Fake Test Results =====//
WriteTestResults();
string res_id = FindResultsID( "Test_Results" );
array< string > @data_names = GetAllDataNames( res_id );
if ( data_names.size() != 5 ) { Print( "---> Error: API GetAllDataNames" ); }
vsp::GetAllDataNames
std::vector< std::string > GetAllDataNames(const std::string &results_id)
Parameters
[in]results_idstring Result ID
Returns
vector<string> Array of result names

◆ GetAllResultsNames()

std::vector< std::string > vsp::GetAllResultsNames ( )
extern

Get the name of all results in the Results Manager

//==== Write Some Fake Test Results =====//
WriteTestResults();
array< string > @results_array = GetAllResultsNames();
for ( int i = 0; i < int( results_array.size() ); i++ )
{
string resid = FindLatestResultsID( results_array[i] );
PrintResults( resid );
}
Returns
vector<string> Array of result names

◆ GetDoubleMatResults()

const std::vector< std::vector< double > > & vsp::GetDoubleMatResults ( const std::string & id,
const std::string & name,
int index = 0 )
extern

Get all matrix (vector<vector<double>>) values for a particular result, name, and index

Parameters
[in]idstring Result ID
[in]namestring Data name
[in]indexint Data index
Returns
vector<vector<double>> 2D array of data values

◆ GetDoubleResults()

const std::vector< double > & vsp::GetDoubleResults ( const std::string & id,
const std::string & name,
int index = 0 )
extern

Get all double values for a particular result, name, and index

//==== Add Pod Geom ====//
string pid = AddGeom( "POD", "" );
//==== Run CompGeom And View Results ====//
string mesh_id = ComputeCompGeom( SET_ALL, false, 0 ); // Half Mesh false and no file export
string comp_res_id = FindLatestResultsID( "Comp_Geom" ); // Find Results ID
array<double> @double_arr = GetDoubleResults( comp_res_id, "Wet_Area" ); // Extract Results
vsp::SET_ALL
@ SET_ALL
Definition APIDefines.h:1419
vsp::GetDoubleResults
const std::vector< double > & GetDoubleResults(const std::string &id, const std::string &name, int index=0)
Parameters
[in]idstring Result ID
[in]namestring Data name
[in]indexint Data index
Returns
vector<double> Array of data values

◆ GetIntResults()

const std::vector< int > & vsp::GetIntResults ( const std::string & id,
const std::string & name,
int index = 0 )
extern

Get all integer values for a particular result, name, and index

//==== Write Some Fake Test Results =====//
WriteTestResults();
string res_id = FindResultsID( "Test_Results" );
if ( GetNumData( res_id, "Test_Int" ) != 2 ) { Print( "---> Error: API GetNumData " ); }
array<int> @int_arr = GetIntResults( res_id, "Test_Int", 0 );
if ( int_arr[0] != 1 ) { Print( "---> Error: API GetIntResults" ); }
int_arr = GetIntResults( res_id, "Test_Int", 1 );
if ( int_arr[0] != 2 ) { Print( "---> Error: API GetIntResults" ); }
vsp::GetNumData
int GetNumData(const std::string &results_id, const std::string &data_name)
Parameters
[in]idstring Result ID
[in]namestring Data name
[in]indexint Data index
Returns
vector<int> Array of data values

◆ GetNumData()

int vsp::GetNumData ( const std::string & results_id,
const std::string & data_name )
extern

Get the number of data values for a given result ID and data name

//==== Write Some Fake Test Results =====//
WriteTestResults();
string res_id = FindResultsID( "Test_Results" );
if ( GetNumData( res_id, "Test_Int" ) != 2 ) { Print( "---> Error: API GetNumData " ); }
array<int> @int_arr = GetIntResults( res_id, "Test_Int", 0 );
if ( int_arr[0] != 1 ) { Print( "---> Error: API GetIntResults" ); }
int_arr = GetIntResults( res_id, "Test_Int", 1 );
if ( int_arr[0] != 2 ) { Print( "---> Error: API GetIntResults" ); }
Parameters
[in]results_idstring Result ID
[in]data_namestring Data name
Returns
int Number of data values

◆ GetNumResults()

int vsp::GetNumResults ( const std::string & name)
extern

Get the number of results for a particular result name

//==== Write Some Fake Test Results =====//
WriteTestResults();
if ( GetNumResults( "Test_Results" ) != 2 ) { Print( "---> Error: API GetNumResults" ); }
Parameters
[in]namestring Input name
Returns
int Number of results

◆ GetResultsName()

std::string vsp::GetResultsName ( const std::string & results_id)
extern

Get the name of a result given its ID

//==== Analysis: VSPAero Compute Geometry ====//
string analysis_name = "VSPAEROComputeGeometry";
// Set defaults
SetAnalysisInputDefaults( analysis_name );
string res_id = ( ExecAnalysis( analysis_name ) );
Print( "Results Name: ", false );
Print( GetResultsName( res_id ) );
vsp::ExecAnalysis
std::string ExecAnalysis(const std::string &analysis)
vsp::SetAnalysisInputDefaults
void SetAnalysisInputDefaults(const std::string &analysis)
vsp::GetResultsName
std::string GetResultsName(const std::string &results_id)
Parameters
[in]results_idstring Result ID
Returns
string Result name

◆ GetResultsSetDoc()

std::string vsp::GetResultsSetDoc ( const std::string & results_id)
extern

Get the documentation string for a result given its ID

//==== Analysis: VSPAero Compute Geometry ====//
string analysis_name = "VSPAEROComputeGeometry";
// Set defaults
SetAnalysisInputDefaults( analysis_name );
string res_id = ( ExecAnalysis( analysis_name ) );
Print( "Results doc: ", false );
Print( GetResultsSetDoc( res_id ) );
vsp::GetResultsSetDoc
std::string GetResultsSetDoc(const std::string &results_id)
Parameters
[in]results_idstring Result ID
Returns
string Result documentation string

◆ GetResultsType()

int vsp::GetResultsType ( const std::string & results_id,
const std::string & data_name )
extern

Get the data type for a given result ID and data name

//==== Write Some Fake Test Results =====//
WriteTestResults();
string res_id = FindResultsID( "Test_Results" );
array < string > @ res_array = GetAllDataNames( res_id );
for ( int j = 0; j < int( res_array.size() ); j++ )
{
int typ = GetResultsType( res_id, res_array[j] );
}
vsp::GetResultsType
int GetResultsType(const std::string &results_id, const std::string &data_name)
See also
RES_DATA_TYPE
Parameters
[in]results_idstring Result ID
[in]data_namestring Data name
Returns
int Data type enum (i.e. DOUBLE_DATA)

◆ GetStringResults()

const std::vector< std::string > & vsp::GetStringResults ( const std::string & id,
const std::string & name,
int index = 0 )
extern

Get all string values for a particular result, name, and index

//==== Write Some Fake Test Results =====//
WriteTestResults();
string res_id = FindResultsID( "Test_Results" );
array<string> @str_arr = GetStringResults( res_id, "Test_String" );
if ( str_arr[0] != "This Is A Test" ) { Print( "---> Error: API GetStringResults" ); }
vsp::GetStringResults
const std::vector< std::string > & GetStringResults(const std::string &id, const std::string &name, int index=0)
Parameters
[in]idstring Result ID
[in]namestring Data name
[in]indexint Data index
Returns
vector<string> Array of data values

◆ GetVec3dResults()

const std::vector< vec3d > & vsp::GetVec3dResults ( const std::string & id,
const std::string & name,
int index = 0 )
extern

Get all vec3d values for a particular result, name, and index

//==== Write Some Fake Test Results =====//
double tol = 0.00001;
WriteTestResults();
string res_id = FindLatestResultsID( "Test_Results" );
array<vec3d> @vec3d_vec = GetVec3dResults( res_id, "Test_Vec3d" );
Print( "X: ", false );
Print( vec3d_vec[0].x(), false );
Print( "\tY: ", false );
Print( vec3d_vec[0].y(), false );
Print( "\tZ: ", false );
Print( vec3d_vec[0].z() );
vsp::GetVec3dResults
const std::vector< vec3d > & GetVec3dResults(const std::string &id, const std::string &name, int index=0)
Parameters
[in]idstring Result ID
[in]namestring Data name
[in]indexint Data index
Returns
vector<vec3d> Array of data values

◆ PrintResults()

void vsp::PrintResults ( const std::string & results_id)
extern

Print a result's name value pairs to stdout

// Add Pod Geom
string pid = AddGeom( "POD" );
string analysis_name = "VSPAEROComputeGeometry";
string rid = ExecAnalysis( analysis_name );
// Get & Display Results
PrintResults( rid );
Parameters
[in]results_idstring Result ID

◆ PrintResultsDocs()

void vsp::PrintResultsDocs ( const std::string & results_id)
extern

Print a result's names and documentation to stdout

// Add Pod Geom
string pid = AddGeom( "POD" );
string analysis_name = "VSPAEROComputeGeometry";
string rid = ExecAnalysis( analysis_name );
// Get & Display Results Docs
PrintResultsDoc( rid );
Parameters
[in]results_idstring Result ID

◆ WriteResultsCSVFile()

void vsp::WriteResultsCSVFile ( const std::string & id,
const std::string & file_name )
extern

Export a result to CSV

// Add Pod Geom
string pid = AddGeom( "POD" );
string analysis_name = "VSPAEROComputeGeometry";
string rid = ExecAnalysis( analysis_name );
WriteResultsCSVFile( rid, "CompGeomRes.csv" );
vsp::WriteResultsCSVFile
void WriteResultsCSVFile(const std::string &id, const std::string &file_name)
Parameters
[in]idstring Rsult ID
[in]file_namestring CSV output file name

◆ WriteTestResults()

void vsp::WriteTestResults ( )
extern

Generate some example results for testing.

//==== Write Some Fake Test Results =====//
WriteTestResults();
array< string > @results_array = GetAllResultsNames();
for ( int i = 0; i < int( results_array.size() ); i++ )
{
string resid = FindLatestResultsID( results_array[i] );
PrintResults( resid );
}
Generated on for OpenVSP API Documentation by doxygen 1.16.1