DOCUMENTATION FOR THE PERMANENT MAGNET ROTOR PARAMETRIC MODEL
                                  <PMROTO_H>

  All parameters are to be contained in a single file whose filename
  has the extention "des". (e.g., mach1.des)  The first part of the
  filename is the item entered in the ANSYS Input window when "GET_DIMS" is
  selected from the Toolbar. When entering this filename, the characters
  must be enclosed in single quotes ( e.g.  'mach1'  for the
  parameter file "mach1.des" ).  These parameters can be combined with
  those for the stator into a single file.

  1) The geometry parameters related to the dimensions of the rotor
     are contained the plot file "pm_rotor.doc".  These plots can
     be accessed by the DISPLAY program using the file "pm_rotor.doc".


  2) The parameter file can also contain the material properties:

             Air              Material Number 1
             Rotor iron       Material Number 2
             Rotor magnet     Material Number 3

      If the radial magnitization option is used, the macro will copy the
      properties from material 3 to another material number and reverse the
      sign for the Hc.

      If the parameter file contains material properties, enter into
      the Preprocessor before selecting {GET_DIMS} from the Toolbar.

      The following additional distinction for the air elements in the air
      gap has been made:

               Air on the rotor side of the air gap:   REAL SET  5
               Air on the stator side of the air gap:  REAL SET  6


  3) The remaining scalar parameters are defined below:

       rotor_id='pmrotor'  The rotor model type identifier. (This prevents
                           other model macros from using the data for the
                           PM rotor.)

       rad_mag = 0 for parallel magnitization
                 1 for radial magnitization

       loaf=0    sides of the magnet are radial
           =1    sides of the magnet are circumferential

       embed=0   rotor iron stops at the base of the magnet
            =1   rotor iron stops at the top of the magnet

       npole = number of poles

       nrp   = number of permanent magnets

       nrpgen= number of rotor magnets to be generated

       ggeom = the length conversion factor from the units of the
               parameters to meters (for English to MKS, ggeom=.0254)

       stkthk= length of stack (used in computing the torque)

       rref  = level of mesh refinement for the rotor
               (1 for least refinement, 5 for greatest refinement)


       mname = identification to be printed out in summaries



       Parameters used if the ToolBar is used to build the model:

       USE_53=0, use plane13 elements, =1, use plane53 elements
       F_MESH=mesh control at the back iron, F_MESH=1 least control, F_MESH=4, the mesh
              in the backiron is coarse

    NOTE:

      At the completion of the rotor generation, the rotor elements and
      nodes are contained in the component group "ROTOR". This identification
      is necessary for the other Toolbar items to function.

      The iron and the magnet elements are in the element componen R_IRON