clab_help.m

matlab例程

      '{\bfAdd a Line} and {\bfAdd an Arrow} menus allows one to add line or arrow to the',...
      '    graphs.  One should use mouse to click for the starting and ending points ',...
      '    of the legends.',...
      '{\bfCursor Positioning} menu allows one to select and label one point on the',...
      '    curves in the graphs.',' ',...
      '{\bfProperties} menu will bring a dialog box, so that one can edit the properties ',...
      '    of the legends he added, such as to change font to the labels, to change the ',...
      '    color and line stypes to line and arrors.',' ',...
      'This facility is also applicable to curve editting.');
case 22,
   hlp_Title='About the Matrix Processor';
   hlp_Contents=str2mat(...
      'The {\bfMatrix Processor} is a GUI-based matrix processing program.  The',...
      'function can be used to display the matrix and state space models, and ',...
      'one can perform analysis to the matrix (or coefficient matrix in the',...
      'system), such as evaluating parameters and decompositions.',' ',...
      '{\bfFile} menu is used to save and load new matrix from files.',' ',...
      '{\bfEdit} menu allows the editting to matrix (system) element in a graphical',...
      '    way, and allows the display of matrix in MATLAB or LaTeX format.',' ',...
      '{\bfFormats} menu defines the displaying format, such as precision.',' ',...
      '{\bfAnalysis} menu performs analysis to matrix parameters, manipulations',...
      '    of matrices, decompositions and function evaluations.',' ',...
      'Matrix Processor can be used as a separate program, or used as part of ',...
      'CtrlLAB.  In stand alone format, one can call the function in:',' ',...
      '   matx\_proc(A) or matx\_proc format.');
case 23
   shw_about('About CtrlLAB','CtrlLABExtras',...
      'Feedback Control LAB Program','CtrlLAB\copyright Version 3.0,  1996-1999');
   bHelp=0;
case 24
   shw_about('About Matrix Processor','MatxProcExtras',...
      'A GUI-based Matrix Processor','for CtrlLAB\copyright 3.0, 1996-1999');
   bHelp=0;
case 25
   hlp_Title='Model Following Controller Design';
   hlp_Contents=str2mat(...
      'To be added to the system',...
      'now is being written');
case 26
   hlp_Title='Model Reduction Comparisons';
   hlp_Contents=str2mat(...
      'Under CtrlLAB, the user is allowed to compare the reduced order model',...
      'with the original model in a number of specifications in open loops.  For ',...
      'instance, one can compare the Bode diagram, step responses, which can be ',...
      'done by selecting corresponding terms from the list box.  ',' ',...
      'One can also compare many of the reduced order models together with that ',...
      'of the original model. This can be done by selecting the reduced order models ',...
      'from the list on the left.  One can specify as many terms as he like.  If none ',...
      'is selected from the list, then only the original model is analysed.',' ',...
      'If multiple models are compared, then we use blue for the original model, and ',...
      'for reduced order models, the following color order appliesto the subsequent ',...
      'reduced models from the list:',' ',...
      '     {\bfgreen} ([0,0.5,0]), {\bfred} ([1,0,0]), {\bfblue-green} ([0,0.5,0.5]), ',...
      '     {\bfpurple} ([0.75,0,0.75]), {\bfyellow-green} ([0.75,0.75,0]), ',...
      '     {\bfblack} ([0.23,0.25,0.25]), {\bflight purple} ([0.5,0.25,0.75])',' ',...
      'If one wants to display a certain reduced model, he can select that model',...
      'ONLY and click {\itShow} button.',' ',...
      'It is worth mentioning that if SIMULINK model is involved, then for time',...
      'response comparison is based on exact model, if {\itUse SIMULINK} is selected.',...
      'The frequency domain analysis uses the linearised model all the time. ');
case 27
   shw_about('About Graf_Tools','CtrlLABExtras',...
         'Graphics Facilities Program','for CtrlLAB\copyright Version 3.0, 1996-1999');
   bHelp=0;
case 28
   hlp_Title='About Creating a New Matrix';
   hlp_Contents=str2mat(...
      'In this dialog box, two methods of entering a new matrix are provided.  They ',...
      'are summarised as follows:',' ',...
      '  1) {\bfDirect method}',...
      '     In this method, one should enter in the top edit box the matrix in',...
      '     MATLAB format.  ',' ',...
      '  2) {\bfTemplate method}',...
      '     In this method, one should specify the format of the matrix in the list ',...
      '     box, and if necessary, the number of rows, columns and a given vector',...
      '     should be provided.  For instance, if one wants to enter a zero matrix, ',...
      '     he should only specify the numbers of rows and columns.  If he wants ',...
      '     to enter a matrix in companion form, then he should enter the known ',...
      '     vector, [a_1, ..., a_n] such that, the matrix will be formulated in the form:',' ',...
      '           -a_1  -a_2   -a_3 ...   -a_n',...
      '            1      0     0   ...   0',...
      '            0      1     0   ...   0',...
      '           ...    ...   ...       ...',' ',...
      '    It should be noted that, if the matrix in the first method, i.e., in the edit ',...
      'box has been specified, it should be evaluated, no matter what have been',...
      'specified in the other method.');
case 29   
   hlp_Title='About Graphics Toolbox^{\copyright}';
   hlp_Contents=str2mat(...
      'Graphics Toolbox is used either as an independent program, or used with',...
      'CtrlLAB to decorating the graphs.  The user can add legends, line and arrows ',...
      'to the graphs obtained, or to use zooming facilities to have a better view.  ',...
      'The user is also allowed to save the graph elements to files such that the ',...
      'whole graphs can be recalled later.  This also applies to a window with',...
      'multiple curves.  ',' ',...
      'In {\bfFile} menu, one is allowed to Save/Load graph elements to certain files, ',...
      'using the data structure defined in the toolbox.',' ',...
      'In this menu, one is allowed to change Box and Grid facilities in the graphics',...
      'window.  Also the setting in the graphs can further be the {\itPreferences} menu',...
      'which gives a dialog box.  {\itPrint} menu allows one to print the current figure',...
      'or copy it to clipboard the graphs.  Also saving of the graphs in EPS format ',...
      'is allowed.',' ',...
      '{\bfLegends}, {\bfZooming} and {\bfCurves} menus will be given in the Help windows.',' ',...
      'If it is used as an individual program, then one can use any graphics command ',...
      'to draw curves on the window and can modify and decorating the curves with ',...
      'this very easily.',' ',...
      'Graphics Toolbox is now only available for 2D graphics.');
case 30   
   hlp_Title='About Curve Editing Facilities';
   hlp_Contents=str2mat(...
      'The {\bfCurve} menu in the Graphics Toolbox allows one to edit certain facilities',...
      'of curves on the current graphics window.',' ',...
      '{\bfDelete a Certain Curve} menu allows one to delete a curve on the graph.',...
      'If one selects such a item, then a cross cursor will occur to prompt the user',...
      'to select a curve to delete on the graph.  If one does not want to delete that',...
      'curve, he can click the right mouse button to cancel.',' ',...
      '{\bfChange Curve Color} allows one to change the color of a curve in an interact',...
      'way.  When a curve is selected, the color palette will appear.  One can use ',...
      'this method to change the color.',' ',...
      'One can also change line style, markers, line thickness to the curve selected.',' ',...
      'The overall properties can also be modified by {\bfProperties} menu, which will',...
      'open a dialog box for modifying it.');
case 31   
   hlp_Title='Changing Plot Ranges';
   hlp_Contents=str2mat(...
      'To be added to the system',...
      'now is being written');
otherwise   
   warndlg('Help messages not available yet!','Warning: Program incomplete!');
   bHelp=0;
end

% if help information is available, then the help window is displayed
if bHelp==1
   help_window(hlp_Title, hlp_Contents, 'CtrlLAB 3.0',nTask);
end

%---------------------------------------------------------
%shw_about display the About dialog box in CtrlLAB.
%
%   shw_about(winTitle,winTag,strText1,strText2)
%where
%  winTitle -- contains the title of the About window 
%  winTag   -- contains the tag of the About window
%  strText1 -- the main information of the About window
%  strText2 -- the version display of the About window
%---------------------------------------------------------
function shw_about(winTitle,winTag,strText1,strText2)
h_win=findobj('Name',winTitle);
if length(h_win)==0
   h_win=figure('Units','normalized','Position',[0.24875 0.248 0.4375 0.25],...
      'NumberTitle','off','Name',winTitle,'MenuBar','none','Color',[0.502,1,1],...
      'Tag',winTag,'Resize','off');
   MyColor=[0.1,1,1]; extra_funs(1); hold on; 
   x1=[0,1,1,0,0]; y1=[0.95,0.95,1,1,0.95]; w=[0,0,0.6275]; w0=w; dw=[0,0.0476,0.0177]/2;
   for i=1:40
      fill(x1,y1,w); h=plot(x1,y1); set(h,'Color',w); y1=y1-0.025; w=w+dw;
   end
   display_str(0.06,0.83,strText1,[1,0,0],'on',20,'Brush Script MT','bold'); 
   display_str(0.1,0.65,strText2,[0,0,0],'on',13,'Times New Roman','bold');
   display_str(0.19,0.47,'Author: Professor Dingyu Xue',...
      [0.8,0,0],'on',11,'Century Schoolbook','bold','italic');
   display_str(0.175,0.36,'Northeastern University, P.R. China',[1,0,0],...
      'on',11,'Century Schoolbook');
   uicontrol('Style','PushButton','String','OK',...
      'Units','normalized','Position',[0.4 0.07 0.20 0.16],...
      'CallBack','close(gcf)')
else, figure(h_win); end

%---------------------------------------------------------
%help_window display the help information in CtrlLAB.
%
%   help_window(titleStr,helpStr,win_name,nTask)
%where
%  titleStr -- contains the title of the help information 
%  helpStr  -- contains the information contents
%  win_name -- the name of the Help window
%  nTask    -- the code of help information
%---------------------------------------------------------
function help_window(titleStr,helpStr,win_name,nTask)

% If the Help Window has already been created, bring it to the front
bCont=0; 

helpw_h=findobj('Tag','CtrlLABHelp');
% if the window has not been opened, create a new window
if length(helpw_h)==0,
   %if Help window dose not exist, then open a new Help window
   helpw_h=figure('Units','normalized','Position',[0.48625 0.1983 0.5 0.77],...
      'NumberTitle','off','Name',[win_name ' Help Window'],...
      'MenuBar','none','Color',0.8*[1,1,1],...            
      'Tag','CtrlLABHelp','Resize','off');
   extra_funs(1);
   uicontrol('Style','PushButton','String','Close Help Window',...
      'Units','normalized','Position',[0.70,0.02,0.28,0.05],...
      'Callback','delete(gcf)');
else
   %if it already opened, then close it and open again with 
   %new contents, since in this way, the speed for updating
   %the help information is faster.
   close(helpw_h); help_window(titleStr,helpStr,win_name,nTask);
end

%Display help information in the Help window
kk=get(gcf,'UserData');
if (length(kk)>0 & kk(1)~=nTask) | length(kk)==0,
   delete(gca), yL=0.91; extra_funs(1);

%Display help title
   display_str(0.04,0.96,['{\bf\it' titleStr ,'}'],[0.5020,0,0.2510],'on',12);

%display help information
   [nr,nc]=size(helpStr);
   for i=1:nr,
      if length(deblank(helpStr(i,:)))>0
         display_str(0.04,yL,helpStr(i,:),[0,0,0],'on',9); yL=yL-0.04;
      else, yL=yL-0.015; end
   end
   set(gcf,'UserData',nTask);
end