binomial

hana_ml.algorithms.pal.random.binomial(conn_context, n=1, p=0.5, num_random=100, seed=None, thread_ratio=None)

Draw samples from a binomial distribution.

Parameters
conn_contextConnectionContext

Database connection object.

nint, optional

Number of trials.

Defaults to 1.

pfloat, optional

Successful fraction. The value range is from 0 to 1.

Defaults to 0.5.

num_randomint, optional

Specifies the number of random data to be generated.

Defaults to 100.

seedint, optional

Indicates the seed used to initialize the random number generator:

  • 0: Uses the system time.

  • Not 0: Uses the specified seed.

Note

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_ratiofloat, optional

Controls the proportion of available threads to use.

The value range is from 0 to 1, where 0 indicates a single thread, and 1 indicates up to all available threads.

Values between 0 and 1 will use that percentage of available threads.

Values outside the range [0, 1] tell PAL to heuristically determine the number of threads to use.

Defaults to 0.

Returns
DataFrame

Dataframe containing the generated random samples, structured as follows:

  • ID, type INTEGER, ID column.

  • GENERATED_NUMBER, type DOUBLE, sample value.

Examples

Draw samples from a binomial distribution.

>>> res = binomial(conn_context=cc, n=1, p=0.5, num_random=10)
>>> res.collect()
   ID  GENERATED_NUMBER
0   0               1.0
1   1               1.0
2   2               0.0
3   3               1.0
4   4               1.0
5   5               1.0
6   6               0.0
7   7               1.0
8   8               0.0
9   9               1.0