<!DOCTYPE html
  PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<!--
Copyright (c) 2006 UGS Corp.

All Rights Reserved.

This software and related documentation are proprietary to UGS Corp.
-->
<html>
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <title>Object-Related Functions</title>
      <script language="javaScript">
        abridged="false";
        displayConditions=new Array();
      </script>
      <link type="text/css" href="../css/main_styles.css" rel="stylesheet">
   </head>
   <body class="bodydocs" onload="top.pageLoader()" bgcolor="#FFFFFF">
      <div class="title_topic4" id="xps10_pagetitle">Object-Related Functions</div>
      <hr noshade="true">
      <p class="para_topic"> <a class="links" href="javascript:void(0)" onclick="top.openFile('shared_func/tls_spd_gwy_extfunc_obj_3_r.html');return(false);">Mass3D Functions</a></p>
      <p class="para_topic">Object-related functions generally work on a specific NX object. In order to use an NX object with one of these spreadsheet functions, you will need to assign an NX name attribute to the object.</p>
      <table border="0">
         <tr>
            <td valign="top" align="left"><img align="left" src="../graphics/note.gif" alt="Note" title="Note"></td>
            <td valign="bottom" align="left" width="100%">
               <div class="para_note">
                  <p class="para_note_body">  Object-related functions may take string or numeric arguments. String arguments such as &quot;object_name&quot; may be specified by the string in double quotes, such as &quot;LINE1&quot;, or by a cell reference to that string.</p>
               </div>
            </td>
         </tr>
      </table>
      <div class="title_division">UGATTR( &quot;object_name&quot;, &quot;attribute_title&quot;, attribute_type)</div>
      <p class="para_division">Returns an NX attribute value given an NX object name, a user-defined attribute title, and a numeric attribute type. The numeric attribute type may be:</p>
      <p class="para_division">1 = integer attribute 2 = real attribute 3 = string attribute 4 = reference attribute</p>
      <p class="para_division">If the object name is the string &quot;PART&quot;, then the specified work part attribute title and type will be returned.</p>
      <div class="title_division">UGNAMES()</div>
      <p class="para_division">Returns the object name, object type and subtype, and layer of all named geometric objects in the work part. One row of information will be returned per object.</p>
      <div class="title_division">ALLATTR(&quot;object_name&quot;)</div>
      <p class="para_division">Returns all the integer, real, and string attribute titles and types associated with a given object. If the object name is the string &quot;PART&quot;; then all integers, real, and string part attribute titles and types will be returned.</p>
      <div class="title_division">ARCLEN( &quot;object_name&quot;, param1, param2, units )</div>
      <p class="para_division">Returns arc length of a curve between two parameter values param1 and param2. This function will work on any curve type, such as arcs, circles, conics, and lines.</p>
      <p class="para_division">Parameter values are from 0.0 to 1.0. Units' conversion is a number from 1 to 4, where:</p>
      <p class="para_division">1 = INCHES 2 = MILLIMETERS 3 = CENTIMETERS 4 = METERS</p>
      <p class="para_division">If the object is not a curve, you will get the message:</p>
      <p class="para_division">@ARCLEN: Curve object type required.</p>
      <div class="title_division">EVALCRV( &quot;object_name&quot;, eval_type, param1, param2, steps)</div>
      <p class="para_division">Returns curve evaluation information for a number of steps along a curve between two parameter values param1 and param2.</p>
      <p class="para_division">Parameter values range from 0.0 to 1.0, and the number of steps can be from 1 to 100. Curve evaluation types are:</p>
      <table cellspacing="3" width="100%" align="center">
         <tr>
            <th bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_th">Type</p>
            </th>
            <th bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_th"># Values</p>
            </th>
            <th bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_th">Description</p>
            </th>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Point</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">2</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Curvature</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Normalized curvature</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">4</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Tangent</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">5</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Binormal</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">6</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Principal Normal</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">7</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Torsion</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">8</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Derivative</p>
            </td>
         </tr>
      </table><br><p class="para_division">When multiple steps are used between parameter values the first column will contain the evaluated parameter value, and the column(s) to the right will contain the data value(s), so that the data is in a form acceptable to the graphing functions in the spreadsheet.</p>
      <p class="para_division">As with ARCLEN, this function will work on any curve type and will return an error message if the object is not a curve.</p>
      <div class="title_division">EVALSRF( &quot;object_name&quot;, eval_type, umin, umax, numu, vmin, vmax, numv )</div>
      <p class="para_division">For EVALSRF, the object must be a face. The function returns surface evaluation information for a number of steps in u and v between two parameter values.</p>
      <p class="para_division">Parameter values range from 0.0 to 1.0, number of steps from 1 to 100. Surface evaluation types are:</p>
      <table cellspacing="3" width="100%" align="center">
         <tr>
            <th bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_th">Type</p>
            </th>
            <th bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_th"># Values</p>
            </th>
            <th bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_th">Description</p>
            </th>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Gaussian curvature</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">2</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Mean curvature</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Min radius</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">4</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Max radius</p>
            </td>
         </tr>
      </table><br><p class="para_division">When multiple steps are used between parameter values, the output will be in a form compatible with the graphing functions. If just u or v are changing, you get output in the same form as @EVALCRV. If both u and v are changing you get output compatible with a surface graph.</p>
      <div class="title_division">POINT( &quot;object_name&quot; )</div>
      <p class="para_division">Returns the &quot;defining&quot; xyz position for object in the current cell and the next two columns. For circles, arcs, and elliptical conics, the center of the circle is returned. For planes and coordinate systems, the object origin is returned.</p>
      <p class="para_division">To use the POINT function:</p>
      <ol type="1" start="1">
         <li>
            <p class="para_item">Enter the Spreadsheet and select three adjacent rows.</p>
         </li>
         <li>
            <p class="para_item">For Excel, enter: =POINT(&quot;&lt;name&gt;&quot;) For Xess, enter: =@POINT(&quot;&lt;name&gt;&quot;)</p>
         </li>
         <li>
            <p class="para_item">To evaluate the coordinates and populate the cells, press Ctrl+Shift+Enter.</p>
         </li>
      </ol>
      <p class="para_division">The function recognizes the following types of NX objects:</p>
      <p class="para_division">RM_point_type RM_gfem_node_type RM_mdm_analysis_pt_type RM_conic_type RM_circle_type RM_coordinate_system_type RM_plane_type</p>
      <p class="para_division">Use of other object types will result in the error message:</p>
      <p class="para_division">@POINT: Unable to process object type.</p>
      <div class="title_division">MASS3D( &quot;object_name&quot;, type, units)</div>
      <p class="para_division">Returns mass properties for a named sheet or solid body, or all sheets or solids in a part or assembly component.</p>
      <p class="para_division">Single return values are returned in the cell. Multiple values are returned in sets of 3 columns. When all properties (type=0) are returned, each property is placed in consecutive rows of the spreadsheet. Multiple values for a property are placed in adjacent columns.</p>
      <table border="0">
         <tr>
            <td valign="top" align="left"><img align="left" src="../graphics/note.gif" alt="Note" title="Note"></td>
            <td valign="bottom" align="left" width="100%">
               <div class="para_note">
                  <p class="para_note_body">In Excel, when using functions that output to multiple cells, you must first select the cells that the function will use, type in the function (=UGNAMES(), =ALLATTR(&quot;part&quot;), etc.), and then press Ctrl-Shift-Enter.  You may have to estimate how many cell to select. If you select too many cells, &quot;#N/A&quot; will appear in the extra ones. If you select too few, data will still appear in those that you did select but the remaining data will be truncated.  For type=0, select 66 rows, and two columns.  For type=4, select one row,and three columns.</p>
               </div>
            </td>
         </tr>
      </table>
      <p class="para_division">Values for &quot;object_name&quot; are:</p>
      <table cellspacing="3" width="80%" align="center">
         <tr>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">&quot;object name string&quot;</p>
            </td>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">name of a single sheet body or solid object</p>
            </td>
         </tr>
         <tr>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">PART</p>
            </td>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">extracts mass properties for all sheets and solids in the part</p>
            </td>
         </tr>
         <tr>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">SOLIDS</p>
            </td>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">extracts mass properties for all solids in the part</p>
            </td>
         </tr>
         <tr>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">SHEETS</p>
            </td>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">extracts mass properties for all sheets in the part</p>
            </td>
         </tr>
         <tr>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">Assembly Component Part Name</p>
            </td>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">extracts mass properties for all sheets and solids in the component part</p>
            </td>
         </tr>
      </table><br><p class="para_division">Units are:</p>
      <table cellspacing="3" width="50%" align="center">
         <tr>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">1</p>
            </td>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">pounds &amp; inches</p>
            </td>
         </tr>
         <tr>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">2</p>
            </td>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">pounds &amp; feet</p>
            </td>
         </tr>
         <tr>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">3</p>
            </td>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">grams &amp; centimeters</p>
            </td>
         </tr>
         <tr>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">4</p>
            </td>
            <td colspan="1" rowspan="1" valign="top">
               <p class="para_td">kilograms &amp; meters</p>
            </td>
         </tr>
      </table><br><p class="para_division">Values for the type field are shown below.</p>
      <table cellspacing="3" width="90%" align="center">
         <tr>
            <th bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_th">Type</p>
            </th>
            <th bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_th"># Values</p>
            </th>
            <th bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_th">Description</p>
            </th>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">0</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">42</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">All properties</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Area</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">2</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Volume</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Mass</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">4</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Center of Mass (CofM), WCS</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">5</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">First Moments, WCS Axes and Origin</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">6</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Moments of Inertia with respect to (w.r.t.) WCS Axes and Origin</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">7</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Moments of Inertia w.r.t. CofM Origin/WCS Axes</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">8</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Spherical Moment of Inertia w.r.t. CofM Origin/ WCS Axes</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">9</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Inertia Products w.r.t. WCS Axes and Origin</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">10</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Inertia Products w.r.t. CofM Origin/WCS Axes</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">11</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">3x3=9</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Principal Axes, WCS</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">12</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Principal Moments w.r.t. CofM Origin</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">13</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Radii Of Gyration w.r.t. WCS Axes and Origin</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">14</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">3</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Radii Of Gyration w.r.t. CofM</p>
               <p class="para_td">Origin/WCS Axes</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">15</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Spherical Radius of Gyration w.r.t. CofM Origin/WCS Axes</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">16</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">1</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Density</p>
            </td>
         </tr>
      </table><br></body>
</html>