clearFrameVariables

Drop all frame variables from the KinematicsSolver object

Description

clearFrameVariables(ks) drops all frame variables from the KinematicsSolver object ks. Frame variables capture the transforms between any two given frames. Use this object function if none of the frame variables are any longer relevant—for example, before formulating a new kinematic problem for the same multibody model using other frame variables.

Frame and joint variables comprise the whole of kinematic variables in a KinematicsSolver object. They can function as targets to constrain the multibody configuration for which to solve the unknowns, as guesses to bias the solution toward one of equally plausible alternatives when several exist, and as outputs—the unknowns in the analysis.

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). Joint variables are native to the object and can be assigned from its start as targets, guesses, and outputs. Frame variables must first be created with addFrameVariables.

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