Welcome to Adams/Solver Subroutines - Kxcad.net
Welcome to Adams/Solver Subroutines - Kxcad.net
Welcome to Adams/Solver Subroutines - Kxcad.net
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
Input Arguments<br />
<strong>Welcome</strong> <strong>to</strong> <strong>Adams</strong>/<strong>Solver</strong> <strong>Subroutines</strong><br />
id An integer variable that specifies the ID of the corresponding MATRIX<br />
statement.<br />
size An integer variable that specifies the size of the MATRIX.<br />
GET_FULL_MATRIX_DATA uses this value <strong>to</strong> compare against the<br />
MATRIX’s true size; a check for a valid call.<br />
Output Arguments<br />
vals A double-precision array of size ‘size’ contains the values from the<br />
MATRIX statement.<br />
ierr An integer variable that indicates the success of the call <strong>to</strong><br />
GET_FULL_MATRIX_DATA:<br />
Extended Definition<br />
GET_FULL_MATRIX_DATA returns the values s<strong>to</strong>red in a dataset MATRIX statement of type full. You<br />
can determine the matrix ordering of the matrix data (row or column ordered), by the type that<br />
GET_MATRIX_INFO returns. The order may not be as entered in the MATRIX statement.<br />
GET_MATRIX_INFO<br />
Returns information about a dataset MATRIX statement given the statement identifier (C++ or<br />
FORTRAN).<br />
Use<br />
Called By<br />
Any user-written subroutine<br />
Prerequisite<br />
MATRIX statement in the dataset<br />
• ierr=0 Successful<br />
• ierr=1 Failed, no MATRIX having an<br />
identifier of ID exists in the dataset<br />
• ierr=2 Failed, the value of ‘size’ does not<br />
match the size of the MATRIX<br />
• ierr=3 Failed, the MATRIX type is sparse<br />
Tip: Call GET_MATRIX_INFO <strong>to</strong> get the size and type of the MATRIX.<br />
33
Change language