IDEAS home Printed from
MyIDEAS: Log in (now much improved!) to save this software component

RANKTEST: Stata module to test the rank of a matrix using the Kleibergen-Paap rk statistic

Listed author(s):
  • Frank Kleibergen


    (Brown University)

  • Mark E Schaffer


    (Heriot-Watt University)

ranktest implements the Kleibergen-Paap (2006) rk test for the rank of a matrix. Tests of the rank of a matrix have many practical applications. For example, in econometrics the requirement for identification is the rank condition, which states that a particular matrix must be of full column rank. Another example from econometrics concerns cointegration in vector autoregressive (VAR) models; the Johansen trace test is a test of a rank of a particular matrix. The traditional test of the rank of a matrix for the standard (stationary) case is the Anderson (1951) canonical correlations test. If we denote one list of variables as Y and a second as Z, and we calculate the squared canonical correlations between Y and Z, the LM form of the Anderson test, where the null hypothesis is that the matrix of correlations or regression parameters B between Y and Z has rank(B)=r, is N times the sum of the r+1 largest squared canonical correlations. A large test statistic and rejection of the null indicates that the matrix has rank at least r+1. The Cragg-Donald (1993) statistic is a closely related Wald test for the rank of a matrix. Both the Anderson and Cragg-Donald tests require the assumption that the covariance matrix has a Kronecker form; when this is not so, e.g., when disturbances are heteroskedastic or autocorrelated, the test statistics are no longer valid. The Kleibergen-Paap (2006) rk statistic is a generalization of the Anderson canonical correlation rank test to the case of a non-Kronecker covariance matrix. The implementation in ranktest will calculate rk statistics that are robust to various forms of heteroskedasticity, autocorrelation, and clustering.

If you experience problems downloading a file, check if you have the proper application to view it first. In case of further problems read the IDEAS help page. Note that these files are not on the IDEAS site. Please be patient as the files may be large.

File URL:
File Function: program code
Download Restriction: no

File URL:
File Function: program code
Download Restriction: no

File URL:
File Function: help file
Download Restriction: no

File URL:
File Function: help file
Download Restriction: no

File URL:
File Function: cert script
Download Restriction: no

Software component provided by Boston College Department of Economics in its series Statistical Software Components with number S456865.

in new window

Programming language: Stata
Requires: Stata version 11.2 (version 9.2 for ranktest9)
Date of creation: 30 Aug 2007
Date of revision: 24 Jan 2015
Handle: RePEc:boc:bocode:s456865
Note: This module should be installed from within Stata by typing "ssc install ranktest". Windows users should not attempt to download these files with a web browser.
Contact details of provider: Postal:
Boston College, 140 Commonwealth Avenue, Chestnut Hill MA 02467 USA

Phone: 617-552-3670
Fax: +1-617-552-2308
Web page:

More information through EDIRC

Order Information: Web:

This item is not listed on Wikipedia, on a reading list or among the top items on IDEAS.

When requesting a correction, please mention this item's handle: RePEc:boc:bocode:s456865. See general information about how to correct material in RePEc.

For technical questions regarding this item, or to correct its authors, title, abstract, bibliographic or download information, contact: (Christopher F Baum)

If you have authored this item and are not yet registered with RePEc, we encourage you to do it here. This allows to link your profile to this item. It also allows you to accept potential citations to this item that we are uncertain about.

If references are entirely missing, you can add them using this form.

If the full references list an item that is present in RePEc, but the system did not link to it, you can help with this form.

If you know of missing items citing this one, you can help us creating those links by adding the relevant references in the same way as above, for each refering item. If you are a registered author of this item, you may also want to check the "citations" tab in your profile, as there may be some citations waiting for confirmation.

Please note that corrections may take a couple of weeks to filter through the various RePEc services.

This information is provided to you by IDEAS at the Research Division of the Federal Reserve Bank of St. Louis using RePEc data.