This group of functions is available for adding, deleting, and modifying OpenVSP Geoms through the API.

Click here to return to the main page. More...

Functions
string []	GetGeomTypes ()

string	AddGeom (const string &in type, const string &in parent=string())

void	UpdateGeom (const string &in geom_id)

void	DeleteGeom (const string &in geom_id)

void	DeleteGeomVec (string[]@ del_arr)

void	CutGeomToClipboard (const string &in geom_id)

void	CopyGeomToClipboard (const string &in geom_id)

string []	PasteGeomClipboard (const string &in parent_id="")

string []	FindGeoms ()

string []	FindGeomsWithName (const string &in name)

string	FindGeom (const string &in name, int index)

void	SetGeomName (const string &in geom_id, const string &in name)

string	GetGeomName (const string &in geom_id)

string []	GetGeomParmIDs (const string &in geom_id)

int	GetGeomVSPSurfCfdType (const string &in geom_id, int main_surf_ind=0)

int	GetGeomVSPSurfType (const string &in geom_id, int main_surf_ind=0)

string	GetGeomTypeName (const string &in geom_id)

int	GetNumMainSurfs (const string &in geom_id)

int	GetTotalNumSurfs (const string &in geom_id)

vec3d	GetGeomBBoxMax (const string &in geom_id, int main_surf_ind=0, bool ref_frame_is_absolute=true)

vec3d	GetGeomBBoxMin (const string &in geom_id, int main_surf_ind=0, bool ref_frame_is_absolute=true)

string	GetGeomParent (const string &in geom_id)

string []	GetGeomChildren (const string &in geom_id)

Detailed Description

Function Documentation

◆ AddGeom()

string AddGeom	(	const string &in	type,
		const string &in	parent = `string()`
	)

Add a new Geom of given type as a child of the specified parent. If no parent or an invalid parent is given, the Geom is placed at the top level

//==== Add Wing Geometry ====//

string wing_id = AddGeom( "WING" );

Parameters

[in]	type	Geom type (i.e FUSELAGE, POD, etc.)
[in]	parent	Parent Geom ID

Returns: Geom ID

◆ CopyGeomToClipboard()

void CopyGeomToClipboard ( const string &in geom_id )

Copy Geom from current location and store on clipboard

//==== Add Pod Geometries ====//
string pid1 = AddGeom( "POD", "" );
string pid2 = AddGeom( "POD", "" );
CopyGeomToClipboard( pid1 );
PasteGeomClipboard( pid2 ); // Paste Pod 1 as child of Pod 2
geom_ids = FindGeoms();
if ( geom_ids.size() != 3 )                { Print( "---> Error: API Copy/Paste Geom  " ); }

See also: PasteGeomClipboard

Parameters

[in] geom_id Geom ID

◆ CutGeomToClipboard()

void CutGeomToClipboard ( const string &in geom_id )

Cut Geom from current location and store on clipboad

//==== Add Pod Geometries ====//
string pid1 = AddGeom( "POD", "" );
string pid2 = AddGeom( "POD", "" );
CopyGeomToClipboard( pid1 );
PasteGeomClipboard( pid2 ); // Paste Pod 1 as child of Pod 2
geom_ids = FindGeoms();
if ( geom_ids.size() != 2 )                { Print( "---> Error: API Cut/Paste Geom  " ); }

See also: PasteGeomClipboard

Parameters

[in] geom_id Geom ID

◆ DeleteGeom()

void DeleteGeom ( const string &in geom_id )

Delete a particular Geom

//==== Add Wing Geometry ====//
string wing_id = AddGeom( "WING" );
//==== Add Pod Geometry ====//
string pod_id = AddGeom( "POD" );
DeleteGeom( wing_id );

Parameters

[in] geom_id Geom ID

◆ DeleteGeomVec()

void DeleteGeomVec ( string@ [] del_arr )

Delete multiple Geoms

//==== Add Pod Geometry ====//
string pid = AddGeom( "POD", "" );
string rid = ExecAnalysis( "CompGeom" );
array<string>@ mesh_id_vec = GetStringResults( rid, "Mesh_GeomID" );
DeleteGeomVec( mesh_id_vec );

Parameters

[in] del_arr Array of Geom IDs

◆ FindGeom()

string FindGeom	(	const string &in	name,
		int	index
	)

Find and return the Geom ID with the specified name at given index. Equivalent to FindGeomsWithName( name )[index].

//==== Add Pod Geometry ====//
string pid = AddGeom( "POD", "" );
SetGeomName( pid, "ExamplePodName" );
geom_id = FindGeom( "ExamplePodName", 0 );
geom_ids = FindGeomsWithName( "ExamplePodName" );
if ( geom_ids[0] != geom_id )
{
    Print( "---> Error: API FindGeom & FindGeomsWithName" );
}

See also: FindGeomsWithName

Parameters

[in]	name	Geom name
[in]	index

Returns: Geom ID with name at specified index

◆ FindGeoms()

string [] FindGeoms ( )

Find and return all Geom IDs in the model

//==== Add Pod Geometries ====//
string pod1 = AddGeom( "POD", "" );
string pod2 = AddGeom( "POD", "" );
//==== There Should Be Two Geoms =====//
array< string > @geom_ids = FindGeoms();
if ( geom_ids.size() != 2 )                        { Print( "---> Error: API FindGeoms " ); }

Returns: Array of all Geom IDs

◆ FindGeomsWithName()

string [] FindGeomsWithName ( const string &in name )

Find and return all Geom IDs with the specified name

//==== Add Pod Geometry ====//
string pid = AddGeom( "POD", "" );
SetGeomName( pid, "ExamplePodName" );
geom_ids = FindGeomsWithName( "ExamplePodName" );
if ( geom_ids.size() != 1 )
{
    Print( "---> Error: API FindGeomsWithName " );
}

See also: FindGeom

Parameters

[in] name Geom name

Returns: Array of Geom IDs

◆ GetGeomBBoxMax()

vec3d GetGeomBBoxMax	(	const string &in	geom_id,
		int	main_surf_ind = `0`,
		bool	ref_frame_is_absolute = `true`
	)

Get the the maximum coordinate of the bounding box of a Geom with given main surface index. The Geom bounding box may be specified in absolute or body reference frame.

//==== Add Pod Geometry ====//
string pid = AddGeom( "Pod" );
SetParmVal( FindParm( pid, "Y_Rotation", "XForm" ), 45 );
SetParmVal( FindParm( pid, "Z_Rotation", "XForm" ), 25 );
Update();
vec3d max_pnt = GetGeomBBoxMax( pid, 0, false );

See also: GetGeomBBoxMin

Parameters

[in]	geom_id	Geom ID
[in]	main_surf_ind	Main surface index
[in]	ref_frame_is_absolute	Flag to specify absolute or body reference frame

Returns: Maximum coordinate of the bounding box

◆ GetGeomBBoxMin()

vec3d GetGeomBBoxMin	(	const string &in	geom_id,
		int	main_surf_ind = `0`,
		bool	ref_frame_is_absolute = `true`
	)

Get the the minimum coordinate of the bounding box of a Geom with given main surface index. The Geom bounding box may be specified in absolute or body reference frame.

//==== Add Pod Geometry ====//
string pid = AddGeom( "Pod" );
SetParmVal( FindParm( pid, "Y_Rotation", "XForm" ), 45 );
SetParmVal( FindParm( pid, "Z_Rotation", "XForm" ), 25 );
Update();
vec3d min_pnt = GetGeomBBoxMin( pid, 0, false );

See also: GetGeomBBoxMax

Parameters

[in]	geom_id	Geom ID
[in]	main_surf_ind	Main surface index
[in]	ref_frame_is_absolute	Flag to specify absolute or body reference frame

Returns: Minimum coordinate of the bounding box

◆ GetGeomChildren()

string [] GetGeomChildren ( const string &in geom_id )

Get the IDs for each child of the input parent Geom.

//==== Add Parent and Child Geometry ====//
string pod1 = AddGeom( "POD" );
string pod2 = AddGeom( "POD", pod1 );
string pod3 = AddGeom( "POD", pod2 );
Print( "Children of Pod #1: " );
array<string> @children = GetGeomChildren( pod1 );
for ( int 1 = 0; i < children.size(); i++ )
{
    Print( "\t", false );
    Print( children[i] );
}

Parameters

[in] geom_id Geom ID

Returns: Array of child Geom IDs

◆ GetGeomName()

string GetGeomName ( const string &in geom_id )

Get the name of a specific Geom

//==== Add Pod Geometry ====//
string pid = AddGeom( "POD", "" );
SetGeomName( pid, "ExamplePodName" );
string name_str = "Geom Name: " + GetGeomName( pid );
Print( name_str );

Parameters

[in] geom_id Geom ID

Returns: Geom name

◆ GetGeomParent()

string GetGeomParent ( const string &in geom_id )

Get the parent Geom ID for the input child Geom. "NONE" is returned if the Geom has no parent.

//==== Add Parent and Child Geometry ====//
string pod1 = AddGeom( "POD" );
string pod2 = AddGeom( "POD", pod1 );
Print( "Parent ID of Pod #2: ", false );
Print( GetGeomParent( pod2 ) );

Parameters

[in] geom_id Geom ID

Returns: Parent Geom ID

◆ GetGeomParmIDs()

string [] GetGeomParmIDs ( const string &in geom_id )

Get all Parm IDs associated with this Geom Parm container

//==== Add Pod Geometry ====//
string pid = AddGeom( "POD", "" );
Print( string( "---> Test Get Parm Arrays" ) );
array< string > @parm_array = GetGeomParmIDs( pid );
if ( parm_array.size() < 1 )            { Print( "---> Error: API GetGeomParmIDs " ); }

Parameters

[in] geom_id Geom ID

Returns: Array of Parm IDs

◆ GetGeomTypeName()

string GetGeomTypeName ( const string &in geom_id )

Get the type name of specified Geom (i.e. FUSELAGE)

//==== Add Wing Geometry ====//
string wing_id = AddGeom( "WING" );
Print( "Geom Type Name: ", false );
Print( GetGeomTypeName( wing_id ) );

Parameters

[in] geom_id Geom ID

Returns: Geom type name

◆ GetGeomTypes()

string [] GetGeomTypes ( )

Get an array of all Geom types (i.e FUSELAGE, POD, etc.)

    //==== Add Pod Geometries ====//
string pod1 = AddGeom( "POD", "" );
string pod2 = AddGeom( "POD", "" );
array< string > @type_array = GetGeomTypes();
if ( type_array[0] != "POD" )                { Print( "---> Error: API GetGeomTypes  " ); }

Returns: Array of Geom type names

◆ GetGeomVSPSurfCfdType()

int GetGeomVSPSurfCfdType	(	const string &in	geom_id,
		int	main_surf_ind = `0`
	)

Get the VSP surface CFD type of the specified Geom

//==== Add Wing Geometry ====//
string wing_id = AddGeom( "WING" );
if ( GetGeomVSPSurfCfdType( wing_id ) != CFD_NORMAL )
{
    Print( "---> Error: API GetGeomVSPSurfCfdType " );
}

See also: VSP_SURF_CFD_TYPE

Parameters

[in]	geom_id	Geom ID
[in]	main_surf_ind	Main surface index

Returns: VSP surface CFD type enum (i.e. CFD_TRANSPARENT)

◆ GetGeomVSPSurfType()

int GetGeomVSPSurfType	(	const string &in	geom_id,
		int	main_surf_ind = `0`
	)

Get the VSP surface type of the specified Geom

//==== Add Wing Geometry ====//
string wing_id = AddGeom( "WING" );
if ( GetGeomVSPSurfType( wing_id ) != WING_SURF )
{
    Print( "---> Error: API GetGeomVSPSurfType " );
}

See also: VSP_SURF_TYPE

Parameters

[in]	geom_id	Geom ID
[in]	main_surf_ind	Main surface index

Returns: VSP surface type enum (i.e. DISK_SURF)

◆ GetNumMainSurfs()

int GetNumMainSurfs ( const string &in geom_id )

Get the number of main surfaces for the specified Geom. Multiple main surfaces may exist for CustoGeoms, propellors, etc., but does not include surfaces created due to symmetry.

//==== Add Prop Geometry ====//
string prop_id = AddGeom( "PROP" );
int num_surf = GetNumMainSurfs( prop_id ); // Should be the same as the number of blades
Print( "Number of Propeller Surfaces: ", false );
Print( num_surf );

Parameters

[in] geom_id Geom ID

Returns: Number of main surfaces

◆ GetTotalNumSurfs()

int GetTotalNumSurfs ( const string &in geom_id )

Get the total number of surfaces for the specified Geom. This is equivalent to the number of main surface multiplied by the number of symmetric copies.

//==== Add Wing Geometry ====//
string wing_id = AddGeom( "WING" );
int num_surf = GetNumMaGetTotalNumSurfsinSurfs( wing_id ); // Wings default with XZ symmetry on -> 2 surfaces
Print( "Total Number of Wing Surfaces: ", false );
Print( num_surf );

Parameters

[in] geom_id Geom ID

Returns: Number of main surfaces

◆ PasteGeomClipboard()

string [] PasteGeomClipboard ( const string &in parent_id = "" )

Paste Geom from clipboard into the model. The Geom is pasted as a child of the specified parent, but will be placed at top level if no parent or an invalid one is provided.

//==== Add Pod Geometries ====//
string pid1 = AddGeom( "POD", "" );
string pid2 = AddGeom( "POD", "" );
CutGeomToClipboard( pid1 );
PasteGeomClipboard( pid2 ); // Paste Pod 1 as child of Pod 2
geom_ids = FindGeoms();
if ( geom_ids.size() != 2 )                { Print( "---> Error: API Cut/Paste Geom  " ); }

Parameters

[in] parent_id Parent Geom ID

Returns: Array of pasted Geom IDs

◆ SetGeomName()

void SetGeomName	(	const string &in	geom_id,
		const string &in	name
	)

Set the name of the specified Geom

//==== Add Pod Geometry ====//
string pid = AddGeom( "POD", "" );
SetGeomName( pid, "ExamplePodName" );
geom_ids = FindGeomsWithName( "ExamplePodName" );
if ( geom_ids.size() != 1 )
{
    Print( "---> Error: API FindGeomsWithName " );
}

Parameters

[in]	geom_id	Geom ID
[in]	name	Geom name

◆ UpdateGeom()

void UpdateGeom ( const string &in geom_id )

Perform an update for the specified Geom

//==== Add Wing Geometry ====//
string wing_id = AddGeom( "WING" );
//==== Add Pod Geometry ====//
string pod_id = AddGeom( "POD" );
SetParmVal( pod_id, "X_Rel_Location", "XForm", 5.0 );
UpdateGeom( pod_id ); // Faster than updating the whole vehicle

See also: Update()

Parameters

[in] geom_id Geom ID

Functions

Detailed Description

Function Documentation

◆ AddGeom()

◆ CopyGeomToClipboard()

◆ CutGeomToClipboard()

◆ DeleteGeom()

◆ DeleteGeomVec()

◆ FindGeom()

◆ FindGeoms()

◆ FindGeomsWithName()

◆ GetGeomBBoxMax()

◆ GetGeomBBoxMin()

◆ GetGeomChildren()

◆ GetGeomName()

◆ GetGeomParent()

◆ GetGeomParmIDs()

◆ GetGeomTypeName()

◆ GetGeomTypes()

◆ GetGeomVSPSurfCfdType()

◆ GetGeomVSPSurfType()

◆ GetNumMainSurfs()

◆ GetTotalNumSurfs()

◆ PasteGeomClipboard()

◆ SetGeomName()

◆ UpdateGeom()