Parm Container Functions

All Parms in OpenVSP are stored in Parm Containers. The functions in this group can be used to work with Parm Containers through the API. Click here to return to the main page. More...

Functions
std::vector< std::string >	vsp::FindContainers ()
std::vector< std::string >	vsp::FindContainersWithName (const std::string &name)
std::string	vsp::FindContainer (const std::string &name, int index)
std::string	vsp::GetContainerName (const std::string &parm_container_id)
std::vector< std::string >	vsp::FindContainerGroupNames (const std::string &parm_container_id)
std::vector< std::string >	vsp::FindContainerParmIDs (const std::string &parm_container_id)
std::string	vsp::GetVehicleID ()
int	vsp::GetNumUserParms ()
int	vsp::GetNumPredefinedUserParms ()
std::vector< std::string >	vsp::GetAllUserParms ()
std::string	vsp::GetUserParmContainer ()
string	vsp::AddUserParm (int type, const string &name, const string &group)
void	vsp::DeleteUserParm (const std::string &id)
void	vsp::DeleteAllUserParm ()

Detailed Description

Function Documentation

AddUserParm()

string vsp::AddUserParm ( int type, const string & name, const string & group )

extern

Function to add a new user Parm of input type, name, and group

string length = AddUserParm( PARM_DOUBLE_TYPE, "Length", "Design" );
 
SetParmValLimits( length, 10.0, 0.001, 1.0e12 );
 
SetParmDescript( length, "Length user parameter" );

See also

PARM_TYPE

Parameters

[in]	type	int Parm type enum (i.e. PARM_DOUBLE_TYPE)
[in]	name	string Parm name
[in]	group	string Parm group

Returns

string Parm ID

DeleteAllUserParm()

void vsp::DeleteAllUserParm ( )

extern

Get the user parm container ID

DeleteAllUserParm();

DeleteUserParm()

void vsp::DeleteUserParm ( const std::string & id )

extern

Get the user parm container ID

int n = GetNumPredefinedUserParms();
array<string> @id_arr = GetAllUserParms();
 
if ( int( id_arr.size() ) > n )
{
    DeleteUserParm( id_arr[n] );
}

FindContainer()

std::string vsp::FindContainer ( const std::string & name, int index )

extern

Get the ID of a Parm Container with specified name at input index

//===== Get Vehicle Parm Container ID ====//
string veh_id = FindContainer( "Vehicle", 0 );

See also

FindContainersWithName

Parameters

[in]	name	string Parm Container name
[in]	index	int Parm Container index

Returns

string Parm Container ID

FindContainerGroupNames()

std::vector< std::string > vsp::FindContainerGroupNames ( const std::string & parm_container_id )

extern

Get an array of Parm group names included in the specified Container

string user_ctr = FindContainer( "UserParms", 0 );
 
array<string> @grp_arr = FindContainerGroupNames( user_ctr );
 
Print( "---> UserParms Container Group IDs: " );
for ( int i = 0; i < int( grp_arr.size() ); i++ )
{
    string message = "\t" + grp_arr[i] + "\n";
 
    Print( message );
}

Parameters

[in]

parm_container_id

string Parm Container ID

Returns

vector<string> Array of Parm group names

FindContainerParmIDs()

std::vector< std::string > vsp::FindContainerParmIDs ( const std::string & parm_container_id )

extern

Get an array of Parm IDs included in the specified Container

//==== Add Pod Geometry ====//
string pod_id = AddGeom( "POD" );
 
//==== Add FeaStructure to Pod ====//
int struct_ind = AddFeaStruct( pod_id );
 
//==== Get Structure Name and Parm Container ID ====//
string parm_container_name = GetFeaStructName( pod_id, struct_ind );
 
string parm_container_id = FindContainer( parm_container_name, struct_ind );
 
//==== Get and List All Parms in the Container ====//
array<string> parm_ids = FindContainerParmIDs( parm_container_id );
 
for ( uint i = 0; i < uint(parm_ids.length()); i++ )
{
    string name_id = GetParmName( parm_ids[i] ) + string(": ") + parm_ids[i] + string("\n");
 
    Print( name_id );
}

Parameters

[in]

parm_container_id

string Parm Container ID

Returns

vector<string> Array of Parm IDs

FindContainers()

std::vector< std::string > vsp::FindContainers ( )

extern

Get an array of all Parm Container IDs

array<string> @ctr_arr = FindContainers();
 
Print( "---> API Parm Container IDs: " );
 
for ( int i = 0; i < int( ctr_arr.size() ); i++ )
{
    string message = "\t" + ctr_arr[i] + "\n";
 
    Print( message );
}

Returns

vector<string> Array of Parm Container IDs

FindContainersWithName()

std::vector< std::string > vsp::FindContainersWithName ( const std::string & name )

extern

Get an array of Parm Container IDs for Containers with the specified name

array<string> @ctr_arr = FindContainersWithName( "UserParms" );
 
if ( ctr_arr.size() > 0 )            { Print( ( "UserParms Parm Container ID: " + ctr_arr[0] ) ); }

Parameters

[in]

name

string Parm Container name

Returns

vector<string> Array of Parm Container IDs

GetAllUserParms()

std::vector< std::string > vsp::GetAllUserParms ( )

extern

Get the vector of id's for all user parameters

array<string> @id_arr = GetAllUserParms();
 
Print( "---> User Parm IDs: " );
 
for ( int i = 0; i < int( id_arr.size() ); i++ )
{
    string message = "\t" + id_arr[i] + "\n";
 
    Print( message );
}

Returns

vector <string> Array of user parameter ids

GetContainerName()

std::string vsp::GetContainerName ( const std::string & parm_container_id )

extern

Get the name of the specified Parm Container

string veh_id = FindContainer( "Vehicle", 0 );
 
if ( GetContainerName( veh_id ) != "Vehicle" )         { Print( "---> Error: API GetContainerName" ); }

Parameters

[in]

parm_container_id

string Parm Container ID

Returns

string Parm Container name

GetNumPredefinedUserParms()

int vsp::GetNumPredefinedUserParms ( )

extern

Get the number of pre-defined user parameters

int n = GetNumPredefinedUserParms();

Returns

int Number of pre-defined user Parms

GetNumUserParms()

int vsp::GetNumUserParms ( )

extern

Get the number of user parameters

int n = GetNumUserParms();

Returns

int Number of user Parms

GetUserParmContainer()

std::string vsp::GetUserParmContainer ( )

extern

Get the user parm container ID

string up_id = GetUserParmContainer();

Returns

string User parm container ID

GetVehicleID()

std::string vsp::GetVehicleID ( )

extern

Get the ID of the Vehicle Parm Container

//===== Get Vehicle Parm Container ID ====//
string veh_id = GetVehicleID();

Returns

string Vehicle ID