WorksheetFunction.ChiInv Method

Excel Developer Reference

Returns the inverse of the one-tailed probability of the chi-squared distribution.

Syntax

expression.ChiInv(Arg1, Arg2)

expression   A variable that represents a WorksheetFunction object.

Parameters

Name Required/Optional Data Type Description
Arg1 Required Double A probability associated with the chi-squared distribution.
Arg2 Required Double The number of degrees of freedom.

Return Value
Double

Remarks

If probability = ChiDist(x,...), then ChiInv(probability,...) = x. Use this function to compare observed results with expected ones in order to decide whether your original hypothesis is valid.

  • If either argument is nonnumeric, ChiInv generates an error.
  • If probability < 0 or probability > 1, ChiInv generates an error.
  • If degrees_freedom is not an integer, it is truncated.
  • If degrees_freedom < 1 or degrees_freedom ≥ 10^10, ChiInv generates an error.

Given a value for probability, ChiInv seeks that value x such that ChiDist(x, degrees_freedom) = probability. Thus, precision of ChiInv depends on precision of ChiDist. ChiInv uses an iterative search technique. If the search has not converged after 100 iterations, the function generates an error.

See Also