Main Content

clearInitialGuessVariables

Drop all guess variables from the KinematicsSolver object

Description

clearInitialGuessVariables(ks) drops all guess variables from the KinematicsSolver object ks. Guess variables bias the solver toward one of equally plausible solutions when several exist. Use this function if none of the guess variables are any longer relevant—for example, before formulating a new kinematic problem for the same multibody model using other guess variables. Guess variables are optional but important solver guides in some kinematic problems.

The figure shows the variables of a general KinematicsSolver object. Target (T), guess (G), and output (O) variables can be joint variables (J) or frame variables (F). The same variable can serve as guess and output, but if it serves as target, it cannot double as guess. Assigning a guess variable as target clears it as guess.

Input Arguments

collapse all

A KinematicsSolver object is the representation of a Simscape Multibody model used for kinematic analysis.

Example: ks = simscape.multibody.KinematicsSolver('sm_double_pendulum')

Data Types: KinematicsSolver object

Introduced in R2019a