| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"> |
| <title>SuperLU: SRC/zreadhb.c File Reference</title> |
| <link href="doxygen.css" rel="stylesheet" type="text/css"> |
| <link href="tabs.css" rel="stylesheet" type="text/css"> |
| </head><body> |
| |
| <div class="navigation" id="top"> |
| <div class="tabs"> |
| <ul> |
| <li><a href="index.html"><span>Main Page</span></a></li> |
| <li><a href="annotated.html"><span>Data Structures</span></a></li> |
| <li class="current"><a href="files.html"><span>Files</span></a></li> |
| </ul> |
| </div> |
| </div> |
| <div class="contents"> |
| <h1>SRC/zreadhb.c File Reference</h1>Read a matrix stored in Harwell-Boeing format. <a href="#_details">More...</a> |
| <p> |
| <code>#include <stdio.h></code><br> |
| <code>#include <stdlib.h></code><br> |
| <code>#include "<a class="el" href="slu__zdefs_8h-source.html">slu_zdefs.h</a>"</code><br> |
| <table border="0" cellpadding="0" cellspacing="0"> |
| <tr><td></td></tr> |
| <tr><td colspan="2"><br><h2>Functions</h2></td></tr> |
| <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="zreadhb_8c.html#4c9a9a1484351dcc1ae1a756a18081e7">zDumpLine</a> (FILE *fp)</td></tr> |
| |
| <tr><td class="mdescLeft"> </td><td class="mdescRight">Eat up the rest of the current line. <a href="#4c9a9a1484351dcc1ae1a756a18081e7"></a><br></td></tr> |
| <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="zreadhb_8c.html#b753ef9c907b1298d163150b6e658247">zParseIntFormat</a> (char *buf, int *num, int *size)</td></tr> |
| |
| <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="zreadhb_8c.html#fb86c617e31fa765098b83fd74539b9b">zParseFloatFormat</a> (char *buf, int *num, int *size)</td></tr> |
| |
| <tr><td class="memItemLeft" nowrap align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="zreadhb_8c.html#fbec2a501b92e7e7bb13af2e21520522">ReadVector</a> (FILE *fp, int n, int *where, int perline, int persize)</td></tr> |
| |
| <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="zreadhb_8c.html#321d6efeb00f45e3e4c961dcc3aa0fcc">zReadValues</a> (FILE *fp, int n, <a class="el" href="structdoublecomplex.html">doublecomplex</a> *destination, int perline, int persize)</td></tr> |
| |
| <tr><td class="mdescLeft"> </td><td class="mdescRight">Read <a class="el" href="structcomplex.html">complex</a> numbers as pairs of (real, imaginary). <a href="#321d6efeb00f45e3e4c961dcc3aa0fcc"></a><br></td></tr> |
| <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="zreadhb_8c.html#ff0805af5c8155100799532d3a9613fb">zreadhb</a> (int *nrow, int *ncol, int *nonz, <a class="el" href="structdoublecomplex.html">doublecomplex</a> **nzval, int **rowind, int **colptr)</td></tr> |
| |
| <tr><td class="mdescLeft"> </td><td class="mdescRight">Auxiliary routines. <a href="#ff0805af5c8155100799532d3a9613fb"></a><br></td></tr> |
| </table> |
| <hr><a name="_details"></a><h2>Detailed Description</h2> |
| <pre> |
| -- SuperLU routine (version 2.0) -- |
| Univ. of California Berkeley, Xerox Palo Alto Research Center, |
| and Lawrence Berkeley National Lab. |
| November 15, 1997</pre><p> |
| <pre> Purpose |
| =======</pre><p> |
| <pre> Read a DOUBLE COMPLEX PRECISION matrix stored in Harwell-Boeing format |
| as described below.</pre><p> |
| <pre> Line 1 (A72,A8) |
| Col. 1 - 72 Title (TITLE) |
| Col. 73 - 80 Key (KEY)</pre><p> |
| <pre> Line 2 (5I14) |
| Col. 1 - 14 Total number of lines excluding header (TOTCRD) |
| Col. 15 - 28 Number of lines for pointers (PTRCRD) |
| Col. 29 - 42 Number of lines for row (or variable) indices (INDCRD) |
| Col. 43 - 56 Number of lines for numerical values (VALCRD) |
| Col. 57 - 70 Number of lines for right-hand sides (RHSCRD) |
| (including starting guesses and solution vectors |
| if present) |
| (zero indicates no right-hand side data is present)</pre><p> |
| <pre> Line 3 (A3, 11X, 4I14) |
| Col. 1 - 3 Matrix type (see below) (MXTYPE) |
| Col. 15 - 28 Number of rows (or variables) (NROW) |
| Col. 29 - 42 Number of columns (or elements) (NCOL) |
| Col. 43 - 56 Number of row (or variable) indices (NNZERO) |
| (equal to number of entries for assembled matrices) |
| Col. 57 - 70 Number of elemental matrix entries (NELTVL) |
| (zero in the case of assembled matrices) |
| Line 4 (2A16, 2A20) |
| Col. 1 - 16 Format for pointers (PTRFMT) |
| Col. 17 - 32 Format for row (or variable) indices (INDFMT) |
| Col. 33 - 52 Format for numerical values of coefficient matrix (VALFMT) |
| Col. 53 - 72 Format for numerical values of right-hand sides (RHSFMT)</pre><p> |
| <pre> Line 5 (A3, 11X, 2I14) Only present if there are right-hand sides present |
| Col. 1 Right-hand side type: |
| F for full storage or M for same format as matrix |
| Col. 2 G if a starting vector(s) (Guess) is supplied. (RHSTYP) |
| Col. 3 X if an exact solution vector(s) is supplied. |
| Col. 15 - 28 Number of right-hand sides (NRHS) |
| Col. 29 - 42 Number of row indices (NRHSIX) |
| (ignored in case of unassembled matrices)</pre><p> |
| <pre> The three character type field on line 3 describes the matrix type. |
| The following table lists the permitted values for each of the three |
| characters. As an example of the type field, RSA denotes that the matrix |
| is real, symmetric, and assembled.</pre><p> |
| <pre> First Character: |
| R Real matrix |
| C Complex matrix |
| P Pattern only (no numerical values supplied)</pre><p> |
| <pre> Second Character: |
| S Symmetric |
| U Unsymmetric |
| H Hermitian |
| Z Skew symmetric |
| R Rectangular</pre><p> |
| <pre> Third Character: |
| A Assembled |
| E Elemental matrices (unassembled)</pre><p> |
| <pre> </pre> <hr><h2>Function Documentation</h2> |
| <a class="anchor" name="fbec2a501b92e7e7bb13af2e21520522"></a> |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">static int ReadVector </td> |
| <td>(</td> |
| <td class="paramtype">FILE * </td> |
| <td class="paramname"> <em>fp</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int </td> |
| <td class="paramname"> <em>n</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int * </td> |
| <td class="paramname"> <em>where</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int </td> |
| <td class="paramname"> <em>perline</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int </td> |
| <td class="paramname"> <em>persize</em></td><td> </td> |
| </tr> |
| <tr> |
| <td></td> |
| <td>)</td> |
| <td></td><td></td><td width="100%"><code> [static]</code></td> |
| </tr> |
| </table> |
| </div> |
| <div class="memdoc"> |
| |
| <p> |
| |
| </div> |
| </div><p> |
| <a class="anchor" name="4c9a9a1484351dcc1ae1a756a18081e7"></a> |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">int zDumpLine </td> |
| <td>(</td> |
| <td class="paramtype">FILE * </td> |
| <td class="paramname"> <em>fp</em> </td> |
| <td> ) </td> |
| <td width="100%"></td> |
| </tr> |
| </table> |
| </div> |
| <div class="memdoc"> |
| |
| <p> |
| |
| </div> |
| </div><p> |
| <a class="anchor" name="fb86c617e31fa765098b83fd74539b9b"></a> |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">int zParseFloatFormat </td> |
| <td>(</td> |
| <td class="paramtype">char * </td> |
| <td class="paramname"> <em>buf</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int * </td> |
| <td class="paramname"> <em>num</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int * </td> |
| <td class="paramname"> <em>size</em></td><td> </td> |
| </tr> |
| <tr> |
| <td></td> |
| <td>)</td> |
| <td></td><td></td><td width="100%"></td> |
| </tr> |
| </table> |
| </div> |
| <div class="memdoc"> |
| |
| <p> |
| |
| </div> |
| </div><p> |
| <a class="anchor" name="b753ef9c907b1298d163150b6e658247"></a> |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">int zParseIntFormat </td> |
| <td>(</td> |
| <td class="paramtype">char * </td> |
| <td class="paramname"> <em>buf</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int * </td> |
| <td class="paramname"> <em>num</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int * </td> |
| <td class="paramname"> <em>size</em></td><td> </td> |
| </tr> |
| <tr> |
| <td></td> |
| <td>)</td> |
| <td></td><td></td><td width="100%"></td> |
| </tr> |
| </table> |
| </div> |
| <div class="memdoc"> |
| |
| <p> |
| |
| </div> |
| </div><p> |
| <a class="anchor" name="ff0805af5c8155100799532d3a9613fb"></a> |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">void zreadhb </td> |
| <td>(</td> |
| <td class="paramtype">int * </td> |
| <td class="paramname"> <em>nrow</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int * </td> |
| <td class="paramname"> <em>ncol</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int * </td> |
| <td class="paramname"> <em>nonz</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype"><a class="el" href="structdoublecomplex.html">doublecomplex</a> ** </td> |
| <td class="paramname"> <em>nzval</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int ** </td> |
| <td class="paramname"> <em>rowind</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int ** </td> |
| <td class="paramname"> <em>colptr</em></td><td> </td> |
| </tr> |
| <tr> |
| <td></td> |
| <td>)</td> |
| <td></td><td></td><td width="100%"></td> |
| </tr> |
| </table> |
| </div> |
| <div class="memdoc"> |
| |
| <p> |
| |
| </div> |
| </div><p> |
| <a class="anchor" name="321d6efeb00f45e3e4c961dcc3aa0fcc"></a> |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">int zReadValues </td> |
| <td>(</td> |
| <td class="paramtype">FILE * </td> |
| <td class="paramname"> <em>fp</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int </td> |
| <td class="paramname"> <em>n</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype"><a class="el" href="structdoublecomplex.html">doublecomplex</a> * </td> |
| <td class="paramname"> <em>destination</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int </td> |
| <td class="paramname"> <em>perline</em>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">int </td> |
| <td class="paramname"> <em>persize</em></td><td> </td> |
| </tr> |
| <tr> |
| <td></td> |
| <td>)</td> |
| <td></td><td></td><td width="100%"></td> |
| </tr> |
| </table> |
| </div> |
| <div class="memdoc"> |
| |
| <p> |
| |
| </div> |
| </div><p> |
| </div> |
| <hr size="1"><address style="text-align: right;"><small>Generated on Mon Nov 22 10:23:48 2010 for SuperLU by |
| <a href="http://www.doxygen.org/index.html"> |
| <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address> |
| </body> |
| </html> |