AVS Modules                                                       2D plot
copyright  1996   Michael J. Rangitsch                         9 Jan 1996

NAME
      2D plot -  produce a 2D plot from a field

SUMMARY
      Name        2D plot

      Type        mapper

      Inputs      field 2D uniform scalar float
                  integer    (optional)

PARAMETERS
      Parameters  x origin           float
                  y origin           float
                  x extent           float
                  y extent           float
                  x axis ticks       integer
                  y axis ticks       integer
                  tick size          float
                  show xy plane      toggle
                  label font size    float
                  x label precision  float
                  y label precision  float
                  label font         integer
                  x label density    integer
                  y label density    integer
                  origin label       string
                  show labels        toggle

                  axis limits        string
                  plot R value       float
                  plot G value       float
                  plot B value       float  

      Outputs     geom

                                          
DESCRIPTION
      This module is a very modified version of Wes Bethel's 3D axis
      module available at the IAC.  This module produces a 2D line plot
      from a 2D uniform field.  The plot is a non-transforamable AVS 
      geometry.  While not as extensive as the AVS supplied plotting 
      module (AVS Graph) it allows for a 2D plot to be included in a
      geometry viewer scene.  The optional 'time step' input draws
      a vertical marker from the x axis to the plot data.  In an animation
      this can show the evolution of a specific piece of data (say the
      overall population of a species) while the geometry shown is the
      distribution of individuals (hey, this isn't what I do, but I 
      can't think of a more generic use).  Another use might be to 
      trace out a stress-strain curve while animating the bending of a 
      beam.

      The data format required by the module is a 2D uniform field with
      the x values in the first dimension and the y values in the second.
   
      Two modules to produce this type of field (with associated data sets
      and networks) are included.

INPUT
      A uniform scalar field (field 2D real uniform)

Optional input

      An integer for the data pair (x,y) to draw a vertical mark on
      the plot

Parameters
              x origin           float        these are the plot
              y origin           float        origin and extent in
              x extent           float        window coordinates. The
              y extent           float        plot is non-transformable

              x axis ticks       integer      The number of ticks on
              y axis ticks       integer      each axis

              tick size          float        The tick size

              show xy plane      toggle       Show axes as a grid

              label font size    float        The label font size

              x label precision  float        Decimal precision of
              y label precision  float        the axis labels

              label font         integer      The integer font number

              x label density    integer      Display every "n" labels
              y label density    integer

              origin label       string       'x' or 'y' axis to have 
                                              the origin labeled

              show labels        toggle       show the axis labels

              axis limits        string       display the axis limits

              plot R value       float        RGB values for the plot
              plot G value       float        color 
              plot B value       float

Outputs
              plot geometry (not transformable with the geometry viewer)

                                          
EXAMPLES
      The following network shows a typical usage of 2D_plot


        read case
            |
        extract scalar
            |
        2D_plot
            |
        geometry viewer



AVS Module						          2D_plot
Michael J. Rangitsch          				       9 Jan 1996