Public PCL Functions

Laminate Modeler > Using MSC.Laminate Modeler > Public PCL Functions

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">

These functions correspond to user interface forms in the usual way. They can be used by running a session file, or calling them directly from other PCL functions. In either case, it is important that the PCL library <laminate_modeler.plb> is available to the session, and the executable <layup> is in the path


p3cm.new	( <filename> )


Input:
STRING	<filename>	Name of the new Layup file.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Begins a MSC.Laminate Modeler session using a new Layup file with the name <filename>.


p3cm.open	( <filename> )


Input:
STRING	<filename>	Name of the existing Layup file.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Begins a MSC.Laminate Modeler session by opening an existing Layup file with the name <filename>.


p3cm.save_as	( <filename> )


Input:
STRING	<filename>	Name of the target Layup file.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Saves a copy of the current Layup file with the name <filename>.


p3cm.create_material_add	( <type_name>, <material_name>, <analysis_material_name>, <thickness>, <max_strain>, <warp_weft_angle> )


Input:
STRING	<type-name>	Application type.
STRING	<material_name>	Material name.
STRING	<analysis_material_name>	Analysis material name.
REAL	<thickness>	Initial thickness of the ply material.
REAL	<max_strain>	Maximum permissible strain of the ply material.
REAL	<warp_weft_angle>	Initial angle between warp and weft fibres.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Creates a new material


p3cm.create_ply_add	( <type_name>, <material_name>, <ply_name>, <start_pt>, <appliqueing>, <ref_dirn>, <ref_ang>, <warp_weft_angle>, <max_strain>, <step_length>, <axis_type>, <max_sweeps>, <bounds>, <area_str>, <split_str> )


Input:
STRING	<type_name>	Application type.
STRING	<material_name>	Ply material name.
STRING	<ply_name>	Ply name.
REAL ARRAY	<start_pt>	Coordinates of starting point.
REAL ARRAY	<appliqueing>	Vector defining application direction.
REAL ARRAY	<ref_dirn>	Vector defining the reference direction.
REAL	<ref_ang>	Reference angle.
REAL	<warp_weft_angle>	Initial angle between warp and weft fibres.
REAL	<max_strain>	Maximum permissible strain of the ply material.
REAL	<step_length>	Step length.
INTEGER	<axis_type>	Axis type.
INTEGER	<max_sweeps>	Maximum number of sweeps.
REAL ARRAY	<bounds>	Maximum fabric bounds.
STRING	<area_str>	Selected area.
STRING	<split_str>	Split definition.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Creates a new ply.


p3cm.create_layup_add	(<num_plies>, <ply_names>, <type_names>, <instances>, <sides>, <offsets>, < num_offs>, <off_values>, < off_flags>, < off_starts>, <off_views>, < off_areas>, < num_tols>, <ang_tols>, <thick_tols>, <tol_areas>, <model_flag>, < element_type>, <solid_flag>, <bacon_flag> )


Input:
INTEGER	<num_plies>	Number of plies.
STRING ARRAY	<ply-names>	Ply names.
STRING ARRAY	<type_names>	Application types.
INTEGER ARRAY	<instances>	Instances.
STRING ARRAY	<sides>	Side of application.
REAL ARRAY	<offsets>	Angular offset values.
INTEGER	<num_offs>	Number of offset regions defined.
REAL ARRAY	<off_values>	Value of offset.
STRING ARRAY	<off_flags>	Side of offset.
REAL ARRAY	<off_starts>	Coordinates of starting points for offset definition.
REAL ARRAY	<off_views>	Vectors defining view direction for offsets.
STRING ARRAY	<off_areas>	Selected areas for offset definition.
INTEGER	<num_tols>	Number of tolerance regions defined.
REAL ARRAY	<ang_tols>	Angular tolerance values (degrees).
REAL ARRAY	<thick_tols>	Thickness tolerance values(degrees).
STRING ARRAY	<tol_areas>	Selected areas for tolerance definition.
LOGICAL	<model_flag>	Generate analysis model.
STRING	<element_type>	Selected element type.
LOGICAL	<solid_flag>	Generate solid element file.
LOGICAL	<bacon_flag>	Generate BACON command file.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Creates a new layup.


p3cm.delete_material_name	(<type_name>, <material_name> )


Input:
STRING	<type_name>	Application type.
STRING	<material_name>	Material name.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Deletes an unused material.


p3cm.delete_ply_name	(<type_name>, < ply_name> )


Input:
STRING	<type_name>	Application type.
STRING	<ply_name>	Ply name.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Deletes an unused ply.


p3cm.create_results_sort	(<res_names> )


Input:
STRING ARRAY	<res_names>	A string array containing the loadcase name, subcase name, primary label, secondary label and dummy layer name of result to be sorted.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Creates sorted results.


p3cm.create_results_failure	(<res_names>,<area>,<criterion>,<basis>, <num_mats>,<mat_names>,<mat_allows>, <name>,<ply_sort>,<ply_results>,<failure_index>,<reserve_factor>,<margin_safety>,<critical_component>,<critical_ply> )


Input:
STRING ARRAY	<res_names>	A string array containing the loadcase name, subcase name, primary label, secondary label and dummy layer name of result to be sorted.
STRING	<area>	A list of elements for which results are to be calculated.
STRING	<criterion>	The name of the criterion to be used.
STRING	<basis>	The basis to be used: "STRESS" or "STRAIN".
INTEGER	<num_mats>	The number of material allowables.
STRING ARRAY	<mat_names>	A <num_mats> array of material names.
REAL ARRAY	<mat_allows>	A <num_mats>x<8> array of material allowables.
STRING	<name>	Result name.
LOGICAL	<ply_sort>	Flag to sort ply results by LM_Ply. (Not yet implemented.)
LOGICAL	<ply_results>	Flag to generate failure index, reserve factor, margin of safety and critical component results for every ply in the Patran database. (Not yet implemented.)
LOGICAL	<failure_index>	Flag to generate failure index results in the Patran database. (Not yet implemented.)
LOGICAL	<reserve_factor>	Flag to generate failure index results in the Patran database. (Not yet implemented.)
LOGICAL	<margin_safety>	Flag to generate margin of safety results in the Patran database.
LOGICAL	<critical_component>	Flag to generate margin of safety results in the Patran database.
LOGICAL	<critical_ply>	Flag to generate critical ply results in the Patran database.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Creates composite failure index results. These are stored in a text file and optional results in the Patran database.


p3cm.set_graphics_options	(<msg>, <ply_gr>, <layup_gr>, <view>, <init>, <maxstrn>, <area>, <cutout>, <pattern>, <offset>, <angles>, <offval>, <scale> )


Input:
LOGICAL	<msg>	Display the message file.
LOGICAL	<ply_gr>	Display the ply graphics control form.
LOGICAL	<layup_gr>	Display the layup graphics control form.
LOGICAL	<view>	Display the view direction arrow of a ply.
LOGICAL	<init>	Display the reference direction arrow of a ply.
LOGICAL	<maxstrn>	Display the maximum strain value of a ply.
LOGICAL	<area>	Display the border of the selected area of a ply.
LOGICAL	<cutout>	Display the 2D flat pattern of a ply.
LOGICAL	<pattern>	Display the 3D draped pattern of a ply.
LOGICAL	<offset>	Display the angles of the surface plies of a layup.
LOGICAL	<angles>	Display the angles of a ply.
REAL	<offval>	Offset value of the 2D flat pattern of a ply.
REAL	<scale>	Scale value of the angles of the surface plies of a layup.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Sets graphics options.


p3cm.set_export_options	(<pat>, <cut>, <mould>, <iges>, <dxf>, <post> )


Input:
LOGICAL	<pat>	Export the 3D draped pattern.
LOGICAL	<cut>	Export the 2D flat pattern.
LOGICAL	<mould>	Export mould surface.
LOGICAL	<iges>	Export files in IGES format.
LOGICAL	<dxf>	Export files in DXF format.
LOGICAL	<post>	Export files in postscript format.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Sets export options.


p3cm.delete_properties_all	( )


Input:
None.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Deletes properties named <P3LM_prop_XXX> generated by the MSC.Laminate Modeler.


p3cm.delete_laminates_all	( )


Input:
None.
Output:
INTEGER	<Return Value>	Status return value. The value will be 0 if the routine is successful.

Deletes laminates named <laminate_XXX> generated by the MSC.Laminate Modeler.