Difference between revisions of "ApCoCoA-1:IML.Solve"

From ApCoCoAWiki
(Description update.)
Line 1: Line 1:
 
<command>
 
<command>
<title>IML.Solve</title>
+
  <title>IML.Solve</title>
<short_description>Solve a linear equation system.</short_description>
+
  <short_description>Solve a linear equation system.</short_description>
<syntax>
+
  <syntax>IML.Solve(M:MAT, B:MAT):MAT</syntax>
IML.Solve(M:MAT, B:MAT):MAT
+
  <description>
</syntax>
 
<description>
 
 
<em>Please note:</em> The function(s) explained on this page is/are using the <em>ApCoCoAServer</em>. You will have to start the ApCoCoAServer in order to use it/them.
 
<em>Please note:</em> The function(s) explained on this page is/are using the <em>ApCoCoAServer</em>. You will have to start the ApCoCoAServer in order to use it/them.
 
<par/>
 
<par/>
Line 40: Line 38:
 
-------------------------------
 
-------------------------------
 
</example>
 
</example>
</description>
+
  </description>
<see>LinBox.Solve</see>
+
  <see>LinBox.Solve</see>
<see>LinKer</see>
+
  <see>LinKer</see>
<types>
+
  <types>
  <type>matrix</type>
+
    <type>matrix</type>
  <type>apcocoaserver</type>
+
    <type>apcocoaserver</type>
</types>
+
  </types>
<key>Solve</key>
+
  <key>Solve</key>
<key>IML.Solve</key>
+
  <key>IML.Solve</key>
<key>iml.Solve</key>
+
  <key>iml.Solve</key>
<key>solve linear equation system</key>
+
  <key>solve linear equation system</key>
<key>solve linear equation</key>
+
  <key>solve linear equation</key>
<wiki-category>Package_iml</wiki-category>
+
  <wiki-category>Package_iml</wiki-category>
 
</command>
 
</command>

Revision as of 11:44, 24 April 2009

IML.Solve

Solve a linear equation system.

Syntax

IML.Solve(M:MAT, B:MAT):MAT

Description

Please note: The function(s) explained on this page is/are using the ApCoCoAServer. You will have to start the ApCoCoAServer in order to use it/them.

Let M and B be matrices defined over the ring of integers, a finite field or the field of rationals. This function tries to solve the linear equation system M*X = B by using the ApCoCoAServer supported by the IML library.

The return value will be a solution vector of the linear equation system or an empty matrix if no solution has been found.

  • @param M A matrix with components either of type INT, ZMOD or RAT.

  • @param B A matrix with components either of type INT, ZMOD or RAT.

  • @return A matrix X representing a solution vector of the linear equation system M*X = B if a solution exists or the empty matrix otherwise.

Example

Use ZZ/(19)[x];
M := BringIn(Mat([[1,3,4], [0,2,1]]));
B := BringIn(Mat([[1], [2]]));
IML.Solve(M, B);
-------------------------------
Mat([
  [-2 % 19],
  [1 % 19],
  [0 % 19]
])
-------------------------------

Example

Use QQ[x];
M := Mat([ [1,3,4], [0,2,1], [1,3,4] ]);
B := Mat([ [1], [2], [0] ]);
IML.Solve(M, B);
-------------------------------
Mat([
  [ ]
])
-------------------------------

LinBox.Solve

LinKer