<!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>DMIG</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">
      <hr noshade="true">
      <div class="title_refTopic" id="xps10_pagetitle">DMIG </div>
      <hr noshade="true">
      <h4 class="refClassification">Direct Matrix Input at Points </h4>
      <p class="para_refTopic">Defines direct input matrices related to grid, extra, and/or scalar points.  The matrix is defined by a single header entry and one or more column entries.  A column entry is required for each column with nonzero elements. </p>
      <div class="title_refCategory">Header Entry Format: </div>
      <div class="refCategoryContent">
         <table border="1" width="100%" align="center">
            <colgroup span="1">
               <col span="1" width="9.94*">
               <col span="1" width="9.94*">
               <col span="1" width="9.94*">
               <col span="1" width="9.94*">
               <col span="1" width="9.94*">
               <col span="1" width="9.94*">
               <col span="1" width="10.54*">
               <col span="1" width="9.94*">
               <col span="1" width="9.94*">
               <col span="1" width="9.94*">
            </colgroup>
            <thead>
               <tr>
                  <th align="center" colspan="1" rowspan="1">
                     <p class="para_th">1 </p>
                  </th>
                  <th align="center" colspan="1" rowspan="1">
                     <p class="para_th">2 </p>
                  </th>
                  <th align="center" colspan="1" rowspan="1">
                     <p class="para_th">3 </p>
                  </th>
                  <th align="center" colspan="1" rowspan="1">
                     <p class="para_th">4 </p>
                  </th>
                  <th align="center" colspan="1" rowspan="1">
                     <p class="para_th">5 </p>
                  </th>
                  <th align="center" colspan="1" rowspan="1">
                     <p class="para_th">6 </p>
                  </th>
                  <th align="center" colspan="1" rowspan="1">
                     <p class="para_th">7 </p>
                  </th>
                  <th align="center" colspan="1" rowspan="1">
                     <p class="para_th">8 </p>
                  </th>
                  <th align="center" colspan="1" rowspan="1">
                     <p class="para_th">9 </p>
                  </th>
                  <th align="center" colspan="1" rowspan="1">
                     <p class="para_th">10 </p>
                  </th>
               </tr>
            </thead>
            <tbody>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">DMIG </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">NAME </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&ldquo;0&quot; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">IFO </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">TIN </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">TOUT </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">POLAR </p>
                  </td>
                  <td align="center" bgcolor="gray" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">NCOL </p>
                  </td>
                  <td align="center" bgcolor="gray" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
               </tr>
            </tbody>
         </table><br></div>
      <div class="title_refCategory">Column Entry Format: </div>
      <div class="refCategoryContent">
         <table border="1" width="100%" align="center">
            <colgroup span="1">
               <col span="1" width="9.92*">
               <col span="1" width="11.31*">
               <col span="1" width="9.92*">
               <col span="1" width="9.92*">
               <col span="1" width="9.92*">
               <col span="1" width="9.92*">
               <col span="1" width="10.52*">
               <col span="1" width="9.92*">
               <col span="1" width="9.92*">
               <col span="1" width="8.73*">
            </colgroup>
            <tbody>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">DMIG </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">NAME </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">GJ </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">CJ </p>
                  </td>
                  <td align="center" bgcolor="gray" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">G1 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">C1 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">A1 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">B1 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">G2 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">C2 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">A2 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">B2 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">-etc.- </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
               </tr>
            </tbody>
         </table><br></div>
      <div class="title_refCategory">Example: </div>
      <div class="refCategoryContent">
         <table border="1" width="100%" align="center">
            <colgroup span="1">
               <col span="1" width="10*">
               <col span="1" width="10*">
               <col span="1" width="10*">
               <col span="1" width="10*">
               <col span="1" width="10*">
               <col span="1" width="10*">
               <col span="1" width="10*">
               <col span="1" width="10*">
               <col span="1" width="10*">
               <col span="1" width="10*">
            </colgroup>
            <tbody>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">DMIG </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">STIF </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">0 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">1 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">3 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">4 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">DMIG </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">STIF </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">27 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">1 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">2 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">3 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">3.+5 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">3.+3 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">2 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">4 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">2.5+10 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">0. </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">50 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">1.0 </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">0. </p>
                  </td>
                  <td align="center" colspan="1" rowspan="1">
                     <p class="para_td">&nbsp; </p>
                  </td>
               </tr>
            </tbody>
         </table><br></div>
      <div class="title_refCategory">Fields:</div>
      <div class="refCategoryContent">
         <table cellpadding="10" width="100%" align="center">
            <colgroup span="1">
               <col span="1" width="16*">
               <col span="1" width="84*">
            </colgroup>
            <thead>
               <tr>
                  <th align="left" colspan="1" rowspan="1">
                     <p class="para_th"><b class="uiTerm">Field </b></p>
                  </th>
                  <th align="left" colspan="1" rowspan="1">
                     <p class="para_th"><b class="uiTerm">Contents </b></p>
                  </th>
               </tr>
            </thead>
            <tbody>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">NAME </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Name of the matrix.  See Remark <a class="links" href="javascript:void(0)" onclick="top.openFile('QRG/15topic_16.html#ref69391');return(false);">17-1. </a> (One to eight alphanumeric characters, the first of which is alphabetic.) 
                     </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">IFO </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Form of matrix input.  IFO = 6 must be specified for matrices selected by the K2GG, M2GG, B2GG, and K42GG Case Control commands.  (Integer) </p>
                     <p class="para_td">1 = Square </p>
                     <p class="para_td">9 or 2 = Rectangular </p>
                     <p class="para_td">6 = Symmetric </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">TIN </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Type of matrix being input. (Integer) </p>
                     <p class="para_td">1 = Real, single precision (One field is used per element.) </p>
                     <p class="para_td">2 = Real, double precision (One field is used per element.) </p>
                     <p class="para_td">3 = Complex, single precision (Two fields are used per element.) </p>
                     <p class="para_td">4 = Complex, double precision (Two fields are used per element.) </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">TOUT </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Type of matrix that will be created:  (Integer) </p>
                     <p class="para_td">0 = Set by precision system cell (Default) </p>
                     <p class="para_td">1 = Real, single precision </p>
                     <p class="para_td">2 = Real, double precision </p>
                     <p class="para_td">3 = Complex, single precision </p>
                     <p class="para_td">4 = Complex, double precision </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">POLAR </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Input format of Ai, Bi.  (Integer=blank or 0 indicates real, imaginary format; Integer&gt;0 indicates amplitude, phase format.) </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">NCOL </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Number of columns in a rectangular matrix.  Used only for IFO = 9. See Remarks <a class="links" href="javascript:void(0)" onclick="top.openFile('QRG/15topic_16.html#ref27244');return(false);">17-5. </a> and <a class="links" href="javascript:void(0)" onclick="top.openFile('QRG/15topic_16.html#ref26312');return(false);">17-6. </a> (Integer&gt;0) 
                     </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">GJ </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Grid, scalar or extra point identification number for a column index.  (Integer&gt;0) </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">CJ </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Component number for a grid point GJ.  (0&lt;Integer &le; 6; blank or zero if GJ is a scalar or extra point.) </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Gi </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Grid, scalar, or extra point identification number for a row index.  (Integer&gt;0) </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Ci </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Component number for Gi for a grid point.  (0&lt;CJ &le; 6 ; blank or zero if Gi is a scalar or extra point.) </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Ai, Bi </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Real and imaginary (or amplitude and phase) parts of a matrix element.  If the matrix is real (TIN = 1 or 2), then Bi must be blank.  (Real) </p>
                  </td>
               </tr>
            </tbody>
         </table><br></div>
      <div class="title_refCategory">Remarks: </div>
      <div class="refCategoryContent">
         <ol type="1" start="1">
            <li><a name="ref69391"></a><p class="para_item">Matrices defined on this entry may be used in dynamics by selection in the Case Control with K2PP  = NAME, or B2PP  =  NAME, or M2PP =  NAME for [<em>K</em><em><sub class="subscript">pp</sub></em>], [<em>B</em><em><sub class="subscript">pp</sub></em>], or [<em>M</em><em><sub class="subscript">pp</sub></em>], respectively.  Matrices may also be selected for all solution sequences with K2GG = NAME, or B2GG = NAME, or M2GG = NAME, or K42GG = NAME.  The g-set matrices are added to the structural matrices before constraints are applied, while p-set matrices are added in dynamics after constraints are applied.  Load matrices may be selected by P2G = NAME for dynamic and superelement analyses. 
               </p>
            </li>
            <li>
               <p class="para_item">The header entry containing IFO, TIN and TOUT is required.  Each nonnull column is started with a GJ, CJ pair.  The entries for each row of that column follows.  Only nonzero terms need be entered.  The terms may be input in arbitrary order.  A GJ, CJ pair may be entered more than once, but input of an element of the matrix more than once will produce a fatal message. </p>
            </li>
            <li>
               <p class="para_item">Field 3 of the header entry must contain an integer 0. </p>
            </li>
            <li>
               <p class="para_item">For symmetric matrices (IFO  =  6), a given off-diagonal element may be input either below or above the diagonal.  While upper and lower triangle terms may be mixed, a fatal message will be issued if an element is input both below and above the diagonal. </p>
            </li>
            <li><a name="ref27244"></a><p class="para_item">The recommended format for rectangular matrices requires the use of NCOL and IFO  =  9.  The number of columns in the matrix is NCOL.  (The number of rows in all DMIG matrices is always either p-set or g-set size, depending on the context.)  The GJ term is used for the column index.  The CJ term is ignored. </p>
            </li>
            <li><a name="ref26312"></a><p class="para_item">If NCOL is not used for rectangular matrices, two different conventions are available: </p>
               <ul>
                  <li>
                     <p class="para_item">If IFO  =  9, GJ and CJ will determine the sorted sequence, but will otherwise be ignored; a rectangular matrix will be generated with the columns submitted being in the 1 to N positions, where N is the number of logical entries submitted (not counting the header entry). </p>
                  </li>
                  <li>
                     <p class="para_item">If IFO  =  2, the number of columns of the rectangular matrix will be equal to the index of the highest numbered non-null column (in internal sort).  Trailing null columns of the g- or p-size matrix will be truncated. </p>
                  </li>
               </ul>
            </li>
            <li>
               <p class="para_item">The matrix names must be unique among all DMIGs. </p>
            </li>
            <li>
               <p class="para_item">TIN should be set consistent with the number of decimal digits required to read the input data adequately.  For a single-precision specification on a short-word machine, the input will be truncated after about eight decimal digits, even when more digits are present in a double-field format.  If more digits are needed, a double precision specification should be used instead.  However, note that a double precision specification requires a &ldquo;D&rdquo; type exponent even for terms that do not need an exponent.  For example, unity may be input as 1.0 in single precision, but the longer form 1.0D0 is required for double precision. </p>
            </li>
            <li>
               <p class="para_item">On long-word machines, almost all matrix calculations are performed in single precision and on short-word machines, in double precision.  It is recommended that DMIG matrices also follow these conventions for a balance of efficiency and reliability.  The recommended value for TOUT is 0, which instructs the program to inspect the system cell that measures the machine precision at run time and sets the precision of the matrix to the same value.  TOUT = 0 allows the same DMIG input to be used on any machine.  If TOUT is contrary to the machine type specified (for example, a TOUT of 1 on a short-word machine), unreliable results may occur. </p>
            </li>
            <li>
               <p class="para_item">If any DMIG entry is changed or added on restart then a complete re-analysis is performed.  Therefore, DMIG entry changes or additions are not recommended on restart. </p>
            </li>
         </ol>
      </div>
   </body>
</html>