index 5a9fde0..c5a751f 100644 (file)
<refpurpose>Householder orthogonal reflexion matrix</refpurpose>
</refnamediv>
<refsynopsisdiv>
-        <title>Calling Sequence</title>
-        <synopsis>         householder         // demo</synopsis>
-        <synopsis> u     = householder(v [,w])</synopsis>
-        <synopsis>[u, H] = householder(v [,w])</synopsis>
+        <title>Syntax</title>
+        <synopsis>
+            householder() // demo
+            u = householder(v [,w])
+            [u, H] = householder(v [,w])
+        </synopsis>
</refsynopsisdiv>
<refsection role="arguments">
<title>Arguments</title>
<para>
If the related reflexion matrix <varname>H</varname> is computed, for any point A
of column coordinates <literal>a</literal>, <literal>H*a</literal> are the coordinates of
-            the reflected image of A on P.
+            the reflected image of A (see the example below).
</para>
<note>
If <varname>v</varname> or/and <varname>w</varname> are in row, they are priorly
@@ -147,7 +149,9 @@ clean(hm' - hm)         // must be zeros(3,3)
clean(det(hm))          // must be -1
]]></programlisting>

-        <para>APPLICATION : Reflected image of an object</para>
+        <para>
+            <emphasis role="bold"> Application:</emphasis> Reflected image of an object w.r. to a given plane
+        </para>
<programlisting role="example"><![CDATA[
// (OA) = [0 0 1] is reflected in O into (OB) = [ 1 1 0.3 ]:
[n, H] = householder([0 0 1]', [ 1 1 0.3 ]');
@@ -194,9 +198,6 @@ a.children(2).foreground = 1;
a.children(3).foreground = color("green");
drawnow
]]></programlisting>
-        <scilab:image>
-            householder();
-        </scilab:image>
</refsection>
<refsection role="see also">
<title>See Also</title>