


*********************************************************************

	         	    SU(N) LIBRARY

		AUTHOR MARCO CIOLFI - MARCOCY@MCLINK.IT

*********************************************************************




This libraries contain some functions to build Pauli, Gell-Mann
and Dirac matrices, plus some gadgets useful to play with Dirac
equation, spinors and things of the like.






***		LIBRARY INFO


Free distribution, of course. If you find the libraries useful, please
let me know. Also bug (hopefully not) reports are welcome. Of course,
you use the libraries at your own risk, anyway, up to now, my HP has 
never exploded using SU(N)  :-)

Three versions of the library are provided, SU(N) is the only complete
one, while SUNLT is a light version and SUNNR can handle only numeric
matrices, if you are not veeery short of RAM, SU(N) is the best choice.


	LIB NAME	LIB ID		CHKSUM		SIZE

	SU(N)		1071		#45892d		2618.5

	SUNLT		1072		#60164d		1846.5

	SUNNR		1073		#19633d		1213.5




***		INSTALLING INSTRUCTIONS


To install a library, just upload it and store in a port (also a
covered one) and warmstart. E.g. with SU(N) on the stack, you will see

1:  Library 1071:  SU(N...

now press 0 STO, or <any_other_available_port> STO
and warmstart (ON-C).

To remove a library, as the one in the example above, input

:0:1071  DUP  DETACH  PURGE

and warmstart.




**********************************************************************



		      DESCRIPTION  OF  FUNCTIONS	



**********************************************************************




	LIBRARY SU(N)	



PAULI	syntax:   k <PAULI>  -->  sigma.k   (symb matrix)
	Pauli matrices are the generators of SU(2) in a
	bidimensional representation, and satisfy

	   sigma.i sigma.j  =  delta.ij + i epsilon.ijk sigma.k

	if k is 0, or anything different from 1,2 or 3, PAULI
	outputs identity matrix. 


PAU3	syntax:   k <PAU3>  -->  I.k   (symb matrix)
	These are the generators of a regular representation
	of SU(2) in three dimensions, satisfying the same constraints
	of Pauli matrices, but in 3 dimensions:

	   I.i I.j  =  delta.ij + i epsilon.ijk I.k


GLMN	syntax:   k <GLMN>  -->  lambda.k   (symb matrix)

	Gell-Mann matrices give the fundamental representation
	of group SU(3), they are eight different matrices, plus
	the identity, lambda.0, in three dimensions, and satisfy

				     4
	   {lambda.i , lambda.j}  =  - delta.ij + 2 d.ijk lambda.k
				     3
	and

	   [lambda.i , lambda.j]  =  2 i f.ijk lambda.k

	where f.ijk and d.ijk are the constants of structure
	of the group.


DIRAC 	syntax:   k <DIRAC>  -->  gamma.k   (symb matrix)
	Dirac gamma matrices satisfy the condition

	   {gamma.i , gamma.j}  =  2 g.ij

	where g.ij is the metric tensor.

	NB here gamma.5 is defined as

			     |  0   0   1   0  |
			     |		       |
			     |  0   0   0   1  |
		gamma.5  =   |                 |
			     |  1   0   0   0  |
			     |                 |
			     |  0   1   0   0  |

	Check the notation you corrently use, since the sign
	may be different.


N.B. If flag 3 is set, then the result of PAULI, PAU3, GLMN and DIRAC
     is a numeric matrix, instead of a symbolic one. It is better to
     work with symbolic matrices, but you need an appropriate library
     of functions to do so, as the wonderful ALG48 by Claude-Nicolas
     Fiechter and Mika Heiskanen. Anyway, if you prefer numeric
     matrices instead, keep flag 3 set.


SLASH	syntax:   4vector <SLASH>  -->  slashed 4vector   (symb matrix)

	A 4vector is a four-elements symbolic vector

	   {x.0 x.1 x.2 x.3}

	the slash operation produces
		       ___
		      \	
	   xslash  =   >     x.k gamma.k  
		      /___
		     k=0..3

	Dirac equation, for example, is ( pslash - m ) PSI = 0.

	SLASH checks for the appropriate number and type of arguments,
	producing a "not a 4vector" error or a "bad element type" error
	if the input is wrong (the elements of the 4vector can be real,
	complex numbers, global names or symbolics). e.g. an allowed
	4vector is

		{  Y  'SIN(W)'  (2,-1)  3.1415  }

	whatever it means.


BARR	syntax:   4vector <BARR>  -->  \bar{4vector}

	This function is intended to be used with bispinors like Psi
	(see the following). It produces

			     +
		Psi  -->  Psi  gamma.0

		 +
	where Psi   is the hermitian conjugate of Psi.



q	syntax:   -->  position (symb 4vector)

p	syntax:   -->  momentum (symb 4vector)

	These two commands give position and momentum 4vectors.
	The output depends on the status of flag 5:

			flag 5 set		flag 5 clear

		q	{t x y z}		{q.0 q.1 q.2 q.3}

		p	{E p.x p.y p.z}		{p.0 p.1 p.2 p.3}

	Of course, you need some functions to multiply
	these 4vectors with Dirac matrices.

	SLASH applied on p gives, with flag 5 set:

		     |      E       0        p.z    p.x-ip.y  |
		     |		    		 	      |
		     |      0       E 	  p.x+ip.y    -p.z    |
	  p SLASH =  |    		                      |
		     |    -p.z   -p.x+ip.y    -E        0     |
		     |                 			      |
		     |  -p.x-ip.y    p.z       0       -E     |


m	syntax:   --> mass tensor

	The mass tensor is

			     |  m   0   0   0  |
			     |		       |
			     |  0   m   0   0  |
		      m  =   |                 |
			     |  0   0   m   0  |
			     |                 |
			     |  0   0   0   m  |



Psi	syntax:   -->  PSI (symb 4vector, well, bispinor)

	This is Dirac Psi, here represented as

	   PSI  =  { alpha.+  alpha.-  omega.+  omega.- }


delta.ij	syntax:   i  j  -->  delta.ij
	If i and j are the same (not just integers) the result is 1, 
	otherwise is 0.


epsilon.ijk	syntax:   i  j  k  -->  epsilon.ijk
	This is the completely antisymmetric tensor


			   /   1   ijk = even permutation of 123 
			   |
	   epsilon.ijk  =  <  -1   ijk = odd permutation of 123
			   |
			   \   0   otherwise




****************************************



	LIBRARY SUNLT


This is a light version of SU(N), the functions provided are

PAULI  PAU3  GLMN  DIRAC  SLASH  BARR

and work like the ones of SU(N) -- see above -- but the result is
always a symolic matrix, regardless of the status of flag 3.





****************************************



	LIBRARY SUNNR


This is the numeric version of SU(N), the function are only

PAULI  PAU3  GLMN  DIRAC

and the result is a numeric matrix.




*********************************************************************



	EXAMPLE


Let see how to write Dirac equation. I suppose you use a library like
ALG48 to manipulate symbolic matrices, ASUB and AMUL do subtract and
multiply such objects:

<p>  <SLASH>  <m>  <ASUB> gives the following matrix


		     |     E-m       0       p.z    p.x-ip.y  |
		     |		    		 	      |
		     |      0      E-m 	  p.x+ip.y    -p.z    |
       pslash - m =  |    		                      |
		     |    -p.z   -p.x+ip.y   -E-m       0     |
		     |                 			      |
		     |  -p.x-ip.y    p.z       0      -E-m    |

that gives, multiplied by Psi ( <Psi>  <AMUL> ), the result.

