The SensorControl class gives you access to *SENSOR_CONTROL keyword 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 |
| cntlid | integer | SensorControl number. The label property is an alternative name for this. |
| defcv | real/string | Default curve value when a curve is not active for TYPE = CURVE only. If DEFCRV = "LASTSTEP", the curve value right before the curve is turned off becomes the default curve value. |
| estyp | string | Element Set Type to be controlled. Can be "BEAM", "DISC", "SHELL", "SOLID", "TSHELL". |
| exists (read only) | logical | true if *SENSOR_CONTROL exists, false if referred to but not defined. |
| include | integer | The Include file number that the *SENSOR_CONTROL is in. |
| initstt | string | Initial status. Can be "On" or "Off". |
| label | integer | SensorControl number. The cntlid property is an alternative name for this. |
| model (read only) | integer | The Model number that the *SENSOR_CONTROL is in. |
| nrep | integer | Number of repeat of cycle of switches. |
| swit1 | integer | ID of 1st switch. |
| swit2 | integer | ID of 2nd switch. |
| swit3 | integer | ID of 3rd switch. |
| swit4 | integer | ID of 4th switch. |
| swit5 | integer | ID of 5th switch. |
| swit6 | integer | ID of 6th switch. |
| swit7 | integer | ID of 7th switch. |
| timeoff | integer | Flag for offset of time in curve. |
| timeoff/idiscl | integer | Flag for offset of time in curve./Flag for the reference length of the discrete element |
| type | string | Entity to be controlled. Can be "AIRBAG", "BAGVENTPOP", "BELTPRET", "BELTRETRA", "BELTSLIP", "CONTACT", "CONTACT2D", "CNRB", "DEF2RIG", "DISC-ELE", "DISC-ELES", "ELESET", "FUNCTION", "JOINT", "JOINTSTIFF", "LOADTHM", "M PRESSURE", "RWALL", "SPC", "SPOTWELD". |
| typeid | integer | ID of entity to be controlled if type is not FUNCTION or input value for FUNCTION. |
Detailed DescriptionThe SensorControl class allows you to create, modify, edit and manipulate *SENSOR_CONTROL. See the documentation below for more details. |
Constructornew SensorControl(Model[Model], Sensor control ID[integer], Type[string], Type ID (optional)[integer], estyp (optional)[string])DescriptionCreate a new SensorControl object. |
Model that *SENSOR_CONTROL will be created in
SensorControl id.
Entity type to be controlled. Can be "AIRBAG", "BAGVENTPOP", "BELTPRET", "BELTRETRA", "BELTSLIP", "CONTACT", "CONTACT2D", "DEF2RIG", "CURVE", "DISC-ELE", "DISC-ELES", "ELESET", "FUNCTION", "JOINT", "JOINTSTIFF", "M PRESSURE", "RWALL", "SPC", "SPOTWELD".
ID of entity to be controlled if type is not FUNCTION or input value for FUNCTION.
Element Set Type to be controlled. Can be "BEAM", "DISC", "SHELL", "SOLID", "TSHELL". Required only if Type argument is "ELESET".
ReturnsSensorControl object Return typeSensorControl |
ExampleTo create a new *SENSOR_CONTROL in model m with label 100 and type JOINT: var sc = new SensorControl(m, 100, "JOINT");
|
Details of functionsAssociateComment(Comment[Comment])DescriptionAssociates a comment with a *SENSOR_CONTROL. |
Comment that will be attached to the *SENSOR_CONTROL
ReturnsNo return value |
ExampleTo associate comment c to the *SENSOR_CONTROL sc: sc.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 *SENSOR_CONTROL sc: sc.Browse();
|
ClearFlag(flag[Flag])DescriptionClears a flag on the *SENSOR_CONTROL. |
Flag to clear on the *SENSOR_CONTROL
ReturnsNo return value |
ExampleTo clear flag f for *SENSOR_CONTROL sc: sc.ClearFlag(f);
|
Copy(range (optional)[boolean])DescriptionCopies the *SENSOR_CONTROL. The target include of the copied *SENSOR_CONTROL 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().
ReturnsSensorControl object Return typeSensorControl |
ExampleTo copy *SENSOR_CONTROL sc into *SENSOR_CONTROL z: var z = sc.Copy();
|
Create(Model[Model], modal (optional)[boolean]) [static]DescriptionStarts an interactive editing panel to create a *SENSOR_CONTROL |
Model that the *SENSOR_CONTROL 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.
ReturnsSensorControl object (or null if not made). Return typeSensorControl |
ExampleTo start creating a *SENSOR_CONTROL in model m: var sc = SensorControl.Create(m);
|
DetachComment(Comment[Comment])DescriptionDetaches a comment from a *SENSOR_CONTROL. |
Comment that will be detached from the *SENSOR_CONTROL
ReturnsNo return value |
ExampleTo detach comment c from the *SENSOR_CONTROL sc: sc.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 *SENSOR_CONTROL sc: sc.Edit();
|
Error(message[string], details (optional)[string])DescriptionAdds an error for *SENSOR_CONTROL. 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 *SENSOR_CONTROL sc: sc.Error("My custom error");
|
First(Model[Model]) [static]DescriptionReturns the first *SENSOR_CONTROL in the model. |
Model to get first *SENSOR_CONTROL in
ReturnsSensorControl object (or null if there are no *SENSOR_CONTROLs in the model). Return typeSensorControl |
ExampleTo get the first *SENSOR_CONTROL in model m: var sc = SensorControl.First(m);
|
FirstFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the first free *SENSOR_CONTROL label in the model. Also see SensorControl.LastFreeLabel(), SensorControl.NextFreeLabel() and Model.FirstFreeItemLabel(). |
Model to get first free *SENSOR_CONTROL 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).
ReturnsSensorControl label. Return typeNumber |
ExampleTo get the first free *SENSOR_CONTROL label in model m: var label = SensorControl.FirstFreeLabel(m);
|
FlagAll(Model[Model], flag[Flag]) [static]DescriptionFlags all of the *SENSOR_CONTROLs in the model with a defined flag. |
Model that all *SENSOR_CONTROLs will be flagged in
Flag to set on the *SENSOR_CONTROLs
ReturnsNo return value |
ExampleTo flag all of the *SENSOR_CONTROLs with flag f in model m: SensorControl.FlagAll(m, f);
|
Flagged(flag[Flag])DescriptionChecks if the *SENSOR_CONTROL is flagged or not. |
Flag to test on the *SENSOR_CONTROL
Returnstrue if flagged, false if not. Return typeBoolean |
ExampleTo check if *SENSOR_CONTROL sc has flag f set on it: if (sc.Flagged(f) ) do_something...
|
ForEach(Model[Model], func[function], extra (optional)[any]) [static]DescriptionCalls a function for each *SENSOR_CONTROL in the model. |
Model that all *SENSOR_CONTROLs are in
Function to call for each *SENSOR_CONTROL
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 SensorControl objects or properties for all of the *SENSOR_CONTROLs in a model in PRIMER. If the optional property argument is not given then an array of SensorControl objects is returned. If the property argument is given, that property value for each *SENSOR_CONTROL is returned in the array instead of a SensorControl object |
Model to get *SENSOR_CONTROLs from
Name for property to get for all *SENSOR_CONTROLs in the model
ReturnsArray of SensorControl objects or properties Return typeArray |
GetComments()DescriptionExtracts the comments associated to a *SENSOR_CONTROL. |
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 *SENSOR_CONTROL sc: var comm_array = sc.GetComments();
|
GetFlagged(Model[Model], flag[Flag], property (optional)[string]) [static]DescriptionReturns an array of SensorControl objects for all of the flagged *SENSOR_CONTROLs in a model in PRIMER If the optional property argument is not given then an array of SensorControl objects is returned. If the property argument is given, then that property value for each *SENSOR_CONTROL is returned in the array instead of a SensorControl object |
Model to get *SENSOR_CONTROLs from
Flag set on the *SENSOR_CONTROLs that you want to retrieve
Name for property to get for all flagged *SENSOR_CONTROLs in the model
ReturnsArray of SensorControl objects or properties Return typeArray |
GetFromID(Model[Model], number[integer]) [static]DescriptionReturns the SensorControl object for a *SENSOR_CONTROL ID. |
Model to find the *SENSOR_CONTROL in
number of the *SENSOR_CONTROL you want the SensorControl object for
ReturnsSensorControl object (or null if *SENSOR_CONTROL does not exist). Return typeSensorControl |
ExampleTo get the SensorControl object for *SENSOR_CONTROL 100 in model m var sc = SensorControl.GetFromID(m, 100);
|
GetParameter(prop[string])DescriptionChecks if a SensorControl 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 SensorControl.ViewParameters() method and 'method chaining' (see the examples below). |
*SENSOR_CONTROL property to get parameter for
ReturnsParameter object if property is a parameter, null if not. Return typeParameter |
Keyword()DescriptionReturns the keyword for this *SENSOR_CONTROL. Note that a carriage return is not added. See also SensorControl.KeywordCards() |
No arguments
Returnsstring containing the keyword. Return typeString |
ExampleTo get the keyword for SensorControl sc: var key = sc.Keyword();
|
KeywordCards()DescriptionReturns the keyword cards for the *SENSOR_CONTROL. Note that a carriage return is not added. See also SensorControl.Keyword() |
No arguments
Returnsstring containing the cards. Return typeString |
ExampleTo get the cards for sensor control sc: var cards = sc.KeywordCards();
|
Last(Model[Model]) [static]DescriptionReturns the last *SENSOR_CONTROL in the model. |
Model to get last *SENSOR_CONTROL in
ReturnsSensorControl object (or null if there are no *SENSOR_CONTROLs in the model). Return typeSensorControl |
ExampleTo get the last *SENSOR_CONTROL in model m: var sc = SensorControl.Last(m);
|
LastFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the last free *SENSOR_CONTROL label in the model. Also see SensorControl.FirstFreeLabel(), SensorControl.NextFreeLabel() and see Model.LastFreeItemLabel() |
Model to get last free *SENSOR_CONTROL 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.
ReturnsSensorControl label. Return typeNumber |
ExampleTo get the last free *SENSOR_CONTROL label in model m: var label = SensorControl.LastFreeLabel(m);
|
Next()DescriptionReturns the next *SENSOR_CONTROL in the model. |
No arguments
ReturnsSensorControl object (or null if there are no more *SENSOR_CONTROLs in the model). Return typeSensorControl |
ExampleTo get the *SENSOR_CONTROL in model m after *SENSOR_CONTROL sc: var sc = sc.Next();
|
NextFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the next free (highest+1) *SENSOR_CONTROL label in the model. Also see SensorControl.FirstFreeLabel(), SensorControl.LastFreeLabel() and Model.NextFreeItemLabel() |
Model to get next free *SENSOR_CONTROL 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).
ReturnsSensorControl label. Return typeNumber |
ExampleTo get the next free *SENSOR_CONTROL label in model m: var label = SensorControl.NextFreeLabel(m);
|
Previous()DescriptionReturns the previous *SENSOR_CONTROL in the model. |
No arguments
ReturnsSensorControl object (or null if there are no more *SENSOR_CONTROLs in the model). Return typeSensorControl |
ExampleTo get the *SENSOR_CONTROL in model m before *SENSOR_CONTROL sc: var sc = sc.Previous();
|
RenumberAll(Model[Model], start[integer]) [static]DescriptionRenumbers all of the *SENSOR_CONTROLs in the model. |
Model that all *SENSOR_CONTROLs will be renumbered in
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the *SENSOR_CONTROLs in model m, from 1000000: SensorControl.RenumberAll(m, 1000000);
|
RenumberFlagged(Model[Model], flag[Flag], start[integer]) [static]DescriptionRenumbers all of the flagged *SENSOR_CONTROLs in the model. |
Model that all the flagged *SENSOR_CONTROLs will be renumbered in
Flag set on the *SENSOR_CONTROLs that you want to renumber
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the *SENSOR_CONTROLs in model m flagged with f, from 1000000: SensorControl.RenumberFlagged(m, f, 1000000);
|
Select(flag[Flag], prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean]) [static]DescriptionAllows the user to select *SENSOR_CONTROLs using standard PRIMER object menus. |
Flag to use when selecting *SENSOR_CONTROLs
Text to display as a prompt to the user
If the argument is a Model then only *SENSOR_CONTROLs from that model can be selected. If the argument is a Flag then only *SENSOR_CONTROLs that are flagged with limit can be selected (limit should be different to flag). If omitted, or null, any *SENSOR_CONTROLs 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 *SENSOR_CONTROLs selected or null if menu cancelled Return typeNumber |
SetFlag(flag[Flag])DescriptionSets a flag on the *SENSOR_CONTROL. |
Flag to set on the *SENSOR_CONTROL
ReturnsNo return value |
ExampleTo set flag f for *SENSOR_CONTROL sc: sc.SetFlag(f);
|
Sketch(redraw (optional)[boolean])DescriptionSketches the *SENSOR_CONTROL. The *SENSOR_CONTROL will be sketched until you either call SensorControl.Unsketch(), SensorControl.UnsketchAll(), Model.UnsketchAll(), or delete the model |
If model should be redrawn or not after the *SENSOR_CONTROL is sketched. If omitted redraw is true. If you want to sketch several *SENSOR_CONTROLs and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch *SENSOR_CONTROL sc: sc.Sketch();
|
SketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionSketches all of the flagged *SENSOR_CONTROLs in the model. The *SENSOR_CONTROLs will be sketched until you either call SensorControl.Unsketch(), SensorControl.UnsketchFlagged(), Model.UnsketchAll(), or delete the model |
Model that all the flagged *SENSOR_CONTROLs will be sketched in
Flag set on the *SENSOR_CONTROLs that you want to sketch
If model should be redrawn or not after the *SENSOR_CONTROLs are sketched. If omitted redraw is true. If you want to sketch flagged *SENSOR_CONTROLs several times and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch all *SENSOR_CONTROLs flagged with flag in model m: SensorControl.SketchFlagged(m, flag);
|
Total(Model[Model], exists (optional)[boolean]) [static]DescriptionReturns the total number of *SENSOR_CONTROLs in the model. |
Model to get total for
true if only existing *SENSOR_CONTROLs should be counted. If false or omitted referenced but undefined *SENSOR_CONTROLs will also be included in the total.
Returnsnumber of *SENSOR_CONTROLs Return typeNumber |
ExampleTo get the total number of *SENSOR_CONTROLs in model m: var total = SensorControl.Total(m);
|
UnflagAll(Model[Model], flag[Flag]) [static]DescriptionUnsets a defined flag on all of the *SENSOR_CONTROLs in the model. |
Model that the defined flag for all *SENSOR_CONTROLs will be unset in
Flag to unset on the *SENSOR_CONTROLs
ReturnsNo return value |
ExampleTo unset the flag f on all the *SENSOR_CONTROLs in model m: SensorControl.UnflagAll(m, f);
|
Unsketch(redraw (optional)[boolean])DescriptionUnsketches the *SENSOR_CONTROL. |
If model should be redrawn or not after the *SENSOR_CONTROL is unsketched. If omitted redraw is true. If you want to unsketch several *SENSOR_CONTROLs and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch *SENSOR_CONTROL sc: sc.Unsketch();
|
UnsketchAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnsketches all *SENSOR_CONTROLs. |
Model that all *SENSOR_CONTROLs will be unblanked in
If model should be redrawn or not after the *SENSOR_CONTROLs 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 *SENSOR_CONTROLs in model m: SensorControl.UnsketchAll(m);
|
UnsketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnsketches all flagged *SENSOR_CONTROLs in the model. |
Model that all *SENSOR_CONTROLs will be unsketched in
Flag set on the *SENSOR_CONTROLs that you want to unsketch
If model should be redrawn or not after the *SENSOR_CONTROLs 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 *SENSOR_CONTROLs flagged with flag in model m: SensorControl.UnsketchAll(m, flag);
|
No arguments
ReturnsSensorControl object. Return typeSensorControl |
ExampleTo check if SensorControl property sc.example is a parameter by using the SensorControl.GetParameter() method: if (sc.ViewParameters().GetParameter(sc.example) ) do_something...
|
Warning(message[string], details (optional)[string])DescriptionAdds a warning for *SENSOR_CONTROL. 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 *SENSOR_CONTROL sc: sc.Warning("My custom warning");
|
Xrefs()DescriptionReturns the cross references for this *SENSOR_CONTROL. |
No arguments
ReturnsXrefs object. Return typeXrefs |
ExampleTo get the cross references for *SENSOR_CONTROL sc: var xrefs = sc.Xrefs();
|
toString()DescriptionCreates a string containing the sensor control data in keyword format. Note that this contains the keyword header and the keyword cards. See also SensorControl.Keyword() and SensorControl.KeywordCards(). |
No arguments
Returnsstring Return typeString |
ExampleTo get data for sensor control sc in keyword format var str = sc.toString();
|