User Macro Document - VolumeIntegral

<table cellspacing="0" cellpadding="0"> <tr height="150"> <td align="left"><img src="../../../../img/logo.gif" alt="IAC logo"></img></td> <td width="100%" rowspan="2" align="left" valign="center"> <table cellspacing="0" cellpadding="0"> <tr> <td> <table class="navigate_doc" width="100%" border="0" align="center"> <tr bgcolor="c6c6e0" align="center"> <th nowrap width="1%" height="32">P0185</th> <th nowrap width="98%">VolumeIntegral</th> <th nowrap width="1%">14th December 2001</th> </tr> <tr> <td align="left" colspan="3"> <p><b>Authors:</b> Ian Curington, AVS Inc.; Andy R. Haas, National Center for Toxicological Research;Tobias Schiebeck,IAC <b>Version:</b> 1.0 <b>Path:</b> iac_proj/volint/</p> <a href="../../mappers.shtml" target="_top"><img src="../../../../img/mapper.gif" width="58" height="30" border="0" alt="Mappers"></a> <a href="volint.shtml" target="_top"> <img src="../../../../img/doc_umac.gif" border="0" width="30" height="30" alt="User Macro Document - VolumeIntegral"></a> <a href="source/mappers/volint/volint.tar.gz"> <img src="../../../../img/targz.gif" border="0" width="52" height="30" alt="Archive - volint.tar.gz"></a> <a href="source/mappers/volint/volint.tar.Z"> <img src="../../../../img/tarz.gif" border="0" width="52" height="30" alt="Archive - volint.tar.Z"></a> <a href="source/mappers/volint/volint.zip"> <img src="../../../../img/zip.gif" border="0" width="52" height="30" alt="Archive - volint.zip"></a> <img src="../../../../img/7.1.gif" alt="Tested for AVS/Express Version 7.1" border="0" height="30" width="47"> <img src="../../../../img/64bit.gif" alt="Tested for 64 Bit" border="0" height="30" width="53"> </td> </tr> </table> <br> </td> </tr> <tr> <td>  <h1> VolumeIntegral</h1> <h3> Synopsis</h3> <p>Computes the surface area and the enclosed volume of a surface mesh enclosing some 3D space.</p> <p> <h4> Input Ports</h4> <table class="parameters"> <tr> <td WIDTH="125"><i>in</i></td> <td WIDTH="125">Mesh[+Node_Data]</td> <td WIDTH="300">input field with trianglar or quad 3D cell sets</td> </tr> </table> <h4> Parameters</h4> <table class="parameters"> <tr> <td WIDTH="125"><i>conversion</i></td> <td>Spatial units coordinate space conversion factor, default = 1.0</td> </tr> </table> <h4> Output Ports</h4> <table class="parameters"> <tr> <td WIDTH="125"><i>area</i></td> <td WIDTH="125">Float</td> <td WIDTH="300">resulting surface area value in units **2</td> </tr> <tr> <td WIDTH="125"><i>volume</i></td> <td WIDTH="125">Float</td> <td WIDTH="300">resulting enclosed volume value in units **3</td> </tr> </table> </p> <h3> Description</h3> <p>This module accepts a geometry mesh of triangle or quad cell sets and outputs the object's volume and surface area.  The input is assumed to be a 3D connected mesh enclosing some single volume, where the triangle or quad cells define the surface boundary of the area. This is typical of the isosurface module or isovolume followed by external faces. If the area does not enclose a single volume, then the volume calculations may be incorrect, however the surface area calculation always should report the overall surface area described by the input mesh shape. If the geometric units defining the object are not the desired units, then a conversion factor can be entered, for instance to convert feet to meters. The internal volume of the shape is computed using Gauss' Theorem, rather than by explicitly looking at all cells in the interior. The module will report an error if anything other than linear triangle or quad cell sets are connected. The local Mesh Xform transformation matrix is applied to all coordinates prior to area and volume computation, so if the object is scaled this will be reflected in the resulting computation. <p>This module uses a form of Gauss' Theorem, or Greens' Theorem in Space. This allows a direct computation of the volume enclosed by a single valued continuous closed surface. All surface normals must point "outwards" for this operation to be correct. See notes section for details. The output of external faces may be used under special circumstances, such as for the simple one-cell test cases. If the enclosed volume can be assumed to contain homogeneous material of unit density, then the volume integral will also equal the mass. This module does not attempt to integrate node data, it only operates on the geometric mesh information. <p>This module is a re-implementation of work described in the paper: <p><i>"Quantitative Analysis of Reconstructed Rodent Embryos"</i> Andy R. Haas, Richard A. Strelitz, William S. Branham, Daniel M. Sheehan, R.O.W Sciences Inc., and Division of Reproductive and Developmental Toxicology, National Center for Toxicological Research, Jefferson Arkansas. The paper was presented at the International AVS User and Developer Conference, April 1995, Boston Mass, appearing in the proceedings on page 263. <p>The original AVS5 module "compute volume" described in the paper is also available at the International AVS centre web site at: <br>    http://www.iavsc.org/repository/avs5/output.html#compute_volume</p> <h3> Input Ports</h3> <p><b><i>in</i></b></p> <p>The input field for this module should be the direct output from isosurface or external_faces.</p> <h3> Output Ports</h3> <p><b><i>area, volume</i></b></p> <p>The output scalar values are the result of the area and volume calculations on the input mesh.</p> <h3> Example</h3> <p>An example application VolintegralEg is provided. The dataset water.fld that comes with AVS/Express is used. The values can be seen by float objects in the network editor. The surface mesh used to compute surface area and volume in this example is generated from the isosurface module.</p> <h3> Other Notes</h3> <p>This module makes some critical assumptions about the input triangle mesh. The surface must be closed. It must not self-intersect. All normals must point outwards. The surface must describe one connected volume. None of the triangles or quads can be hidden inside the enclosed volume, that is the interior must be empty. The surface is not restricted to a convex shape. Note that the "external faces" module cannot be relied apon to meet these conditions.  If ANY of these assumptions are invalid, then the resulting numerical computation will be invalid.</p> <h3> Authors</h3> <p> <pre> Ian Curington, AVS Inc., derived from original AVS5 module by </pre> <pre> Andy R. Haas R.O.W. Sciences National Center for Toxicological Research </pre> </p> <h3>Modifications</h3> <p> <pre> Tobias Schiebeck, International AVS Centre </pre> </p> <h3>Contact</h3> <p> <pre> International AVS Centre Manchester Visualization Centre Manchester Computing University of Manchester Oxford Road Manchester United Kingdom M13 9PL </pre> </p>  </td> </tr> </table> </td> </tr> <tr height="100%"> <td class="sideLink" width="25%" align="left" valign="top" nowrap="nowrap"> <p><a href="../../../../general/index.shtml" target="_top">General Information</a></p> <p><a href="../../../../repository/index.shtml" target="_top">Repositories</a></p> <p class="sideLinkLevel2"><a href="../../../new/index.shtml" target="_top">  New Releases</a></p> <p class="sideLinkLevel2"><a href="../../../download/index.shtml" target="_top">  Download</a></p> <p class="sideLinkLevel2"><a href="../../../submit/index.shtml" target="_top">  Submit</a></p> <p class="sideLinkLevel2"><a href="../../../pfiles/index.shtml" target="_top">  Project Files</a></p> <p class="sideLinkLevel2"><a href="../../../avs5/index.shtml" target="_top">  AVS5</a></p> <p class="sideLinkLevel2"><a href="../../../express/index.shtml" target="_top">  AVS/Express</a></p> <p class="sideLinkLevel3"><a href="../../atoz.shtml" target="_top">    A to Z</a></p> <p class="sideLinkLevel3"><a href="../../number.shtml" target="_top">    Project #</a></p> <p></p> <p class="sideLinkLevel3"><a href="../../data_io.shtml" target="_top">    Data IO</a></p> <p class="sideLinkLevel3"><a href="../../filters.shtml" target="_top">    Filters</a></p> <p class="sideLinkLevel3"><a href="../../mappers.shtml" target="_top">    Mappers</a></p> <p class="sideLinkLevel3"><a href="../../misc.shtml" target="_top">    Miscellaneous</a></p> <p class="sideLinkLevel3"><a href="../../special.shtml" target="_top">    Special Projects</a></p> <p class="sideLinkLevel2"><a href="../../../pog/index.shtml" target="_top">  Project Guidelines</a></p> <p><a href="../../../../usergroup/index.shtml" target="_top">User Group</a></p> <p><a href="../../../../training/index.shtml" target="_top">Training Materials</a></p> </td> </tr> </table> <table width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="c6c6e0"> <tr> <td><img src="../../../../img/foot1.gif" alt="IAC" width="155" height="25"></td> <td width="100%"> Last Updated:  22nd January 2008 </td> </tr> </table>