PHP | stats_rand_gen_ibinomial() Function

PHP stats_rand_gen_ibinomial() Function


Hello folks! welcome back to a new edition of our tutorial on PHP. In this tutorial guide, we are going to be discussing briefly about the php stats_rand_gen_ibinomial() function.

The built-in PHP stats_rand_gen_ibinomial() function generates a single random deviate from the binomial distribution.

Syntax

Following below is the syntax to use this function -

int stats_rand_gen_ibinomial( int $n, float $pp )


Parameter Details

Sr.NoParameterDescription
1

n

The number of trials

2

pp

The probability of an event in each trial


Return Value

This PHP function returns a random deviate from the binomial distribution, in which the number of trials and probability of events in each trail are "n" and "pp" respectively.

Dependencies

This built-in function was first introduced in statistics extension (PHP version 4.0.0 and PEAR v1.4.0). In this tutorial guide, we used the latest release of stats-2.0.3 (PHP v7.0.0 or newer and PEAR version 1.4.0 or newer).

Example1

In the below example, we have compute the random deviation from binomial distribution whose number of trial and probability of an event in each trial are 0 and 0.7 respectively -

<?php
   var_dump(stats_rand_gen_ibinomial(0, 0.7));
?>

Output

When the above code is executed, it will produce the following result -

int(0)

Example2

In the below example, we have compute the random deviation from binomial distribution whose number of trial and probability of an event in each trial are 3 and 0 respectively -

<?php
   var_dump(stats_rand_gen_ibinomial(3, 0));
?>

Output

When the above code is executed, it will produce the following result -

int(0)

Example3

In the below example, we have compute the random deviation from binomial distribution whose number of trial and probability of an event in each trial are 3 and 1 respectively -

<?php
   var_dump(stats_rand_gen_ibinomial(3, 1));
?>

Output

When the above code is executed, it will produce the following result -

int(3)

Example4

The following below is an error case. In the following example, we have passed n < 0. A warning is shown in logs -

<?php
   // error cases
   var_dump(stats_rand_gen_ibinomial(-1, 0.7));    // n < 0
?>

Output

The above code will produce the following result and a warning in logs PHP Warning: stats_rand_gen_ibinomial(): Bad values for the arguments. n: -1 pp: 7.000000E-1vs

bool(false)

Example5

The following is an error case. In the below example, we have passed pp < 0. A warning is shown in logs -

<?php
   // error cases
   var_dump(stats_rand_gen_ibinomial(3, -0.1));    // pp < 0
?>

Output

The above code will produce the following result and a warning in logs PHP Warning: stats_rand_gen_ibinomial(): Bad values for the arguments n: 3 pp: -1.000000E-1

bool(false)

Example6

The following is an error case. In the below example, we have passed pp > 1. A warning is shown in logs -

<?php
   // error cases
   var_dump(stats_rand_gen_ibinomial(3, 1.1));     // pp > 1
?>

Output

The above code will produce the following result and a warning in logs PHP Warning: stats_rand_gen_ibinomial(): Bad values for the arguments. n: 3 pp: 1.100000E+0

bool(false)


Alright guys! This is where we are going to be rounding up for this tutorial post. In our next tutorial, we will be studying  about the built-in stats_rand_gen_ibinomial_negative() Function.

Feel free to ask your questions where necessary and we will attend to them as soon as possible. If this tutorial was helpful to you, you can use the share button to share this tutorial.

Follow us on our various social media platforms to stay updated with our latest tutorials. You can also subscribe to our newsletter in order to get our tutorials delivered directly to your emails.

Thanks for reading and bye for now.