Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

plcont(3plplot) [debian man page]

PLCONT(3plplot) 						    PLplot API							   PLCONT(3plplot)

NAME

       plcont - Contour plot

SYNOPSIS

       plcont(z, nx, ny, kx, lx, ky, ly, clevel, nlevel, pltr, pltr_data)

DESCRIPTION

       Draws a contour plot of the data in z[nx][ny], using the nlevel contour levels specified by clevel. Only the region of the array from kx to
       lx and from ky to ly is plotted out.  A transformation routine pointed to by pltr with a pointer pltr_data for additional data required	by
       the transformation routine is used to map indices within the array to the world coordinates.  See the following discussion of the arguments
       and the PLplot documentation for more information.

       Redacted form: [PLEASE UPDATE! ONLY PERL INFO IS LIKELY CORRECT!] F95: plcont(z, kx, lx, ky, ly, clevel, tr?) or plcont(z, kx, lx, ky,  ly,
       clevel,	xgrid, ygrid) Java: pls.cont(z, kx, lx, ky, ly, clevel, xgrid, ygrid) Perl/PDL: plcont(z, kx, lx, ky, ly, clevel, pltr, pltr_data)
       Python: plcont2(z, kx, lx, ky, ly, clevel)

       This function is used in examples 9,14,16,22.

ARGUMENTS

       z (PLFLT **, input)
	      Pointer to a vectored two-dimensional array containing data to be contoured.

       nx, ny (PLINT, input)
	      Physical dimensions of array z.

       kx, lx (PLINT, input)
	      Range of x indices to consider.

       ky, ly (PLINT, input)
	      Range of y indices to consider.

       clevel (PLFLT *, input)
	      Pointer to array specifying levels at which to draw contours.

       nlevel (PLINT, input)
	      Number of contour levels to draw.

       pltr (void (*) (PLFLT, PLFLT, PLFLT *, PLFLT *, PLPointer) , input)
	      Pointer to function that defines transformation between indices in array z and the world coordinates (C only).  Transformation func-
	      tions  are  provided in the PLplot library: pltr0(3plplot) for identity mapping, and pltr1(3plplot) and pltr2(3plplot) for arbitrary
	      mappings respectively defined by one- and two-dimensional arrays.  In addition, user-supplied routines for the transformation can be
	      used  as	well.	Examples of all of these approaches are given in the PLplot documentation. The transformation function should have
	      the form given by any of pltr0(3plplot), pltr1(3plplot), or pltr2(3plplot). Note that unlike plshades(3plplot)  and  similar  PLplot
	      functions  which have a pltr argument, plcont requires that a transformation function be provided in the C interface.  Leaving  pltr
	      NULL will result in an error.

       pltr_data (PLPointer, input)
	      Extra parameter to help pass information to pltr0(3plplot), pltr1(3plplot), pltr2(3plplot), or whatever routine that  is	externally
	      supplied.

AUTHORS

       Geoffrey  Furnish  and  Maurice LeBrun wrote and maintain PLplot.  This man page was automatically generated from the DocBook source of the
       PLplot documentation, maintained by Alan W. Irwin and Rafael Laboissiere.

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/resources.

								   August, 2012 						   PLCONT(3plplot)

Check Out this Related Man Page

PLMESHC(3plplot)						    PLplot API							  PLMESHC(3plplot)

NAME

       plmeshc - Magnitude colored plot surface mesh with contour.

SYNOPSIS

       plmeshc(x, y, z, nx, ny, opt, clevel, nlevel)

DESCRIPTION

       Identical  to  plmesh  but  with extra functionalities: the surface mesh can be colored accordingly to the current z value being plotted, a
       contour plot can be drawn at the base XY plane, and a curtain can be drawn between the plotted function border and the base XY plane.

       Redacted form: plmeshc(x, y, z, opt, clevel)

       This function is used in example 11.

ARGUMENTS

       x (PLFLT *, input)
	      Pointer to set of x coordinate values at which the function is evaluated.

       y (PLFLT *, input)
	      Pointer to set of y coordinate values at which the function is evaluated.

       z (PLFLT **, input)
	      Pointer to a vectored two-dimensional array with set of function values.

       nx (PLINT, input)
	      Number of x values at which function is evaluated.

       ny (PLINT, input)
	      Number of y values at which function is evaluated.

       opt (PLINT, input)
	      Determines the way in which the surface is represented. To specify more than one option just add the  options,  e.g.  DRAW_LINEXY  +
	      MAG_COLOR  opt=DRAW_LINEX:  Lines  are  drawn  showing z as a function of x for each value of y[j].  opt=DRAW_LINEY: Lines are drawn
	      showing z as a function of y for each value of x[i].  opt=DRAW_LINEXY: Network of lines is drawn connecting points at which function
	      is defined.  opt=MAG_COLOR: Each line in the mesh is colored according to the z value being plotted. The color is used from the cur-
	      rent colormap 1.	opt=BASE_CONT: A contour plot is drawn at the base XY plane using parameters nlevel and  clevel.   opt=DRAW_SIDES:
	      draws a curtain between the base XY plane and the borders of the plotted function.

       clevel (PLFLT *, input)
	      Pointer to the array that defines the contour level spacing.

       nlevel (PLINT, input)
	      Number of elements in the clevel array.

AUTHORS

       Geoffrey  Furnish  and  Maurice LeBrun wrote and maintain PLplot.  This man page was automatically generated from the DocBook source of the
       PLplot documentation, maintained by Alan W. Irwin and Rafael Laboissiere.

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/resources.

								   August, 2012 						  PLMESHC(3plplot)
Man Page