The TangentPlane(f, var1, var2) command computes the plane tangent to the surface f at the point specified by var1 and var2. The surface can be entered as a Vector, a Vector-valued procedure, a scalar expression, or a scalar-valued procedure. If f is entered as a procedure, then it must accept at least 2 arguments; it will be evaluated as $f\left(\mathrm{lhs}\left(\mathrm{var1}\right)\,\mathrm{lhs}\left(\mathrm{var2}\right)\right)$ to obtain the expression for the surface and will be evaluated as $f\left(\mathrm{rhs}\left(\mathrm{var1}\right)\,\mathrm{rhs}\left(\mathrm{var2}\right)\right)$ to obtain the point of tangency.

The TangentPlane(f, var1, var2, var3) command computes the plane tangent to the surface f at the point specified by the three var parameters, where f is defined implicitly by an equation, for example $x^2+y^2+z^2=1$.  No attempt is made to verify that the point specified by the var parameters is actually on the surface.

The TangentPlane(f, pt) command computes the plane tangent to the surface f at the point specified by the 3-element Vector pt parameters, where f is defined implicitly by an equation, for example $x^2+y^2+z^2=1$.  No attempt is made to verify that the point specified by the pt parameter is actually on the surface.

If f is a scalar expression, an equation, or a scalar-valued procedure, then the current coordinate system must be three-dimensional, e.g., cartesian (in three dimensions), spherical, or cylindrical, or the coordopt option must be provided and specify a three-dimensional coordinate system.

If f is a scalar expression, then the second and third arguments must be equations in which the left-hand sides are the coordinate names from the current coordinate system or from the coordopts option. For example, if f is a scalar expression in $x$ and $z$, the ambient coordinate system is ${\mathrm{cartesian}}_{x,y,z}$, and the second and third arguments are $x=a$ and $z=b$, respectively, then f is parameterized as the Vector <$x$, f, $z$>. The tangent plane will be computed at the point $x=a$, $z=\genfrac{}{}{0ex}{}{f}{}|\genfrac{}{}{0ex}{}{}{x=a,z=b}$, $z=b$ .

If f is a scalar-valued procedure, the second and third arguments must be equations in which the left-hand sides are the coordinate names from the current coordinate system or from the coordopt option. The procedure f will be evaluated at these two names, producing a scalar expression, and the previous paragraph applies.

If f is a procedure, the information in var1 will always be substituted into the first parameter of f, and likewise, the information in var2 will always be substituted into the second parameter.

If f is a Vector, var1 and var2 must specify the names of the two parameters of the surface.

If f is a Vector or a scalar expression, the output is a position Vector. If f is a procedure, the output is a procedure that evaluates to a position Vector.  If f is described implicitly, as an equation, then the returned tangent plane will be given as an equation.

If the current coordinate system is not indexed by its coordinate variable names, then the default names will be used, should they be required during computation. For example, if the current coordinate system is cartesian (in three dimensions), then if required, the default names x, y and z will be used as the coordinate variable names.

If the input expression f is not a Vector with a coords attribute, it is interpreted in coordinate system specified by the coordopt option.  If this is not given, then the ambient coordinate system (as set, for example, by SetCoordinates) is assumed.

If neither the ambient coordinate system nor the coordinate system in which f is interpreted (see previous item) is cartesian, then the outvars option must be used to provide the names of the output (cartesian) coordinate system variable names.

$\mathrm{with}\left(\mathrm{Student}\left[\mathrm{VectorCalculus}\right]\right)\&colon;$

$\mathrm{TangentPlane}\left(f\left(x\&comma;y\right)\&comma;x=a\&comma;y=b\right)$

$\left[\begin{array}{c}x\\ y\\ {\mathrm{D}}_1\left(f\right)\left(a\&comma;b\right)\left(x-a\right)+{\mathrm{D}}_2\left(f\right)\left(a\&comma;b\right)\left(y-b\right)+f\left(a\&comma;b\right)\end{array}\right]$

$\mathrm{TangentPlane}\left(⟨s\&comma;t\&comma;s^2+t^2⟩\&comma;s=a\&comma;t=b\right)$

$\left[\begin{array}{c}x\\ y\\ 2a\left(x-a\right)+2b\left(y-b\right)+a^2+b^2\end{array}\right]$

$\mathrm{TangentPlane}\left(\left(s\&comma;t\right)\mapsto ⟨t^2+s^2\&comma;s^2-t^2\&comma;t\cdot s⟩\&comma;s=a\&comma;t=b\right)$

$\left(x\&comma;y\right)\mapsto \mathrm{VectorCalculus}:-\mathrm{Vector}\left(\left[x\&comma;y\&comma;-\frac{-\left(2\cdot a^2+2\cdot b^2\right)\cdot \left(-a^2-b^2+x\right)-\left(-2\cdot a^2+2\cdot b^2\right)\cdot \left(-a^2+b^2+y\right)}{8\cdot a\cdot b}+a\cdot b\right]\&comma;\mathrm{attributes}=\left[\mathrm{positionvector}\&comma;\mathrm{coords}={\mathrm{cartesian}}_{x,y,z}\right]\right)$

$\mathrm{SetCoordinates}\left(\mathrm{spherical}\right)$

${\mathrm{spherical}}_{r,\mathrm{\phi },\mathrm{\theta }}$

$\mathrm{TangentPlane}\left(⟨1\&comma;s\&comma;t⟩\&comma;s=\frac{\mathrm{\pi }}{4}\&comma;t=\frac{\mathrm{\pi }}{2}\right)$

$\left[\begin{array}{c}x\\ y\\ -y+\sqrt{2}\end{array}\right]$

$\mathrm{TangentPlane}\left(r=1\&comma;⟨1\&comma;\frac{\mathrm{\pi }}{4}\&comma;\frac{\mathrm{\pi }}{2}⟩\&comma;\mathrm{outnames}=\left[u\&comma;v\&comma;w\right]\right)$

$\frac{\sqrt{2}\left(v-\frac{\sqrt{2}}{2}\right)}{2}+\frac{\sqrt{2}\left(w-\frac{\sqrt{2}}{2}\right)}{2}=0$

$\mathrm{SetCoordinates}\left('\mathrm{cartesian}'\left[x,y,z\right]\right)$

${\mathrm{cartesian}}_{x,y,z}$

$\mathrm{TangentPlane}\left(\left(x\&comma;y\right)\mapsto y^2+x^2\&comma;x=a\&comma;y=b\right)$

$\left(x\&comma;y\right)\mapsto \mathrm{VectorCalculus}:-\mathrm{Vector}\left(\left[x\&comma;y\&comma;2\cdot a\cdot \left(x-a\right)+2\cdot b\cdot \left(y-b\right)+a^2+b^2\right]\&comma;\mathrm{attributes}=\left[\mathrm{positionvector}\&comma;\mathrm{coords}={\mathrm{cartesian}}_{x,y,z}\right]\right)$

$\mathrm{TangentPlane}\left(x^2+y^2\&comma;x=a\&comma;y=b\right)$

$\left[\begin{array}{c}x\\ y\\ 2a\left(x-a\right)+2b\left(y-b\right)+a^2+b^2\end{array}\right]$

$\mathrm{SetCoordinates}\left('\mathrm{cartesian}'\right)$

$\mathrm{cartesian}$

$\mathrm{TangentPlane}\left(x^2+y^2\&comma;x=a\&comma;y=b\right)$

$\left[\begin{array}{c}x\\ y\\ 2a\left(x-a\right)+2b\left(y-b\right)+a^2+b^2\end{array}\right]$

$\mathrm{`~`}\left[\mathrm{normal}\right]\left(\mathrm{TangentPlane}\left(r^2\mathrm{\theta }\&comma;r=1\&comma;\mathrm{\theta }=\frac{\mathrm{\pi }}{4}\&comma;\mathrm{coords}=\mathrm{spherical}\right)\right)$

$\left[\begin{array}{c}x\\ y\\ -\frac{\sqrt{2}\left(\mathrm{\pi }x+\mathrm{\pi }y-2\mathrm{\pi }-6x+2y\right)}{2\left(2+\mathrm{\pi }\right)}\end{array}\right]$

The Student[VectorCalculus][TangentPlane] command was updated in Maple 17.

The var3, pt, outvars and coordopt parameters were introduced in Maple 17.

For more information on Maple 17 changes, see Updates in Maple 17.