Contour_Line

Author

 KGT (Kubota Graphics Technologies) Inc.
    Makefile.osf1    for DEC Alpha/osf1 (2.1)
    Makefile.sun2    for SUN Solaris2.3 
    f77              special f77 
    contourline.f    source file 
    falloc.c         source file (for fortran allocation)
    contourline.net  sample network
    Target.dat       sample data (specify contour line)
    sample.dat       sample data
    sample.fld       field data (for sample data)
    sample2.fld      binary data (= sample.fld (sample.dat))
    contourline.txt  Module Reference
  Note : You have to use "f77" in this directory to create the module.
  # make -f Makefile.***

Name

  Contour Lines --- create contour lines 
                           from 2D field 

Summary

   Name           Contour Lines

Type

         mapper

Inputs

        field 2D 3-space real irregular
                  colormap

Outputs

       geometry

Parameters

    Name            Type       Default   Min/Max
                  On/Off          boolean    on        on/off
                  just            oneshot      
                  color option    boolean    off       on/off
                  min             float      -0.5      unbound
                  max             float      0.5       unbound
                  line_num        integer    5         5/50
                  file option     boolean    off       on/off
                  target file     string     null
                  infomation min  float      0.5                     
                  infomation max  float      0.5

Description

   The "Contour Lines" module inputs a 2D field 
   and colormap.
   This module looks like the "contour to geom" module.
   It finds and creates 2D contour lines of similar value.
   Note!
   This module inputs 1-vector or 2-vector field.
   1-vector :This data is scalar value(for contour lines).
   2-vector :The first component is scalar value(for contour lines),
             and the second component is flag data(for CFD Non-fluid Area).
             The second component tells which digit (0 or 1) is 
             in the node as flag data.
             The flag data of the cells is as follows.
             1 means the fluid node and 0 is the non-fluid node.
              1---1---1           +---+---+
              +   +   +           +   +   +
              0---0---1           +---+---+
              +   +   +   ---->       |   |
              0---0---1               +---+  creates only this area
                                             only Fluid Area
       
              data(1,i,j) = the scalar data for contour lines
              data(2,i,j) = the flag data for CFD node
                               1 : fluid node     (live)
                               0 : non-fluid node (obstacle)
   1. The min/max and line_num parameter controls 
      what value the contour lines are created for.
      The target value is as follows.
   
           value(1)        = min 
           value(2)        = min + ((max-min)/(line_num-1))
           value(3)        = min + ((max-min)/(line_num-1))*2
               ... 
           value(line_num) = max
   2. When the color option parameter is ON, the target value 
      is set from the input colormap data(lower/upper). 
      You cannot change min/max dial.
      Set the lower/upper dial of the "generate colormap" module.
   3. You can specify the target value from the file.
      First specify the target file, then press the file option button.
      For example, if you arrange the following file, 
      you can get the 5 line for the 5 value (1.0,2.0 ... 5.0).
   
        target file    The sample file is "Target.dat"
        ----------- 
        5          ... integer (the number of line)
        1.0        ... real    (scalar value)
        2.0
        3.0
        4.0
        5.0
        -----------
   
   The color option parameter controls the color of contour lines. 
   When you press this button, the color is set by the input colormap
   (lower/upper dial). When this button is off, the color is determined 
   by the min/max dial.
Parameters
   On/Off            Determines the visible/invisible.
   just	             If pressed, the min/max dial is automatically set 
                     the minimum/maximum value of input field. 
   color option      Controls the color of contour lines.
   min               Sets the minimum value of contour lines.
   max               Sets the maximum value of contour lines.
   line_num          Sets the number of contour lines.
   file option       Controls the value of contour lines.
   target file       Specifies the target file.
   information       Displays the information of minimum/maximum value.

Example

 contourline.net
     The following network reads a sample data 
     ($AVS_PATH/data/field/bluntfin.fld).
                              read_field      
                                  |
                        +---------+-----------+
                        |                     |
                 extract scalar               |
                        |               volume bounds
                 orthgonal slicer             |
                        |                     |
      generate colormap |                     |
                  |     |                     |
                  +-+   |                     |
                    |   |                     |
                  Contour Lines               |
                        |                     |
                        +----------+----------+
                                   |
                            geometry viewer
 contourline2.net
     The following network reads a sample data 
     (sample.fld in this directory).
     Choose 2-component (extract vector).
                              read_field      
                                  |
                        +---------+-----------+
                        |                     |
                 extract vector               |
                        |               volume bounds
                 orthgonal slicer             |
                        |                     |
      generate colormap |                     |
                  |     |                     |
                  +-+   |                     |
                    |   |                     |
                  Contour Lines               |
                        |                     |
                        +----------+----------+
                                   |
                            geometry viewer

See also

       Read CFD           (read_cfd)
       CFD_object         (CFD_object)
       CFD_objectline     (CFD_objectline)
       CFD_objectcontour  (CFD_objectcont)
       Contour Lines      (contourline)

Other

PDS modules)