The SubmodelSB object stores the data for a submodel surface based load.
The SubmodelSB object is derived from the Load object.
import load mdb.models[name].loads[name]
This method creates a SubmodelSB object.
mdb.models[name].SubmodelSB
Required arguments
A String specifying the load repository key.
A String specifying the name of the step in which the load is created.
A Region object specifying the region to which the load is applied.
A String specifying the step in the global model from which Abaqus reads the values of the variables that will drive the submodel analysis. The String indicates the position of the step in the sequence of analysis steps. For example, globalStep='1' indicates the first step.
Optional arguments
A String specifying the element set in the global model that will be searched for elements whose responses will be used to drive the submodel. An empty string indicates that the entire global model will be searched. The default value is an empty string.
None or a Float specifying the absolute value by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is None.
None or a Float specifying the fraction of the average element size in the global model by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is 0.05.
An Int specifying the increment number in the global model step from which the solution will be used to specify the values of the driven variables. If globalIncrement=0, the solution from the last increment will be used. The globalIncrement argument is applicable only for linear perturbation steps. The default value is 0.
Return value
A SubmodelSB object.
Exceptions
This method modifies the data for an existing SubmodelSB object in the step where it is created.
Required arguments
Optional arguments
The optional arguments to setValues are the same as the arguments to the SubmodelSB method, except for the name and createStepName arguments.
Return value
Exceptions
This method modifies the propagating data for an existing SubmodelSB object in the specified step.
Required argument
A String specifying the name of the step in which the load is modified.
Optional arguments
A Boolean specifying whether the load should remain fixed at the current values at the start of the step. The default value is ON.
A String specifying the step in the global model from which Abaqus reads the values of the variables that will drive the submodel analysis. The String indicates the position of the step in the sequence of analysis steps. For example, globalStep='1' indicates the first step. The globalStep argument is applicable only if fixed=OFF.
An Int specifying the increment number in the global model step at which the solution will be used to specify the values of the driven variables. If globalIncrement=0, the solution from the last increment will be used. The globalIncrement argument is applicable only for linear perturbation steps and if fixed=OFF. The default value is 0.
Return value
Exceptions
The SubmodelSB object can have the following members:
A String specifying the load repository key.
None or a Float specifying the absolute value by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is None.
None or a Float specifying the fraction of the average element size in the global model by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is 0.05.
A String specifying the element set in the global model that will be searched for elements whose responses will be used to drive the submodel. An empty string indicates that the entire global model will be searched. The default value is an empty string.
A Region object specifying the region to which the load is applied.