% $Date: 2003/09/15 16:37:45 $ $Author: nthiery $ $Revision: 1.1.1.1 $

\begin{Mhelppage}{RRep2Perm}%
  {V. Prosper}%
  \begin{MInfo}
    \eng{calculates a permutation from its matrix in the regular
      representation}
  \end{MInfo}
  

\begin{MCalls}
  \Mcall{m}
\end{MCalls}

\begin{MParameters}
  \param{m}
  \eng{a square matrix} 
\end{MParameters}

\begin{MIntro}
  \eng{
The {\Mthis} function calculates  a  permutation  from  its  matrix  in
the  regular  representation, that  is  to  say the matrix of the linear
operator "left multiplication by perm".
}
\end{MIntro}

\begin{MExample}{ex1}
\begin{Mexin}
muEC::SG::Perm2RRep( [3,1,2] );
\end{Mexin}
\begin{Mexout}
                    +-                  -+
                    |  0, 0, 0, 1, 0, 0  |
                    |                    |
                    |  0, 0, 1, 0, 0, 0  |
                    |                    |
                    |  0, 0, 0, 0, 0, 1  |
                    |                    |
                    |  0, 0, 0, 0, 1, 0  |
                    |                    |
                    |  1, 0, 0, 0, 0, 0  |
                    |                    |
                    |  0, 1, 0, 0, 0, 0  |
                    +-                  -+
\end{Mexout}
% \begin{Mexout}[hide]
% array(1..6, 1..6,
% (1,1) = 0, (1,2) = 0, (1,3) = 0, (1,4) = 1, (1,5) = 0, (1,6) = 0,
% (2,1) = 0, (2,2) = 0, (2,3) = 1, (2,4) = 0, (2,5) = 0, (2,6) = 0,
% (3,1) = 0, (3,2) = 0, (3,3) = 0, (3,4) = 0, (3,5) = 0, (3,6) = 1,
% (4,1) = 0, (4,2) = 0, (4,3) = 0, (4,4) = 0, (4,5) = 1, (4,6) = 0,
% (5,1) = 1, (5,2) = 0, (5,3) = 0, (5,4) = 0, (5,5) = 0, (5,6) = 0,
% (6,1) = 0, (6,2) = 1, (6,3) = 0, (6,4) = 0, (6,5) = 0, (6,6) = 0 )
% \end{Mexout}
\begin{Mexin}
muEC::SG::RRep2Perm( % );
\end{Mexin}
\begin{Mexout}
                           [3, 1, 2]
\end{Mexout}
\end{MExample}

\MRelatedFunctions{Mat2Perm,Perm2Mat,Perm2RRep}
\end{Mhelppage}
