visual

NAME

visual

SYNOPSIS

         visual -b basename -p path -n freq [-c colormap] [-h nyy] [-w nxx] [-z zoom]

DEFAULTS

           -c cmap -h 2*ny -w 2*nx -z 1

DESCRIPTION

visual specifies the output parameters for the IBIS visualization routines. visual requires the statements

• -b basename - Basename of the output color graphics files.
• -n freq - Number of time steps between visualization output.
• -p pathname - Pathname of the output color graphics files.

visual interpretes the optional statements

• -c colormap - Name of the colormap.
• -h nyy - Number of pixels in the y direction.
• -w nxx - Number of pixels in the x direction.
• -z - Zoom factor for display

The basename is the file basename and should not include the path. The last character of the path must not be a forward slash ``/''. As a general suggestion, a path other than the current directory should always be specified because many graphics files will typically be written. Therefore to keep track of them it is best to put them in a separate subdirectory.

The colormap is the name of a file that specifies the colors. This file must contain 256 lines of three integers each. Each integer must be in the range from 0 to 255.

The number of pixels in the x and y direction can be specified to be any numbers. However, for accurate representation of the data, it is best to preserve the aspect ratio of the fluid calculations. It is best to use either 2, 4 or 8 times the number of fluid grid points for pixels in each direction. This allows for a better representation of the position of the immersed boundaries.

The frequency that files are written is specified by freq. Every freq time steps a new graphics file is created.

The zoom factor is an inexpensive way to create larger graphics output display. Some accuracy in the data representation is lost if zoom is different from one.

SEE ALSO

graph, particle

EXAMPLE

          visual -h 128 -w 256 -n 5 -b balloon -p binary

This visual command will create color plots that are 256x128 bytes in size. The color graphics files will be generated every fifth time step. The output files will be created and stored sequentially as binary/balloon.xxxx where xxxx is the file number.