=========================================== MotionAnalysisSettings (hwx.inspire.motion) =========================================== Controls how long the motion simulation will run. Some of the settings that can be controlled are: - The number of frames in the results output. - The type of analysis. - Includes gravity. Inherits: - :ref:`MotionObject (hwx.inspire.motion)` ---------- Attributes ---------- +--------------------------------+--------------------------------+--------------------------------+ | active_: Bool | activeContactIteration_: Bool | addFreeJoints_: Bool | +--------------------------------+--------------------------------+--------------------------------+ | addGravity_: Bool | addMotionContacts_: Bool | addRequests_: Enum | +--------------------------------+--------------------------------+--------------------------------+ | addSensors_: Enum | analysisType_: Enum | animate_: Enum | +--------------------------------+--------------------------------+--------------------------------+ | animationFile_: Enum | bushingC_: Double | bushingCT_: Double | +--------------------------------+--------------------------------+--------------------------------+ | bushingK_: Double | bushingKT_: Double | bushing_calculateRates_: Bool | +--------------------------------+--------------------------------+--------------------------------+ | combineGround_: Bool | contactType_: Enum | cutoffFrequency_: Bool | +--------------------------------+--------------------------------+--------------------------------+ | cutoffFrequencyValue_: Double | debugPrint_: Bool | disableDamping_: Bool | +--------------------------------+--------------------------------+--------------------------------+ | domain_: Enum | eigenSolution_: Bool | endTime_: Double | +--------------------------------+--------------------------------+--------------------------------+ | implicitType_: Enum | integratorDaeIndex_: Enum | integratorError_: Double | +--------------------------------+--------------------------------+--------------------------------+ | integratorHmax_: Double | integratorKmax_: Int | jointType_: Enum | +--------------------------------+--------------------------------+--------------------------------+ | keepContactForceResults_: Enum | logFiles_: Enum | name_: Attribute | +--------------------------------+--------------------------------+--------------------------------+ | outputRate_: Double | requestFrame_: Enum | sensorError_: Double | +--------------------------------+--------------------------------+--------------------------------+ | sensorValue_: Double | stateSpaceMatrix_: Bool | storeResults_: Bool | +--------------------------------+--------------------------------+--------------------------------+ | supportType_: Enum | visible_: Bool | writeEnergyDistrib_: Bool | +--------------------------------+--------------------------------+--------------------------------+ ---------- Properties ---------- +--------------------+--------------------+--------------------+ | addAllSensors_ | addJointSensors_ | flexibleContacts_ | +--------------------+--------------------+--------------------+ | flexibleFasteners_ | flexibleImplicits_ | flexibleJoints_ | +--------------------+--------------------+--------------------+ | flexibleSupports_ | outputInterval_ | virtualContacts_ | +--------------------+--------------------+--------------------+ | virtualImplicits_ | virtualJoints_ | virtualSupports_ | +--------------------+--------------------+--------------------+ -------------- Public Methods -------------- +-----------------------------+ | addRequestsFor_ (self, obj) | +-----------------------------+ ----------------- Attribute Details ----------------- .. _active: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ active : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Returns or sets the object activeness. Setting this on or off sets all children. Setting to True sets all the parents active too. .. _activeContactIteration: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ activeContactIteration : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Controls the contact force evaluation during corrector iterations. .. _addFreeJoints: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ addFreeJoints : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies whether to include free joints from the motion analysis. .. _addGravity: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ addGravity : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies whether to include gravity from the motion analysis. .. _addMotionContacts: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ addMotionContacts : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies whether to include motion contacts from the motion analysis. .. _addRequests: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ addRequests : :ref:`Enum ` (all, notparts, measuresonly, none) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies options to create analysis results used for plotting. The options can be "All", "Exclude for parts", "Measures only" or "None". .. _addSensors: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ addSensors : :ref:`Enum ` (all, notjoints, none) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Provides options for what modeling checking sensors are in effect. The options can be "All", "Exclude joint deformation", "None". .. _analysisType: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ analysisType : :ref:`Enum ` (TRANSIENT, STATICS, ASSEMBLY, STATICS+TRANSIENT) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies what type of motion analysis to perform. A motion analysis can be either be Assembly, Transient, Static, or Statics+Transient. - Transient analysis is used to include dynamic effects in a time-dependent motion simulation. Enable ***Start at equilibrium*** to begin from an equilibrium solution first. - Statics analysis is used to determine the static equilibrium position of your mechanism. For this analysis type, all velocity and damping terms are ignored. This helps you analyze the loading without including dynamic effects. .. _animate: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ animate : :ref:`Enum ` (solving, finished) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies when to animate the model. The options to animate are "While Solving", "When Finished". .. _animationFile: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ animationFile : :ref:`Enum ` (auto, all, notcontact, none) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the options to generate H3D files containing all motion analysis data. The options can be "Auto", "Include all data", "Exclude contact data" or "None". .. _bushingC: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ bushingC : :ref:`Double ` (units="damping") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the damping rate. .. _bushingCT: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ bushingCT : :ref:`Double ` (units="torsion_damping") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the torsional damping rate. .. _bushingK: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ bushingK : :ref:`Double ` (units="stiffness") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the stiffness rate. .. _bushingKT: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ bushingKT : :ref:`Double ` (units="torsion_stiffness") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the torsional stiffness rate. .. _bushing_calculateRates: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ bushing_calculateRates : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ By default, the global rates (below) are determined automatically. Disable this option to enter your own rates. .. _combineGround: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ combineGround : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies whether to combine ground parts. .. _contactType: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ contactType : :ref:`Enum ` (rigid, flexible, virtual) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Used to override the default behavior of the contact based joint, during motion analysis. The behaviors can be "Rigid", "Flexible" or "Virtual". Defaults to Flexible. .. _cutoffFrequency: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ cutoffFrequency : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies whether to use cut off frequency. .. _cutoffFrequencyValue: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ cutoffFrequencyValue : :ref:`Double ` (units="frequency") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the value of cut off frquency. .. _debugPrint: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ debugPrint : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _disableDamping: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ disableDamping : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Disables damping if set to True, defaults to False. .. _domain: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ domain : :ref:`Enum ` (TIME_DOMAIN, LINEAR) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies what domain does the motion analysis should follow. They can be of type - Time Domain - Linear .. _eigenSolution: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ eigenSolution : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies whether to use Eigen solution. .. _endTime: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ endTime : :ref:`Double ` (units="time") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The end time indicates how long the motion simulation should run. .. _implicitType: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ implicitType : :ref:`Enum ` (rigid, flexible, virtual) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Used to override the default behavior of the implicit joint, during motion analysis. The behaviors can be "Rigid", "Flexible" or "Virtual". Defaults to Rigid. .. _integratorDaeIndex: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ integratorDaeIndex : :ref:`Enum ` (i3, si1) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the DAE formulation to use within the solver. They can be of type 'I3' and 'SI1'. - 'I3' is faster but can be slightly inaccurate - 'SI1' is very accurate, but can be somewhat slower. .. _integratorError: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ integratorError : :ref:`Double ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This tolerance represents the maximum absolute error per integrator step. .. _integratorHmax: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ integratorHmax : :ref:`Double ` (units="time") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The maximum step size the integrator is allowed to take. .. _integratorKmax: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ integratorKmax : :ref:`Int ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This is the maximum order that the integrator can take. The default value is 5, higher orders lead to higher accuracy, but lower stability. .. _jointType: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ jointType : :ref:`Enum ` (rigid, flexible, virtual) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Used to override the default behavior of the joint, during motion analysis. The behaviors can be "Rigid", "Flexible" or "Virtual". Defaults to Flexible. - Flexible, joints behave as a linear bushing model. - Rigid, joints are idealized and do not deform. - Virtual, it is very similar to a rigid joint, but with "soft constraint" behavior. .. _keepContactForceResults: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ keepContactForceResults : :ref:`Enum ` (all, region, none) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies what contact force data to be saved in the model. .. _logFiles: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ logFiles : :ref:`Enum ` (keep, discard) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies what options to choose to log the Motion analysis related files after a run. The options could be "Keep" and "Discard". - Select 'Keep' to retain motion-related solver files from runs. - Select 'Discard' to automatically delete the files after a run. .. _name: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ name : :ref:`Attribute ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Returns or sets the name of the object. It can be any text string, including spaces, although it's best to avoid using the following characters: " ' * ? and $. While these characters are allowed, they could create difficulties when you export the model to other applications. .. _outputRate: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ outputRate : :ref:`Double ` (units="frequency") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The output rate controls the number of frames in the results output. Larger numbers give smoother, continuous results, but will animate more slowly. .. _requestFrame: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ requestFrame : :ref:`Enum ` (global, i, j) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies options for what reference frame to use. Used for plotting. The options can be "Global", "Local to 1st part", "Local to 2nd part". .. _sensorError: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ sensorError : :ref:`Double ` (units="length") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the sensor error offset value. Defaults to '1e-5'. .. _sensorValue: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ sensorValue : :ref:`Double ` (units="length") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the sensor value. Defaults to '1e-3'. .. _stateSpaceMatrix: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ stateSpaceMatrix : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies whether to use state space matrix. .. _storeResults: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ storeResults : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Allows to store the motion analysis results in the model stmod file. Turning this option off will reduce the size of the model file. .. _supportType: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ supportType : :ref:`Enum ` (rigid, flexible, virtual) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Used to override the default behavior of the supports, during motion analysis. The behaviors can be "Rigid", "Flexible" or "Virtual". Defaults to Rigid. .. _visible: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ visible : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Determines whether the object is visible in the modeling window. Setting this on or off sets all children. Setting to True sets all the parents visible too. .. _writeEnergyDistrib: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ writeEnergyDistrib : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies whether to write energy distribution. ---------------- Property Details ---------------- .. _addAllSensors: .. method:: addAllSensors Specifies if the add sensors are not set to None. .. _addJointSensors: .. method:: addJointSensors Specifies if the add sensors are set to All. .. _flexibleContacts: .. method:: flexibleContacts Specifies if the contact type is set to Flexible. .. _flexibleFasteners: .. method:: flexibleFasteners Specifies if the fasteners type is set to Flexible. .. _flexibleImplicits: .. method:: flexibleImplicits Specifies if the joint type is set to Flexible. .. _flexibleJoints: .. method:: flexibleJoints Specifies if the joint type is set to Flexible. .. _flexibleSupports: .. method:: flexibleSupports Specifies if the support type is set to Flexible. .. _outputInterval: .. method:: outputInterval Returns the fraction of the output rate. .. _virtualContacts: .. method:: virtualContacts Specifies if the contact type is set to Virtual. .. _virtualImplicits: .. method:: virtualImplicits Specifies if the implicit joint type is set to Virtual. .. _virtualJoints: .. method:: virtualJoints Specifies if the joint type is set to Virtual. .. _virtualSupports: .. method:: virtualSupports Specifies if the support type is set to Virtual. -------------- Method Details -------------- .. _addRequestsFor: .. method:: addRequestsFor(self, obj) Validates if the specified object request are added. :param obj: Object for which the validation requests are added. :type obj: Named :returns: True if the validation is successful, False otherwise. :rtype: bool