PHP | stats_cdf_noncentral_chisquare() Function

PHP stats_cdf_noncentral_chisquare() Function


Hello folks! welcome back to a new edition of our tutorial on PHP. In this tutorial guide, we are going to be studying about the PHP stats_cdf_noncentral_chisquare() Function.

The PHP stats_cdf_noncentral_chisquare() function is used for calculating any one parameter of the non-central chi-square distribution given values for the others.

Syntax

Following below is the syntax to use this function -

float stats_cdf_noncentral_chisquare ( float $par1, float $par2, float $par3, int $which )


Parameter Details

Sr.NoParameterDescription
1

par1

The first parameter

2

par2

The second parameter

3

par3

The third parameter

4

which

The flag to determine what to be calculated


Return Value

This built-in function can return the CDF, its inverse, or one of its parameters of the non-central chi-square distribution. The kind of return value and the parameters (par1, par2, & par3) are determined by which.

The following table list the return value and parameters by which.

  • CDF denotes cumulative distribution function.
  • x denotes the number of failures.
  • k denotes the number of success.
  • lambda denotes the success rate for each trial.

whichReturn valuepar1par2par3
1CDFxklambda
2xCDFklambda
3kxCDFlambda
4lambdaxCDFk

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 following example below, when which = 1, calculate P from (X, DF, PNONC).

  • P is the integral from 0 to X of the non-central chi-square distribution.
  • X is the upper limit of integration of the non-central chi-square distribution.
  • DF is the degree of freedom of the non-central chi-square distribution.
  • PNONC is the non-centrality parameter of the non-central chi-square distribution.

<?php
   // which = 1 : calculate P from (X, DF, PNONC)
   var_dump(round(stats_cdf_noncentral_chisquare(4, 2, 3, 1), 6));
?>

Output

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

float(0.493562)

Example2

In the following example below, when which = 2, calculate X from (P, DF, PNONC).

  • P is the integral from 0 to X of the non-central chi-square distribution.
  • X is the upper limit of integration of the non-central chi-square distribution.
  • DF is the degree of freedom of the non-central chi-square distribution.
  • PNONC is the non-centrality parameter of the non-central chi-square distribution.

<?php
   // which = 2 : calculate X from (P, DF, PNONC)
   var_dump(round(stats_cdf_noncentral_chisquare(0.493562417, 2, 3, 2), 6));
?>

Output

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

float(4)

Example3

In the following example below, when which = 3, calculate DF from (P, X, PNONC).

  • P is the integral from 0 to X of the non-central chi-square distribution.
  • X is the upper limit of integration of the non-central chi-square distribution.
  • DF is the degree of freedom of the non-central chi-square distribution.
  • PNONC is the non-centrality parameter of the non-central chi-square distribution.

<?php
   // which = 3 : calculate DF from (P, X, PNONC)
   var_dump(round(stats_cdf_noncentral_chisquare(0.493562417, 4, 3, 3), 6));
?>

Output

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

float(2)

Example4

In the following example below, when which = 4, calculate PNONC from (P, X, DF).

  • P is the integral from 0 to X of the non-central chi-square distribution.
  • X is the upper limit of integration of the non-central chi-square distribution.
  • DF is the degree of freedom of the non-central chi-square distribution.
  • PNONC is the non-centrality parameter of the non-central chi-square distribution.

<?php
   // which = 4 : calculate PNONC from (P, X, DF)
   var_dump(round(stats_cdf_noncentral_chisquare(0.493562417, 4, 2, 4), 6));
?>

Output

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

float(3)

Example5

Following is an error case. In the following example below which<1, warning message is displayed in logs.

<?php
   var_dump(stats_cdf_noncentral_chisquare(4, 2, 3, 0));       // which < 1
?>

Output

The above code will produce the following result and a warning in logs PHP Warning: stats_cdf_noncentral_chisquare(): Fourth parameter should to be in the 1..4 range.

bool(false)

Example6

Following is an error case. In the following example below which>4, warning message is displayed in logs.

<?php
   var_dump(stats_cdf_noncentral_chisquare(4, 2, 3, 5));       // which > 4
?>

Output

The above code will produce the following result and a warning in logs PHP Warning: stats_cdf_noncentral_chisquare(): Fourth parameter should to be in the 1..4 range.

bool(false)


Alright guys! This is where we are going to be rounding up for this tutorial post. In our next tutorial, we are going to be discussing about the stats_cdf_noncentral_f() Function in PHP.

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.