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
	)

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	Parm type enum (i.e. PARM_DOUBLE_TYPE)
[in]	name	Parm name
[in]	group	Parm group

Returns

Parm ID

DeleteAllUserParm()

void vsp::DeleteAllUserParm

(

)

Get the user parm container ID

DeleteAllUserParm();

DeleteUserParm()

void vsp::DeleteUserParm

(

const std::string &

id

)

Get the user parm container ID

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

FindContainer()

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

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	Parm Container name
[in]	index	Parm Container index

Returns

Parm Container ID

FindContainerGroupNames()

std::vector<std::string> vsp::FindContainerGroupNames

(

const std::string &

parm_container_id

)

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

Parm Container ID

Returns

Array of Parm group names

FindContainerParmIDs()

std::vector<std::string> vsp::FindContainerParmIDs

(

const std::string &

parm_container_id

)

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

Parm Container ID

Returns

Array of Parm IDs

FindContainers()

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

(

)

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

Array of Parm Container IDs

FindContainersWithName()

std::vector<std::string> vsp::FindContainersWithName

(

const std::string &

name

)

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

Parm Container name

Returns

Array of Parm Container IDs

GetAllUserParms()

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

(

)

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

Array of user parameter ids

GetContainerName()

std::string vsp::GetContainerName

(

const std::string &

parm_container_id

)

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

Parm Container ID

Returns

Parm Container name

GetNumPredefinedUserParms()

int vsp::GetNumPredefinedUserParms

(

)

Get the number of pre-defined user parameters

int n = GetNumPredefinedUserParms();

Returns

Number of pre-defined user Parms

GetNumUserParms()

int vsp::GetNumUserParms

(

)

Get the number of user parameters

int n = GetNumUserParms();

Returns

Number of user Parms

GetUserParmContainer()

std::string vsp::GetUserParmContainer

(

)

Get the user parm container ID

string up_id = GetUserParmContainer();

Returns

User parm container ID

GetVehicleID()

std::string vsp::GetVehicleID

(

)

Get the ID of the Vehicle Parm Container

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

Returns

Vehicle ID