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

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

\begin{MCalls}
\Mcall{perm}
\end{MCalls}

\begin{MParameters}
  \param{perm}
  \eng{any list denoting a permutation} 
\end{MParameters}

\begin{MIntro}
  \eng{
The {\Mthis} function calculates the  matrix  representing  \Mex{perm} in the
regular  representation. It  amounts   to  consider  \Mex{perm}  as the linear
operator acting on permutations by left multiplication.
}
\end{MIntro}

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

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