KPSS test for stationarity
Name,Value pair argument
is a vector, then all
Name,Value pair arguments
specified must be vectors of equal length or length one.
each element of a vector input as a separate test, and returns a vector
of rejection decisions.
Name,Value pair argument
is a row vector, then
a row vector.
Reproduce the first row of the second half of Table 5 in Kwiatkowski et al., 1992.
Load the Nelson-Plosser Macroeconomic series data set.
Linearize the real gross national product series (RGNP).
logGNPR = log(DataTable.GNPR);
Assess the null hypothesis that the series is trend stationary over a range of lags.
lags = (0:8)'; [~,pValue,stats] = kpsstest(logGNPR,'Lags',lags,'Trend',true); results = [lags pValue stats]
Warning: Test statistic #1 above tabulated critical values: minimum p-value = 0.010 reported. Warning: Test statistic #2 above tabulated critical values: minimum p-value = 0.010 reported. Warning: Test statistic #3 above tabulated critical values: minimum p-value = 0.010 reported. results = 0 0.0100 0.6299 1.0000 0.0100 0.3367 2.0000 0.0100 0.2421 3.0000 0.0169 0.1976 4.0000 0.0276 0.1729 5.0000 0.0401 0.1578 6.0000 0.0484 0.1479 7.0000 0.0589 0.1412 8.0000 0.0668 0.1370
Warnings appear because the tests using 0
2 produce p-values that are less than 0.01. For
7, the tests indicate sufficient evidence to suggest that log rGNP is unit root nonstationary (i.e., not trend stationary) at the default 5% level.
Test whether the wage series in the manufacturing sector (1900-1970) has a unit root.
Load the Nelson-Plosser Macroeconomic data set.
load Data_NelsonPlosser wages = DataTable.WN; T = sum(isfinite(wages)); % Sample size without NaNs sqrtT = sqrt(T) % See Kwiatkowski et al., 1992
sqrtT = 8.4261
Plot the wages series.
plot(dates,wages) title('Wages') axis tight
The plot suggests that the wages series grows exponentially.
Linearize the wages series.
logWages = log(wages); plot(dates,logWages) title('Log Wages') axis tight
The plot suggests that the log wages series has a linear trend.
Test the hypothesis that the log wages series is a unit root process with a trend (i.e., difference stationary), against the alternative that there is no unit root (i.e., trend stationary). Conduct the test by setting a range of lags around , as suggested in Kwiatkowski et al., 1992.
[h,pValue] = kpsstest(logWages,'lags',[7:10])
Warning: Test statistic #1 below tabulated critical values: maximum p-value = 0.100 reported. Warning: Test statistic #2 below tabulated critical values: maximum p-value = 0.100 reported. Warning: Test statistic #3 below tabulated critical values: maximum p-value = 0.100 reported. Warning: Test statistic #4 below tabulated critical values: maximum p-value = 0.100 reported. h = 0 0 0 0 pValue = 0.1000 0.1000 0.1000 0.1000
All tests fail to reject the null hypothesis that the log wages series is trend stationary.
The warning messages do not indicate a problem. Rather, they indicate that the p-values are larger than 0.1. The software compares the test statistic to critical values and computes p-values that it interpolates from tables in Kwiatkowski et al., 1992.
Univariate time series, specified as a vector. The last element is the most recent observation.
NaNs indicate missing observations, and
the effective sample size and can cause an irregular time series.
Specify optional comma-separated pairs of
Name is the argument
Value is the corresponding
Name must appear
inside single quotes (
You can specify several name and value pair
arguments in any order as
'alpha',0.1,'lags',0:2specifies three tests that include 0, 1, and 2 autocovariance lags in the Newey-West estimator of the long-run variance, each conducted at 0.1 level of significance.
'lags'— Number of autocovariance lags0 (default) | nonnegative integer | vector of nonnegative integers
Number of autocovariance lags to include in the Newey-West estimator
of the long-run variance, specified as the comma-separated pair consisting
'lags' and a nonnegative integer or vector of
nonnegative integers. Use a vector to conduct multiple tests.
'trend'— Indicate whether to include deterministic trend
false| vector of logical values
Indicate whether to include the deterministic trend term δt in
the model, specified as the comma-separated pair consisting of
and a logical value or a vector of logical values. Use a vector to
conduct multiple tests.
'alpha'— Significance levels0.05 (default) | scalar | vector
Significance levels for the hypothesis tests, specified as the
comma-separated pair consisting of
a scalar or vector. All values of
alpha must be
between 0.01 and 0.10. Use a vector to conduct multiple tests.
h— Test rejection decisionslogical | vector of logical values
Test rejection decisions, returned as a logical value or vector of logical values with a length equal to the number of tests that the software conducts.
h = 1 indicates rejection of the
trend-stationary null in favor of the unit root alternative.
h = 0 indicates failure to reject
the trend-stationary null.
pValue— Test statistic p-valuesscalar | vector
Test statistic p-values, returned as a scalar or vector with a length equal to the number of tests that the software conducts. The p-values are right-tail probabilities.
stat— Test statisticsscalar | vector
Test statistics, returned as a scalar or vector with a length equal to the number of tests that the software conducts.
kpsstest computes test statistics using an
ordinary least squares (OLS) regression.
If you set
the software regresses
y on an intercept.
Otherwise, the software regresses
an intercept and trend term.
cValue— Critical valuesscalar | vector
Critical values, returned as a scalar or vector with a length equal to the number of tests that the software conducts. Critical values are for right-tail probabilities.
reg— Regression statisticsdata structure | data structure array
Regression statistics for ordinary least squares (OLS) estimation of coefficients in the alternative model, returned as a data structure or data structure array with a length equal to the number of tests that the software conducts.
Each data structure has the following fields.
|Length of input series with |
|Effective sample size, adjusted for lags|
|Regression coefficient names|
|Estimated coefficient values|
|Estimated coefficient standard errors|
|Estimated coefficient covariance matrix|
|t statistics of coefficients and p-values|
|F statistic and p-value|
|Mean of the lag-adjusted input series|
|Standard deviation of the lag-adjusted input series|
|Fitted values of the lag-adjusted input series|
|Regression sum of squares|
|Error sum of squares|
|Total sum of squares|
|Mean square error|
|Standard error of the regression|
|Adjusted R2 statistic|
|Loglikelihood of data under Gaussian innovations|
|Akaike information criterion|
|Bayesian (Schwarz) information criterion|
|Hannan-Quinn information criterion|
Assesses the null hypothesis that a univariate time series is trend stationary against the alternative that it is a nonstationary unit root process.
The test uses the structural model:
δ is the trend coefficient.
u1t is a stationary process.
u2t is an independent and identically distributed process with mean 0 and variance σ2.
The null hypothesis is that σ2 = 0, which implies that the random walk term (ct) is constant and acts as the model intercept. The alternative hypothesis is that σ2 > 0, which introduces the unit root in the random walk.
The test statistic is
T is the sample size.
s2 is the Newey-West estimate of the long-run variance.
In order to draw valid inferences from the KPSS test,
you should determine a suitable value for
These two methods determine a suitable number of lags:
Begin with a small number of lags and then evaluate the sensitivity of the results by adding more lags.
Kwiatkowski et al.  suggest that a number of lags on the order of , where T is the sample size, is often satisfactory under both the null and the alternative.
For consistency of the Newey-West estimator, the number of lags must approach infinity as the sample size increases.
You should determine the value of
the growth characteristics of the time series. Determine its value
with a specific testing strategy in mind.
If a series is growing, then include a trend term
to provide a reasonable comparison of a trend stationary null and
a unit root process with drift.
If a series does not exhibit long-term growth characteristics,
then don't include a trend term (i.e., set
kpsstest performs a regression
to find the ordinary least squares (OLS) fit between the data and
the null model.
Test statistics follow nonstandard distributions under
the null, even asymptotically. Kwiatkowski et al.  use
Monte Carlo simulations, for models with and without a trend, to tabulate
asymptotic critical values for a standard set of significance levels
between 0.01 and 0.1.
kpsstest interpolates critical
values and p-values from these tables.
 Hamilton, J. D. Time Series Analysis. Princeton, NJ: Princeton University Press, 1994.
 Kwiatkowski, D., P. C. B. Phillips, P. Schmidt, and Y. Shin. "Testing the Null Hypothesis of Stationarity against the Alternative of a Unit Root." Journal of Econometrics. Vol. 54, 1992, pp. 159–178.
 Newey, W. K., and K. D. West. "A Simple, Positive Semidefinite, Heteroskedasticity and Autocorrelation Consistent Covariance Matrix." Econometrica. Vol. 55, 1987, pp. 703–708.