1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN"> 2<HTML><HEAD> 3 <TITLE>User's Reference - MapToPlane</TITLE> 4 <META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA 5MINING"> 6 <meta http-equiv="content-type" content="text/html;charset=ISO-8859-1"> 7</HEAD><BODY BGCOLOR="#FFFFFF" link="#00004b" vlink="#4b004b"> 8 <TABLE width=510 border=0 cellpadding=0 cellspacing=0> 9 <TR> 10 <TD><IMG src="../images/spacer.gif" width=80 height=1></TD> 11 <TD><IMG src="../images/spacer.gif" width=49 height=1></TD> 12 <TD><IMG src="../images/spacer.gif" width=24 height=1></TD> 13 <TD><IMG src="../images/spacer.gif" width=100 height=1></TD> 14 <TD><IMG src="../images/spacer.gif" width=3 height=1></TD> 15 <TD><IMG src="../images/spacer.gif" width=127 height=1></TD> 16 <TD><IMG src="../images/spacer.gif" width=6 height=1></TD> 17 <TD><IMG src="../images/spacer.gif" width=50 height=1></TD> 18 <TD><IMG src="../images/spacer.gif" width=71 height=1></TD> 19 </TR> 20 <TR> 21 <TD colspan=9><IMG src="../images/flcgh_01.gif" width=510 height=24 alt="OpenDX - Documentation"></TD> 22 </TR> 23 <TR> 24 <TD colspan=2><A href="../allguide.htm"><IMG src="../images/flcgh_02.gif" width=129 height=25 border="0" alt="Full Contents"></A></TD> 25 <TD colspan=3><A href="../qikguide.htm"><IMG src="../images/flcgh_03.gif" width=127 height=25 border="0" alt="QuickStart Guide"></A></TD> 26 <TD><A href="../usrguide.htm"><IMG src="../images/flcgh_04.gif" width=127 height=25 border="0" alt="User's Guide"></A></TD> 27 <TD colspan=3><B><A href="../refguide.htm"><IMG src="../images/flcgh_05d.gif" width=127 height=25 border="0" alt="User's Reference"></A></B></TD> 28 </TR> 29 <TR> 30 <TD><A href="refgu091.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD> 31 <TD colspan=2><A href="refgu093.htm"><IMG src="../images/flcgh_07.gif" width=73 height=17 border="0" alt="Next Page"></A></TD> 32 <TD><A href="../refguide.htm"><IMG src="../images/flcgh_08.gif" width=100 height=17 border="0" alt="Table of Contents"></A></TD> 33 <TD colspan=3><A href="refgu009.htm"><IMG src="../images/flcgh_09.gif" width=136 height=17 border="0" alt="Partial Table of Contents"></A></TD> 34 <TD><A href="refgu175.htm"><IMG src="../images/flcgh_10.gif" width=50 height=17 border="0" alt="Index"></A></TD> 35 <TD><A href="../srchindx.htm"><IMG src="../images/flcgh_11.gif" width=71 height=17 border="0" alt="Search"></A></TD> 36 </TR> 37 </TABLE> 38 <H3><A name="HDRMAPTOPL" ></A>MapToPlane</H3> 39 <A NAME="IDX584"></A><A NAME="IDX585"></A> 40 <P><STRONG>Category</STRONG> 41 <P> 42<A HREF="refgu008.htm#HDRCATREL">Realization</A> 43<A NAME="IDX586"></A> 44<P><STRONG>Function</STRONG> 45<P> 46Maps a 3-dimensional field onto a plane. 47<P><STRONG>Syntax</STRONG> 48<PRE><STRONG> 49plane</STRONG> = MapToPlane(<STRONG>data, point, normal</STRONG>); 50</PRE> 51<P><STRONG>Inputs</STRONG> 52<BR> 53<TABLE BORDER> 54<TR> 55<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Name 56</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Type 57</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Default 58</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">Description 59</TH></TR><TR> 60<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>data</STRONG></TT> 61</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">field 62</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none 63</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">data to be mapped 64</TD></TR><TR> 65<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>point</STRONG></TT> 66</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">vector 67</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">center of object 68</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">a point on the map plane 69</TD></TR><TR> 70<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>normal</STRONG></TT> 71</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">vector 72</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">[0 0 1] 73</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">normal to the map plane 74</TD></TR></TABLE> 75<P><STRONG>Outputs</STRONG> 76<BR> 77<TABLE BORDER> 78<TR> 79<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Name 80</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Type 81</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">Description 82</TH></TR><TR> 83<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>plane</STRONG></TT> 84</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">field 85</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">mapped plane 86</TD></TR></TABLE> 87<P><STRONG>Functional Details</STRONG> 88<P> 89This module creates an arbitrary cutting plane through 3-dimensional 90space and interpolates data values onto it. 91<TABLE CELLPADDING="3"> 92<TR VALIGN="TOP"><TD><P><B><TT><STRONG>data</STRONG></TT> 93</B></TD><TD><P>must be a field with 3-dimensional connections (i.e., cubes or 94tetrahedra). 95</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>point</STRONG></TT> 96</B></TD><TD><P>is a vector value specifying a point on the cutting plane. 97If this parameter is not specified, Data Explorer uses the center of the 98bounding box of <TT><STRONG>data</STRONG></TT>. 99</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>normal</STRONG></TT> 100</B></TD><TD><P>is a vector value specifying the normal to the map plane and is 101interpreted as the end point of a vector from the origin (not 102from <TT><STRONG>point</STRONG></TT>). 103The parameter defaults to [0 0 1]. 104</TD></TR></TABLE> 105<P><B>Notes: </B><OL> 106<P><LI>To create a plane parallel to one of the axes along a connections 107boundary (for regular data) it is more efficient to use the Slab 108module with zero thickness, because it performs no 109interpolation. 110<P><LI>MapToPlane (unlike Slab) adds a "normals" component to the 111plane, so that the result is shaded. 112To eliminate the shading, remove the "normals" component with the 113Remove module or turn off the shading with the Shade module. 114<P><LI>If the specified plane is precisely at the edge of the data, the 115output may or may not appear, depending on the direction of 116<TT><STRONG>normal</STRONG></TT>. 117</OL> 118 119<P><STRONG>Components</STRONG> 120<P> 121Creates new "positions," "connections," and "normals" 122components. 123New "components" of all other input components are created 124(e.g., the "data" component) and contain values 125interpolated from the originals. 126<P><STRONG>Example Visual Programs</STRONG> 127<PRE> 128AlternateVisualizations.net 129ContoursAndCaption.net 130ThunderGlyphSheet.net 131SIMPLE/MapToPlane.net 132</PRE> 133<P><STRONG>See Also</STRONG> 134<P> 135 <A HREF="refgu016.htm#HDRAUTOCOL">AutoColor</A>, 136 <A HREF="refgu091.htm#HDRMAP">Map</A>, 137 <A HREF="refgu116.htm#HDRREMOVE">Remove</A>, 138 <A HREF="refgu125.htm#HDRRUBBERS">RubberSheet</A>, 139 <A HREF="refgu137.htm#HDRSHADE">Shade</A>, 140 <A HREF="refgu143.htm#HDRSLAB">Slab</A> 141 <P> 142 <HR> 143 <DIV align="center"> 144 <P><A href="../allguide.htm"><IMG src="../images/foot-fc.gif" width="94" height="18" border="0" alt="Full Contents"></A> <A href="../qikguide.htm"><IMG src="../images/foot-qs.gif" width="94" height="18" border="0" alt="QuickStart Guide"></A> <A href="../usrguide.htm"><IMG src="../images/foot-ug.gif" width="94" height="18" border="0" alt="User's Guide"></A> <A href="../refguide.htm"><IMG src="../images/foot-ur.gif" width="94" height="18" border="0" alt="User's Reference"></A></P> 145 </DIV> 146 <DIV align="center"> 147 <P><FONT size="-1">[ <A href="http://www.research.ibm.com/dx">OpenDX Home at IBM</A> | <A href="http://www.opendx.org/">OpenDX.org</A> ] </FONT></P> 148 <P></P> 149 </DIV> 150 <P></P> 151 </BODY></HTML> 152