The Spotweld class gives you access to constrained spotweld 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 |
| colour | Colour | The colour of the spotweld |
| ep | real | Effective plastic strain at failure |
| exists (read only) | logical | true if spotweld exists, false if referred to but not defined. |
| filtered_force | logical | true if _FILTERED_FORCE option is set, false if not |
| id | logical | true if _ID option is set, false if not |
| include | integer | The Include file number that the spotweld is in. |
| label | integer | Constrained spotweld number |
| m | real | Exponent for shear spotweld force |
| model (read only) | integer | The Model number that the spotweld is in. |
| n | real | Exponent for normal spotweld force |
| n1 | integer | Node ID |
| n2 | integer | Node ID |
| nf | integer | Number of force vectors stored for filtering |
| sn | real | Normal force at spotweld failure |
| ss | real | Shear force at spotweld failure |
| tf | real | Failure time for nodal constraint set |
| tw | real | Time window for filtering |
| wid | integer | Constrained spotweld number (identical to label) |
Detailed DescriptionThe Spotweld class allows you to create, modify, edit and manipulate constrained spotweld cards. See the documentation below for more details. |
Constructornew Spotweld(Model[Model], n1[integer], n2[integer], label (optional)[integer])DescriptionCreate a new Spotweld object. |
Model that constrained spotweld will be created in
Node ID 1
Node ID 2
Constrained spotweld number
ReturnsSpotweld object Return typeSpotweld |
ExampleTo create a new constrained spotweld 500 in model m between nodes 10 and 11 var s = new Spotweld(m, 10, 11, 500);
|
Details of functionsAssociateComment(Comment[Comment])DescriptionAssociates a comment with a spotweld. |
Comment that will be attached to the spotweld
ReturnsNo return value |
ExampleTo associate comment c to the spotweld s: s.AssociateComment(c);
|
Blank()DescriptionBlanks the spotweld |
No arguments
ReturnsNo return value |
ExampleTo blank spotweld s: s.Blank();
|
BlankAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionBlanks all of the spotwelds in the model. |
Model that all spotwelds 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 spotwelds in model m: Spotweld.BlankAll(m);
|
BlankFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionBlanks all of the flagged spotwelds in the model. |
Model that all the flagged spotwelds will be blanked in
Flag set on the spotwelds 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 spotwelds in model m flagged with f: Spotweld.BlankFlagged(m, f);
|
Blanked()DescriptionChecks if the spotweld is blanked or not. |
No arguments
Returnstrue if blanked, false if not. Return typeBoolean |
ExampleTo check if spotweld s is blanked: if (s.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 spotweld s: s.Browse();
|
ClearFlag(flag[Flag])DescriptionClears a flag on the spotweld. |
Flag to clear on the spotweld
ReturnsNo return value |
ExampleTo clear flag f for spotweld s: s.ClearFlag(f);
|
Copy(range (optional)[boolean])DescriptionCopies the spotweld. The target include of the copied spotweld 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().
ReturnsSpotweld object Return typeSpotweld |
ExampleTo copy spotweld s into spotweld z: var z = s.Copy();
|
Create(Model[Model], modal (optional)[boolean]) [static]DescriptionStarts an interactive editing panel to create a spotweld |
Model that the spotweld 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.
ReturnsSpotweld object (or null if not made). Return typeSpotweld |
ExampleTo start creating a spotweld in model m: var s = Spotweld.Create(m);
|
DetachComment(Comment[Comment])DescriptionDetaches a comment from a spotweld. |
Comment that will be detached from the spotweld
ReturnsNo return value |
ExampleTo detach comment c from the spotweld s: s.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 spotweld s: s.Edit();
|
Error(message[string], details (optional)[string])DescriptionAdds an error for spotweld. 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 spotweld s: s.Error("My custom error");
|
ExtractColour()DescriptionExtracts the actual colour used for spotweld. |
No arguments
Returnscolour value (integer) Return typeNumber |
ExampleTo return the colour used for drawing spotweld s: var colour = s.ExtractColour();
|
First(Model[Model]) [static]DescriptionReturns the first spotweld in the model. |
Model to get first spotweld in
ReturnsSpotweld object (or null if there are no spotwelds in the model). Return typeSpotweld |
ExampleTo get the first spotweld in model m: var s = Spotweld.First(m);
|
FirstFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the first free spotweld label in the model. Also see Spotweld.LastFreeLabel(), Spotweld.NextFreeLabel() and Model.FirstFreeItemLabel(). |
Model to get first free spotweld 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).
ReturnsSpotweld label. Return typeNumber |
ExampleTo get the first free spotweld label in model m: var label = Spotweld.FirstFreeLabel(m);
|
FlagAll(Model[Model], flag[Flag]) [static]DescriptionFlags all of the spotwelds in the model with a defined flag. |
Model that all spotwelds will be flagged in
Flag to set on the spotwelds
ReturnsNo return value |
ExampleTo flag all of the spotwelds with flag f in model m: Spotweld.FlagAll(m, f);
|
Flagged(flag[Flag])DescriptionChecks if the spotweld is flagged or not. |
Flag to test on the spotweld
Returnstrue if flagged, false if not. Return typeBoolean |
ExampleTo check if spotweld s has flag f set on it: if (s.Flagged(f) ) do_something...
|
ForEach(Model[Model], func[function], extra (optional)[any]) [static]DescriptionCalls a function for each spotweld in the model. |
Model that all spotwelds are in
Function to call for each spotweld
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 Spotweld objects or properties for all of the spotwelds in a model in PRIMER. If the optional property argument is not given then an array of Spotweld objects is returned. If the property argument is given, that property value for each spotweld is returned in the array instead of a Spotweld object |
Model to get spotwelds from
Name for property to get for all spotwelds in the model
ReturnsArray of Spotweld objects or properties Return typeArray |
GetComments()DescriptionExtracts the comments associated to a spotweld. |
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 spotweld s: var comm_array = s.GetComments();
|
GetFlagged(Model[Model], flag[Flag], property (optional)[string]) [static]DescriptionReturns an array of Spotweld objects for all of the flagged spotwelds in a model in PRIMER If the optional property argument is not given then an array of Spotweld objects is returned. If the property argument is given, then that property value for each spotweld is returned in the array instead of a Spotweld object |
Model to get spotwelds from
Flag set on the spotwelds that you want to retrieve
Name for property to get for all flagged spotwelds in the model
ReturnsArray of Spotweld objects or properties Return typeArray |
GetFromID(Model[Model], number[integer]) [static]DescriptionReturns the Spotweld object for a spotweld ID. |
Model to find the spotweld in
number of the spotweld you want the Spotweld object for
ReturnsSpotweld object (or null if spotweld does not exist). Return typeSpotweld |
ExampleTo get the Spotweld object for spotweld 100 in model m var s = Spotweld.GetFromID(m, 100);
|
GetParameter(prop[string])DescriptionChecks if a Spotweld 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 Spotweld.ViewParameters() method and 'method chaining' (see the examples below). |
spotweld property to get parameter for
ReturnsParameter object if property is a parameter, null if not. Return typeParameter |
Keyword()DescriptionReturns the keyword for this spotweld (*CONSTRAINED_SPOTWELD). Note that a carriage return is not added. See also Spotweld.KeywordCards() |
No arguments
Returnsstring containing the keyword. Return typeString |
ExampleTo get the keyword for spotweld s: var key = s.Keyword();
|
KeywordCards()DescriptionReturns the keyword cards for the spotweld. Note that a carriage return is not added. See also Spotweld.Keyword() |
No arguments
Returnsstring containing the cards. Return typeString |
ExampleTo get the cards for spotweld s: var cards = s.KeywordCards();
|
Last(Model[Model]) [static]DescriptionReturns the last spotweld in the model. |
Model to get last spotweld in
ReturnsSpotweld object (or null if there are no spotwelds in the model). Return typeSpotweld |
ExampleTo get the last spotweld in model m: var s = Spotweld.Last(m);
|
LastFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the last free spotweld label in the model. Also see Spotweld.FirstFreeLabel(), Spotweld.NextFreeLabel() and see Model.LastFreeItemLabel() |
Model to get last free spotweld 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.
ReturnsSpotweld label. Return typeNumber |
ExampleTo get the last free spotweld label in model m: var label = Spotweld.LastFreeLabel(m);
|
Next()DescriptionReturns the next spotweld in the model. |
No arguments
ReturnsSpotweld object (or null if there are no more spotwelds in the model). Return typeSpotweld |
ExampleTo get the spotweld in model m after spotweld s: var s = s.Next();
|
NextFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the next free (highest+1) spotweld label in the model. Also see Spotweld.FirstFreeLabel(), Spotweld.LastFreeLabel() and Model.NextFreeItemLabel() |
Model to get next free spotweld 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).
ReturnsSpotweld label. Return typeNumber |
ExampleTo get the next free spotweld label in model m: var label = Spotweld.NextFreeLabel(m);
|
Pick(prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean], button text (optional)[string]) [static]DescriptionAllows the user to pick a spotweld. |
Text to display as a prompt to the user
If the argument is a Model then only spotwelds from that model can be picked. If the argument is a Flag then only spotwelds that are flagged with limit can be selected. If omitted, or null, any spotwelds 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.
ReturnsSpotweld object (or null if not picked) Return typeSpotweld |
ExampleTo pick a spotweld from model m giving the prompt 'Pick spotweld from screen': var s = Spotweld.Pick('Pick spotweld from screen', m);
|
Previous()DescriptionReturns the previous spotweld in the model. |
No arguments
ReturnsSpotweld object (or null if there are no more spotwelds in the model). Return typeSpotweld |
ExampleTo get the spotweld in model m before spotweld s: var s = s.Previous();
|
RenumberAll(Model[Model], start[integer]) [static]DescriptionRenumbers all of the spotwelds in the model. |
Model that all spotwelds will be renumbered in
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the spotwelds in model m, from 1000000: Spotweld.RenumberAll(m, 1000000);
|
RenumberFlagged(Model[Model], flag[Flag], start[integer]) [static]DescriptionRenumbers all of the flagged spotwelds in the model. |
Model that all the flagged spotwelds will be renumbered in
Flag set on the spotwelds that you want to renumber
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the spotwelds in model m flagged with f, from 1000000: Spotweld.RenumberFlagged(m, f, 1000000);
|
Select(flag[Flag], prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean]) [static]DescriptionAllows the user to select spotwelds using standard PRIMER object menus. |
Flag to use when selecting spotwelds
Text to display as a prompt to the user
If the argument is a Model then only spotwelds from that model can be selected. If the argument is a Flag then only spotwelds that are flagged with limit can be selected (limit should be different to flag). If omitted, or null, any spotwelds 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 spotwelds selected or null if menu cancelled Return typeNumber |
SetFlag(flag[Flag])DescriptionSets a flag on the spotweld. |
Flag to set on the spotweld
ReturnsNo return value |
ExampleTo set flag f for spotweld s: s.SetFlag(f);
|
Sketch(redraw (optional)[boolean])DescriptionSketches the spotweld. The spotweld will be sketched until you either call Spotweld.Unsketch(), Spotweld.UnsketchAll(), Model.UnsketchAll(), or delete the model |
If model should be redrawn or not after the spotweld is sketched. If omitted redraw is true. If you want to sketch several spotwelds and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch spotweld s: s.Sketch();
|
SketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionSketches all of the flagged spotwelds in the model. The spotwelds will be sketched until you either call Spotweld.Unsketch(), Spotweld.UnsketchFlagged(), Model.UnsketchAll(), or delete the model |
Model that all the flagged spotwelds will be sketched in
Flag set on the spotwelds that you want to sketch
If model should be redrawn or not after the spotwelds are sketched. If omitted redraw is true. If you want to sketch flagged spotwelds several times and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch all spotwelds flagged with flag in model m: Spotweld.SketchFlagged(m, flag);
|
Total(Model[Model], exists (optional)[boolean]) [static]DescriptionReturns the total number of spotwelds in the model. |
Model to get total for
true if only existing spotwelds should be counted. If false or omitted referenced but undefined spotwelds will also be included in the total.
Returnsnumber of spotwelds Return typeNumber |
ExampleTo get the total number of spotwelds in model m: var total = Spotweld.Total(m);
|
Unblank()DescriptionUnblanks the spotweld |
No arguments
ReturnsNo return value |
ExampleTo unblank spotweld s: s.Unblank();
|
UnblankAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnblanks all of the spotwelds in the model. |
Model that all spotwelds 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 spotwelds in model m: Spotweld.UnblankAll(m);
|
UnblankFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnblanks all of the flagged spotwelds in the model. |
Model that the flagged spotwelds will be unblanked in
Flag set on the spotwelds 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 spotwelds in model m flagged with f: Spotweld.UnblankFlagged(m, f);
|
UnflagAll(Model[Model], flag[Flag]) [static]DescriptionUnsets a defined flag on all of the spotwelds in the model. |
Model that the defined flag for all spotwelds will be unset in
Flag to unset on the spotwelds
ReturnsNo return value |
ExampleTo unset the flag f on all the spotwelds in model m: Spotweld.UnflagAll(m, f);
|
Unsketch(redraw (optional)[boolean])DescriptionUnsketches the spotweld. |
If model should be redrawn or not after the spotweld is unsketched. If omitted redraw is true. If you want to unsketch several spotwelds and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch spotweld s: s.Unsketch();
|
UnsketchAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnsketches all spotwelds. |
Model that all spotwelds will be unblanked in
If model should be redrawn or not after the spotwelds 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 spotwelds in model m: Spotweld.UnsketchAll(m);
|
UnsketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnsketches all flagged spotwelds in the model. |
Model that all spotwelds will be unsketched in
Flag set on the spotwelds that you want to unsketch
If model should be redrawn or not after the spotwelds 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 spotwelds flagged with flag in model m: Spotweld.UnsketchAll(m, flag);
|
No arguments
ReturnsSpotweld object. Return typeSpotweld |
ExampleTo check if Spotweld property s.example is a parameter by using the Spotweld.GetParameter() method: if (s.ViewParameters().GetParameter(s.example) ) do_something...
|
Warning(message[string], details (optional)[string])DescriptionAdds a warning for spotweld. 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 spotweld s: s.Warning("My custom warning");
|
Xrefs()DescriptionReturns the cross references for this spotweld. |
No arguments
ReturnsXrefs object. Return typeXrefs |
ExampleTo get the cross references for spotweld s: var xrefs = s.Xrefs();
|
toString()DescriptionCreates a string containing the spotweld data in keyword format. Note that this contains the keyword header and the keyword cards. See also Spotweld.Keyword() and Spotweld.KeywordCards(). |
No arguments
Returnsstring Return typeString |
ExampleTo get data for spotweld s in keyword format var str = s.toString();
|