1223 lines
		
	
	
		
			59 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
			
		
		
	
	
			1223 lines
		
	
	
		
			59 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
<?xml version="1.0" encoding="utf-8"?>
 | 
						|
<?xml version="1.0" encoding="utf-8"?>
 | 
						|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
 | 
						|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 | 
						|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
 | 
						|
<head>
 | 
						|
<!-- 2020-01-22 mer. 11:35 -->
 | 
						|
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 | 
						|
<meta name="viewport" content="width=device-width, initial-scale=1" />
 | 
						|
<title>Stewart Platform - Simscape Model</title>
 | 
						|
<meta name="generator" content="Org mode" />
 | 
						|
<meta name="author" content="Dehaeze Thomas" />
 | 
						|
<style type="text/css">
 | 
						|
 <!--/*--><![CDATA[/*><!--*/
 | 
						|
  .title  { text-align: center;
 | 
						|
             margin-bottom: .2em; }
 | 
						|
  .subtitle { text-align: center;
 | 
						|
              font-size: medium;
 | 
						|
              font-weight: bold;
 | 
						|
              margin-top:0; }
 | 
						|
  .todo   { font-family: monospace; color: red; }
 | 
						|
  .done   { font-family: monospace; color: green; }
 | 
						|
  .priority { font-family: monospace; color: orange; }
 | 
						|
  .tag    { background-color: #eee; font-family: monospace;
 | 
						|
            padding: 2px; font-size: 80%; font-weight: normal; }
 | 
						|
  .timestamp { color: #bebebe; }
 | 
						|
  .timestamp-kwd { color: #5f9ea0; }
 | 
						|
  .org-right  { margin-left: auto; margin-right: 0px;  text-align: right; }
 | 
						|
  .org-left   { margin-left: 0px;  margin-right: auto; text-align: left; }
 | 
						|
  .org-center { margin-left: auto; margin-right: auto; text-align: center; }
 | 
						|
  .underline { text-decoration: underline; }
 | 
						|
  #postamble p, #preamble p { font-size: 90%; margin: .2em; }
 | 
						|
  p.verse { margin-left: 3%; }
 | 
						|
  pre {
 | 
						|
    border: 1px solid #ccc;
 | 
						|
    box-shadow: 3px 3px 3px #eee;
 | 
						|
    padding: 8pt;
 | 
						|
    font-family: monospace;
 | 
						|
    overflow: auto;
 | 
						|
    margin: 1.2em;
 | 
						|
  }
 | 
						|
  pre.src {
 | 
						|
    position: relative;
 | 
						|
    overflow: visible;
 | 
						|
    padding-top: 1.2em;
 | 
						|
  }
 | 
						|
  pre.src:before {
 | 
						|
    display: none;
 | 
						|
    position: absolute;
 | 
						|
    background-color: white;
 | 
						|
    top: -10px;
 | 
						|
    right: 10px;
 | 
						|
    padding: 3px;
 | 
						|
    border: 1px solid black;
 | 
						|
  }
 | 
						|
  pre.src:hover:before { display: inline;}
 | 
						|
  /* Languages per Org manual */
 | 
						|
  pre.src-asymptote:before { content: 'Asymptote'; }
 | 
						|
  pre.src-awk:before { content: 'Awk'; }
 | 
						|
  pre.src-C:before { content: 'C'; }
 | 
						|
  /* pre.src-C++ doesn't work in CSS */
 | 
						|
  pre.src-clojure:before { content: 'Clojure'; }
 | 
						|
  pre.src-css:before { content: 'CSS'; }
 | 
						|
  pre.src-D:before { content: 'D'; }
 | 
						|
  pre.src-ditaa:before { content: 'ditaa'; }
 | 
						|
  pre.src-dot:before { content: 'Graphviz'; }
 | 
						|
  pre.src-calc:before { content: 'Emacs Calc'; }
 | 
						|
  pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
 | 
						|
  pre.src-fortran:before { content: 'Fortran'; }
 | 
						|
  pre.src-gnuplot:before { content: 'gnuplot'; }
 | 
						|
  pre.src-haskell:before { content: 'Haskell'; }
 | 
						|
  pre.src-hledger:before { content: 'hledger'; }
 | 
						|
  pre.src-java:before { content: 'Java'; }
 | 
						|
  pre.src-js:before { content: 'Javascript'; }
 | 
						|
  pre.src-latex:before { content: 'LaTeX'; }
 | 
						|
  pre.src-ledger:before { content: 'Ledger'; }
 | 
						|
  pre.src-lisp:before { content: 'Lisp'; }
 | 
						|
  pre.src-lilypond:before { content: 'Lilypond'; }
 | 
						|
  pre.src-lua:before { content: 'Lua'; }
 | 
						|
  pre.src-matlab:before { content: 'MATLAB'; }
 | 
						|
  pre.src-mscgen:before { content: 'Mscgen'; }
 | 
						|
  pre.src-ocaml:before { content: 'Objective Caml'; }
 | 
						|
  pre.src-octave:before { content: 'Octave'; }
 | 
						|
  pre.src-org:before { content: 'Org mode'; }
 | 
						|
  pre.src-oz:before { content: 'OZ'; }
 | 
						|
  pre.src-plantuml:before { content: 'Plantuml'; }
 | 
						|
  pre.src-processing:before { content: 'Processing.js'; }
 | 
						|
  pre.src-python:before { content: 'Python'; }
 | 
						|
  pre.src-R:before { content: 'R'; }
 | 
						|
  pre.src-ruby:before { content: 'Ruby'; }
 | 
						|
  pre.src-sass:before { content: 'Sass'; }
 | 
						|
  pre.src-scheme:before { content: 'Scheme'; }
 | 
						|
  pre.src-screen:before { content: 'Gnu Screen'; }
 | 
						|
  pre.src-sed:before { content: 'Sed'; }
 | 
						|
  pre.src-sh:before { content: 'shell'; }
 | 
						|
  pre.src-sql:before { content: 'SQL'; }
 | 
						|
  pre.src-sqlite:before { content: 'SQLite'; }
 | 
						|
  /* additional languages in org.el's org-babel-load-languages alist */
 | 
						|
  pre.src-forth:before { content: 'Forth'; }
 | 
						|
  pre.src-io:before { content: 'IO'; }
 | 
						|
  pre.src-J:before { content: 'J'; }
 | 
						|
  pre.src-makefile:before { content: 'Makefile'; }
 | 
						|
  pre.src-maxima:before { content: 'Maxima'; }
 | 
						|
  pre.src-perl:before { content: 'Perl'; }
 | 
						|
  pre.src-picolisp:before { content: 'Pico Lisp'; }
 | 
						|
  pre.src-scala:before { content: 'Scala'; }
 | 
						|
  pre.src-shell:before { content: 'Shell Script'; }
 | 
						|
  pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
 | 
						|
  /* additional language identifiers per "defun org-babel-execute"
 | 
						|
       in ob-*.el */
 | 
						|
  pre.src-cpp:before  { content: 'C++'; }
 | 
						|
  pre.src-abc:before  { content: 'ABC'; }
 | 
						|
  pre.src-coq:before  { content: 'Coq'; }
 | 
						|
  pre.src-groovy:before  { content: 'Groovy'; }
 | 
						|
  /* additional language identifiers from org-babel-shell-names in
 | 
						|
     ob-shell.el: ob-shell is the only babel language using a lambda to put
 | 
						|
     the execution function name together. */
 | 
						|
  pre.src-bash:before  { content: 'bash'; }
 | 
						|
  pre.src-csh:before  { content: 'csh'; }
 | 
						|
  pre.src-ash:before  { content: 'ash'; }
 | 
						|
  pre.src-dash:before  { content: 'dash'; }
 | 
						|
  pre.src-ksh:before  { content: 'ksh'; }
 | 
						|
  pre.src-mksh:before  { content: 'mksh'; }
 | 
						|
  pre.src-posh:before  { content: 'posh'; }
 | 
						|
  /* Additional Emacs modes also supported by the LaTeX listings package */
 | 
						|
  pre.src-ada:before { content: 'Ada'; }
 | 
						|
  pre.src-asm:before { content: 'Assembler'; }
 | 
						|
  pre.src-caml:before { content: 'Caml'; }
 | 
						|
  pre.src-delphi:before { content: 'Delphi'; }
 | 
						|
  pre.src-html:before { content: 'HTML'; }
 | 
						|
  pre.src-idl:before { content: 'IDL'; }
 | 
						|
  pre.src-mercury:before { content: 'Mercury'; }
 | 
						|
  pre.src-metapost:before { content: 'MetaPost'; }
 | 
						|
  pre.src-modula-2:before { content: 'Modula-2'; }
 | 
						|
  pre.src-pascal:before { content: 'Pascal'; }
 | 
						|
  pre.src-ps:before { content: 'PostScript'; }
 | 
						|
  pre.src-prolog:before { content: 'Prolog'; }
 | 
						|
  pre.src-simula:before { content: 'Simula'; }
 | 
						|
  pre.src-tcl:before { content: 'tcl'; }
 | 
						|
  pre.src-tex:before { content: 'TeX'; }
 | 
						|
  pre.src-plain-tex:before { content: 'Plain TeX'; }
 | 
						|
  pre.src-verilog:before { content: 'Verilog'; }
 | 
						|
  pre.src-vhdl:before { content: 'VHDL'; }
 | 
						|
  pre.src-xml:before { content: 'XML'; }
 | 
						|
  pre.src-nxml:before { content: 'XML'; }
 | 
						|
  /* add a generic configuration mode; LaTeX export needs an additional
 | 
						|
     (add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
 | 
						|
  pre.src-conf:before { content: 'Configuration File'; }
 | 
						|
 | 
						|
  table { border-collapse:collapse; }
 | 
						|
  caption.t-above { caption-side: top; }
 | 
						|
  caption.t-bottom { caption-side: bottom; }
 | 
						|
  td, th { vertical-align:top;  }
 | 
						|
  th.org-right  { text-align: center;  }
 | 
						|
  th.org-left   { text-align: center;   }
 | 
						|
  th.org-center { text-align: center; }
 | 
						|
  td.org-right  { text-align: right;  }
 | 
						|
  td.org-left   { text-align: left;   }
 | 
						|
  td.org-center { text-align: center; }
 | 
						|
  dt { font-weight: bold; }
 | 
						|
  .footpara { display: inline; }
 | 
						|
  .footdef  { margin-bottom: 1em; }
 | 
						|
  .figure { padding: 1em; }
 | 
						|
  .figure p { text-align: center; }
 | 
						|
  .equation-container {
 | 
						|
    display: table;
 | 
						|
    text-align: center;
 | 
						|
    width: 100%;
 | 
						|
  }
 | 
						|
  .equation {
 | 
						|
    vertical-align: middle;
 | 
						|
  }
 | 
						|
  .equation-label {
 | 
						|
    display: table-cell;
 | 
						|
    text-align: right;
 | 
						|
    vertical-align: middle;
 | 
						|
  }
 | 
						|
  .inlinetask {
 | 
						|
    padding: 10px;
 | 
						|
    border: 2px solid gray;
 | 
						|
    margin: 10px;
 | 
						|
    background: #ffffcc;
 | 
						|
  }
 | 
						|
  #org-div-home-and-up
 | 
						|
   { text-align: right; font-size: 70%; white-space: nowrap; }
 | 
						|
  textarea { overflow-x: auto; }
 | 
						|
  .linenr { font-size: smaller }
 | 
						|
  .code-highlighted { background-color: #ffff00; }
 | 
						|
  .org-info-js_info-navigation { border-style: none; }
 | 
						|
  #org-info-js_console-label
 | 
						|
    { font-size: 10px; font-weight: bold; white-space: nowrap; }
 | 
						|
  .org-info-js_search-highlight
 | 
						|
    { background-color: #ffff00; color: #000000; font-weight: bold; }
 | 
						|
  .org-svg { width: 90%; }
 | 
						|
  /*]]>*/-->
 | 
						|
</style>
 | 
						|
<link rel="stylesheet" type="text/css" href="./css/htmlize.css"/>
 | 
						|
<link rel="stylesheet" type="text/css" href="./css/readtheorg.css"/>
 | 
						|
<script src="./js/jquery.min.js"></script>
 | 
						|
<script src="./js/bootstrap.min.js"></script>
 | 
						|
<script src="./js/jquery.stickytableheaders.min.js"></script>
 | 
						|
<script src="./js/readtheorg.js"></script>
 | 
						|
<script type="text/javascript">
 | 
						|
/*
 | 
						|
@licstart  The following is the entire license notice for the
 | 
						|
JavaScript code in this tag.
 | 
						|
 | 
						|
Copyright (C) 2012-2020 Free Software Foundation, Inc.
 | 
						|
 | 
						|
The JavaScript code in this tag is free software: you can
 | 
						|
redistribute it and/or modify it under the terms of the GNU
 | 
						|
General Public License (GNU GPL) as published by the Free Software
 | 
						|
Foundation, either version 3 of the License, or (at your option)
 | 
						|
any later version.  The code is distributed WITHOUT ANY WARRANTY;
 | 
						|
without even the implied warranty of MERCHANTABILITY or FITNESS
 | 
						|
FOR A PARTICULAR PURPOSE.  See the GNU GPL for more details.
 | 
						|
 | 
						|
As additional permission under GNU GPL version 3 section 7, you
 | 
						|
may distribute non-source (e.g., minimized or compacted) forms of
 | 
						|
that code without the copy of the GNU GPL normally required by
 | 
						|
section 4, provided you include this license notice and a URL
 | 
						|
through which recipients can access the Corresponding Source.
 | 
						|
 | 
						|
 | 
						|
@licend  The above is the entire license notice
 | 
						|
for the JavaScript code in this tag.
 | 
						|
*/
 | 
						|
<!--/*--><![CDATA[/*><!--*/
 | 
						|
 function CodeHighlightOn(elem, id)
 | 
						|
 {
 | 
						|
   var target = document.getElementById(id);
 | 
						|
   if(null != target) {
 | 
						|
     elem.cacheClassElem = elem.className;
 | 
						|
     elem.cacheClassTarget = target.className;
 | 
						|
     target.className = "code-highlighted";
 | 
						|
     elem.className   = "code-highlighted";
 | 
						|
   }
 | 
						|
 }
 | 
						|
 function CodeHighlightOff(elem, id)
 | 
						|
 {
 | 
						|
   var target = document.getElementById(id);
 | 
						|
   if(elem.cacheClassElem)
 | 
						|
     elem.className = elem.cacheClassElem;
 | 
						|
   if(elem.cacheClassTarget)
 | 
						|
     target.className = elem.cacheClassTarget;
 | 
						|
 }
 | 
						|
/*]]>*///-->
 | 
						|
</script>
 | 
						|
<script type="text/x-mathjax-config">
 | 
						|
    MathJax.Hub.Config({
 | 
						|
        displayAlign: "center",
 | 
						|
        displayIndent: "0em",
 | 
						|
 | 
						|
        "HTML-CSS": { scale: 100,
 | 
						|
                        linebreaks: { automatic: "false" },
 | 
						|
                        webFont: "TeX"
 | 
						|
                       },
 | 
						|
        SVG: {scale: 100,
 | 
						|
              linebreaks: { automatic: "false" },
 | 
						|
              font: "TeX"},
 | 
						|
        NativeMML: {scale: 100},
 | 
						|
        TeX: { equationNumbers: {autoNumber: "AMS"},
 | 
						|
               MultLineWidth: "85%",
 | 
						|
               TagSide: "right",
 | 
						|
               TagIndent: ".8em",
 | 
						|
               Macros: {
 | 
						|
                 bm: ["{\\boldsymbol #1}",1],
 | 
						|
               }
 | 
						|
             }
 | 
						|
});
 | 
						|
</script>
 | 
						|
<script type="text/javascript"
 | 
						|
        src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS_HTML"></script>
 | 
						|
</head>
 | 
						|
<body>
 | 
						|
<div id="org-div-home-and-up">
 | 
						|
 <a accesskey="h" href="./index.html"> UP </a>
 | 
						|
 |
 | 
						|
 <a accesskey="H" href="./index.html"> HOME </a>
 | 
						|
</div><div id="content">
 | 
						|
<h1 class="title">Stewart Platform - Simscape Model</h1>
 | 
						|
<div id="table-of-contents">
 | 
						|
<h2>Table of Contents</h2>
 | 
						|
<div id="text-table-of-contents">
 | 
						|
<ul>
 | 
						|
<li><a href="#org6f92f51">1. Procedure</a></li>
 | 
						|
<li><a href="#orgf7df3dd">2. Matlab Code</a>
 | 
						|
<ul>
 | 
						|
<li><a href="#org36ddd65">2.1. Simscape Model</a></li>
 | 
						|
<li><a href="#orgfdd5b30">2.2. Test the functions</a></li>
 | 
						|
</ul>
 | 
						|
</li>
 | 
						|
<li><a href="#org9b04ea6">3. <code>initializeFramesPositions</code>: Initialize the positions of frames {A}, {B}, {F} and {M}</a>
 | 
						|
<ul>
 | 
						|
<li><a href="#org12408b9">3.1. Function description</a></li>
 | 
						|
<li><a href="#org65e1007">3.2. Documentation</a></li>
 | 
						|
<li><a href="#org94be80d">3.3. Optional Parameters</a></li>
 | 
						|
<li><a href="#org87eaafa">3.4. Initialize the Stewart structure</a></li>
 | 
						|
<li><a href="#org23ee353">3.5. Compute the position of each frame</a></li>
 | 
						|
</ul>
 | 
						|
</li>
 | 
						|
<li><a href="#org087790f">4. <code>generateCubicConfiguration</code>: Generate a Cubic Configuration</a>
 | 
						|
<ul>
 | 
						|
<li><a href="#org4227245">4.1. Function description</a></li>
 | 
						|
<li><a href="#org0a67b9a">4.2. Documentation</a></li>
 | 
						|
<li><a href="#orgedf8c0c">4.3. Optional Parameters</a></li>
 | 
						|
<li><a href="#org512c9d4">4.4. Position of the Cube</a></li>
 | 
						|
<li><a href="#orgcb8a030">4.5. Compute the pose</a></li>
 | 
						|
</ul>
 | 
						|
</li>
 | 
						|
<li><a href="#org1a639eb">5. <code>generateGeneralConfiguration</code>: Generate a Very General Configuration</a>
 | 
						|
<ul>
 | 
						|
<li><a href="#orgaf38049">5.1. Function description</a></li>
 | 
						|
<li><a href="#org99d670a">5.2. Documentation</a></li>
 | 
						|
<li><a href="#orgb94dd5e">5.3. Optional Parameters</a></li>
 | 
						|
<li><a href="#org217593d">5.4. Compute the pose</a></li>
 | 
						|
</ul>
 | 
						|
</li>
 | 
						|
<li><a href="#org027ac62">6. <code>computeJointsPose</code>: Compute the Pose of the Joints</a>
 | 
						|
<ul>
 | 
						|
<li><a href="#org9851a88">6.1. Function description</a></li>
 | 
						|
<li><a href="#org38475a0">6.2. Documentation</a></li>
 | 
						|
<li><a href="#orgcb68548">6.3. Compute the position of the Joints</a></li>
 | 
						|
<li><a href="#org17b24ef">6.4. Compute the strut length and orientation</a></li>
 | 
						|
<li><a href="#orgdf76376">6.5. Compute the orientation of the Joints</a></li>
 | 
						|
</ul>
 | 
						|
</li>
 | 
						|
<li><a href="#org18a1d1b">7. <code>initializeStrutDynamics</code>: Add Stiffness and Damping properties of each strut</a>
 | 
						|
<ul>
 | 
						|
<li><a href="#orgfdf3d88">7.1. Function description</a></li>
 | 
						|
<li><a href="#orge5e71a3">7.2. Optional Parameters</a></li>
 | 
						|
<li><a href="#org85adb8d">7.3. Add Stiffness and Damping properties of each strut</a></li>
 | 
						|
</ul>
 | 
						|
</li>
 | 
						|
<li><a href="#orgbaa0753">8. <code>computeJacobian</code>: Compute the Jacobian Matrix</a>
 | 
						|
<ul>
 | 
						|
<li><a href="#org7f7fdc1">8.1. Function description</a></li>
 | 
						|
<li><a href="#orgc824a02">8.2. Compute Jacobian Matrix</a></li>
 | 
						|
<li><a href="#org2806583">8.3. Compute Stiffness Matrix</a></li>
 | 
						|
<li><a href="#orgb5560fc">8.4. Compute Compliance Matrix</a></li>
 | 
						|
</ul>
 | 
						|
</li>
 | 
						|
<li><a href="#orgb6aa2e4">9. <code>inverseKinematics</code>: Compute Inverse Kinematics</a>
 | 
						|
<ul>
 | 
						|
<li><a href="#org1abf793">9.1. Function description</a></li>
 | 
						|
<li><a href="#orgae295b6">9.2. Optional Parameters</a></li>
 | 
						|
<li><a href="#orgfd5d40a">9.3. Theory</a></li>
 | 
						|
<li><a href="#orgc7dd5e8">9.4. Compute</a></li>
 | 
						|
</ul>
 | 
						|
</li>
 | 
						|
<li><a href="#org689b179">10. <code>forwardKinematicsApprox</code>: Compute the Forward Kinematics</a>
 | 
						|
<ul>
 | 
						|
<li><a href="#orgba48270">10.1. Function description</a></li>
 | 
						|
<li><a href="#org22e2134">10.2. Optional Parameters</a></li>
 | 
						|
<li><a href="#orgfa57f93">10.3. Computation</a></li>
 | 
						|
</ul>
 | 
						|
</li>
 | 
						|
</ul>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<p>
 | 
						|
Stewart platforms are generated in multiple steps.
 | 
						|
</p>
 | 
						|
 | 
						|
<p>
 | 
						|
We define 4 important <b>frames</b>:
 | 
						|
</p>
 | 
						|
<ul class="org-ul">
 | 
						|
<li>\(\{F\}\): Frame fixed to the <b>Fixed</b> base and located at the center of its bottom surface.
 | 
						|
This is used to fix the Stewart platform to some support.</li>
 | 
						|
<li>\(\{M\}\): Frame fixed to the <b>Moving</b> platform and located at the center of its top surface.
 | 
						|
This is used to place things on top of the Stewart platform.</li>
 | 
						|
<li>\(\{A\}\): Frame fixed to the fixed base.
 | 
						|
It defined the center of rotation of the moving platform.</li>
 | 
						|
<li>\(\{B\}\): Frame fixed to the moving platform.
 | 
						|
The motion of the moving platforms and forces applied to it are defined with respect to this frame \(\{B\}\).</li>
 | 
						|
</ul>
 | 
						|
 | 
						|
<p>
 | 
						|
Then, we define the <b>location of the spherical joints</b>:
 | 
						|
</p>
 | 
						|
<ul class="org-ul">
 | 
						|
<li>\(\bm{a}_{i}\) are the position of the spherical joints fixed to the fixed base</li>
 | 
						|
<li>\(\bm{b}_{i}\) are the position of the spherical joints fixed to the moving platform</li>
 | 
						|
</ul>
 | 
						|
 | 
						|
<p>
 | 
						|
We define the <b>rest position</b> of the Stewart platform:
 | 
						|
</p>
 | 
						|
<ul class="org-ul">
 | 
						|
<li>For simplicity, we suppose that the fixed base and the moving platform are parallel and aligned with the vertical axis at their rest position.</li>
 | 
						|
<li>Thus, to define the rest position of the Stewart platform, we just have to defined its total height \(H\).
 | 
						|
\(H\) corresponds to the distance from the bottom of the fixed base to the top of the moving platform.</li>
 | 
						|
</ul>
 | 
						|
 | 
						|
<p>
 | 
						|
From \(\bm{a}_{i}\) and \(\bm{b}_{i}\), we can determine the <b>length and orientation of each strut</b>:
 | 
						|
</p>
 | 
						|
<ul class="org-ul">
 | 
						|
<li>\(l_{i}\) is the length of the strut</li>
 | 
						|
<li>\({}^{A}\hat{\bm{s}}_{i}\) is the unit vector align with the strut</li>
 | 
						|
</ul>
 | 
						|
 | 
						|
<p>
 | 
						|
The position of the Spherical joints can be computed using various methods:
 | 
						|
</p>
 | 
						|
<ul class="org-ul">
 | 
						|
<li>Cubic configuration</li>
 | 
						|
<li>Circular configuration</li>
 | 
						|
<li>Arbitrary position</li>
 | 
						|
<li>These methods should be easily scriptable and corresponds to specific functions that returns \({}^{F}\bm{a}_{i}\) and \({}^{M}\bm{b}_{i}\).
 | 
						|
The input of these functions are the parameters corresponding to the wanted geometry.</li>
 | 
						|
</ul>
 | 
						|
 | 
						|
<p>
 | 
						|
For Simscape, we need:
 | 
						|
</p>
 | 
						|
<ul class="org-ul">
 | 
						|
<li>The position and orientation of each spherical joint fixed to the fixed base: \({}^{F}\bm{a}_{i}\) and \({}^{F}\bm{R}_{a_{i}}\)</li>
 | 
						|
<li>The position and orientation of each spherical joint fixed to the moving platform: \({}^{M}\bm{b}_{i}\) and \({}^{M}\bm{R}_{b_{i}}\)</li>
 | 
						|
<li>The rest length of each strut: \(l_{i}\)</li>
 | 
						|
<li>The stiffness and damping of each actuator: \(k_{i}\) and \(c_{i}\)</li>
 | 
						|
<li>The position of the frame \(\{A\}\) with respect to the frame \(\{F\}\): \({}^{F}\bm{O}_{A}\)</li>
 | 
						|
<li>The position of the frame \(\{B\}\) with respect to the frame \(\{M\}\): \({}^{M}\bm{O}_{B}\)</li>
 | 
						|
</ul>
 | 
						|
 | 
						|
 | 
						|
<div id="outline-container-org6f92f51" class="outline-2">
 | 
						|
<h2 id="org6f92f51"><span class="section-number-2">1</span> Procedure</h2>
 | 
						|
<div class="outline-text-2" id="text-1">
 | 
						|
<p>
 | 
						|
The procedure to define the Stewart platform is the following:
 | 
						|
</p>
 | 
						|
<ol class="org-ol">
 | 
						|
<li>Define the initial position of frames {A}, {B}, {F} and {M}.
 | 
						|
We do that using the <code>initializeFramesPositions</code> function.
 | 
						|
We have to specify the total height of the Stewart platform \(H\) and the position \({}^{M}O_{B}\) of {B} with respect to {M}.</li>
 | 
						|
<li>Compute the positions of joints \({}^{F}a_{i}\) and \({}^{M}b_{i}\).
 | 
						|
We can do that using various methods depending on the wanted architecture:
 | 
						|
<ul class="org-ul">
 | 
						|
<li><code>generateCubicConfiguration</code> permits to generate a cubic configuration</li>
 | 
						|
</ul></li>
 | 
						|
<li>Compute the position and orientation of the joints with respect to the fixed base and the moving platform.
 | 
						|
This is done with the <code>computeJointsPose</code> function.</li>
 | 
						|
<li>Define the dynamical properties of the Stewart platform.
 | 
						|
The output are the stiffness and damping of each strut \(k_{i}\) and \(c_{i}\).
 | 
						|
This can be done we simply choosing directly the stiffness and damping of each strut.
 | 
						|
The stiffness and damping of each actuator can also be determine from the wanted stiffness of the Stewart platform for instance.</li>
 | 
						|
<li>Define the mass and inertia of each element of the Stewart platform.</li>
 | 
						|
</ol>
 | 
						|
 | 
						|
<p>
 | 
						|
By following this procedure, we obtain a Matlab structure <code>stewart</code> that contains all the information for the Simscape model and for further analysis.
 | 
						|
</p>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgf7df3dd" class="outline-2">
 | 
						|
<h2 id="orgf7df3dd"><span class="section-number-2">2</span> Matlab Code</h2>
 | 
						|
<div class="outline-text-2" id="text-2">
 | 
						|
</div>
 | 
						|
<div id="outline-container-org36ddd65" class="outline-3">
 | 
						|
<h3 id="org36ddd65"><span class="section-number-3">2.1</span> Simscape Model</h3>
 | 
						|
<div class="outline-text-3" id="text-2-1">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">open(<span class="org-string">'stewart_platform.slx'</span>)
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgfdd5b30" class="outline-3">
 | 
						|
<h3 id="orgfdd5b30"><span class="section-number-3">2.2</span> Test the functions</h3>
 | 
						|
<div class="outline-text-3" id="text-2-2">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart = initializeFramesPositions(<span class="org-string">'H'</span>, 90e<span class="org-type">-</span>3, <span class="org-string">'MO_B'</span>, 45e<span class="org-type">-</span>3);
 | 
						|
stewart = generateCubicConfiguration(stewart, <span class="org-string">'Hc'</span>, 60e<span class="org-type">-</span>3, <span class="org-string">'FOc'</span>, 45e<span class="org-type">-</span>3, <span class="org-string">'FHa'</span>, 5e<span class="org-type">-</span>3, <span class="org-string">'MHb'</span>, 5e<span class="org-type">-</span>3);
 | 
						|
stewart = computeJointsPose(stewart);
 | 
						|
stewart = initializeStrutDynamics(stewart, <span class="org-string">'Ki'</span>, 1e6<span class="org-type">*</span>ones(6,1), <span class="org-string">'Ci'</span>, 1e2<span class="org-type">*</span>ones(6,1));
 | 
						|
stewart = computeJacobian(stewart);
 | 
						|
[Li, dLi] = inverseKinematics(stewart, <span class="org-string">'AP'</span>, [0;0;0.00001], <span class="org-string">'ARB'</span>, eye(3));
 | 
						|
[P, R] = forwardKinematicsApprox(stewart, <span class="org-string">'dL'</span>, dLi)
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org9b04ea6" class="outline-2">
 | 
						|
<h2 id="org9b04ea6"><span class="section-number-2">3</span> <code>initializeFramesPositions</code>: Initialize the positions of frames {A}, {B}, {F} and {M}</h2>
 | 
						|
<div class="outline-text-2" id="text-3">
 | 
						|
<p>
 | 
						|
<a id="org88d4785"></a>
 | 
						|
</p>
 | 
						|
 | 
						|
<p>
 | 
						|
This Matlab function is accessible <a href="src/initializeFramesPositions.m">here</a>.
 | 
						|
</p>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org12408b9" class="outline-3">
 | 
						|
<h3 id="org12408b9"><span class="section-number-3">3.1</span> Function description</h3>
 | 
						|
<div class="outline-text-3" id="text-3-1">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab"><span class="org-keyword">function</span> <span class="org-variable-name">[stewart]</span> = <span class="org-function-name">initializeFramesPositions</span>(<span class="org-variable-name">args</span>)
 | 
						|
<span class="org-comment">% initializeFramesPositions - Initialize the positions of frames {A}, {B}, {F} and {M}</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Syntax: [stewart] = initializeFramesPositions(args)</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Inputs:</span>
 | 
						|
<span class="org-comment">%    - args - Can have the following fields:</span>
 | 
						|
<span class="org-comment">%        - H    [1x1] - Total Height of the Stewart Platform (height from {F} to {M}) [m]</span>
 | 
						|
<span class="org-comment">%        - MO_B [1x1] - Height of the frame {B} with respect to {M} [m]</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Outputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - A structure with the following fields:</span>
 | 
						|
<span class="org-comment">%        - H    [1x1] - Total Height of the Stewart Platform [m]</span>
 | 
						|
<span class="org-comment">%        - FO_M [3x1] - Position of {M} with respect to {F} [m]</span>
 | 
						|
<span class="org-comment">%        - MO_B [3x1] - Position of {B} with respect to {M} [m]</span>
 | 
						|
<span class="org-comment">%        - FO_A [3x1] - Position of {A} with respect to {F} [m]</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org65e1007" class="outline-3">
 | 
						|
<h3 id="org65e1007"><span class="section-number-3">3.2</span> Documentation</h3>
 | 
						|
<div class="outline-text-3" id="text-3-2">
 | 
						|
 | 
						|
<div id="org4b4d91b" class="figure">
 | 
						|
<p><img src="figs/stewart-frames-position.png" alt="stewart-frames-position.png" />
 | 
						|
</p>
 | 
						|
<p><span class="figure-number">Figure 1: </span>Definition of the position of the frames</p>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org94be80d" class="outline-3">
 | 
						|
<h3 id="org94be80d"><span class="section-number-3">3.3</span> Optional Parameters</h3>
 | 
						|
<div class="outline-text-3" id="text-3-3">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">arguments
 | 
						|
    args.H    (1,1) double {mustBeNumeric, mustBePositive} = 90e<span class="org-type">-</span>3
 | 
						|
    args.MO_B (1,1) double {mustBeNumeric} = 50e<span class="org-type">-</span>3
 | 
						|
<span class="org-keyword">end</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org87eaafa" class="outline-3">
 | 
						|
<h3 id="org87eaafa"><span class="section-number-3">3.4</span> Initialize the Stewart structure</h3>
 | 
						|
<div class="outline-text-3" id="text-3-4">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart = struct();
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org23ee353" class="outline-3">
 | 
						|
<h3 id="org23ee353"><span class="section-number-3">3.5</span> Compute the position of each frame</h3>
 | 
						|
<div class="outline-text-3" id="text-3-5">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart.H = args.H; <span class="org-comment">% Total Height of the Stewart Platform [m]</span>
 | 
						|
 | 
						|
stewart.FO_M = [0; 0; stewart.H]; <span class="org-comment">% Position of {M} with respect to {F} [m]</span>
 | 
						|
 | 
						|
stewart.MO_B = [0; 0; args.MO_B]; <span class="org-comment">% Position of {B} with respect to {M} [m]</span>
 | 
						|
 | 
						|
stewart.FO_A = stewart.MO_B <span class="org-type">+</span> stewart.FO_M; <span class="org-comment">% Position of {A} with respect to {F} [m]</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org087790f" class="outline-2">
 | 
						|
<h2 id="org087790f"><span class="section-number-2">4</span> <code>generateCubicConfiguration</code>: Generate a Cubic Configuration</h2>
 | 
						|
<div class="outline-text-2" id="text-4">
 | 
						|
<p>
 | 
						|
<a id="org9bd21cb"></a>
 | 
						|
</p>
 | 
						|
 | 
						|
<p>
 | 
						|
This Matlab function is accessible <a href="src/generateCubicConfiguration.m">here</a>.
 | 
						|
</p>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org4227245" class="outline-3">
 | 
						|
<h3 id="org4227245"><span class="section-number-3">4.1</span> Function description</h3>
 | 
						|
<div class="outline-text-3" id="text-4-1">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab"><span class="org-keyword">function</span> <span class="org-variable-name">[stewart]</span> = <span class="org-function-name">generateCubicConfiguration</span>(<span class="org-variable-name">stewart</span>, <span class="org-variable-name">args</span>)
 | 
						|
<span class="org-comment">% generateCubicConfiguration - Generate a Cubic Configuration</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Syntax: [stewart] = generateCubicConfiguration(stewart, args)</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Inputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - A structure with the following fields</span>
 | 
						|
<span class="org-comment">%        - H   [1x1] - Total height of the platform [m]</span>
 | 
						|
<span class="org-comment">%    - args - Can have the following fields:</span>
 | 
						|
<span class="org-comment">%        - Hc  [1x1] - Height of the "useful" part of the cube [m]</span>
 | 
						|
<span class="org-comment">%        - FOc [1x1] - Height of the center of the cube with respect to {F} [m]</span>
 | 
						|
<span class="org-comment">%        - FHa [1x1] - Height of the plane joining the points ai with respect to the frame {F} [m]</span>
 | 
						|
<span class="org-comment">%        - MHb [1x1] - Height of the plane joining the points bi with respect to the frame {M} [m]</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Outputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - updated Stewart structure with the added fields:</span>
 | 
						|
<span class="org-comment">%        - Fa  [3x6] - Its i'th column is the position vector of joint ai with respect to {F}</span>
 | 
						|
<span class="org-comment">%        - Mb  [3x6] - Its i'th column is the position vector of joint bi with respect to {M}</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org0a67b9a" class="outline-3">
 | 
						|
<h3 id="org0a67b9a"><span class="section-number-3">4.2</span> Documentation</h3>
 | 
						|
<div class="outline-text-3" id="text-4-2">
 | 
						|
 | 
						|
<div id="org77ddaf9" class="figure">
 | 
						|
<p><img src="figs/cubic-configuration-definition.png" alt="cubic-configuration-definition.png" />
 | 
						|
</p>
 | 
						|
<p><span class="figure-number">Figure 2: </span>Cubic Configuration</p>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgedf8c0c" class="outline-3">
 | 
						|
<h3 id="orgedf8c0c"><span class="section-number-3">4.3</span> Optional Parameters</h3>
 | 
						|
<div class="outline-text-3" id="text-4-3">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">arguments
 | 
						|
    stewart
 | 
						|
    args.Hc  (1,1) double {mustBeNumeric, mustBePositive} = 60e<span class="org-type">-</span>3
 | 
						|
    args.FOc (1,1) double {mustBeNumeric} = 50e<span class="org-type">-</span>3
 | 
						|
    args.FHa (1,1) double {mustBeNumeric, mustBePositive} = 15e<span class="org-type">-</span>3
 | 
						|
    args.MHb (1,1) double {mustBeNumeric, mustBePositive} = 15e<span class="org-type">-</span>3
 | 
						|
<span class="org-keyword">end</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org512c9d4" class="outline-3">
 | 
						|
<h3 id="org512c9d4"><span class="section-number-3">4.4</span> Position of the Cube</h3>
 | 
						|
<div class="outline-text-3" id="text-4-4">
 | 
						|
<p>
 | 
						|
We define the useful points of the cube with respect to the Cube’s center.
 | 
						|
\({}^{C}C\) are the 6 vertices of the cubes expressed in a frame {C} which is
 | 
						|
located at the center of the cube and aligned with {F} and {M}.
 | 
						|
</p>
 | 
						|
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">sx = [ 2; <span class="org-type">-</span>1; <span class="org-type">-</span>1];
 | 
						|
sy = [ 0;  1; <span class="org-type">-</span>1];
 | 
						|
sz = [ 1;  1;  1];
 | 
						|
 | 
						|
R = [sx, sy, sz]<span class="org-type">./</span>vecnorm([sx, sy, sz]);
 | 
						|
 | 
						|
L = args.Hc<span class="org-type">*</span>sqrt(3);
 | 
						|
 | 
						|
Cc = R<span class="org-type">'*</span>[[0;0;L],[L;0;L],[L;0;0],[L;L;0],[0;L;0],[0;L;L]] <span class="org-type">-</span> [0;0;1.5<span class="org-type">*</span>args.Hc];
 | 
						|
 | 
						|
CCf = [Cc(<span class="org-type">:</span>,1), Cc(<span class="org-type">:</span>,3), Cc(<span class="org-type">:</span>,3), Cc(<span class="org-type">:</span>,5), Cc(<span class="org-type">:</span>,5), Cc(<span class="org-type">:</span>,1)]; <span class="org-comment">% CCf(:,i) corresponds to the bottom cube's vertice corresponding to the i'th leg</span>
 | 
						|
CCm = [Cc(<span class="org-type">:</span>,2), Cc(<span class="org-type">:</span>,2), Cc(<span class="org-type">:</span>,4), Cc(<span class="org-type">:</span>,4), Cc(<span class="org-type">:</span>,6), Cc(<span class="org-type">:</span>,6)]; <span class="org-comment">% CCm(:,i) corresponds to the top cube's vertice corresponding to the i'th leg</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgcb8a030" class="outline-3">
 | 
						|
<h3 id="orgcb8a030"><span class="section-number-3">4.5</span> Compute the pose</h3>
 | 
						|
<div class="outline-text-3" id="text-4-5">
 | 
						|
<p>
 | 
						|
We can compute the vector of each leg \({}^{C}\hat{\bm{s}}_{i}\) (unit vector from \({}^{C}C_{f}\) to \({}^{C}C_{m}\)).
 | 
						|
</p>
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">CSi = (CCm <span class="org-type">-</span> CCf)<span class="org-type">./</span>vecnorm(CCm <span class="org-type">-</span> CCf);
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
 | 
						|
<p>
 | 
						|
We now which to compute the position of the joints \(a_{i}\) and \(b_{i}\).
 | 
						|
</p>
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart.Fa = CCf <span class="org-type">+</span> [0; 0; args.FOc] <span class="org-type">+</span> ((args.FHa<span class="org-type">-</span>(args.FOc<span class="org-type">-</span>args.Hc<span class="org-type">/</span>2))<span class="org-type">./</span>CSi(3,<span class="org-type">:</span>))<span class="org-type">.*</span>CSi;
 | 
						|
stewart.Mb = CCf <span class="org-type">+</span> [0; 0; args.FOc<span class="org-type">-</span>stewart.H] <span class="org-type">+</span> ((stewart.H<span class="org-type">-</span>args.MHb<span class="org-type">-</span>(args.FOc<span class="org-type">-</span>args.Hc<span class="org-type">/</span>2))<span class="org-type">./</span>CSi(3,<span class="org-type">:</span>))<span class="org-type">.*</span>CSi;
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org1a639eb" class="outline-2">
 | 
						|
<h2 id="org1a639eb"><span class="section-number-2">5</span> <code>generateGeneralConfiguration</code>: Generate a Very General Configuration</h2>
 | 
						|
<div class="outline-text-2" id="text-5">
 | 
						|
<p>
 | 
						|
<a id="org4135659"></a>
 | 
						|
</p>
 | 
						|
 | 
						|
<p>
 | 
						|
This Matlab function is accessible <a href="src/generateGeneralConfiguration.m">here</a>.
 | 
						|
</p>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgaf38049" class="outline-3">
 | 
						|
<h3 id="orgaf38049"><span class="section-number-3">5.1</span> Function description</h3>
 | 
						|
<div class="outline-text-3" id="text-5-1">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab"><span class="org-keyword">function</span> <span class="org-variable-name">[stewart]</span> = <span class="org-function-name">generateGeneralConfiguration</span>(<span class="org-variable-name">stewart</span>, <span class="org-variable-name">args</span>)
 | 
						|
<span class="org-comment">% generateGeneralConfiguration - Generate a Very General Configuration</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Syntax: [stewart] = generateGeneralConfiguration(stewart, args)</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Inputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - A structure with the following fields</span>
 | 
						|
<span class="org-comment">%        - H   [1x1] - Total height of the platform [m]</span>
 | 
						|
<span class="org-comment">%    - args - Can have the following fields:</span>
 | 
						|
<span class="org-comment">%        - FH  [1x1] - Height of the position of the fixed joints with respect to the frame {F} [m]</span>
 | 
						|
<span class="org-comment">%        - FR  [1x1] - Radius of the position of the fixed joints in the X-Y [m]</span>
 | 
						|
<span class="org-comment">%        - FTh [6x1] - Angles of the fixed joints in the X-Y plane with respect to the X axis [rad]</span>
 | 
						|
<span class="org-comment">%        - MH  [1x1] - Height of the position of the mobile joints with respect to the frame {M} [m]</span>
 | 
						|
<span class="org-comment">%        - FR  [1x1] - Radius of the position of the mobile joints in the X-Y [m]</span>
 | 
						|
<span class="org-comment">%        - MTh [6x1] - Angles of the mobile joints in the X-Y plane with respect to the X axis [rad]</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Outputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - updated Stewart structure with the added fields:</span>
 | 
						|
<span class="org-comment">%        - Fa  [3x6] - Its i'th column is the position vector of joint ai with respect to {F}</span>
 | 
						|
<span class="org-comment">%        - Mb  [3x6] - Its i'th column is the position vector of joint bi with respect to {M}</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org99d670a" class="outline-3">
 | 
						|
<h3 id="org99d670a"><span class="section-number-3">5.2</span> Documentation</h3>
 | 
						|
<div class="outline-text-3" id="text-5-2">
 | 
						|
<p>
 | 
						|
Joints are positions on a circle centered with the Z axis of {F} and {M} and at a chosen distance from {F} and {M}.
 | 
						|
The radius of the circles can be chosen as well as the angles where the joints are located.
 | 
						|
</p>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgb94dd5e" class="outline-3">
 | 
						|
<h3 id="orgb94dd5e"><span class="section-number-3">5.3</span> Optional Parameters</h3>
 | 
						|
<div class="outline-text-3" id="text-5-3">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">arguments
 | 
						|
    stewart
 | 
						|
    args.FH  (1,1) double {mustBeNumeric, mustBePositive} = 15e<span class="org-type">-</span>3
 | 
						|
    args.FR  (1,1) double {mustBeNumeric, mustBePositive} = 90e<span class="org-type">-</span>3;
 | 
						|
    args.FTh (6,1) double {mustBeNumeric} = [<span class="org-type">-</span>10, 10, 120<span class="org-type">-</span>10, 120<span class="org-type">+</span>10, 240<span class="org-type">-</span>10, 240<span class="org-type">+</span>10]<span class="org-type">*</span>(<span class="org-constant">pi</span><span class="org-type">/</span>180);
 | 
						|
    args.MH  (1,1) double {mustBeNumeric, mustBePositive} = 15e<span class="org-type">-</span>3
 | 
						|
    args.MR  (1,1) double {mustBeNumeric, mustBePositive} = 70e<span class="org-type">-</span>3;
 | 
						|
    args.MTh (6,1) double {mustBeNumeric} = [<span class="org-type">-</span>60<span class="org-type">+</span>10, 60<span class="org-type">-</span>10, 60<span class="org-type">+</span>10, 180<span class="org-type">-</span>10, 180<span class="org-type">+</span>10, <span class="org-type">-</span>60<span class="org-type">-</span>10]<span class="org-type">*</span>(<span class="org-constant">pi</span><span class="org-type">/</span>180);
 | 
						|
<span class="org-keyword">end</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org217593d" class="outline-3">
 | 
						|
<h3 id="org217593d"><span class="section-number-3">5.4</span> Compute the pose</h3>
 | 
						|
<div class="outline-text-3" id="text-5-4">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart.Fa = zeros(3,6);
 | 
						|
stewart.Mb = zeros(3,6);
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab"><span class="org-keyword">for</span> <span class="org-variable-name"><span class="org-constant">i</span></span> = <span class="org-constant">1:6</span>
 | 
						|
  stewart.Fa(<span class="org-type">:</span>,<span class="org-constant">i</span>) = [args.FR<span class="org-type">*</span>cos(args.FTh(<span class="org-constant">i</span>)); args.FR<span class="org-type">*</span>sin(args.FTh(<span class="org-constant">i</span>)); args.FH];
 | 
						|
  stewart.Mb(<span class="org-type">:</span>,<span class="org-constant">i</span>) = [args.MR<span class="org-type">*</span>cos(args.MTh(<span class="org-constant">i</span>)); args.MR<span class="org-type">*</span>sin(args.MTh(<span class="org-constant">i</span>)); <span class="org-type">-</span>args.MH];
 | 
						|
<span class="org-keyword">end</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org027ac62" class="outline-2">
 | 
						|
<h2 id="org027ac62"><span class="section-number-2">6</span> <code>computeJointsPose</code>: Compute the Pose of the Joints</h2>
 | 
						|
<div class="outline-text-2" id="text-6">
 | 
						|
<p>
 | 
						|
<a id="org86d3c8d"></a>
 | 
						|
</p>
 | 
						|
 | 
						|
<p>
 | 
						|
This Matlab function is accessible <a href="src/computeJointsPose.m">here</a>.
 | 
						|
</p>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org9851a88" class="outline-3">
 | 
						|
<h3 id="org9851a88"><span class="section-number-3">6.1</span> Function description</h3>
 | 
						|
<div class="outline-text-3" id="text-6-1">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab"><span class="org-keyword">function</span> <span class="org-variable-name">[stewart]</span> = <span class="org-function-name">computeJointsPose</span>(<span class="org-variable-name">stewart</span>)
 | 
						|
<span class="org-comment">% computeJointsPose -</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Syntax: [stewart] = computeJointsPose(stewart)</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Inputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - A structure with the following fields</span>
 | 
						|
<span class="org-comment">%        - Fa   [3x6] - Its i'th column is the position vector of joint ai with respect to {F}</span>
 | 
						|
<span class="org-comment">%        - Mb   [3x6] - Its i'th column is the position vector of joint bi with respect to {M}</span>
 | 
						|
<span class="org-comment">%        - FO_A [3x1] - Position of {A} with respect to {F}</span>
 | 
						|
<span class="org-comment">%        - MO_B [3x1] - Position of {B} with respect to {M}</span>
 | 
						|
<span class="org-comment">%        - FO_M [3x1] - Position of {M} with respect to {F}</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Outputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - A structure with the following added fields</span>
 | 
						|
<span class="org-comment">%        - Aa  [3x6]   - The i'th column is the position of ai with respect to {A}</span>
 | 
						|
<span class="org-comment">%        - Ab  [3x6]   - The i'th column is the position of bi with respect to {A}</span>
 | 
						|
<span class="org-comment">%        - Ba  [3x6]   - The i'th column is the position of ai with respect to {B}</span>
 | 
						|
<span class="org-comment">%        - Bb  [3x6]   - The i'th column is the position of bi with respect to {B}</span>
 | 
						|
<span class="org-comment">%        - l   [6x1]   - The i'th element is the initial length of strut i</span>
 | 
						|
<span class="org-comment">%        - As  [3x6]   - The i'th column is the unit vector of strut i expressed in {A}</span>
 | 
						|
<span class="org-comment">%        - Bs  [3x6]   - The i'th column is the unit vector of strut i expressed in {B}</span>
 | 
						|
<span class="org-comment">%        - FRa [3x3x6] - The i'th 3x3 array is the rotation matrix to orientate the bottom of the i'th strut from {F}</span>
 | 
						|
<span class="org-comment">%        - MRb [3x3x6] - The i'th 3x3 array is the rotation matrix to orientate the top of the i'th strut from {M}</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org38475a0" class="outline-3">
 | 
						|
<h3 id="org38475a0"><span class="section-number-3">6.2</span> Documentation</h3>
 | 
						|
<div class="outline-text-3" id="text-6-2">
 | 
						|
 | 
						|
<div id="orge85a023" class="figure">
 | 
						|
<p><img src="figs/stewart-struts.png" alt="stewart-struts.png" />
 | 
						|
</p>
 | 
						|
<p><span class="figure-number">Figure 3: </span>Position and orientation of the struts</p>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgcb68548" class="outline-3">
 | 
						|
<h3 id="orgcb68548"><span class="section-number-3">6.3</span> Compute the position of the Joints</h3>
 | 
						|
<div class="outline-text-3" id="text-6-3">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart.Aa = stewart.Fa <span class="org-type">-</span> repmat(stewart.FO_A, [1, 6]);
 | 
						|
stewart.Bb = stewart.Mb <span class="org-type">-</span> repmat(stewart.MO_B, [1, 6]);
 | 
						|
 | 
						|
stewart.Ab = stewart.Bb <span class="org-type">-</span> repmat(<span class="org-type">-</span>stewart.MO_B<span class="org-type">-</span>stewart.FO_M<span class="org-type">+</span>stewart.FO_A, [1, 6]);
 | 
						|
stewart.Ba = stewart.Aa <span class="org-type">-</span> repmat( stewart.MO_B<span class="org-type">+</span>stewart.FO_M<span class="org-type">-</span>stewart.FO_A, [1, 6]);
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org17b24ef" class="outline-3">
 | 
						|
<h3 id="org17b24ef"><span class="section-number-3">6.4</span> Compute the strut length and orientation</h3>
 | 
						|
<div class="outline-text-3" id="text-6-4">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart.As = (stewart.Ab <span class="org-type">-</span> stewart.Aa)<span class="org-type">./</span>vecnorm(stewart.Ab <span class="org-type">-</span> stewart.Aa); <span class="org-comment">% As_i is the i'th vector of As</span>
 | 
						|
 | 
						|
stewart.l = vecnorm(stewart.Ab <span class="org-type">-</span> stewart.Aa)<span class="org-type">'</span>;
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart.Bs = (stewart.Bb <span class="org-type">-</span> stewart.Ba)<span class="org-type">./</span>vecnorm(stewart.Bb <span class="org-type">-</span> stewart.Ba);
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgdf76376" class="outline-3">
 | 
						|
<h3 id="orgdf76376"><span class="section-number-3">6.5</span> Compute the orientation of the Joints</h3>
 | 
						|
<div class="outline-text-3" id="text-6-5">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart.FRa = zeros(3,3,6);
 | 
						|
stewart.MRb = zeros(3,3,6);
 | 
						|
 | 
						|
<span class="org-keyword">for</span> <span class="org-variable-name"><span class="org-constant">i</span></span> = <span class="org-constant">1:6</span>
 | 
						|
  stewart.FRa(<span class="org-type">:</span>,<span class="org-type">:</span>,<span class="org-constant">i</span>) = [cross([0;1;0], stewart.As(<span class="org-type">:</span>,<span class="org-constant">i</span>)) , cross(stewart.As(<span class="org-type">:</span>,<span class="org-constant">i</span>), cross([0;1;0], stewart.As(<span class="org-type">:</span>,<span class="org-constant">i</span>))) , stewart.As(<span class="org-type">:</span>,<span class="org-constant">i</span>)];
 | 
						|
  stewart.FRa(<span class="org-type">:</span>,<span class="org-type">:</span>,<span class="org-constant">i</span>) = stewart.FRa(<span class="org-type">:</span>,<span class="org-type">:</span>,<span class="org-constant">i</span>)<span class="org-type">./</span>vecnorm(stewart.FRa(<span class="org-type">:</span>,<span class="org-type">:</span>,<span class="org-constant">i</span>));
 | 
						|
 | 
						|
  stewart.MRb(<span class="org-type">:</span>,<span class="org-type">:</span>,<span class="org-constant">i</span>) = [cross([0;1;0], stewart.Bs(<span class="org-type">:</span>,<span class="org-constant">i</span>)) , cross(stewart.Bs(<span class="org-type">:</span>,<span class="org-constant">i</span>), cross([0;1;0], stewart.Bs(<span class="org-type">:</span>,<span class="org-constant">i</span>))) , stewart.Bs(<span class="org-type">:</span>,<span class="org-constant">i</span>)];
 | 
						|
  stewart.MRb(<span class="org-type">:</span>,<span class="org-type">:</span>,<span class="org-constant">i</span>) = stewart.MRb(<span class="org-type">:</span>,<span class="org-type">:</span>,<span class="org-constant">i</span>)<span class="org-type">./</span>vecnorm(stewart.MRb(<span class="org-type">:</span>,<span class="org-type">:</span>,<span class="org-constant">i</span>));
 | 
						|
<span class="org-keyword">end</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org18a1d1b" class="outline-2">
 | 
						|
<h2 id="org18a1d1b"><span class="section-number-2">7</span> <code>initializeStrutDynamics</code>: Add Stiffness and Damping properties of each strut</h2>
 | 
						|
<div class="outline-text-2" id="text-7">
 | 
						|
<p>
 | 
						|
<a id="org41cab5e"></a>
 | 
						|
</p>
 | 
						|
 | 
						|
<p>
 | 
						|
This Matlab function is accessible <a href="src/initializeStrutDynamics.m">here</a>.
 | 
						|
</p>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgfdf3d88" class="outline-3">
 | 
						|
<h3 id="orgfdf3d88"><span class="section-number-3">7.1</span> Function description</h3>
 | 
						|
<div class="outline-text-3" id="text-7-1">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab"><span class="org-keyword">function</span> <span class="org-variable-name">[stewart]</span> = <span class="org-function-name">initializeStrutDynamics</span>(<span class="org-variable-name">stewart</span>, <span class="org-variable-name">args</span>)
 | 
						|
<span class="org-comment">% initializeStrutDynamics - Add Stiffness and Damping properties of each strut</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Syntax: [stewart] = initializeStrutDynamics(args)</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Inputs:</span>
 | 
						|
<span class="org-comment">%    - args - Structure with the following fields:</span>
 | 
						|
<span class="org-comment">%        - Ki [6x1] - Stiffness of each strut [N/m]</span>
 | 
						|
<span class="org-comment">%        - Ci [6x1] - Damping of each strut [N/(m/s)]</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Outputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - updated Stewart structure with the added fields:</span>
 | 
						|
<span class="org-comment">%        - Ki [6x1] - Stiffness of each strut [N/m]</span>
 | 
						|
<span class="org-comment">%        - Ci [6x1] - Damping of each strut [N/(m/s)]</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orge5e71a3" class="outline-3">
 | 
						|
<h3 id="orge5e71a3"><span class="section-number-3">7.2</span> Optional Parameters</h3>
 | 
						|
<div class="outline-text-3" id="text-7-2">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">arguments
 | 
						|
    stewart
 | 
						|
    args.Ki (6,1) double {mustBeNumeric, mustBePositive} = 1e6<span class="org-type">*</span>ones(6,1)
 | 
						|
    args.Ci (6,1) double {mustBeNumeric, mustBePositive} = 1e3<span class="org-type">*</span>ones(6,1)
 | 
						|
<span class="org-keyword">end</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org85adb8d" class="outline-3">
 | 
						|
<h3 id="org85adb8d"><span class="section-number-3">7.3</span> Add Stiffness and Damping properties of each strut</h3>
 | 
						|
<div class="outline-text-3" id="text-7-3">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart.Ki = args.Ki;
 | 
						|
stewart.Ci = args.Ci;
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgbaa0753" class="outline-2">
 | 
						|
<h2 id="orgbaa0753"><span class="section-number-2">8</span> <code>computeJacobian</code>: Compute the Jacobian Matrix</h2>
 | 
						|
<div class="outline-text-2" id="text-8">
 | 
						|
<p>
 | 
						|
<a id="orgfa470f8"></a>
 | 
						|
</p>
 | 
						|
 | 
						|
<p>
 | 
						|
This Matlab function is accessible <a href="src/computeJacobian.m">here</a>.
 | 
						|
</p>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org7f7fdc1" class="outline-3">
 | 
						|
<h3 id="org7f7fdc1"><span class="section-number-3">8.1</span> Function description</h3>
 | 
						|
<div class="outline-text-3" id="text-8-1">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab"><span class="org-keyword">function</span> <span class="org-variable-name">[stewart]</span> = <span class="org-function-name">computeJacobian</span>(<span class="org-variable-name">stewart</span>)
 | 
						|
<span class="org-comment">% computeJacobian -</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Syntax: [stewart] = computeJacobian(stewart)</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Inputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - With at least the following fields:</span>
 | 
						|
<span class="org-comment">%        - As [3x6] - The 6 unit vectors for each strut expressed in {A}</span>
 | 
						|
<span class="org-comment">%        - Ab [3x6] - The 6 position of the joints bi expressed in {A}</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Outputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - With the 3 added field:</span>
 | 
						|
<span class="org-comment">%        - J [6x6] - The Jacobian Matrix</span>
 | 
						|
<span class="org-comment">%        - K [6x6] - The Stiffness Matrix</span>
 | 
						|
<span class="org-comment">%        - C [6x6] - The Compliance Matrix</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgc824a02" class="outline-3">
 | 
						|
<h3 id="orgc824a02"><span class="section-number-3">8.2</span> Compute Jacobian Matrix</h3>
 | 
						|
<div class="outline-text-3" id="text-8-2">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart.J = [stewart.As<span class="org-type">'</span> , cross(stewart.Ab, stewart.As)<span class="org-type">'</span>];
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org2806583" class="outline-3">
 | 
						|
<h3 id="org2806583"><span class="section-number-3">8.3</span> Compute Stiffness Matrix</h3>
 | 
						|
<div class="outline-text-3" id="text-8-3">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart.K = stewart.J<span class="org-type">'*</span>diag(stewart.Ki)<span class="org-type">*</span>stewart.J;
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgb5560fc" class="outline-3">
 | 
						|
<h3 id="orgb5560fc"><span class="section-number-3">8.4</span> Compute Compliance Matrix</h3>
 | 
						|
<div class="outline-text-3" id="text-8-4">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">stewart.C = inv(stewart.K);
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgb6aa2e4" class="outline-2">
 | 
						|
<h2 id="orgb6aa2e4"><span class="section-number-2">9</span> <code>inverseKinematics</code>: Compute Inverse Kinematics</h2>
 | 
						|
<div class="outline-text-2" id="text-9">
 | 
						|
<p>
 | 
						|
<a id="org85d5414"></a>
 | 
						|
</p>
 | 
						|
 | 
						|
<p>
 | 
						|
This Matlab function is accessible <a href="src/inverseKinematics.m">here</a>.
 | 
						|
</p>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org1abf793" class="outline-3">
 | 
						|
<h3 id="org1abf793"><span class="section-number-3">9.1</span> Function description</h3>
 | 
						|
<div class="outline-text-3" id="text-9-1">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab"><span class="org-keyword">function</span> <span class="org-variable-name">[Li, dLi]</span> = <span class="org-function-name">inverseKinematics</span>(<span class="org-variable-name">stewart</span>, <span class="org-variable-name">args</span>)
 | 
						|
<span class="org-comment">% inverseKinematics - Compute the needed length of each strut to have the wanted position and orientation of {B} with respect to {A}</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Syntax: [stewart] = inverseKinematics(stewart)</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Inputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - A structure with the following fields</span>
 | 
						|
<span class="org-comment">%        - Aa   [3x6] - The positions ai expressed in {A}</span>
 | 
						|
<span class="org-comment">%        - Bb   [3x6] - The positions bi expressed in {B}</span>
 | 
						|
<span class="org-comment">%    - args - Can have the following fields:</span>
 | 
						|
<span class="org-comment">%        - AP   [3x1] - The wanted position of {B} with respect to {A}</span>
 | 
						|
<span class="org-comment">%        - ARB  [3x3] - The rotation matrix that gives the wanted orientation of {B} with respect to {A}</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Outputs:</span>
 | 
						|
<span class="org-comment">%    - Li   [6x1] - The 6 needed length of the struts in [m] to have the wanted pose of {B} w.r.t. {A}</span>
 | 
						|
<span class="org-comment">%    - dLi  [6x1] - The 6 needed displacement of the struts from the initial position in [m] to have the wanted pose of {B} w.r.t. {A}</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgae295b6" class="outline-3">
 | 
						|
<h3 id="orgae295b6"><span class="section-number-3">9.2</span> Optional Parameters</h3>
 | 
						|
<div class="outline-text-3" id="text-9-2">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">arguments
 | 
						|
    stewart
 | 
						|
    args.AP  (3,1) double {mustBeNumeric} = zeros(3,1)
 | 
						|
    args.ARB (3,3) double {mustBeNumeric} = eye(3)
 | 
						|
<span class="org-keyword">end</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgfd5d40a" class="outline-3">
 | 
						|
<h3 id="orgfd5d40a"><span class="section-number-3">9.3</span> Theory</h3>
 | 
						|
<div class="outline-text-3" id="text-9-3">
 | 
						|
<p>
 | 
						|
For inverse kinematic analysis, it is assumed that the position \({}^A\bm{P}\) and orientation of the moving platform \({}^A\bm{R}_B\) are given and the problem is to obtain the joint variables, namely, \(\bm{L} = [l_1, l_2, \dots, l_6]^T\).
 | 
						|
</p>
 | 
						|
 | 
						|
<p>
 | 
						|
From the geometry of the manipulator, the loop closure for each limb, \(i = 1, 2, \dots, 6\) can be written as
 | 
						|
</p>
 | 
						|
\begin{align*}
 | 
						|
  l_i {}^A\hat{\bm{s}}_i &= {}^A\bm{A} + {}^A\bm{b}_i - {}^A\bm{a}_i \\
 | 
						|
                         &= {}^A\bm{A} + {}^A\bm{R}_b {}^B\bm{b}_i - {}^A\bm{a}_i
 | 
						|
\end{align*}
 | 
						|
 | 
						|
<p>
 | 
						|
To obtain the length of each actuator and eliminate \(\hat{\bm{s}}_i\), it is sufficient to dot multiply each side by itself:
 | 
						|
</p>
 | 
						|
\begin{equation}
 | 
						|
  l_i^2 \left[ {}^A\hat{\bm{s}}_i^T {}^A\hat{\bm{s}}_i \right] = \left[ {}^A\bm{P} + {}^A\bm{R}_B {}^B\bm{b}_i - {}^A\bm{a}_i \right]^T \left[ {}^A\bm{P} + {}^A\bm{R}_B {}^B\bm{b}_i - {}^A\bm{a}_i \right]
 | 
						|
\end{equation}
 | 
						|
 | 
						|
<p>
 | 
						|
Hence, for \(i = 1, 2, \dots, 6\), each limb length can be uniquely determined by:
 | 
						|
</p>
 | 
						|
\begin{equation}
 | 
						|
  l_i = \sqrt{{}^A\bm{P}^T {}^A\bm{P} + {}^B\bm{b}_i^T {}^B\bm{b}_i + {}^A\bm{a}_i^T {}^A\bm{a}_i - 2 {}^A\bm{P}^T {}^A\bm{a}_i + 2 {}^A\bm{P}^T \left[{}^A\bm{R}_B {}^B\bm{b}_i\right] - 2 \left[{}^A\bm{R}_B {}^B\bm{b}_i\right]^T {}^A\bm{a}_i}
 | 
						|
\end{equation}
 | 
						|
 | 
						|
<p>
 | 
						|
If the position and orientation of the moving platform lie in the feasible workspace of the manipulator, one unique solution to the limb length is determined by the above equation.
 | 
						|
Otherwise, when the limbs’ lengths derived yield complex numbers, then the position or orientation of the moving platform is not reachable.
 | 
						|
</p>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgc7dd5e8" class="outline-3">
 | 
						|
<h3 id="orgc7dd5e8"><span class="section-number-3">9.4</span> Compute</h3>
 | 
						|
<div class="outline-text-3" id="text-9-4">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">Li = sqrt(args.AP<span class="org-type">'*</span>args.AP <span class="org-type">+</span> diag(stewart.Bb<span class="org-type">'*</span>stewart.Bb) <span class="org-type">+</span> diag(stewart.Aa<span class="org-type">'*</span>stewart.Aa) <span class="org-type">-</span> (2<span class="org-type">*</span>args.AP<span class="org-type">'*</span>stewart.Aa)<span class="org-type">'</span> <span class="org-type">+</span> (2<span class="org-type">*</span>args.AP<span class="org-type">'*</span>(args.ARB<span class="org-type">*</span>stewart.Bb))<span class="org-type">'</span> <span class="org-type">-</span> diag(2<span class="org-type">*</span>(args.ARB<span class="org-type">*</span>stewart.Bb)<span class="org-type">'*</span>stewart.Aa));
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">dLi = Li<span class="org-type">-</span>stewart.l;
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org689b179" class="outline-2">
 | 
						|
<h2 id="org689b179"><span class="section-number-2">10</span> <code>forwardKinematicsApprox</code>: Compute the Forward Kinematics</h2>
 | 
						|
<div class="outline-text-2" id="text-10">
 | 
						|
<p>
 | 
						|
<a id="org887d5a9"></a>
 | 
						|
</p>
 | 
						|
 | 
						|
<p>
 | 
						|
This Matlab function is accessible <a href="src/forwardKinematicsApprox.m">here</a>.
 | 
						|
</p>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgba48270" class="outline-3">
 | 
						|
<h3 id="orgba48270"><span class="section-number-3">10.1</span> Function description</h3>
 | 
						|
<div class="outline-text-3" id="text-10-1">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab"><span class="org-keyword">function</span> <span class="org-variable-name">[P, R]</span> = <span class="org-function-name">forwardKinematicsApprox</span>(<span class="org-variable-name">stewart</span>, <span class="org-variable-name">args</span>)
 | 
						|
<span class="org-comment">% forwardKinematicsApprox - Computed the approximate pose of {B} with respect to {A} from the length of each strut and using</span>
 | 
						|
<span class="org-comment">%                           the Jacobian Matrix</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Syntax: [P, R] = forwardKinematicsApprox(stewart, args)</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Inputs:</span>
 | 
						|
<span class="org-comment">%    - stewart - A structure with the following fields</span>
 | 
						|
<span class="org-comment">%        - J  [6x6] - The Jacobian Matrix</span>
 | 
						|
<span class="org-comment">%    - args - Can have the following fields:</span>
 | 
						|
<span class="org-comment">%        - dL [6x1] - Displacement of each strut [m]</span>
 | 
						|
<span class="org-comment">%</span>
 | 
						|
<span class="org-comment">% Outputs:</span>
 | 
						|
<span class="org-comment">%    - P  [3x1] - The estimated position of {B} with respect to {A}</span>
 | 
						|
<span class="org-comment">%    - R  [3x3] - The estimated rotation matrix that gives the orientation of {B} with respect to {A}</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-org22e2134" class="outline-3">
 | 
						|
<h3 id="org22e2134"><span class="section-number-3">10.2</span> Optional Parameters</h3>
 | 
						|
<div class="outline-text-3" id="text-10-2">
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">arguments
 | 
						|
    stewart
 | 
						|
    args.dL (6,1) double {mustBeNumeric} = zeros(6,1)
 | 
						|
<span class="org-keyword">end</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
 | 
						|
<div id="outline-container-orgfa57f93" class="outline-3">
 | 
						|
<h3 id="orgfa57f93"><span class="section-number-3">10.3</span> Computation</h3>
 | 
						|
<div class="outline-text-3" id="text-10-3">
 | 
						|
<p>
 | 
						|
From a small displacement of each strut \(d\bm{\mathcal{L}}\), we can compute the
 | 
						|
position and orientation of {B} with respect to {A} using the following formula:
 | 
						|
\[ d \bm{\mathcal{X}} = \bm{J}^{-1} d\bm{\mathcal{L}} \]
 | 
						|
</p>
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">X = stewart.J<span class="org-type">\</span>args.dL;
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
 | 
						|
<p>
 | 
						|
The position vector corresponds to the first 3 elements.
 | 
						|
</p>
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">P = X(1<span class="org-type">:</span>3);
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
 | 
						|
<p>
 | 
						|
The next 3 elements are the orientation of {B} with respect to {A} expressed
 | 
						|
using the screw axis.
 | 
						|
</p>
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">theta = norm(X(4<span class="org-type">:</span>6));
 | 
						|
s = X(4<span class="org-type">:</span>6)<span class="org-type">/</span>theta;
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
 | 
						|
<p>
 | 
						|
We then compute the corresponding rotation matrix.
 | 
						|
</p>
 | 
						|
<div class="org-src-container">
 | 
						|
<pre class="src src-matlab">R = [s(1)<span class="org-type">^</span>2<span class="org-type">*</span>(1<span class="org-type">-</span>cos(theta)) <span class="org-type">+</span> cos(theta) ,        s(1)<span class="org-type">*</span>s(2)<span class="org-type">*</span>(1<span class="org-type">-</span>cos(theta)) <span class="org-type">-</span> s(3)<span class="org-type">*</span>sin(theta), s(1)<span class="org-type">*</span>s(3)<span class="org-type">*</span>(1<span class="org-type">-</span>cos(theta)) <span class="org-type">+</span> s(2)<span class="org-type">*</span>sin(theta);
 | 
						|
     s<span class="org-type">(2)*s(1)*(1-cos(theta)) + s(3)*sin(theta), s(2)^2*(1-cos(theta)) + cos(theta),         s(2)*s(3)*(1-cos(theta)) - s(1)*sin(theta);</span>
 | 
						|
     s<span class="org-type">(3)*s(1)*(1-cos(theta)) - s(2)*sin(theta), s(3)*s(2)*(1-cos(theta)) + s(1)*sin(theta), s(3)^2*(1-cos(theta)) + cos(theta)];</span>
 | 
						|
</pre>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
</div>
 | 
						|
<div id="postamble" class="status">
 | 
						|
<p class="author">Author: Dehaeze Thomas</p>
 | 
						|
<p class="date">Created: 2020-01-22 mer. 11:35</p>
 | 
						|
</div>
 | 
						|
</body>
 | 
						|
</html>
 |