DATAMANIP (kdatamanip) functions


LIBRARY ROUTINE

lkgnoise - generate noise in value segment of data object

LIBRARY CALL

int lkgnoise(
             int width, 
	     int height,
             int depth, 
             int t,
             int elements,
             char *noise_type,
             int datatype,
             double noise_spec1,
             double noise_spec2,
             kobject object)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) on success, FALSE (0) otherwise

DESCRIPTION

Library Routine for kgnoise. lkgnoise creates noisy value segment for a data object. The value segment will be set to the dimension of width* height * depth * time * elements that were specified. The data type of the value segment is specified by the datatype int and can be KBIT, KBYTE, KUBYTE, KSHORT, KUSHORT, KINT, KUINT, KLONG, KULONG, KFLOAT, KDOUBLE, KCOMPLEX and KDCOMPLEX. The value segment will be set to the noisy data having the distribution specified by the noise_type string. The noise distribution can be Gaussian, Rayleigh, Uniform, Exponential or Poisson. The parameters associated with a particular distribution can be specifed by noise_apec1 and noise_spec2 (optional depending on the distribution).

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATAMANIP/objects/library/kdatamanip/src/lkgnoise.c

SEE ALSO

kdatamanip(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.