8.5.11 pvtrmm

b=PyPBLAS.pvtrmm(alpha,a,b[,side='L',uplo='U',transa='N',diag='N'])

La función "PyPBLAS.pvtrmm" implementa la siguiente operación entre matrices asumiendo que las matrices a y b son matrices triangulares:

$\begin{displaymath}\alpha \cdot op(A)\times B \to B ; \alpha \cdot B \times op(A) \to B\end{displaymath}$

Donde depende del valor del parámetro "transa":

trans='N': No se se realiza ninguna operación sobre la matriz.
trans='T': Se realiza la transpuesta de : .
trans='C': Se realiza la transpuesta conjugada de : .

En el caso que las dimensiones de alguna de las entradas no sea correcta, la rutina PyPBLASpvtrmm informará de ello y no podrá finalizar la operación.

Esta rutina se provee para matrices con elementos de tipo real y complejo.Las características de cada uno de los parámetros son las siguientes:

Parametros de Entrada
- "alpha":Escalar.
- "a": Matriz de dimensiones $m\times n$ .
- "b": Matriz de dimensiones $m\times n$ .
- "side": Caracter que indica la posición de la matriz a en la operación:
  - side='L': (Valor por defecto).La operación que se realiza es: $\alpha \cdot op(A)\times B \to B$ .
  - side='R': La operación que se realiza es $\alpha \cdot B \times op(A) \to B$ .
- "uplo": Debido a que las matrices son triangulares, con este caracter indicamos en que lado de la diagonal principal se encuentran los datos validos , es decir, si la matriz es triangular superior o inferior :
  - uplo='U': (Valor por defecto).Las matrices son triangulares superiores
  - uplo='L': Las matrices son triangulares inferiores
- "transa": Caracter que indica la opearación a realizar sobre la matriz a:
  - transa='N':No transpuesta, es decir, no se realiza operación.(valor por defecto)
  - transa='T':Transpuesta.
  - transa='C': Transpuesta conjugada.
- "diag": Caracter que indica si la matriz triangular es unitaria o no:
  - diag='N': Matriz triangular NO unitaria (valor por defecto).
  - diag='U': Matriz triangular Unitaria.
- Parametros de Salida
  - "b": Vector distribuido donde se almacena el resultado.

A continuación mostramos un ejemplo en la utilización de esta rutina:

from PyACTS import *
import PyACTS.PyPBLAS as PyPBLAS
from RandomArray import *
from Numeric import *
m,n=8,6
#Initiliaze the Grid
PyACTS.gridinit()
if PyACTS.iread==1:
        print "Example of using PyPBLAS 3: PvTRMM"
        print "N=",n,";nprow x npcol:",PyACTS.nprow,"x",PyACTS.npcol
        print "Block's size:",PyACTS.mb,"*",PyACTS.nb
        a=reshape(range(m*m),[m,m])
        print "a=",a
        b=reshape(range(m*n),[m,n])
        print "b=",b
        alpha=2.
        print "alpha=",alpha
else:
        alpha,a,b=None,None,None
#We convert Numeric Array to PyACTS.Scalapack Array
ACTS_lib=1 # 1=Scalapack
alpha=Scal2PyACTS(alpha,ACTS_lib)
a=Num2PyACTS(a,ACTS_lib)
b=Num2PyACTS(b,ACTS_lib)
#We call PBLAS routine
b= PyPBLAS.pvtrmm(alpha,a,b)
b_num=PyACTS2Num(b)
if PyACTS.iread==1:
        print "PvTRMM=",transpose(b_num)
PyACTS.gridexit()

El resultado de este código es el siguiente:

[vgaliano@localhost EXAMPLES]$ mpirun -np 4 mpipython exPypvtrmm.py
Example of using PyPBLAS 3: PvTRMM
N= 6 ;nprow x npcol: 2 x 2
Block's size: 2 * 2
a= [[ 0  1  2  3  4  5  6  7]
 [ 8  9 10 11 12 13 14 15]
 [16 17 18 19 20 21 22 23]
 [24 25 26 27 28 29 30 31]
 [32 33 34 35 36 37 38 39]
 [40 41 42 43 44 45 46 47]
 [48 49 50 51 52 53 54 55]
 [56 57 58 59 60 61 62 63]]
b= [[ 0  1  2  3  4  5]
 [ 6  7  8  9 10 11]
 [12 13 14 15 16 17]
 [18 19 20 21 22 23]
 [24 25 26 27 28 29]
 [30 31 32 33 34 35]
 [36 37 38 39 40 41]
 [42 43 44 45 46 47]]
alpha= 2.0
PvTRMM= [[  1680.   4368.   6852.   8820.   9960.   9960.   8508.   5292.]
 [  1736.   4536.   7098.   9110.  10260.  10236.   8726.   5418.]
 [  1792.   4704.   7344.   9400.  10560.  10512.   8944.   5544.]
 [  1848.   4872.   7590.   9690.  10860.  10788.   9162.   5670.]
 [  1904.   5040.   7836.   9980.  11160.  11064.   9380.   5796.]
 [  1960.   5208.   8082.  10270.  11460.  11340.   9598.   5922.]]

Los paramentros side, uplo ,transa y diag son parámetros opcionales que tienen un valor establecido por defecto. En el caso que no se especifiquen estos parámetros tomaraán sus valores por defecto. Para especificar un valor diferente se puede realizar del siguiente modo:

b=PyPBLAS.pvtrmm(alpha,a,b,side='R',uplo='L')

See Sobre este documento... para sugerencias en cambios.