EXPLANATION OF THE MACHINE TOOLBAR ITEMS


         The purpose of the ToolBar is to provide easy access to model generation,
         solution, and post processing macros, as well certain ANSYS commands.
         The description provided below documents the overall functionality and a brief
         dcescription of the input for which the user will be prompted.  At the end of
         this description, the relationship of the ToolBar to the macros is specified.
         At the top of each macro, a detailed desciption of the macro and options
         is provided.



          TOOLBAR NAME                        DESCRIPTION


        DOCUMENTATION:

            MAG_HELP               LISTS THE EXPLANATION OF THE TOOLBAR ITEMS

            STATOR_H               DEFINES THE PARAMETERS TO GENERATE A slotted  STATOR

            RSLOT_H                DEFINES THE PARAMETERS TO GENERATE A SLOTTED STATOR

            PMSTAT_H               DEFINES THE PARAMETERS TO GENERATE A PM STATOR

            SLOT_R_H               DEFINES THE PARAMETERS TO GENERATE A SLOTTED ROTOR

            PMROTO_H               DEFINES THE PARAMETERS TO GENERATE A PM  ROTOR

            HOW_TO                 DESCRIBES THE PROCESS OF GENERATING A MODEL
                                   AND PERFORMING AN ANALYSIS and POST PROCESSING
                                   Contains listing of example parameter files.
                                   ( for a 2D model).  Further details can be found
                                   in the dc-machine1.ppt power point file.

         UTILITY:


            PICK_NOD               GENERATES A NEW SUBSET of NODES FROM THE
                                   DEFINED NODE SET.  THE "PICKER BOX"
                                   IS DISPLAYED TO SELECT THE METHOD OF NODE
                                   SELECTION.

            PICK_ELE               GENERATES A NEW SUBSET of ELEMENTS FROM THE
                                   DEFINED NODE SET.  THE "PICKER BOX"
                                   IS DISPLAYED TO SELECT THE METHOD OF ELEMENT
                                   SELECTION.

            GET_DIMS               Reads the ASCII file input at the prompt.  The file
                                   is assumed to have a file extention .des.  This file
                                   is intended to contain all the parameters for
                                   the model to be constructed.


         GEOMETRY GENERATION:


            STATOR                 GENERATES A uniform tooth shank STATOR.
                                   PARAMETERS MUST ALREADY BE LOADED FROM
                                   THE PARAMETER FILE
                                   (Template description is accessed by <STATOR_H>)

            RSLOT                  GENERATES A RECTANGULAR SLOTTED STATOR.
                                   (Template description is accessed by <RSLOT_H>)

            PMSTATOR               GENERATES A PM STATOR.  PARAMETERS MUST
                                   ALREADY BE LOADED FROM THE PARAMETER FILE
                                   (Template description is accessed by <PMSTAT_H>)


            SLOT_R                 BUILDS SLOTTED ROTOR.  PARAMETERS MUST
                                   ALREADY BE LOADED FROM THE PARAMETER FILE
                                   (Template description is accessed by <SLOT_R_H>)

            PMROTOR                BUILDS PM ROTOR. PARAMETERS MUST
                                   ALREADY BE LOADED FROM THE PARAMETER FILE
                                   (Template description is accessed by <PMROTO_H>)


          BOUNDARY CONDITIONS  (2 D models):

            EVEN_BC                APPLIES EVEN PERIODIC BOUNDARY CONDITIONS
                                   TO THE SIDE OF THE MODEL  (USED FOR EVEN
                                   NUMBER OF POLES). THIS MUST BE USED PRIOR
                                   TO USING THE <ROTATE> TOOLBAR ITEM.


            ROTATE                 ROTATES THE ROTOR AND CONNECTS IT TO THE
                                   STATOR MODEL.  User is prompted for the angle
                                   of rotation, which is a mechanical angle, measured
                                   from the +X axis in a CCW direction.

            WIND_2D                Builds the winding based on the specification
                                   in the winding file.  See mach2.wnd for an
                                   example.  The user is prompted for the name
                                   of the winding file (must be enclosed in single
                                   quotes 'mach2'  and the file extention must be
                                   .wnd), the component name of the elements in the
                                   slots, which defaults to 's_coil' for the
                                   elements in the stator slots.

            PLOT_WND               Plots the winding by using volumes to display
                                   the coils defined in the winding file, which
                                   was generated by WIND_2D

            PLT_FORM               Displays the current form which was input
                                   with the other parameters for this model.

            LOAD                   APPLIES THE CURRENT DENSITIES TO THE STATOR.
                                   User is prompted for the electrical angle and
                                   the peak current.  The winding must already
                                   have been input using <wind_2d>

            DELECURR               Deletes all currents in the entire model

            COIL_SEL               Uses the current set of elements which has been selected
                                   using PICK_ELEM in the coil region (rotor or stator)
                                   and selects all the elements in the remainder of the coil
                                   cross. This is used before using DC_LOAD


            DC_LOAD                Applies Amp-turns to the active elements. Select the
                                   coil elements first using COIL_SEL before using this Toolbar.
                                   The user is prompted for the Amp-turns that is to be applied
                                   to each coil cross section
         SOLUTION:

            SOLUTION               PERFORMS  a single SOLUTION

            ROT_CONS               Rotates the machine , with no load or with
                                   an existing current load to the coils, solves
                                   and computes the torque and generates a plot
                                   for each rotor position. The model is connected
                                   together  with CE's.  The starting,ending,
                                   increment angles are specified in the input. A plot
                                   file "mname".f33 contains a plot for each position
                                   solved.

            ROT_CURR               Rotates the machine , with current load for which a
                                   a wave form (sine, see mach2.des) has been specified,
                                   solves and computes the torque and generates a plot
                                   for each rotor position. The model is connected
                                   together  with CE's.  The starting ,ending,
                                   increment mechanical angles, the starting electrical
                                   angle are specified in the input. A plot
                                   file "mname".f33 contains a plot for each position
                                   solved.

           MACH_IND               COMPUTES INDUCTANCE MATRIX-SEE M_INDUC.MAC
                                  FOR DOCUMENTATION.  User is prompted for the winding
                                  file, the rotor position, the range of currents
                                  for the calculation, and the total number of solutions


         POST PROCESSING:


            MACH_TORQ              COMPUTES TORQUE IN THE AIR GAP
                                   AND DATA FOR THE B_RADIAL AND B_TANGENTIAL
                                   OF THE AIR GAP FLUX DENSITY.

            COILLINK               COMPUTES THE COIL LINKAGE FOR EACH COIL IN
                                   THE WINDING FILE FOR THE CURRENT SOLUTION

            MUR                    Computes relative permeability for the selected
                                   elements.

            _MMF                   Computes the MMF for a path that has already been defined


            B_RADIAL               PLOTS THE LINE GRAPH OF THE RADIAL FLUX DENSITY (T)
                                   AT THE RADIUS OF THE MAXWELLS STRESS TORQUE CALCULATION
                                   The <MACH_TORQ> must be used first.

            B_TANGET               PLOTS THE LINE GRAPH OF THE TANGENTIAL FLUX DENSITY (T)
                                   AT THE RADIUS OF THE MAXWELLS STRESS TORQUE CALCULATION
                                   The <MACH_TORQ> must be used first.


            B_VECTOR               PLOTS FLUX DENSITY VECTOR


            H_VECTOR               PLOTS FIELD INTENSITY VECTOR

            FLUXLINE               PLOTS THE FLUX LINES


            CHK_AMP                CHECKS THE AMPERAGE IN THE COILS (STATOR)


            PLOTCURR               Plots the current stored in the element
                                   data base during solution.  <CHK_AMP> must
                                   be executed first.


    Other macros:

    COMPLETE MODEL GENERATION:

     b_mach2d.mac     An example of using the macros to build a complete model
                      starting with the parameter file.


    WINDING:

     r_form.mac       This macro defines the table for a square current form
                      for the current application to a machine.  Once this
                      macro has been used, <plt_form> can be used to display
                      the form.



    MATERIALS:

     M14         M15      M19      M2        M22      M27      M36      M4
     M43         M45      M47      M50       M54      M6


     These are used by entering the preprocessor or solution and entering at the
     command line

               m14,2    !  for the rotor iron
               m14,5    !  for the stator iron



      Definition of the relationship of the Toolbar Items and their functionality:


       The Toolbar is a means to provide easy access to executing macros, executing
       one line ANSYS commands.


      Toolbar Item                 Description

      MAG_HELP         Displays the file maghelp.mac to the screen

      STATOR_H         Displays the file stator_doc.mac to the screen
                       (Help file for the slotted stator with uniform thick
                       shank)


      RSLOT_H          Displays the file rslotdoc.mac to the screen
                       (Help file for the rectangular slotted stator)


      PMSTAT_H         Displays the file pmstadoc.mac to the screen
                       (Help file for the permanent magnet on the stator

      SLOT_R_H         Displays the file slor_doc.mac to the screen
                       (Help file for the slotted rotor)

      PMROTO_H         Displays the file pmrotdoc.mac to the screen
                       (Help file for the permanent magnet rotor)

      HOW_TO           Displays the file how_to.mac to the screen


      PICK_NOD         Executes the ANSYS node pick command to display the picker box.
                       This allows the nodes to picked from the entire nodal set

      PICK_ELE         Executes the ANSYS element pick command to display the picker box
                       This allows the elements to picked from the entire element set

      GET_DIMS         Executes the macro g_parfil.mac  to read the parameter file.  The
                       file must have the extention .des

      STATOR           Executes the stator.mac with arguements using the existing
                       defined parameters.  This builds the slotted stator with uniform
                       width tooth shank.

      RSLOT            Executes the rslotsta.mac with arguements using the existing
                       defined parameters.  This builds the rectangular slotted rotor.


      PMSTATOR         Executes the pm_stat.mac with arguements using the existing
                       defined parameters.  This builds the permanent magent on
                       the stator.

      SLOT_R           Executes the pm_rotor.mac with arguements using the existing
                       defined parameters.  This builds the slotted rotor.


      PMROTOR          Executes the pm_rotor.mac with arguements using the existing
                       defined parameters.  This builds the permanent magnet rotor

      EVEN_BC          Executes the permach.mac for the even boundary conndition, which
                       corresponds to using couple sets.

      ROTATE           Executes the mvrotor.mac to move the rotor and regenerate the
                       constraint equations.

      WIND_2D          Executes the macro  b_wndsc.mac to build the winding arrays
                       to allow the currents to be applied

      PLT_FORM         Executes the macro plt_form.mac to display the current form to
                       be used to apply the current to the winding

      LOAD             Executes the ld_coil.mac to apply the currents to the slots based
                       on winding definition

      SOLUTION         Executes the mvpsol.mac to generate a solution (one)

      ROT_CONS         Executes rotsol1.mac to obtain a series of solutions using the
                       same current, but for a number of rotor positions. This
                       will compute a torque versus angle and the EMF versus angle. The
                       <WIND_2D> must be used first in order to compute the EMF for
                       the winding.  To compute a cogg torque or an open circuit EMF
                       no currents must be applied (or delete the existing currents).

      ROT_CURR         Executes rotsol2.mac to obtain a series of solutions using the
                       current form specified with the parameters

      MACH_IND         Executes m_induc.mac to solve for the inductance for the
                       specified rotor position for the range of currents specified
                       in the input

      MACH_TORQ        Executes machtorq.mac.  This uses the element data computed based
                       on the rotor element components and the torque is evaluated
                       using the Maxwell's stress tensor method.


      MUR              Executes mur.mac to compute the relative permeabilities of the
                       elements

      B_RADIAL         Executes the command PLPATH using the B-radial computed using
                       MACH_TORQ

      B_TANGET         Executes the command PLPATH using the B-tangential computes using
                       MACH_TORQ

      B_VECTOR         Executes plvln.mac to generate the B vector plot and to outline
                       the elements with different materials

      H_VECTOR         Executes plvln.mac to generate the H vector plot and to outline
                       the elements with different materials


      FLUXLINE         Executes the ANSYS command  PLF2D.

      CHK_AMP          Executes the chk_amp.mac to summarize the currents applied
                       to the slots

      PLOTCURR         Executes the ANSYS command  PLET to plot the element etable JS
                       which is the current density.




      MACRO CALLING SEQUENCE:



      This provides the calling sequence of macros which executes other macros.  The
      macros listed below also contain a more detailed description in the individual
      macro.  This list does not contain ToolBar items which do not have additional called
      macros.


      TOOLBAR ITEM    MAIN MACRO      LAYER 1     LAYER 2


      STATOR          slotsta         polegen

      RSLOT           rslotsta        polegen

      PMSTATOR        pm_stat         polegen

      SLOT_R          slotrot         polegen

      PMROTOR         pm_rotor        polegen

      SLOT_R          slotrot         polegen

      EVEN_BC         permach

      ROTATE          mvrotor         stitch6

      WIND_2D         b_wndsc         g_area
                                      dparm3d

      rot_cons        rotsol1         d_parm
                                      mvrotor
                                                    stitch6
                                      mvpsol
                                      torqsum

      rot_curr        rotsol2         d_parm
                                      mvrotor
                                                    stitch6
                                      ld_coil
                                      mvpsol
                                      torqsum

      mach_ind         m_induc        b2wndsc       g_area
                                                    dparm3d
                                      mvrotor       stitch6
                                      s_ind         ld_coil
                                                    l_matrix
      mach_torq        machtorq       torqsum
                                      mtorqc2d