The ShellReferenceGeometry class gives you access to airbag shell reference geometry cards in PRIMER. More...
The PRIMER JavaScript API provides many class constants, properties and methods. For Arup to
be able to extend and enhance the API in the future any constant, property or method names beginning with a lowercase
or uppercase letter are reserved.
If you need to add your own properties or methods to one of the existing classes then to avoid any potential future conflict you
should ensure that the name begins with either an underscore (_) or a dollar sign ($) or the name is prefixed with your
own unique identifier.
For example if company 'ABC' need to add a property called 'example' then to avoid any potential future conflict use one of:
| Name | Type | Description |
| aid | integer | ShellReferenceGeometry number. Also see the label property which is an alternative name for this. |
| exists (read only) | logical | true if airbag shell reference geometry exists, false if referred to but not defined. |
| id | logical | Turns _ID on or OFF |
| include | integer | The Include file number that the airbag shell reference geometry is in. |
| iout | integer | Flag for outputting the current reference node coordinates |
| label | integer | ShellReferenceGeometry number. Also see the aid property which is an alternative name for this. |
| model (read only) | integer | The Model number that the airbag shell reference geometry is in. |
| nid | integer | Node number for origin |
| rdt | logical | Turns _RDT on or OFF |
| sx | real | Scale factor in X direction |
| sy | real | Scale factor in Y direction |
| sz | real | Scale factor in Z direction |
Detailed DescriptionThe ShellReferenceGeometry class allows you to create, modify, edit and manipulate airbag shell reference geometry cards. See the documentation below for more details. |
Constructornew ShellReferenceGeometry(Model[Model], aid (optional)[integer])DescriptionCreate a new ShellReferenceGeometry object. |
Model that ShellReferenceGeometry will be created in
ShellReferenceGeometry number to set _ID suffix
ReturnsShellReferenceGeometry object Return typeShellReferenceGeometry |
ExampleTo create a new ShellReferenceGeometry in model m var a = new ShellReferenceGeometry(m);
|
Details of functionsAssociateComment(Comment[Comment])DescriptionAssociates a comment with a airbag shell reference geometry. |
Comment that will be attached to the airbag shell reference geometry
ReturnsNo return value |
ExampleTo associate comment c to the airbag shell reference geometry a: a.AssociateComment(c);
|
Browse(modal (optional)[boolean])DescriptionStarts an edit panel in Browse mode. |
If this window is modal (blocks the user from doing anything else in PRIMER until this window is dismissed). If omitted the window will be modal.
Returnsno return value |
ExampleTo Browse airbag shell reference geometry a: a.Browse();
|
ClearFlag(flag[Flag])DescriptionClears a flag on the airbag shell reference geometry. |
Flag to clear on the airbag shell reference geometry
ReturnsNo return value |
ExampleTo clear flag f for airbag shell reference geometry a: a.ClearFlag(f);
|
Copy(range (optional)[boolean])DescriptionCopies the airbag shell reference geometry. The target include of the copied airbag shell reference geometry can be set using Options.copy_target_include. |
If you want to keep the copied item in the range specified for the current include. Default value is false. To set current include, use Include.MakeCurrentLayer().
ReturnsShellReferenceGeometry object Return typeShellReferenceGeometry |
ExampleTo copy airbag shell reference geometry a into airbag shell reference geometry z: var z = a.Copy();
|
Create(Model[Model], modal (optional)[boolean]) [static]DescriptionStarts an interactive editing panel to create a airbag shell reference geometry |
Model that the airbag shell reference geometry will be created in.
If this window is modal (blocks the user from doing anything else in PRIMER until this window is dismissed). If omitted the window will be modal.
ReturnsShellReferenceGeometry object (or null if not made). Return typeShellReferenceGeometry |
ExampleTo start creating a airbag shell reference geometry in model m: var a = ShellReferenceGeometry.Create(m);
|
DetachComment(Comment[Comment])DescriptionDetaches a comment from a airbag shell reference geometry. |
Comment that will be detached from the airbag shell reference geometry
ReturnsNo return value |
ExampleTo detach comment c from the airbag shell reference geometry a: a.DetachComment(c);
|
Edit(modal (optional)[boolean])DescriptionStarts an interactive editing panel. |
If this window is modal (blocks the user from doing anything else in PRIMER until this window is dismissed). If omitted the window will be modal.
Returnsno return value |
ExampleTo Edit airbag shell reference geometry a: a.Edit();
|
Error(message[string], details (optional)[string])DescriptionAdds an error for airbag shell reference geometry. For more details on checking see the Check class. |
The error message to give
An optional detailed error message
ReturnsNo return value |
ExampleTo add an error message "My custom error" for airbag shell reference geometry a: a.Error("My custom error");
|
First(Model[Model]) [static]DescriptionReturns the first airbag shell reference geometry in the model. |
Model to get first airbag shell reference geometry in
ReturnsShellReferenceGeometry object (or null if there are no airbag shell reference geometrys in the model). Return typeShellReferenceGeometry |
ExampleTo get the first airbag shell reference geometry in model m: var a = ShellReferenceGeometry.First(m);
|
FirstFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the first free airbag shell reference geometry label in the model. Also see ShellReferenceGeometry.LastFreeLabel(), ShellReferenceGeometry.NextFreeLabel() and Model.FirstFreeItemLabel(). |
Model to get first free airbag shell reference geometry label in
Include file (0 for the main file) to search for labels in (Equivalent to First free in layer in editing panels). If omitted the whole model will be used (Equivalent to First free in editing panels).
ReturnsShellReferenceGeometry label. Return typeNumber |
ExampleTo get the first free airbag shell reference geometry label in model m: var label = ShellReferenceGeometry.FirstFreeLabel(m);
|
FlagAll(Model[Model], flag[Flag]) [static]DescriptionFlags all of the airbag shell reference geometrys in the model with a defined flag. |
Model that all airbag shell reference geometrys will be flagged in
Flag to set on the airbag shell reference geometrys
ReturnsNo return value |
ExampleTo flag all of the airbag shell reference geometrys with flag f in model m: ShellReferenceGeometry.FlagAll(m, f);
|
Flagged(flag[Flag])DescriptionChecks if the airbag shell reference geometry is flagged or not. |
Flag to test on the airbag shell reference geometry
Returnstrue if flagged, false if not. Return typeBoolean |
ExampleTo check if airbag shell reference geometry a has flag f set on it: if (a.Flagged(f) ) do_something...
|
ForEach(Model[Model], func[function], extra (optional)[any]) [static]DescriptionCalls a function for each airbag shell reference geometry in the model. |
Model that all airbag shell reference geometrys are in
Function to call for each airbag shell reference geometry
An optional extra object/array/string etc that will appended to arguments when calling the function
ReturnsNo return value |
GetAll(Model[Model], property (optional)[string]) [static]DescriptionReturns an array of ShellReferenceGeometry objects or properties for all of the airbag shell reference geometrys in a model in PRIMER. If the optional property argument is not given then an array of ShellReferenceGeometry objects is returned. If the property argument is given, that property value for each airbag shell reference geometry is returned in the array instead of a ShellReferenceGeometry object |
Model to get airbag shell reference geometrys from
Name for property to get for all airbag shell reference geometrys in the model
ReturnsArray of ShellReferenceGeometry objects or properties Return typeArray |
GetComments()DescriptionExtracts the comments associated to a airbag shell reference geometry. |
No arguments
ReturnsArray of Comment objects (or null if there are no comments associated to the node). Return typeArray |
ExampleTo get the array of comments associated to the airbag shell reference geometry a: var comm_array = a.GetComments();
|
GetFlagged(Model[Model], flag[Flag], property (optional)[string]) [static]DescriptionReturns an array of ShellReferenceGeometry objects for all of the flagged airbag shell reference geometrys in a model in PRIMER If the optional property argument is not given then an array of ShellReferenceGeometry objects is returned. If the property argument is given, then that property value for each airbag shell reference geometry is returned in the array instead of a ShellReferenceGeometry object |
Model to get airbag shell reference geometrys from
Flag set on the airbag shell reference geometrys that you want to retrieve
Name for property to get for all flagged airbag shell reference geometrys in the model
ReturnsArray of ShellReferenceGeometry objects or properties Return typeArray |
GetFromID(Model[Model], number[integer]) [static]DescriptionReturns the ShellReferenceGeometry object for a airbag shell reference geometry ID. |
Model to find the airbag shell reference geometry in
number of the airbag shell reference geometry you want the ShellReferenceGeometry object for
ReturnsShellReferenceGeometry object (or null if airbag shell reference geometry does not exist). Return typeShellReferenceGeometry |
ExampleTo get the ShellReferenceGeometry object for airbag shell reference geometry 100 in model m var a = ShellReferenceGeometry.GetFromID(m, 100);
|
GetParameter(prop[string])DescriptionChecks if a ShellReferenceGeometry property is a parameter or not. Note that object properties that are parameters are normally returned as the integer or float parameter values as that is virtually always what the user would want. For this function to work the JavaScript interpreter must use the parameter name instead of the value. This can be done by setting the Options.property_parameter_names option to true before calling the function and then resetting it to false afterwards.. This behaviour can also temporarily be switched by using the ShellReferenceGeometry.ViewParameters() method and 'method chaining' (see the examples below). |
airbag shell reference geometry property to get parameter for
ReturnsParameter object if property is a parameter, null if not. Return typeParameter |
GetShell(eid[integer])DescriptionReturns the shell reference geometry nodes and pid for the shell |
Shell element ID
ReturnsAn array containing the four reference node labels and the part ID (or null if the shell is not on the shell reference geometry) Return typeArray |
Keyword()DescriptionReturns the keyword for this shell_reference_geometry (*AIRBAG_SHELL_REFERENCE_GEOMETRY). Note that a carriage return is not added. See also ShellReferenceGeometry.KeywordCards() |
No arguments
Returnsstring containing the keyword. Return typeString |
ExampleTo get the keyword for shell_reference_geometry a: var key = a.Keyword();
|
KeywordCards()DescriptionReturns the keyword cards for the shell_reference_geometry. Note that a carriage return is not added. See also ShellReferenceGeometry.Keyword() |
No arguments
Returnsstring containing the cards. Return typeString |
ExampleTo get the cards for airbag shell reference geometry a: var cards = b.KeywordCards();
|
Last(Model[Model]) [static]DescriptionReturns the last airbag shell reference geometry in the model. |
Model to get last airbag shell reference geometry in
ReturnsShellReferenceGeometry object (or null if there are no airbag shell reference geometrys in the model). Return typeShellReferenceGeometry |
ExampleTo get the last airbag shell reference geometry in model m: var a = ShellReferenceGeometry.Last(m);
|
LastFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the last free airbag shell reference geometry label in the model. Also see ShellReferenceGeometry.FirstFreeLabel(), ShellReferenceGeometry.NextFreeLabel() and see Model.LastFreeItemLabel() |
Model to get last free airbag shell reference geometry label in
Include file (0 for the main file) to search for labels in (Equivalent to Highest free in layer in editing panels). If omitted the whole model will be used.
ReturnsShellReferenceGeometry label. Return typeNumber |
ExampleTo get the last free airbag shell reference geometry label in model m: var label = ShellReferenceGeometry.LastFreeLabel(m);
|
Next()DescriptionReturns the next airbag shell reference geometry in the model. |
No arguments
ReturnsShellReferenceGeometry object (or null if there are no more airbag shell reference geometrys in the model). Return typeShellReferenceGeometry |
ExampleTo get the airbag shell reference geometry in model m after airbag shell reference geometry a: var a = a.Next();
|
NextFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the next free (highest+1) airbag shell reference geometry label in the model. Also see ShellReferenceGeometry.FirstFreeLabel(), ShellReferenceGeometry.LastFreeLabel() and Model.NextFreeItemLabel() |
Model to get next free airbag shell reference geometry label in
Include file (0 for the main file) to search for labels in (Equivalent to Highest+1 in layer in editing panels). If omitted the whole model will be used (Equivalent to Highest+1 in editing panels).
ReturnsShellReferenceGeometry label. Return typeNumber |
ExampleTo get the next free airbag shell reference geometry label in model m: var label = ShellReferenceGeometry.NextFreeLabel(m);
|
Pick(prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean], button text (optional)[string]) [static]DescriptionAllows the user to pick a airbag shell reference geometry. |
Text to display as a prompt to the user
If the argument is a Model then only airbag shell reference geometrys from that model can be picked. If the argument is a Flag then only airbag shell reference geometrys that are flagged with limit can be selected. If omitted, or null, any airbag shell reference geometrys from any model can be selected. from any model.
If picking is modal (blocks the user from doing anything else in PRIMER until this window is dismissed). If omitted the pick will be modal.
By default the window with the prompt will have a button labelled 'Cancel' which if pressed will cancel the pick and return null. If you want to change the text on the button use this argument. If omitted 'Cancel' will be used.
ReturnsShellReferenceGeometry object (or null if not picked) Return typeShellReferenceGeometry |
Previous()DescriptionReturns the previous airbag shell reference geometry in the model. |
No arguments
ReturnsShellReferenceGeometry object (or null if there are no more airbag shell reference geometrys in the model). Return typeShellReferenceGeometry |
ExampleTo get the airbag shell reference geometry in model m before airbag shell reference geometry a: var a = a.Previous();
|
RemoveShell(eid[integer])DescriptionRemoves a shell from the shell reference geometry if it is on it |
Element ID
ReturnsNo return value. |
ExampleTo remove shell 11 from shell reference geometry a: a.RemoveShell(11);
|
RenumberAll(Model[Model], start[integer]) [static]DescriptionRenumbers all of the airbag shell reference geometrys in the model. |
Model that all airbag shell reference geometrys will be renumbered in
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the airbag shell reference geometrys in model m, from 1000000: ShellReferenceGeometry.RenumberAll(m, 1000000);
|
RenumberFlagged(Model[Model], flag[Flag], start[integer]) [static]DescriptionRenumbers all of the flagged airbag shell reference geometrys in the model. |
Model that all the flagged airbag shell reference geometrys will be renumbered in
Flag set on the airbag shell reference geometrys that you want to renumber
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the airbag shell reference geometrys in model m flagged with f, from 1000000: ShellReferenceGeometry.RenumberFlagged(m, f, 1000000);
|
Select(flag[Flag], prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean]) [static]DescriptionAllows the user to select airbag shell reference geometrys using standard PRIMER object menus. |
Flag to use when selecting airbag shell reference geometrys
Text to display as a prompt to the user
If the argument is a Model then only airbag shell reference geometrys from that model can be selected. If the argument is a Flag then only airbag shell reference geometrys that are flagged with limit can be selected (limit should be different to flag). If omitted, or null, any airbag shell reference geometrys can be selected. from any model.
If selection is modal (blocks the user from doing anything else in PRIMER until this window is dismissed). If omitted the selection will be modal.
ReturnsNumber of airbag shell reference geometrys selected or null if menu cancelled Return typeNumber |
SetFlag(flag[Flag])DescriptionSets a flag on the airbag shell reference geometry. |
Flag to set on the airbag shell reference geometry
ReturnsNo return value |
ExampleTo set flag f for airbag shell reference geometry a: a.SetFlag(f);
|
Element ID
Nodal point 1
Nodal point 2
Nodal point 3
Nodal point 4
Part ID (ignored by Ansys LS-DYNA). If omitted pid will be zero.
ReturnsNo return value. |
Sketch(redraw (optional)[boolean])DescriptionSketches the airbag shell reference geometry. The airbag shell reference geometry will be sketched until you either call ShellReferenceGeometry.Unsketch(), ShellReferenceGeometry.UnsketchAll(), Model.UnsketchAll(), or delete the model |
If model should be redrawn or not after the airbag shell reference geometry is sketched. If omitted redraw is true. If you want to sketch several airbag shell reference geometrys and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch airbag shell reference geometry a: a.Sketch();
|
SketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionSketches all of the flagged airbag shell reference geometrys in the model. The airbag shell reference geometrys will be sketched until you either call ShellReferenceGeometry.Unsketch(), ShellReferenceGeometry.UnsketchFlagged(), Model.UnsketchAll(), or delete the model |
Model that all the flagged airbag shell reference geometrys will be sketched in
Flag set on the airbag shell reference geometrys that you want to sketch
If model should be redrawn or not after the airbag shell reference geometrys are sketched. If omitted redraw is true. If you want to sketch flagged airbag shell reference geometrys several times and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch all airbag shell reference geometrys flagged with flag in model m: ShellReferenceGeometry.SketchFlagged(m, flag);
|
Spool()DescriptionSpools a shell reference geometry, entry by entry. See also ShellReferenceGeometry.StartSpool |
No arguments
ReturnsReturns an array containing the shell ID and the four nodal point labels. Returns 0 if no more items Return typeArray |
ExampleTo spool shell reference geometry a: var array;
a.StartSpool();
while (array = a.Spool())
{
do something...
}
|
StartSpool()DescriptionStarts a shell reference geometry spooling operation. See also ShellReferenceGeometry.Spool |
No arguments
ReturnsNo return value |
ExampleTo start spooling shell reference geometry a: a.StartSpool();
|
Total(Model[Model], exists (optional)[boolean]) [static]DescriptionReturns the total number of airbag shell reference geometrys in the model. |
Model to get total for
true if only existing airbag shell reference geometrys should be counted. If false or omitted referenced but undefined airbag shell reference geometrys will also be included in the total.
Returnsnumber of airbag shell reference geometrys Return typeNumber |
ExampleTo get the total number of airbag shell reference geometrys in model m: var total = ShellReferenceGeometry.Total(m);
|
UnflagAll(Model[Model], flag[Flag]) [static]DescriptionUnsets a defined flag on all of the airbag shell reference geometrys in the model. |
Model that the defined flag for all airbag shell reference geometrys will be unset in
Flag to unset on the airbag shell reference geometrys
ReturnsNo return value |
ExampleTo unset the flag f on all the airbag shell reference geometrys in model m: ShellReferenceGeometry.UnflagAll(m, f);
|
Unsketch(redraw (optional)[boolean])DescriptionUnsketches the airbag shell reference geometry. |
If model should be redrawn or not after the airbag shell reference geometry is unsketched. If omitted redraw is true. If you want to unsketch several airbag shell reference geometrys and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch airbag shell reference geometry a: a.Unsketch();
|
UnsketchAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnsketches all airbag shell reference geometrys. |
Model that all airbag shell reference geometrys will be unblanked in
If model should be redrawn or not after the airbag shell reference geometrys are unsketched. If omitted redraw is true. If you want to unsketch several things and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch all airbag shell reference geometrys in model m: ShellReferenceGeometry.UnsketchAll(m);
|
UnsketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnsketches all flagged airbag shell reference geometrys in the model. |
Model that all airbag shell reference geometrys will be unsketched in
Flag set on the airbag shell reference geometrys that you want to unsketch
If model should be redrawn or not after the airbag shell reference geometrys are unsketched. If omitted redraw is true. If you want to unsketch several things and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch all airbag shell reference geometrys flagged with flag in model m: ShellReferenceGeometry.UnsketchAll(m, flag);
|
No arguments
ReturnsShellReferenceGeometry object. Return typeShellReferenceGeometry |
ExampleTo check if ShellReferenceGeometry property a.example is a parameter by using the ShellReferenceGeometry.GetParameter() method: if (a.ViewParameters().GetParameter(a.example) ) do_something...
|
Warning(message[string], details (optional)[string])DescriptionAdds a warning for airbag shell reference geometry. For more details on checking see the Check class. |
The warning message to give
An optional detailed warning message
ReturnsNo return value |
ExampleTo add a warning message "My custom warning" for airbag shell reference geometry a: a.Warning("My custom warning");
|
Xrefs()DescriptionReturns the cross references for this airbag shell reference geometry. |
No arguments
ReturnsXrefs object. Return typeXrefs |
ExampleTo get the cross references for airbag shell reference geometry a: var xrefs = a.Xrefs();
|
toString()DescriptionCreates a string containing the ShellReferenceGeometry data in keyword format. Note that this contains the keyword header and the keyword cards. See also ShellReferenceGeometry.Keyword() and ShellReferenceGeometry.KeywordCards(). |
No arguments
Returnsstring Return typeString |
ExampleTo get data for ShellReferenceGeometry rdt in keyword format var s = rdt.toString();
|