PCL Reference Manual > FlightLoads Functions > Modeling Utilities
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
Modeling Utilities
This section explains the functions that are used in defining the Flight Loads model and maintaining it and its environment.
   
flds_calc_fringe_value
( threshold, swtch_val, dbox1_val, dbox2_val, grp_name, min_val, max_val, table_id )
Description:
 
 
This function calculates the fringe value for each QUAD in the current group.
Input:
 
 
REAL
threshold
The comparison value to indicate element has failed. Threshold is a lower limit.
STRING
swtch_val
The value of the switch that determines which equation is to be used in calculating the Boxes/Wavelength. (“Dimensional (v and f)” or “Nondimensional (c and k)”)
REAL
dbox1_val
The Minimum Velocity or the Reference Length depending on what the value of swtch_val is set to
REAL
dbox2_val
The Maximum Cyclic Frequency or the Maximum Reduced Frequency depending on what the value of swtch_val is set to
Output:
 
 
STRING
grp_name
Current group label
REAL
min_val
Minimum fringe factor for QUADS tested
REAL
max_val
Maximum fringe factor for QUADS tested
INTEGER
table_id
ID of scalar element fringe results table
INTEGER
<Return Value>
0 = Success; otherwise a problem was encountered
Remarks:
None.
Example:
None.
  
flds_delete_element
( element_name, delete_geom )
Description:
 
 
This function deletes the Aero element and all its associated entities. This action includes the deletion of the property set and the associated group containing the nodes and boxes/beams, geometries, and removes the nodes and boxes/beams. If specified by the user, the surface/curve and the points used to create the Aero element are also deleted. Moreover, the Splines, Control Devices and Fields are deleted if their respective application regions are emptied due to the Aero element deletion.
Input:
 
 
STRING
element_name
This value specifies the name of the element to be deleted.
LOGICAL
delete_geom
TRUE if the associated geometries are to be deleted; FALSE otherwise.
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
 
This is only a partial list of the error values that can be returned by this function.
1
This is am internal status condition. There is no corresponding status message in the message database.
-1
This is am internal status condition. There is no corresponding status message in the message database.
Remarks:
None.
Example:
None.
    
flds_gnrl_cntrl_cre
( device_name, units_label, super_group_name )
Description:
 
 
This function creates the General Contols control device
Input:
 
 
STRING
device_name
Name of the General Controller
STRING
units_label
Units label for the General Controller
STRING
super_group_name
Name of the current SuperGroup
Output:
 
 
INTEGER
<Return Value>
0 = Success; otherwise there is a problem
Remarks:
None.
Example:
None. 
  
flds_gnrl_cntrl_mod
( device_name, units_label, super_group_name )
Description:
 
 
This function modifies the specified General Controls control device.
Input:
 
 
STRING
device_name
Name of the General Controller
STRING
units_label
Units label for the General Controller
STRING
super_group_name
Name of the current SuperGroup
Output:
 
 
INTEGER
<Return Value>
0 = Success; otherwise there is a problem
Remarks:
None.
Example:
None.
  
flds_lbc_delete
( num_names, name_array )
Description:
 
 
This function deletes the Aero LBC from the database.
Input:
 
 
INTEGER
num_names
This value specifies the number of selected LBCs.
STRING
name_array()
This value specifies the array of selected LBC names to be deleted.
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
 
-1
This is am internal status condition. There is no corresponding status message in the message database.
Remarks:
None.
Example:
None.
   
flds_mod_mng_sup_grp_cre
( sg_name, sg_type, num_sel_grps, sel_gnames, mk_cur_flag )
Description:
 
 
This function checks the validity of the entered SuperGroup Name, to create it, to associate the appropriate Aero Groups to it, and to make it current if need be.
Input:
 
 
STRING
sg_name
This value specifies the name of the SuperGroup to create.
STRING
sg_type
This value specifies the type of the SuperGroup. (FLAT_PLATE or THREED)
INTEGER
num_sel_grps
This value specifies the number of Aero Groups selected.
STRING
sel_gnames()
This value specifies the array listing the selected Aero Group Names.
LOGICAL
mk_cur_flag
TRUE if the SuperGroup is to be made current; FALSE otherwise.
Output:
 
 
None.
 
 
Remarks:
None.
Example:
None.
   
flds_mod_mng_sup_grp_cur
( sg_type, sg_name )
Description:
 
 
This function makes the selected SuperGroup current.
Input:
 
 
STRING
sg_type
This value specifies the type of the SuperGroup to make current. (FLAT_PLATE or THREED)
STRING
sg_name
This value specifies the name of the SuperGroup to make current.
Output:
 
 
None.
 
 
 
Remarks:
None.
Example:
None.
   
flds_mod_mng_sup_grp_del
( sg_type, num_sel_sgrps, sg_names )
Description:
 
 
This function deletes the list of given SuperGroup names.
Input:
 
 
STRING
sg_type
This value specifies the type of the SuperGroup to delete. (FLAT_PLATE or THREED)
INTEGER
num_sel_sgrps
This value specifies the number of SuperGroups selected.
STRING
sg_names()
This value specifies the array listing the selected SuperGroup Names.
Output:
 
 
None.
 
 
Remarks:
None.
Example:
None.
  
flds_mod_mng_sup_grp_mod
( sg_name, new_sg_name, sg_type, num_sel_grps, sel_gnames )
Description:
 
 
This function checks the validity of the entered SuperGroup Name, modifies the selected SuperGroup and reassociates the appropriate Aero Groups to it.
Input:
 
 
STRING
sg_name
This value specifies the name of the SuperGroup to modify.
STRING
new_sg_name
This value specifies the new name of the SuperGroup to be used if different than sg_name.
STRING
sg_type
This value specifies the type of the SuperGroup. (FLAT_PLATE or THREED)
INTEGER
num_sel_grps
This value specifies the number of Aero Groups selected.
STRING
sel_gnames()
This value specifies the array listing the selected Aero Group Names.
Output:
 
 
None.
 
 
Remarks:
None.
Example:
None.
   
flds_mod_mng_sup_grp_rbld
( num_entities, entity_names, num_aero_grps, aero_grps, crnt_sgrp_name )
Description:
 
 
This function rebuilds all the Aero Groups and the SuperGroups.
Input:
 
 
INTEGER
num_entities
This value specifies the number of selected Lifting Surface/Body names.
STRING
entity_names()
This value specifies the array listing the selected Lifting Surface/Body names.
INTEGER
num_aero_grps
This value specifies the number of existing Aero Groups.
STRING
aero_grps()
This value specifies the array listing the Aero Group Names.
STRING
crnt_sgrp_name
This value specifies the name of the current SuperGroup to which the selected Lifting Surface/Body names are to be assigned. This value is left blank if they are not to be assigned to the current SuperGroup.
Output:
 
 
None.
 
 
Remarks:
None.
Example:
None.
 
flds_monitor_pts_cre
( aero_or_struct, monitor_name, monitor_pt_label, num_box, box_id_array, coord_label, monitor_comp )
Description:
 
 
This function creates the monitor points.
Input:
 
 
INTEGER
aero_or_struct
1 = Aero; 2 = Structural
STRING
monitor_name
Name of the monitor point
STRING
monitor_pt_label
Monitor point label
INTEGER
num_box
Number of box id’s specified in box_id_array
INTEGER
box_id_array()
The array of areodynamic boxes/elements making up the nonlinear control surface component
INTEGER
coord_label
The label of the rectangular coordinate system
INTEGER
monitor_comp(6)
The monitor components
Output:
 
 
INTEGER
<Return Value>
0 = Success; otherwise there is a problem
Remarks:
None.
Example:
None.
 
flds_monitor_pts_get
( monitor_name, monitor_pt_label, num_elem, app_reg_ent, coordinate_id, monitor_comp )
Description:
 
 
This function gets the data for the specified Monitor Point.
Input:
 
 
STRING
monitor_name
Name of the monitor point to get
Output:
 
 
STRING
monitor_pt_label
The monitor point label
INTEGER
num_elem
The number of boxes/elements in the application region
INTEGER
app_reg_ent()
The array of box/element ids making up the nonlinear control surface component
INTEGER
coordinate_id
The label of the rectangular coordinate system
INTEGER
monitor_comp(6)
The monitor components
INTEGER
<Return Value>
0 = Success; otherwise there is a problem
Remarks:
None.
Example:
None.
.
flds_monitor_pts_mod
( aero_or_struct, monitor_name, monitor_pt_label, num_box, box_id_array, coord_label, monitor_comp )
Description:
 
 
This function modifies the specified monitor point.
Input:
 
 
INTEGER
aero_or_struct
1 = Aero; 2 = Structural
STRING
monitor_name
Name of the monitor point to modify
STRING
monitor_pt_label
Monitor point label
INTEGER
num_box
Number of box id’s specified in box_id_array
INTEGER
box_id_array()
The array of areodynamic boxes/elements making up the nonlinear control surface component
INTEGER
coord_label
The label of the rectangular coordinate system
INTEGER
monitor_comp(6)
The monitor components
Output:
 
 
INTEGER
<Return Value>
0 = Success; otherwise there is a problem
Remarks:
None.
Example:
None.
 
flds_nonlnr_cntrl_srf_cre
( device_name, coord_label, num_box, box_id_array, effectiveness, ref_chord_len, ref_area, upper_def_limit, lower_def_limit, is_up_mom_defined, upper_mom_limit, is_lo_mom_defined, lower_mom_limit, up_def_limit_field, low_def_limit_field, cntrl_param_unit, super_group_name )
Description:
 
 
This function creates the Nonlinear Control Surface control device.
Input:
 
 
STRING
device_name
This value specifies the name of the Nonlinear Control Surface.
INTEGER
coord_label
This value specifies the label of the rectangular coordinate with y-axis defining the hinge line of the control surface component.
INTEGER
num_box
This value specifies the number of box id’s specified in the box_id_array.
INTEGER
box_id_array()
This value specifies the array of aerodynamic boxes/elements making up the control surface component.
REAL
effectiveness
This value specifies the Control Device effectiveness.
REAL
ref_chord_len
This value specifies the reference chord length.
REAL
ref_area
This value specifies the reference area for the Control Device.
REAL
upper_def_limit
This value specifies the upper deflection limit (Radians).
REAL
lower_def_limit
This value specifies the lower deflection limit (Radians).
LOGICAL
is_up_mom_defined
TRUE: if the upper moment is defined; FALSE otherwise.
REAL
upper_mom_limit
This value specifies the upper hinge moment limit.
LOGICAL
is_lo_mom_defined
TRUE: if the lower moment is defined; FALSE otherwise.
REAL
lower_mom_limit
This value specifies the lower hinge moment limit.
STRING
up_def_limit_field
This value specifies the Field name containing the upper deflection limits vs. Dynamic pressure. If up_def_limit_field="" then upper_def_limit value will be used.
STRING
low_def_limit_field
This value specifies the Field name containing the lower deflection limits vs. Dynamic Pressure. If low_def_limit_field="" then lower_def_limit value will be used.
STRING
cntrl_param_unit
“Degrees” or “Rads”
STRING
super_group_name
Current SuperGroup name
Output:
 
 
INTEGER
<Return Value>
0 = Success; otherwise there is a problem
Remarks:
None.
Example:
None.
 
flds_nonlnr_cntrl_srf_mod
( device_name, new_dev_name, coord_label, num_box, box_id_array, effectiveness, ref_chord_len, ref_area, upper_def_limit, lower_def_limit, is_up_mom_defined, upper_mom_limit, is_lo_mom_defined, lower_mom_limit, up_def_limit_field, low_def_limit_field, cntrl_param_unit, super_group_name )
Description:
 
 
This function modifies the specified Nonlinear Control Surface control device.
Input:
 
 
STRING
device_name
This value specifies the old name of the Nonlinear Control Surface.
STRING
new_dev_name
This value specifies the new name of the Nonlinear Control Surface.
INTEGER
coord_label
This value specifies the label of the rectangular coordinate with y-axis defining the hinge line of the control surface component.
INTEGER
num_box
This value specifies the number of box id’s specified in the box_id_array.
INTEGER
box_id_array()
This value specifies the array of aerodynamic boxes/elements making up the control surface component.
REAL
effectiveness
This value specifies the Control Device effectiveness.
REAL
ref_chord_len
This value specifies the reference chord length.
REAL
ref_area
This value specifies the reference area for the Control Device.
REAL
upper_def_limit
This value specifies the upper deflection limit (Radians).
REAL
lower_def_limit
This value specifies the lower deflection limit (Radians).
LOGICAL
is_up_mom_defined
TRUE: if the upper moment is defined; FALSE otherwise.
REAL
upper_mom_limit
This value specifies the upper hinge moment limit.
LOGICAL
is_lo_mom_defined
TRUE: if the lower moment is defined; FALSE otherwise.
REAL
lower_mom_limit
This value specifies the lower hinge moment limit.
STRING
up_def_limit_field
This value specifies the Field name containing the upper deflection limits vs. Dynamic pressure. If up_def_limit_field="" then upper_def_limit value will be used.
STRING
low_def_limit_field
This value specifies the Field name containing the lower deflection limits vs. Dynamic Pressure. If low_def_limit_field="" then lower_def_limit value will be used.
STRING
cntrl_param_unit
“Degrees” or “Rads”
STRING
super_group_name
Current SuperGroup name
Output:
 
 
INTEGER
<Return Value>
0 = Success; otherwise there is a problem
Remarks:
None.
Example:
None.
 
flds_rigid_bdy_mot_cntrl_cre
( rbm_type, rbm_status, super_group_name )
Description:
 
 
This function creates the Rigid Body Motion control device.
Input:
 
 
STRING
rbm_type
“ANGLEA”, “SIDES”, “ROLL”, “PITCH”, or “YAW”
STRING
rbm_status
“Linear”, “Nonlinear”, or “Do Not Create”
STRING
super_group_name
Name of the current SuperGroup. This is the SuperGroup the rigid body motion will be associated with.
Output:
 
 
INTEGER
<Return Value>
0 = Success; otherwise there is a problem
Remarks:
None.
Example:
None.
 
flds_rigid_bdy_mot_cntrl_mod
( rbm_type, rbm_status, super_group_name )
Description:
 
 
This function modifies the specified Rigid Body Motion control device.
Input:
 
 
STRING
rbm_type
“ANGLEA”, “SIDES”, “ROLL”, “PITCH”, or “YAW”
STRING
rbm_status
“Linear”, “Nonlinear”, or “Do Not Create”
STRING
super_group_name
Name of the current SuperGroup. This is the SuperGroup the rigid body motion will be associated with.
Output:
 
 
INTEGER
<Return Value>
0 = Success; otherwise there is a problem
Remarks:
None.
Example:
None.
 
flds_rigid_body_mod_cntrl_get
( rbm_type, super_group_name, rbm_status )
Description:
 
 
This function gets the status of the specified Rigid Body Motion in the specified SuperGroup.
Input:
 
 
STRING
rbm_type
Name of the specified Rigid Body Motion (“ANGLEA”, “SIDES”, “ROLL”, “PITCH”, or “YAW”)
STRING
super_group_name
Name of the current SuperGroup
Output:
 
 
STRING
rbm_status
“Linear”, “Nonlinear”, or “Do Not Create”
INTEGER
<Return Value>
0 = Success; otherwise there is a problem
Remarks:
None.
Example:
None.
   
flat_plate_body_create
( body_name, body_orient, xyz1, x12, starting_elem_id, interference_id, coordinate_id, num_slender, slender_array, num_interf, interf_array, half_width_array, interf_half_width, interf_aspect_ratio, num_interf_theta, interf_theta_array, keep_geom, exist_curve_name, aero_coord_id )
Description:
 
 
This function creates the flat plate Aero body given the information available on a CAERO2 card, and the coordinates of the point X1 and the body length.
Input:
 
 
STRING
body_name
This value specifies the user defined name of the body.
STRING
body_orient
This value specifies the orientation. (Z_BODY, Y_BODY, ZY_BODY)
REAL
xyz1
This value specifies the coordinates of the X1 point.
REAL
x12
This value specifies the length of the body.
INTEGER
starting_elem_id
This value specifies the starting element ID.
INTEGER
interference_id
This value specifies the interference group ID.
INTEGER
coordinate_id
This value specifies the reference coordinate ID.
INTEGER
num_slender
This value specifies the number of seeds for slender body.
REAL
slender_array
This value specifies the seed array for slender body.
INTEGER
num_interf
This value specifies the number of seeds for interference body.
REAL
interf_array
This value specifies the seed array for interference body.
REAL
half_width_array
This value specifies the slender body half width distribution.
REAL
interf_half_width
This value specifies the interference body half width value.
REAL
interf_aspect_ratio
This value specifies the interference body aspect ratio.
INTEGER
num_interf_theta
This value specifies the number of interference body theta values.
REAL
interf_theta_array
This value specifies the interference body theta distribution.
LOGICAL
keep_geom
TRUE if the curve/points are to be kept; FALSE otherwise.
STRING
exist_curve_name
This value specifies the name of an existing curve("" if not used).
INTEGER
aero_coord_id
This value specifies the label of the Aero coordinate system.
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate an error.
Error Conditions:
 
This is only a partial list of the error values that can be returned by this function.
6026016
The group already exists in the database.
1
This is am internal status condition. There is no corresponding status message in the message database.
Remarks:
None.
Example:
None.
   
flat_plate_body_modify
( body_name, starting_elem_id, interf_group_id, coordinate_id, num_slender, slender_mesh, num_interf, interf_mesh, slender_half_width, num_theta, interf_body_theta, interf_half_width, interf_aspect_ratio, new_body_name, aero_coord_id )
Description:
 
 
This function modifies the specified flat plate body with the updated property/mesh values. The group is updated with the new elements and nodes if necessary.
Input:
 
 
STRING
body_name
This value specifies the user defined name of the body.
INTEGER
starting_elem_id
This value specifies the starting element ID.
INTEGER
interf_group_id
This value specifies the interference group ID.
INTEGER
coordinate_id
This value specifies the reference coordinate system ID for X1.
INTEGER
num_slender
This value specifies the number of slender mesh seeds.
REAL
slender_mesh()
This value specifies the array of mesh seed distribution for the slender body.
INTEGER
num_interf
This value specifies the number of interference mesh seeds.
REAL
interf_mesh()
This value specifies the array of mesh seed distribution for the interference body.
REAL
slender_half_width()
This value specifies the array of slender body half width distribution.
INTEGER
num_theta
This value specifies the number of theta values.
REAL
interf_body_theta()
This value specifies the array of interference body theta distribution.
REAL
interf_half_width
This value specifies the interference body half width value.
REAL
interf_aspect_ratio
This value specifies the interference body aspect ratio.
STRING
new_body_name
This value specifies the new name of the body.
INTEGER
aero_coord_id
This value specifies the ID of the Aero Coordinate System.
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate an error.
Error Conditions:
 
This is only a partial list of the error values that can be returned by this function.
1
This is am internal status condition. There is no corresponding status message in the message database.
Remarks:
None.
Example:
None.
   
flat_plate_cntrl_dev_create
( device_name, device_type, coord_label, num_box, box_id_array, effectiveness, ref_chord_len, ref_area, upper_def_limit, lower_def_limit, is_up_mom_defined, upper_mom_limit, is_lo_mom_defined, lower_mom_limit, up_def_limit_field, low_def_limit_field )
Description:
 
 
This function creates a Linear Control Surface control device given the information available on an AESURF/AELIST cards.
Input:
 
 
STRING
device_name
This value specifies the name of the Control Device.
INTEGER
device_type
This value specifies the type. (1=SURFACE, 2=GIMBLE, 3=THRUST, 4=GENERAL)
INTEGER
coord_label
This value specifies the label of the rectangular coordinate with y-axis defining the hinge line of the control surface component.
INTEGER
num_box
This value specifies the number of box id’s specified in the box_id_array.
INTEGER
box_id_array()
This value specifies the array of aerodynamic boxes/elements making up the control surface component.
REAL
effectiveness
This value specifies the Control Device effectiveness.
REAL
ref_chord_len
This value specifies the reference chord length.
REAL
ref_area
This value specifies the reference area for the Control Device.
REAL
upper_def_limit
This value specifies the upper deflection limit (Radians).
REAL
lower_def_limit
This value specifies the lower deflection limit (Radians).
LOGICAL
is_up_mom_defined
TRUE: if the upper moment is defined; FALSE otherwise.
REAL
upper_mom_limit
This value specifies the upper hinge moment limit.
LOGICAL
is_lo_mom_defined
TRUE: if the lower moment is defined; FALSE otherwise.
REAL
lower_mom_limit
This value specifies the lower hinge moment limit.
STRING
up_def_limit_field
This value specifies the Field name containing the upper deflection limits vs. Dynamic pressure. If up_def_limit_field="" then upper_def_limit value will be used.
STRING
low_def_limit_field
This value specifies the Field name containing the lower deflection limits vs. Dynamic Pressure. If low_def_limit_field="" then lower_def_limit value will be used.
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate an error.
Error Conditions:
 
This is only a partial list of the error values that can be returned by this function.
1
This is am internal status condition. There is no corresponding status message in the message database.
Remarks:
None.
Example:
None.
   
flat_plate_cntrl_dev_modify
( device_name, new_device_name, device_type, coord_label, num_box, box_id_array, effectiveness, ref_chord_len, ref_area, upper_def_limit, lower_def_limit, is_up_mom_defined, upper_mom_limit, is_lo_mom_defined, lower_mom_limit, up_def_limit_field, low_def_limit_field )
Description:
 
 
This function modifies the specified Linear Control Surface.
Input:
 
 
STRING
device_name
This value specifies the name of the Control Device.
STRING
new_device_name
This value specifies the new name of the Control Device.
INTEGER
device_type
This value specifies the type. (1=SURFACE, 2=GIMBLE, 3=THRUST, 4=GENERAL)
INTEGER
coord_label
This value specifies the label of the rectangular coordinate with y-axis defining the hinge line of the control surface component.
INTEGER
num_box
This value specifies the number of box id’s specified in the box_id_array.
INTEGER
box_id_array()
This value specifies the array of aerodynamic boxes/elements making up the control surface component.
REAL
effectiveness
This value specifies the Control Device effectiveness.
REAL
ref_chord_len
This value specifies the reference chord length.
REAL
ref_area
This value specifies the reference area for the Control Device.
REAL
upper_def_limit
This value specifies the upper deflection limit (Radians).
REAL
lower_def_limit
This value specifies the lower deflection limit (Radians).
LOGICAL
is_up_mom_defined
TRUE: if the upper moment is defined; FALSE otherwise.
REAL
upper_mom_limit
This value specifies the upper hinge moment limit.
LOGICAL
is_lo_mom_defined
TRUE: if the lower moment is defined; FALSE otherwise.
REAL
lower_mom_limit
This value specifies the lower hinge moment limit.
STRING
up_def_limit_field
This value specifies the Field name containing the upper deflection limits vs. Dynamic pressure. If up_def_limit_field="" then upper_def_limit value will be used.
STRING
low_def_limit_field
This value specifies the Field name containing the lower deflection limits vs. Dynamic Pressure. If low_def_limit_field="" then lower_def_limit value will be used.
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate an error.
Error Conditions:
 
This is only a partial list of the error values that can be returned by this function.
1
This is am internal status condition. There is no corresponding status message in the message database.
Remarks:
None.
Example:
None.
   
flat_plate_surf_create
( surf_name, xyz1, xyz4, x12, x43, starting_elem_id, interference_id, coordinate_id, body_flag, num_bodies, body_name_array, num_span, num_chord, span_array, chord_array, keep_geom, exist_surf_name, aero_coord_id, auto_connect)
Description:
 
 
This function creates the flat plate surface given the information available on a CAERO card, and the coordinates of the points X1, X4, and the chord lengths X12 and X43.
Input:
 
 
STRING
surf_name
This value specifies the user defined name of the surface.
REAL
xyz1()
This value specifies the coordinates of Point 1 in coordinate_id frame.
REAL
xyz4()
This value specifies the coordinates of Point 4 in coordinate_id frame.
REAL
x12
This value specifies the X12 edge chord length in the Aerodynamic coordinate system.
REAL
x43
This value specifies the X43 edge chord length in the Aerodynamic coordinate system.
INTEGER
starting_elem_id
This value specifies the starting element ID
INTEGER
interference_id
This value specifies the interference ID.
INTEGER
coordinate_id
This value specifies the reference coordinate system ID for X1 and X4.
STRING
body_flag
This value specifies the body flag. ("None", "All", "All IGID", "Select")
INTEGER
num_bodies
This value specifies the number of bodies.
STRING
body_name_array()
This value specifies the array of body names. (Only used if the body_flag is "Select")
INTEGER
num_span
This value specifies the number of seeds in span direction.
INTEGER
num_chord
This value specifies the number of seeds in chord direction.
REAL
span_array()
This value specifies the seed array in the span direction.
REAL
chord_array()
This value specifies the seed array in the chord direction.
LOGICAL
keep_geom
TRUE: if the surface/points are to be kept; FALSE otherwise.
STRING
exist_surf_name
This value specifies the name of an existing surface ("" if not used)
INTEGER
aero_coord_id
This value specifies the Aero coordinate system id.
LOGICAL
auto_connect
TRUE if the surface connectivity is to be automatically reset such that Y4 >= Y1. Where Y1 is the Y coordinate of Point 1 in the Aero coordinate system, Y4 is the Y coordinate of Point 4 in the Aero coordinate system following the right hand rule. FALSE if the user defined connection is to be used.
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate an error.
Error Conditions:
 
This is only a partial list of the error values that can be returned by this function.
6026016
The group already exists in the database.
1
This is am internal status condition. There is no corresponding status message in the message database.
Remarks:
None.
Example:
None.
   
flat_plate_surf_modify
( surf_name, starting_elem_id, interference_id, coordinate_id, body_flag, num_bodies, body_name_array, num_span, span_array, num_chord, chord_array, new_surf_name, aero_coord_id )
Description:
 
 
This function modifies the specified flat plate surface with the updated property/mesh values. The group is updated with the new elements and nodes if necessary.
Input:
 
 
STRING
surf_name
This value specifies the user defined name of the surface.
INTEGER
starting_elem_id
This value specifies the starting element ID
INTEGER
interference_id
This value specifies the interference ID.
INTEGER
coordinate_id
This value specifies the reference coordinate system ID for X1 and X4.
STRING
body_flag
This value specifies the body flag. ("None", "All", "All IGID", "Select")
INTEGER
num_bodies
This value specifies the number of bodies.
STRING
body_name_array()
This value specifies the array of body names. (Only used if the body_flag is "Select")
INTEGER
num_span
This value specifies the number of seeds in span direction.
REAL
span_array()
This value specifies the seed array in the span direction.
INTEGER
num_chord
This value specifies the number of seeds in chord direction.
REAL
chord_array()
This value specifies the seed array in the chord direction.
STRING
new_surf_name
This value specifies the new name of the surface.
INTEGER
aero_coord_id
This value specifies the Aero coordinate system id.
Output:
 
 
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate an error.
Error Conditions:
 
This is only a partial list of the error values that can be returned by this function.
1
This is am internal status condition. There is no corresponding status message in the message database.
 
 
 
Remarks:
None.
Example:
None.