SCATPLT_CREATE_VV(3)

EXPERIMENTAL_FUNC
scatplt_create_vv - Create a value-value scatter plot from two 2D sub-arrays.

SYNOPSIS
#include <karma_scatplt.h>

KScatterPlot scatplt_create_vv

(KWorldCanvas canvas, CONST char *array1,CONST array_desc *arr_desc1, unsigned int xdim1, unsigned int ydim1, unsigned int type1, double scale1, double offset1, KwcsAstro ap1, unsigned int num_restr1, CONST char **restr_names1, CONST double *restr_values1, double *min1, double *max1, uaddr xstart, uaddr xlen, uaddr ystart, uaddr ylen, CONST char *array2,CONST array_desc *arr_desc2, unsigned int xdim2, unsigned int ydim2, unsigned int type2, double scale2, double offset2, KwcsAstro ap2, unsigned int num_restr2, CONST char **restr_names2, CONST double *restr_values2, double *min2, double *max2)

DESCRIPTION
Create a value-value scatter plot from two 2D sub-arrays.

canvas
    The world canvas onto which the scatter plot may be drawn.

array1
    The data for the first array.

arr_desc1
    The array descriptor for the first array.

xdim1
    The X dimension index for the first array.

ydim1
    The Y dimension index for the first array.

type1
    The data type for the first array.

scale1
    The data scaling for the first array.

offset1
    The data offset for the first array.

ap1 The KwcsAstro object for the first array.

num_restr1
    The number of restrictions for the first array.

restr_names1
    The array of restriction names for the first array.

restr_values1
    The restriction values for the first array.

min1
    The minimum value from the first array. This is updated.

max1
    The maximum value from the first array. This is updated.

xstart
    The X dimension start of the sub-array in the first array.

xlen
    The X dimension length of the sub-array in the first array.

ystart
    The Y dimension start of the sub-array in the first array.

ylen
    The Y dimension length of the sub-array in the first array.

array2
    The data for the second array.

arr_desc2
    The array descriptor for the second array.

xdim2
    The X dimension index for the second array.

ydim2
    The Y dimension index for the second array.

type2
    The data type for the second array.

scale2
    The data scaling for the second array.

offset2
    The data offset for the second array.

ap2 The KwcsAstro object for the second array.

num_restr
    The number of restrictions for the second array.

restr_names
    The array of restriction names for the second array.

restr_values
    The restriction values for the second array.

min2
    The minimum value from the second array. This is updated.

max2
    The maximum value from the second array. This is updated.

RETURN VALUE
A KScatterPlot object on success, NULL.

Multi-threading Level
Unsafe.

NOTE
The KScatterPlot will be automatically destroyed if the canvas is destroyed.

AUTHOR
Richard Gooch (rgooch@atnf.csiro.au)

AVAILABLITY
The Karma Distribution is available for anonymous ftp from: ftp://ftp.atnf.csiro.au/pub/software/karma/ ftp://wuarchive.wustl.edu/graphics/graphics/packages/karma/ ftp://ftp.pwr.wroc.pl/pub/karma/ The Karma Home Page is: http://www.atnf.csiro.au/karma/