Run kinematic analysis for KinematicsSolver object
solves, or attempts to solve, the kinematic problem posed in the
targets] = solve(
ks. The unknowns are the variables assigned as outputs in
ks. Their solution hinges on the initial position constraints of the
model and on the position targets of the object. When multiple solutions exist, position
guesses bias the solver toward one over the others.
ks— KinematicsSolver object for which to run the analysis
Name of the
KinematicsSolver object for
which to run the analysis. The object is a kinematic representation of the model from
which it derives. It contains the variables upon which the analysis depends.
targets— Desired values of target variables
Desired values of the target variables of
ks. Specify the
values in the order of the variables as shown in the
targetVariables table. The
values are interpreted in the units listed in the table. If no target variables exist,
enter an empty vector. If neither target nor initial guess variables exist, enter an
empty vector or omit the argument altogether.
Example: '[0 45 30]'
initialGuesses— Values of initial guess variables
Values of the initial guess variables of
ks. Specify the values
in the order of the variables as shown in the
initialGuessVariables table. The
values are interpreted in the units listed in that table. If no initial guess variables
exist, enter an empty vector or omit the argument altogether.
Example: '[10 25]'
outputs— Computed values of output variables
Computed values of the output variables. The variables show in the order of their
ranking in the
outputVariables table. They are
each in the units listed there.
The solution may not satisfy all position targets or even all model constraints.
statusFlag argument for an overview of the issues
encountered in the solution.
statusFlag— Flag with overall status of solution
Flag with the overall status of the analysis results. A positive flag means that all
target variables and model constraints have been satisfied. A negative flag means that
one or more have not. See the
targetFlags argument to check which
of the targets the solver may have missed. See the
to see the actual values reached for each.
All model constraints and target variables are satisfied.
All model constraints and target variables are satisfied. A joint or belt-cable network may be in a singular configuration, however—due to gimbal lock in the former or a zero belt-cable length between pulleys in the latter.
All model constraints are satisfied, but one or more target variables are not.
All model constraints are satisfied, but one or more target variables are not. At least one joint or belt-cable network is in a singular configuration—due to gimbal lock in the former or a zero belt-cable length between pulleys in the latter.
One or more model constraints cannot be satisfied. The solution is invalid. The
output variables are
targetFlags— Logical flags with status of each target variable
Logical flags with the status of each target variable. A logical
1 indicates that a target has been satisfied. A logical
0 indicates that it has been missed. The flags show in the order
given in the
targetVariables table of the
object. The vector is empty in kinematic problems without target variables.
targets— Computed values of target variables