Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

plgriddata(3plplot) [debian man page]

PLGRIDDATA(3plplot)						    PLplot API						       PLGRIDDATA(3plplot)

NAME

       plgriddata - Grid data from irregularly sampled data

SYNOPSIS

       plggriddata(x, y, z, npts, xg, nptsx, yg, nptsy, zg, type, data)

DESCRIPTION

       Real  world  data  is  frequently  irregularly  sampled, but all PLplot 3D plots require data placed in a uniform grid. This function takes
       irregularly sampled data from three input arrays x[npts], y[npts], and z[npts], reads the desired grid location from input arrays xg[nptsx]
       and  yg[nptsy], and returns the gridded data into output array zg[nptsx][nptsy].  The algorithm used to grid the data is specified with the
       argument type which can have one parameter specified in argument data.

       Redacted form:  General: plgriddata(x, y, z, xg, yg, zg, type, data) Perl/PDL: Not available?

       This function is used in example 21.

ARGUMENTS

       x (PLFLT *, input)
	      The input x array.

       y (PLFLT *, input)
	      The input y array.

       z (PLFLT *, input)
	      The input z array. Each triple x[i], y[i], z[i] represents one data sample coordinate.

       npts (PLINT, input)
	      The number of data samples in the x, y and z arrays.

       xg (PLFLT *, input)
	      The input array that specifies the grid spacing in the x direction. Usually xg has nptsx equally spaced values from the  minimum	to
	      the maximum values of the x input array.

       nptsx (PLINT, input)
	      The number of points in the xg array.

       yg (PLFLT *, input)
	      The input array that specifies the grid spacing in the y direction. Similar to the xg parameter.

       nptsy (PLINT, input)
	      The number of points in the yg array.

       zg (PLFLT **, output)
	      The  output  array,  where data lies in the regular grid specified by xg and yg. the zg array must exist or be allocated by the user
	      prior to the call, and must have dimension zg[nptsx][nptsy].

       type (PLINT, input)
	      The type of gridding algorithm to use, which can be: GRID_CSA: Bivariate Cubic Spline approximation GRID_DTLI:  Delaunay	Triangula-
	      tion  Linear  Interpolation  GRID_NNI:  Natural  Neighbors  Interpolation  GRID_NNIDW:  Nearest  Neighbors Inverse Distance Weighted
	      GRID_NNLI: Nearest Neighbors Linear Interpolation GRID_NNAIDW:  Nearest Neighbors Around Inverse Distance Weighted  For  details	of
	      the algorithms read the source file plgridd.c.

       data (PLFLT, input)
	      Some  gridding  algorithms  require  extra data, which can be specified through this argument. Currently, for algorithm: GRID_NNIDW,
	      data specifies the number of neighbors to use, the lower the value, the noisier (more local) the approximation is.  GRID_NNLI,  data
	      specifies  what  a thin triangle is, in the range [1. .. 2.]. High values enable the usage of very thin triangles for interpolation,
	      possibly resulting in error in the approximation.  GRID_NNI, only weights greater than data will be accepted. If 0, all weights will
	      be accepted.

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 					       PLGRIDDATA(3plplot)

Check Out this Related Man Page

PLOT3D(3plplot) 						    PLplot API							   PLOT3D(3plplot)

NAME

       plot3d - Plot 3-d surface plot

SYNOPSIS

       plot3d(x, y, z, nx, ny, opt, side)

DESCRIPTION

       Plots  a  three	dimensional  surface  plot within the environment set up by plw3d(3plplot).  The surface is defined by the two-dimensional
       array z[nx][ny], the point z[i][j] being the value of the function at (x[i], y[j]).  Note that the points in arrays x and y do not need	to
       be  equally spaced, but must be stored in ascending order.  The parameter opt controls the way in which the surface is displayed.  For fur-
       ther details see the PLplot documentation. The only difference between plmesh(3plplot) and plot3d(3plplot) is  that  plmesh(3plplot)  draws
       the bottom side of the surface, while plot3d(3plplot) only draws the surface as viewed from the top.

       Redacted form: plot3d(x, y, z, opt, side)

       This function is used in examples 11,21.

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: 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.

       side (PLBOOL, input)
	      Flag  to	indicate  whether  or not ``sides'' should be draw on the figure.  If side is true sides are drawn, otherwise no sides are
	      drawn.

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 						   PLOT3D(3plplot)
Man Page