The Rigidwall class gives you access to rigidwall 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 |
| birth | real | Birth time. |
| boxid | integer | Box for nodes. |
| d1 | real | X component of vector defn. |
| d2 | real | Y component of vector defn. |
| d3 | real | Z component of vector defn. |
| death | real | Death time. |
| decaya | real | Friction decay const in local A dir. |
| decayb | real | Friction decay const in local B dir. |
| dfrica | real | Dynamic friction coeff in local A dir. |
| dfricb | real | Dynamic friction coeff in local B dir. |
| display | logical | DISPLAY flag. |
| e | real | Young's modulus of rigidwall (for _DISPLAY option). |
| exists (read only) | logical | true if rigidwall exists, false if referred to but not defined. |
| finite | logical | Finite flag. |
| forces | logical | Forces flag. |
| fric | real | Friction coefficient. |
| heading | string | Rigidwall heading |
| id | logical | true if _ID option is set, false if not |
| include | integer | The Include file number that the rigidwall is in. |
| label | integer | Rigidwall number. |
| lcid | integer | Vel/disp vs time curve number. |
| lencyl | real | Length of cylinder. |
| lenl | real | Length of L edge. |
| lenm | real | Length of M edge. |
| lenp | real | Length of prism in -ve N. |
| mass | real | Mass of moving wall. |
| model (read only) | integer | The Model number that the rigidwall is in. |
| motion | logical | Motion flag. |
| moving | logical | Moving flag. |
| n1 | integer | 1st node for visualisation. |
| n2 | integer | 2nd node for visualisation. |
| n3 | integer | 3rd node for visualisation. |
| n4 | integer | 4th node for visualisation. |
| node1 | integer | Node 1 for vector defn. |
| node2 | integer | Node 2 for vector defn. |
| nsegs | integer | Number of subsections. |
| nsid | integer | Constrained node set included in wall. |
| nsidex | integer | Constrained node set exempted from wall. |
| offset | real | Offset for planar option. |
| opt | integer | Motion type. |
| ortho | logical | Ortho flag. |
| pid | integer | Part ID for display of geometric rigidwall (for _DISPLAY option). |
| pr | real | Poisson's ratio of rigidwall (for _DISPLAY option). |
| radcyl | real | Radius of cylinder. |
| radsph | real | Radius of sphere. |
| ro | real | Density of rigidwall (for _DISPLAY option). |
| rwid | integer | Rigidwall number (identical to label). |
| rwksf | real | Stiffness scaling factor. |
| sfrica | real | Static friction coeff in local A dir. |
| sfricb | real | Static friction coeff in local B dir. |
| soft | integer | No. of cycles to zero relative velocity. |
| ssid | integer | Segment set number. |
| type | constant | The rigidwall type. Can be Rigidwall.FLAT, Rigidwall.PRISM, Rigidwall.CYLINDER, Rigidwall.SPHERE, Rigidwall.PLANAR, |
| v0 | real | Initial velocity. |
| vx | real | X component of motion vector. |
| vy | real | Y component of motion vector. |
| vz | real | Z component of motion vector. |
| wvel | real | Velocity at which nodes weld to wall. |
| xh | real | Head X coord of outward normal. |
| xhev | real | Head X coord of edge I vector. |
| xt | real | Tail X coord of outward normal. |
| yh | real | Head Y coord of outward normal. |
| yhev | real | Head Y coord of edge I vector. |
| yt | real | Tail Y coord of outward normal. |
| zh | real | Head Z coord of outward normal. |
| zhev | real | Head Z coord of edge I vector. |
| zt | real | Tail Z coord of outward normal. |
Detailed DescriptionThe Rigidwall class allows you to create, modify, edit rigidwall cards. See the documentation below for more details. |
Constructornew Rigidwall(Model[Model], type[constant], nsid (optional)[integer], rwid (optional)[integer], heading (optional)[string])DescriptionCreate a new Rigidwall object. |
Model that Rigidwall will be created in
Specify the type of rigidwall (Can be Rigidwall.FLAT, Rigidwall.PRISM, Rigidwall.CYLINDER, Rigidwall.SPHERE, Rigidwall.PLANAR)
Node set number.
Rigidwall number
Title for the Rigidwall
ReturnsRigidwall object Return typeRigidwall |
ExampleTo create a new rigidwall 200 of type GEOMETRIC_SPHERE in model m using node set 100 having the title "test wall" var r = new Rigidwall(m, Rigidwall.SPHERE, 200, 100, "test wall");
|
Details of functionsAssociateComment(Comment[Comment])DescriptionAssociates a comment with a rigidwall. |
Comment that will be attached to the rigidwall
ReturnsNo return value |
ExampleTo associate comment c to the rigidwall r: r.AssociateComment(c);
|
Blank()DescriptionBlanks the rigidwall |
No arguments
ReturnsNo return value |
ExampleTo blank rigidwall r: r.Blank();
|
BlankAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionBlanks all of the rigidwalls in the model. |
Model that all rigidwalls will be blanked in
If model should be redrawn or not. If omitted redraw is false. If you want to do several (un)blanks and only redraw after the last one then use false for all redraws apart from the last one. Alternatively you can redraw using View.Redraw().
ReturnsNo return value |
ExampleTo blank all of the rigidwalls in model m: Rigidwall.BlankAll(m);
|
BlankFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionBlanks all of the flagged rigidwalls in the model. |
Model that all the flagged rigidwalls will be blanked in
Flag set on the rigidwalls that you want to blank
If model should be redrawn or not. If omitted redraw is false. If you want to do several (un)blanks and only redraw after the last one then use false for all redraws apart from the last one. Alternatively you can redraw using View.Redraw().
ReturnsNo return value |
ExampleTo blank all of the rigidwalls in model m flagged with f: Rigidwall.BlankFlagged(m, f);
|
Blanked()DescriptionChecks if the rigidwall is blanked or not. |
No arguments
Returnstrue if blanked, false if not. Return typeBoolean |
ExampleTo check if rigidwall r is blanked: if (r.Blanked() ) do_something...
|
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 rigidwall r: r.Browse();
|
ClearFlag(flag[Flag])DescriptionClears a flag on the rigidwall. |
Flag to clear on the rigidwall
ReturnsNo return value |
ExampleTo clear flag f for rigidwall r: r.ClearFlag(f);
|
Copy(range (optional)[boolean])DescriptionCopies the rigidwall. The target include of the copied rigidwall 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().
ReturnsRigidwall object Return typeRigidwall |
ExampleTo copy rigidwall r into rigidwall z: var z = r.Copy();
|
Create(Model[Model], modal (optional)[boolean]) [static]DescriptionStarts an interactive editing panel to create a rigidwall |
Model that the rigidwall 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.
ReturnsRigidwall object (or null if not made). Return typeRigidwall |
ExampleTo start creating a rigidwall in model m: var r = Rigidwall.Create(m);
|
DetachComment(Comment[Comment])DescriptionDetaches a comment from a rigidwall. |
Comment that will be detached from the rigidwall
ReturnsNo return value |
ExampleTo detach comment c from the rigidwall r: r.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 rigidwall r: r.Edit();
|
Error(message[string], details (optional)[string])DescriptionAdds an error for rigidwall. 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 rigidwall r: r.Error("My custom error");
|
FindNodesBehind(flag[Flag])DescriptionFlags nodes that are behind a rigidwall |
Flag to be set on nodes behind rigidwall.
ReturnsNumber of nodes found Return typeNumber |
ExampleTo set flag f on nodes behind rigidwall w: w.FlagNodesBehind(f);
|
First(Model[Model]) [static]DescriptionReturns the first rigidwall in the model. |
Model to get first rigidwall in
ReturnsRigidwall object (or null if there are no rigidwalls in the model). Return typeRigidwall |
ExampleTo get the first rigidwall in model m: var r = Rigidwall.First(m);
|
FirstFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the first free rigidwall label in the model. Also see Rigidwall.LastFreeLabel(), Rigidwall.NextFreeLabel() and Model.FirstFreeItemLabel(). |
Model to get first free rigidwall 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).
ReturnsRigidwall label. Return typeNumber |
ExampleTo get the first free rigidwall label in model m: var label = Rigidwall.FirstFreeLabel(m);
|
FlagAll(Model[Model], flag[Flag]) [static]DescriptionFlags all of the rigidwalls in the model with a defined flag. |
Model that all rigidwalls will be flagged in
Flag to set on the rigidwalls
ReturnsNo return value |
ExampleTo flag all of the rigidwalls with flag f in model m: Rigidwall.FlagAll(m, f);
|
Flagged(flag[Flag])DescriptionChecks if the rigidwall is flagged or not. |
Flag to test on the rigidwall
Returnstrue if flagged, false if not. Return typeBoolean |
ExampleTo check if rigidwall r has flag f set on it: if (r.Flagged(f) ) do_something...
|
ForEach(Model[Model], func[function], extra (optional)[any]) [static]DescriptionCalls a function for each rigidwall in the model. |
Model that all rigidwalls are in
Function to call for each rigidwall
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 Rigidwall objects or properties for all of the rigidwalls in a model in PRIMER. If the optional property argument is not given then an array of Rigidwall objects is returned. If the property argument is given, that property value for each rigidwall is returned in the array instead of a Rigidwall object |
Model to get rigidwalls from
Name for property to get for all rigidwalls in the model
ReturnsArray of Rigidwall objects or properties Return typeArray |
GetComments()DescriptionExtracts the comments associated to a rigidwall. |
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 rigidwall r: var comm_array = r.GetComments();
|
GetFlagged(Model[Model], flag[Flag], property (optional)[string]) [static]DescriptionReturns an array of Rigidwall objects for all of the flagged rigidwalls in a model in PRIMER If the optional property argument is not given then an array of Rigidwall objects is returned. If the property argument is given, then that property value for each rigidwall is returned in the array instead of a Rigidwall object |
Model to get rigidwalls from
Flag set on the rigidwalls that you want to retrieve
Name for property to get for all flagged rigidwalls in the model
ReturnsArray of Rigidwall objects or properties Return typeArray |
GetFromID(Model[Model], number[integer]) [static]DescriptionReturns the Rigidwall object for a rigidwall ID. |
Model to find the rigidwall in
number of the rigidwall you want the Rigidwall object for
ReturnsRigidwall object (or null if rigidwall does not exist). Return typeRigidwall |
ExampleTo get the Rigidwall object for rigidwall 100 in model m var r = Rigidwall.GetFromID(m, 100);
|
GetParameter(prop[string])DescriptionChecks if a Rigidwall 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 Rigidwall.ViewParameters() method and 'method chaining' (see the examples below). |
rigidwall property to get parameter for
ReturnsParameter object if property is a parameter, null if not. Return typeParameter |
GetRow(row[integer])DescriptionReturns the data for an NSEGS card row in the rigidwall. |
The row you want the data for. Note row indices start at 0.
ReturnsAn array of numbers containing the row variables VL and HEIGHT. Return typeNumber |
ExampleTo get the data for the 2nd row in rigidwall r: var data = r.GetRow(1); var vl = data[0]; var height = data[1];
|
Keyword()DescriptionReturns the keyword for this Rigidwall (*RIGIDWALL). Note that a carriage return is not added. See also Rigidwall.KeywordCards() |
No arguments
Returnsstring containing the keyword. Return typeString |
ExampleTo get the keyword for Rigidwall pm: var key = r.Keyword();
|
KeywordCards()DescriptionReturns the keyword cards for the Rigidwall. Note that a carriage return is not added. See also Rigidwall.Keyword() |
No arguments
Returnsstring containing the cards. Return typeString |
ExampleTo get the cards for Rigidwall pm: var cards = r.KeywordCards();
|
Last(Model[Model]) [static]DescriptionReturns the last rigidwall in the model. |
Model to get last rigidwall in
ReturnsRigidwall object (or null if there are no rigidwalls in the model). Return typeRigidwall |
ExampleTo get the last rigidwall in model m: var r = Rigidwall.Last(m);
|
LastFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the last free rigidwall label in the model. Also see Rigidwall.FirstFreeLabel(), Rigidwall.NextFreeLabel() and see Model.LastFreeItemLabel() |
Model to get last free rigidwall 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.
ReturnsRigidwall label. Return typeNumber |
ExampleTo get the last free rigidwall label in model m: var label = Rigidwall.LastFreeLabel(m);
|
Next()DescriptionReturns the next rigidwall in the model. |
No arguments
ReturnsRigidwall object (or null if there are no more rigidwalls in the model). Return typeRigidwall |
ExampleTo get the rigidwall in model m after rigidwall r: var r = r.Next();
|
NextFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the next free (highest+1) rigidwall label in the model. Also see Rigidwall.FirstFreeLabel(), Rigidwall.LastFreeLabel() and Model.NextFreeItemLabel() |
Model to get next free rigidwall 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).
ReturnsRigidwall label. Return typeNumber |
ExampleTo get the next free rigidwall label in model m: var label = Rigidwall.NextFreeLabel(m);
|
Pick(prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean], button text (optional)[string]) [static]DescriptionAllows the user to pick a rigidwall. |
Text to display as a prompt to the user
If the argument is a Model then only rigidwalls from that model can be picked. If the argument is a Flag then only rigidwalls that are flagged with limit can be selected. If omitted, or null, any rigidwalls 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.
ReturnsRigidwall object (or null if not picked) Return typeRigidwall |
ExampleTo pick a rigidwall from model m giving the prompt 'Pick rigidwall from screen': var r = Rigidwall.Pick('Pick rigidwall from screen', m);
|
Previous()DescriptionReturns the previous rigidwall in the model. |
No arguments
ReturnsRigidwall object (or null if there are no more rigidwalls in the model). Return typeRigidwall |
ExampleTo get the rigidwall in model m before rigidwall r: var r = r.Previous();
|
RemoveRow(row[integer])DescriptionRemoves an NSEGS card row in the *RIGIDWALL. |
The row you want to remove the data for. Note that row indices start at 0.
ReturnsNo return value. |
ExampleTo remove the second row of data for rigidwall r: r.RemoveRow(1);
|
RenumberAll(Model[Model], start[integer]) [static]DescriptionRenumbers all of the rigidwalls in the model. |
Model that all rigidwalls will be renumbered in
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the rigidwalls in model m, from 1000000: Rigidwall.RenumberAll(m, 1000000);
|
RenumberFlagged(Model[Model], flag[Flag], start[integer]) [static]DescriptionRenumbers all of the flagged rigidwalls in the model. |
Model that all the flagged rigidwalls will be renumbered in
Flag set on the rigidwalls that you want to renumber
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the rigidwalls in model m flagged with f, from 1000000: Rigidwall.RenumberFlagged(m, f, 1000000);
|
Select(flag[Flag], prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean]) [static]DescriptionAllows the user to select rigidwalls using standard PRIMER object menus. |
Flag to use when selecting rigidwalls
Text to display as a prompt to the user
If the argument is a Model then only rigidwalls from that model can be selected. If the argument is a Flag then only rigidwalls that are flagged with limit can be selected (limit should be different to flag). If omitted, or null, any rigidwalls 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 rigidwalls selected or null if menu cancelled Return typeNumber |
SetFlag(flag[Flag])DescriptionSets a flag on the rigidwall. |
Flag to set on the rigidwall
ReturnsNo return value |
ExampleTo set flag f for rigidwall r: r.SetFlag(f);
|
SetRow(row[integer], data[Array of data])DescriptionSets the data for an NSEGS card row in the *RIGIDWALL. |
The row you want to set the data for. Note that row indices start at 0.
The data you want to set the row to
ReturnsNo return value. |
Sketch(redraw (optional)[boolean])DescriptionSketches the rigidwall. The rigidwall will be sketched until you either call Rigidwall.Unsketch(), Rigidwall.UnsketchAll(), Model.UnsketchAll(), or delete the model |
If model should be redrawn or not after the rigidwall is sketched. If omitted redraw is true. If you want to sketch several rigidwalls and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch rigidwall r: r.Sketch();
|
SketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionSketches all of the flagged rigidwalls in the model. The rigidwalls will be sketched until you either call Rigidwall.Unsketch(), Rigidwall.UnsketchFlagged(), Model.UnsketchAll(), or delete the model |
Model that all the flagged rigidwalls will be sketched in
Flag set on the rigidwalls that you want to sketch
If model should be redrawn or not after the rigidwalls are sketched. If omitted redraw is true. If you want to sketch flagged rigidwalls several times and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch all rigidwalls flagged with flag in model m: Rigidwall.SketchFlagged(m, flag);
|
Total(Model[Model], exists (optional)[boolean]) [static]DescriptionReturns the total number of rigidwalls in the model. |
Model to get total for
true if only existing rigidwalls should be counted. If false or omitted referenced but undefined rigidwalls will also be included in the total.
Returnsnumber of rigidwalls Return typeNumber |
ExampleTo get the total number of rigidwalls in model m: var total = Rigidwall.Total(m);
|
Unblank()DescriptionUnblanks the rigidwall |
No arguments
ReturnsNo return value |
ExampleTo unblank rigidwall r: r.Unblank();
|
UnblankAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnblanks all of the rigidwalls in the model. |
Model that all rigidwalls will be unblanked in
If model should be redrawn or not. If omitted redraw is false. If you want to do several (un)blanks and only redraw after the last one then use false for all redraws apart from the last one. Alternatively you can redraw using View.Redraw().
ReturnsNo return value |
ExampleTo unblank all of the rigidwalls in model m: Rigidwall.UnblankAll(m);
|
UnblankFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnblanks all of the flagged rigidwalls in the model. |
Model that the flagged rigidwalls will be unblanked in
Flag set on the rigidwalls that you want to unblank
If model should be redrawn or not. If omitted redraw is false. If you want to do several (un)blanks and only redraw after the last one then use false for all redraws apart from the last one. Alternatively you can redraw using View.Redraw().
ReturnsNo return value |
ExampleTo unblank all of the rigidwalls in model m flagged with f: Rigidwall.UnblankFlagged(m, f);
|
UnflagAll(Model[Model], flag[Flag]) [static]DescriptionUnsets a defined flag on all of the rigidwalls in the model. |
Model that the defined flag for all rigidwalls will be unset in
Flag to unset on the rigidwalls
ReturnsNo return value |
ExampleTo unset the flag f on all the rigidwalls in model m: Rigidwall.UnflagAll(m, f);
|
Unsketch(redraw (optional)[boolean])DescriptionUnsketches the rigidwall. |
If model should be redrawn or not after the rigidwall is unsketched. If omitted redraw is true. If you want to unsketch several rigidwalls and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch rigidwall r: r.Unsketch();
|
UnsketchAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnsketches all rigidwalls. |
Model that all rigidwalls will be unblanked in
If model should be redrawn or not after the rigidwalls 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 rigidwalls in model m: Rigidwall.UnsketchAll(m);
|
UnsketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnsketches all flagged rigidwalls in the model. |
Model that all rigidwalls will be unsketched in
Flag set on the rigidwalls that you want to unsketch
If model should be redrawn or not after the rigidwalls 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 rigidwalls flagged with flag in model m: Rigidwall.UnsketchAll(m, flag);
|
No arguments
ReturnsRigidwall object. Return typeRigidwall |
ExampleTo check if Rigidwall property r.example is a parameter by using the Rigidwall.GetParameter() method: if (r.ViewParameters().GetParameter(r.example) ) do_something...
|
Warning(message[string], details (optional)[string])DescriptionAdds a warning for rigidwall. 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 rigidwall r: r.Warning("My custom warning");
|
Xrefs()DescriptionReturns the cross references for this rigidwall. |
No arguments
ReturnsXrefs object. Return typeXrefs |
ExampleTo get the cross references for rigidwall r: var xrefs = r.Xrefs();
|
toString()DescriptionCreates a string containing the Rigidwall data in keyword format. Note that this contains the keyword header and the keyword cards. See also Rigidwall.Keyword() and Rigidwall.KeywordCards(). |
No arguments
Returnsstring Return typeString |
ExampleTo get data for Rigidwall pm in keyword format var r = r.toString();
|