function  component_bc_stars (i_p)
% Copyright 2000, J.E. Akin.  All rights reserved.
% function  component_bc_stars (inc_e, inc_p)
%  ------------------------------------------------------
%  Plot the i_p component bc value at restrained nodes
%  ------------------------------------------------------

% c_x    = x coordinates of nod_per_el line polygon
% c_y    = y coordinates of nod_per_el line polygon
% inc_e  = increment in element numbers on plot, if > 0
% inc_p  = increment in node numbers on plot, if > 0
% msh_typ_nodes   = connectivity list for elements, nt x nod_per_el
% loop   = corners for nod_per_el line polygon
% lab_p  = 1, if node points are circled
  lab_p  = 0;
% nod_per_el = Nodes per element
% np     = Number of Points
% nt     = Number of elements
% pre_e  = Element items before connectivity list
  pre_e  = 0 ;
% pre_p  = Nodal items before coordinates
  pre_p = 1;
% msh_bc_xyz = Nodal coordinates (with preceeding data)
% t_x    = x coordinates of nod_per_el corners
% t_y    = y coordinates of nod_per_el corners
% x_bar  = x-centroid of each element
% xy     = Coordinates of points, np x 2
% y_bar  = y-centroid of each element

  %b fprintf ('Begin bc values plot for component: \n')
  if ( nargin == 0 )
    i_p = 1 ;
  end % if no arguments

%    Read coordinate file and connectivity file
%    integer bc code, real xy pairs for np points (pre_p = 1)

%    Set control data: number of points
  load msh_bc_xyz.tmp ;  
  np = size (msh_bc_xyz,1) ;   % number of nodal points  
  ns = size (msh_bc_xyz,2) - pre_p ;   % dimension of space
  if ( np == 0 )
    error ('Error missing file msh_bc_xyz.tmp')
  end % if error
  fprintf ('Read %g mesh coordinate pairs \n', np)
  % fprintf ('       x        y \n')

  x (np)      = 0.       ;       % pre-allocate array x
  y (np)      = 0.       ;       % pre-allocate array y

  % msh_bc_xyz has: pre_p items then: x, y
  bc = msh_bc_xyz (1:np, pre_p) ; % extract bc flag  
  x  = msh_bc_xyz (1:np, (pre_p+1)) ; % extract x column of xy
  if ( ns >= 2)
    y = msh_bc_xyz (1:np, (pre_p+2)) ; % extract y column of xy
  else
    y (1:np) = 0. ;
  end % if 1D
  
%    Set control data: number elements & nodes_per_element
  load  msh_typ_nodes.tmp ; % nod_per_el nodes per element
  nt         = size (msh_typ_nodes,1);           % number of elements 
  if ( nt == 0 )
    error ('Error missing file msh_typ_nodes.tmp')
  end % if error
  nod_per_el = size (msh_typ_nodes,2) - pre_e -1 ; % nodes per element
  fprintf ('Read %g elements with %g nodes each \n', nt,nod_per_el)

% recover bc values from results
  load node_results.tmp
  nr = size (node_results, 1);
  if ( nr == 0 )
    error ('Error missing file node_results.tmp')
  end % if error
  max_p = size (node_results, 2) ; % number of columns
  fprintf ('Read %g nodal solution values \n', nr)
  fprintf ('     with %g components each \n', max_p)
  if ( i_p > max_p ) 
    error ('i_p > available data')
  end % if error

  t_nodes (nod_per_el) = 0 ;    % Optional pre-allocation
  t_x (nod_per_el) = 0 ;        % Optional pre-allocation
  t_y (nod_per_el) = 0 ;        % Optional pre-allocation
  c_x (nod_per_el + 1) = 0 ;    % Optional pre-allocation
  c_y (nod_per_el + 1) = 0 ;    % Optional pre-allocation
  loop (nod_per_el + 1) = 0 ;   % Optional pre-allocation
 
%                set constants
  [loop] = get_El_Loop (nod_per_el) ;
  %b fprintf ('Begin element plots:')

%    Initialize plots
  xmax = max (x)      ; xmin = min (x) ;
  ymax = max (y)      ; ymin = min (y) ;
  %b xdiff = xmax - xmin ; ydiff = ymax - ymin ;
  %b if ( ydiff == 0.0 )
    %b ydiff = 0.5 ; % allow for 1-D mesh (with y == 0)
  %b end % if no y coordinates
  %b xmax = xmax + xdiff/10; ymax = ymax + ydiff/10;
  %b xmin = xmin - xdiff/10; ymin = ymin - ydiff/10;
  clf                               % clear graphics
  axis ([xmin, xmax, ymin, ymax])   % set axes
  axis ('equal')                    % true shape style
  hold on                           % hold image for plots
  grid                              % add grid dots
% xlabel ('X')                      % add label
xlabel (['X for ', int2str(nt),' Elements with ', ...
        int2str(nod_per_el), ' nodes'])
  ylabel ('Y')                      % add label
  format short
 
%      Plot input mesh points & label them
  if (lab_p == 1)                   % plot all points
    plot (x, y, 'b.')               % mark each node
  end % if show labels

%%    Show 20 nodes and 10 elements, or all for small mesh
%  inc_p = floor(np/20) ; inc_e = floor(nt/10) ;
%  if (inc_p == 0 ) 
%    inc_p = np - 1 ;
%  end % if inc_p
%  if (inc_e == 0 ) 
%    inc_e = nt - 1 ;
%  end % if inc_e
%%    Show all if a small mesh
%  if ( np <= 20 )
%    inc_p = 1 ;
%  end % if np
%  if ( nt <= 10 )
%    inc_e = 1 ;
%  end % if nt

%  if (inc_p > 0)      % plot node numbers, if node in mesh
%   in_mesh (1:np) = 0 ;               % default to missing
%   for i = 1:nt                       % loop all elements
%     for j = 1:nod_per_el             % loop its nodes
%       in_mesh (msh_typ_nodes(i, j+1)) = 1; % flag as present
%     end % for its nodes
%   end % for all elements
%   % disp (in_mesh)
%  end % if show labels
%  disp (' ')

%    Loop over all elements
  for it = 1:nt  ;

%      Extract corner connectivity 
    t_nodes = msh_typ_nodes (it, (pre_e+2):(nod_per_el+pre_e+1)); 

%      Extract corner coordinates
    t_x  = x (t_nodes) ;         % x at those nodes, only
    t_y  = y (t_nodes) ;         % y at those nodes, only

%      Plot this polygon
    c_x  = t_x (loop) ;       % x for nod_per_el line polygon
    c_y  = t_y (loop) ;       % y for nod_per_el line polygon
    plot (c_x, c_y)           % plot nod_per_el lines
  end % for over all elements
 
%%    Finish the plots with polygon numbers
%  if (inc_e > 0)                     % plot elem number, inclined
%    plot (x_bar, y_bar, 'g.')        % centroid of each element
%    for i = 1:inc_e:nt               % convert to string
%      t_text = sprintf ('  %g', i);  % offset # from pt
%      text (x_bar(i), y_bar(i), t_text, 'Rotation', 45) % incline
%    end % for all polygons
%  end % if show labels

%     Finish with BC & MPC values
   given = 0 ;
   for i = 1:np                 % loop over all nodes
     if ( bc (i) > 0 )           % it has BC or MPC
       if ( max_p > 1 ) % then
         jold = bc (i)  ;
         jsum = 0  ;
         for j = 1:max_p
           jj   = max_p + 1 - j  ;
           jnew = fix (jold / 10);
           jk   = jold - jnew * 10  ;
           jsum = jsum + jk * 10^(j - 1)  ;
           jold = jnew  ;
           kodes (jj) = jk  ;
           if ( jk > max_p ) % then
             error    'INVALID BC TYPE'
           end % IF
         end % for
       %  WAS DATA RIGHT jUSTIFIED?
         if ( bc (i) > jsum ) % THEN
           fprintf ('AT NODE %g \n', i)
           fprintf ('FLAG %g \n', jold)
           error 'WARNING: BC NOT RIGHT JUSTIFIED'
         end % IF
         iold = kodes(i_p)  ;
       else
         iold = 1 ;
       end % if one unknown per node
       if ( iold == 1 ) % then type 1 bc value
         given = given + 1 ;
         plot (x(i), y(i), 'k*')   % star at bc pt
       end % if type1
     end % if present
   end % for all points

  title  (['FE BC Flags for Component\_',int2str(i_p), ...
     ' (', int2str(np), ' Nodes, ', ...
     int2str(given), ' flagged)']) 

%       -depsc -tiff            % for an eps version
  %b print -dpsc component_bc_stars
  hold off
  %b fprintf ('Created file component_bc_stars.ps \n')
% end of component_bc_stars