Draw samples from a lognormal distribution.

hanaml.lognormal(
  connection.context,
  m = NULL,
  location = NULL,
  scale = NULL,
  seed = NULL,
  thread.ratio = NULL
)

Arguments

connection.context

ConnectionContext
SAP HANA Database connection object.

m

integer, optional
Standard deviation of the underlying normal distribution. Defaults to 1

location

numeric, optional
Location parameter for lognormal distribution.
Defaults to 0.

scale

numeric, optional
Scale parameter for lognormal distribution.
Defaults to 1.

seed

integer, optional
Indicates the seed used to initialize the random number generator:

  • 0: Uses the system time.

  • Not 0: Uses the specified seed.

Note that when multithreading is enabled, the random number sequences of different runs might be different even if the seed value remains the same.
Defaults to 0.

thread.ratio

double, optional
Controls the proportion of available threads that can be used by this function.
The value range is from 0 to 1, where 0 indicates a single thread, and 1 indicates all available threads.
Values between 0 and 1 will use up to that percentage of available threads.Values outside this range are ignored.
Defaults to 0.

Value

DataFrame containing the generated random samples, structured as follows:

  • ID: type INTEGER, ID column

  • GENERATED_NUMBER: type DOUBLE, sample values

Examples

Draw samples from a lognormal distribution:


> lognormal <- hanaml.lognormal(connection.context = conn,
                                m = 20,
                                location = 0.6,
                                scale = 1,
                                seed = 1,
                                thread.ratio = 0)

Output:


> exponential$collect()
   ID  GENERATED_NUMBER
1   0          0.461803
2   1          0.548432
3   2          0.625874
4   3          3.038529
5   4          3.582703
6   5          1.867543
7   6          1.853857
8   7          0.378827
9   8          1.104031
10  9          0.840102