Download dess.notice

Back to the list

Display this manual page in
$$$$ DESS     NOTICE  BP208322  13/10/24    21:15:12     7852           
                                             DATE     13/10/24

    Directive DESSIN                         Voir aussi : TRAC EVOL
    ----------------                                      MOT   CHAI   
                                                          @HISTOGR OPTI   

   DESS (EVOL1 ET EVOL2 ET ... EVOLN) ( 'LOGX'                      ) ;
                                      ( 'LOGY'                      ) ;
                                      ( 'GRIL' (TYPELIGN) ('GRIS')  ) ;
                                      ( 'CARR'                      ) ;
                                      ( 'XBOR'  XINF XSUP           ) ;
                                      ( 'YBOR'  YINF YSUP           ) ;
                                      ( 'XGRA'  DELTAX              ) ;
                                      ( 'YGRA'  DELTAY              ) ;
                                      ( 'MIMA'                      ) ;
                                      ( 'DATE'                      ) ;
                                      ( 'LOGO'                      ) ;
                                      ( 'SEPA'                      ) ;
                                      ( 'CHOI'  (N1 (N2 (N3 ...)))  ) ;
                                      ( 'TITR'  'titre global'      ) ;
                                      ( 'TITX'  'xlabel'            ) ;
                                      ( 'TITY'  'ylabel'            ) ;
                                      ( 'POSX'  MOPOSX              ) ;
                                      ( 'POSY'  MOPOSY              ) ;
                                      ( 'AXES'                      ) ;
                                      ( 'NCLK'                      ) ;
                                      ( 'LEGE'  (POSITION)          ) ;
                                      ( TAB1                        ) ;
                                      
   TAB1.i = 'CHAINE'  ('NOLI ') (| 'TIRR ' |) ('REMP ') ('LABEL' MOT3)
                                 | 'TIRC ' |
                                 | 'TIRL ' |
                                 | 'TIRM ' |

                      ('MARQ ' (MOT2) ('PLEIN ') MOT1) ('REGU') ;

   TAB1.'TITRE'.i = 'CHAINE' MOT4 ;



    Description :
    ___________

    This instruction plots curves described by an evolution, itself
    possibly concatenation of several sub-evolutions EVOLi.


    Contents :
    __________


    GENERAL OPTIONS
    ---------------

    Default behavior :

      - linear scale in X and in Y
      - automatic centering
      - rectangular window
      - curves plotted simultaneously in the same frame
      - curves without marker
      - points connected by straight lines
      - axes graduated with multiples of .02 and 0.05
      - general title is the evolution's one
      - X- (resp. Y-) axis name = name of abscissa (resp. ordinate)
                                  of the first sub-evolution

    Available options :

    'LOGX' : logarithmic scale for X-axis.
    'LOGY' : logarithmic scale for Y-axis.
    'GRIL' : draw a grid.
     TYPELIGN : MOT defining the linestyle used to draw the grid
             Possible choices are: 'LIGN' (continuous line = default),
                                   'TIRR' (regular dash),
                                   'TIRC' (short dash), 
                                   'TIRL' (long dash),
                                   'TIRM' (mixed dashes),
                                ou 'POIN' (dots). 
     'GRIS':  Color in gray the grid lines.
    'CARR' : Square window.
    'XBOR' : The XINF and XSUP boundaries are imposed on the X-axis.
    'YBOR' : The XINF and XSUP boundaries are imposed on the Y-axis.
    'XGRA' : The Xtick spacing is imposed to DELTAX 
               (only possible with a linear X-scale).
    'YGRA' : The Ytick spacing is imposed to DELTAY 
               (only possible with a linear Y-scale).
    'MIMA' : Displays the curves global minimum and maximum.
    'DATE' : Displays the date.
    'LOGO' : Displays the logo.
    'SEPA' : the different curves are plotted separately with same axis.
    'LEGE' : adds captions for each curves.
             Number of individual captions is limited to 30.
             This option enforces a square frame if the legend is
             positionned outside the plotting area (default).
    POSITION : MOT definisng the position where to draw the legend.
             Possible choices are: 'NO' (North West),
                                   'NE' (North East),
                                   'SO' (South West),
                                   'SE' (South East),
                                   'EXT' (outside),        
                                or 'XY' followed by 2 FLOTTANT X Y.
    'CHOI' : restricts the drawing to the sub-evolutions N1,N2 ....
    'TITR' : Modification of the general title.
    'TITX' : Modification of abscissa name (limited to 20 characters).
    'TITY' : Modification of ordinnate name (limited to 20 characters).
    'POSX' : Enable to set the the position of the abscissa name.
             Must be followed by the keyword MOPOSX 
             Possible choices are: 'EXCE' (off-centre position),
                                   'CENT' (centered position).
    'POSY' : Enable to set the the position of the ordinnate name.
             Must be followed by the keyword MOPOSY 
             Possible choices are: 'EXCE' (off-centre position),
                                   'CENT' (centered position).
    'AXES' : Draws the axis (x=0 and y=0) if they appear in the frame.
    'NCLK' : Suppress user input to end the display (X).


    OPTIONS SPECIFIC TO EACH INDIVIDUAL CURVE
    -----------------------------------------

      Default behavior :

        - Plain lines, no marker, no caption and no fill
        - If 'LEGE' option is specified, each curve appears in the
          legend, but no name is associated to it.


      One can define separately the appearance of each sub-evolution by
      creating TAB1 (table with no subtype).

      TAB1 may contain indexes i (between 1 and N=number of curves) and
      'TITRE' (all of which are optional).


      a) Index i : string containing the line-drawing options for
                   sub-evolution EVOLi (/!\ use CAPITAL letters).

         These options are :

         'NOLI' : no line

         'TIRR' : dash
         'TIRC' : short dash
         'TIRL' : long dash
         'TIRM' : mixed dashes (alternate long/short dashes)

         'REMP' : fills the area under the curve (the surface color is
                  the one of EVOLi while the line, if present, is drawn
                  in black or white, according to the background color)

         'MARQ ' (MOT3) ('PLEIN') MOT1 :
                  markers plotted at the different points of the curve.

             - MOT1 is a word specifying the marker type :
                       'CROI' = times symbol (x)
                       'PLUS' = plus symbol  (+)
                       'MOIN' = minus symbol (-)
                       'BARR' = vertical bar (|)
                       'ETOI' = eight-pointed star
                       'CARR' = square
                       'LOSA' = diamond
                       'ROND' = circle
                       'TRID' = down-pointing triangle
                       'TRIU' = up-pointing triangle
                       'TRIL' = left-pointing triangle
                       'TRIR' = right-pointing triangle

               /!\ MOT1 must always be placed LAST.

             - The 'PLEIN' keyword indicates that the marker must be
               filled by a color.

             - MOT3 is the size specification chosen between :
                       'SS' = the smallest
                       'S'
                       'M'  = default size
                       'L'
                       'XL' = the biggest

         'LABEL ' MOT3 : label plotted at different points of the curve.
                         Only the 20 first characters of MOT1 at taken
                         into account

         'REGU' : draws only 6 regularly spaced markers.


      b) Index 'TITRE' : a table indexed by integers i from 1 to N,
                         containing the caption MOT4 (20 char. max.) of
                         the sub-evolution EVOLi.

         If TAB1.'TITRE'.i does not exist and 'LEGE' is present, a
         sample of the curve is drawn anyway (=line/fill/marker/label).
         In order not to draw anything for this curve, set :

                TAB1.'TITRE'.i = 'MOT' 'PAS DE LEGENDE' ;



    Note:
    _____

    Stamping the type of the curves of an evolution with the key-word
    HIST enables their drawing as histograms.

    When an EVOLUTION (or a sub-evolution) type is 'HIST', CAST3M also
    checks the ordinates axis name : if it is not empty, it is written
    above the curve (horizontally centered).

    This functionality is used by the @HISTOGR procedur which allows
    to draw histograms very easily.
    
    The OPTION operator handles other formatting options (e.g. fonts,
    line thickness ...) in particular with the postscript output (PS and
    PSC).
    
    It is possible to print subscript, superscript and greek letters in
    titles (global, xlabel and ylabel) and in legends of the postscript
    output by using the following convention :
    _{subscript}   : to get a subscript
    ^{superscript} : to get a superscript
    \a             : to get the greek symbol alpha (etc...)
 


    Example:
    ________

*   draws 4 evolutions, imposing line drawing specifications to the
*   three first ones, et writing captions : lines and text for the two
*   first ones, only the line for the third, and nothing for the fourth.
    TAB1     = 'TABLE' ;
    TAB1 . 1 = 'MOT' 'TIRR ';
    TAB1 . 2 = 'MOT' 'MARQ CROI NOLI';
    TAB1 . 3 = 'MOT' 'MARQ LOSA';
    TAB1 . 'TITRE'     = 'TABLE' ;
    TAB1 . 'TITRE' . 1 = 'MOT' 'le resultat';
    TAB1 . 'TITRE' . 2 = 'MOT' 'deplacements en X' ;
    TAB1 . 'TITRE' . 3 = 'MOT' ' ' ;
    'DESS' (EVOL1 'ET' EVOL2 'ET' EVOL3 'ET' EVOL4) 'LOGO' 'LEGE' TAB1 
           'TITR' 'Déplacement harmonique : X_{\O}(t) = sin(\O t)'
           'TITX' 'X (m)' 'TITY' 't(s)' 
           'GRIL' 'POIN' 'GRIS';


 
 
 
 
 
 
 

© Cast3M 2003 - All rights reserved.
Disclaimer