Developer(s)the gretl team
Initial release31 January 2000; 24 years ago (2000-01-31)
Stable release
2023b[1] Edit this on Wikidata / 21 July 2023; 6 months ago (21 July 2023)
Preview release
Through git
Written inC
Operating systemCross-platform
Available inMultilingual (11)
TypeStatistical software
LicenseGNU GPLv3

gretl is an open-source statistical package, mainly for econometrics. The name is an acronym for Gnu Regression, Econometrics and Time-series Library.

It has both a graphical user interface (GUI) and a command-line interface. It is written in C, uses GTK+ as widget toolkit for creating its GUI, and calls gnuplot for generating graphs. The native scripting language of gretl is known as hansl (see below); it can also be used together with TRAMO/SEATS, R, Stata, Python, Octave, Ox and Julia.

It includes natively all the basic statistical techniques employed in contemporary Econometrics and Time-Series Analysis. Additional estimators and tests are available via user-contributed function packages, which are written in hansl.[2] gretl can output models as LaTeX files.

Besides English, gretl is also available in Albanian, Basque, Bulgarian, Catalan, Chinese, Czech, French, Galician, German, Greek, Italian, Polish, Portuguese (both varieties), Romanian, Russian, Spanish, Turkish and Ukrainian.

Gretl has been reviewed several times in the Journal of Applied Econometrics[3][4][5] and, more recently, in the Australian Economic Review.[6]

A review also appeared in the Journal of Statistical Software[7] in 2008. Since then, the journal has featured several articles in which gretl is used to implement various statistical techniques.

Supported data formats

gretl offers its own fully documented, XML-based data format.

It can also import ASCII, CSV, databank, EViews, Excel, Gnumeric, GNU Octave, JMulTi, OpenDocument spreadsheets, PcGive, RATS 4, SAS xport, SPSS, and Stata files. Since version 2020c, the GeoJSON and Shapefile formats are also supported, for thematic map creation.

It can export to Stata, GNU Octave, R, CSV, JMulTi, and PcGive file formats.


Gretl has its own scripting language, called hansl (which is a recursive acronym for Hansl's A Neat Scripting Language).

Hansl is a Turing-complete, interpreted programming language, featuring loops, conditionals, user-defined functions and complex data structures.[8] It can be considered a domain-specific language for econometrics.[9] Like other scientifically oriented programming languages, such as MATLAB and Julia, matrices are supported natively as a primitive variable type.

A simple example of hansl:

matrix A = {1, 2 ; 3, 4}
matrix B = inv(A)
matrix C = A*B

print A B C

loop i=-3..3
    printf "Phi(%d) = %7.3f\n", i, cdf(N, i)

Running the above code produces

A (2 x 2)

  1   2
  3   4

B (2 x 2)

    -2      1
   1.5   -0.5

C (2 x 2)

      1.0000       0.0000
  8.8818e-16       1.0000

Phi(-3) =   0.001
Phi(-2) =   0.023
Phi(-1) =   0.159
Phi( 0) =   0.500
Phi( 1) =   0.841
Phi( 2) =   0.977
Phi( 3) =   0.999

Random Number Generation

Random Number Generation (RNG) in gretl has been examined and tested in Yalta & Schreiber (2012).[10] The authors conclude "Our results show that the RNG related procedures in gretl are implemented soundly and perform well in the three crush test suites of the TestU01".

Gretl as a teaching tool

Due to its libre nature and the breadth of econometric techniques it contains, gretl is widely used for teaching econometrics, from the undergraduate level onwards. Datasets in gretl format are available for several popular textbooks.

The following is a list of textbooks that use gretl as their software of choice:

In addition, a free supplement[11] to Hill, Griffiths and Lim Principles of Econometrics (Wiley) is available.

See also


  1. ^ Allin F. Cottrell (21 July 2023). "gretl 2023b released". Retrieved 1 August 2023.
  2. ^ "gretl function packages".
  3. ^ Baiocchi, Giovanni; Distaso, Walter (2003). "GRETL: Econometric software for the GNU generation". Journal of Applied Econometrics. 18: 105–110. CiteSeerX doi:10.1002/jae.704.
  4. ^ "GRETL: 1.6.0 and its numerical accuracy". Archived from the original on 2012-12-16. ((cite journal)): Cite journal requires |journal= (help)
  5. ^ Mixon Jr, J. Wilson; Smith, Ryan J. (2006). "Teaching undergraduate econometrics with GRETL". Journal of Applied Econometrics. 21 (7): 1103–1107. doi:10.1002/jae.927.
  6. ^ Tarassow, Artur (2019). "Practical Empirical Research Using gretl and hansl". Australian Economic Review. 52 (2): 255–271. doi:10.1111/1467-8462.12324. S2CID 195431406.
  7. ^ Rosenblad, Andreas (2008). "gretl 1.7.3". Journal of Statistical Software. 25 (1): 1–14. doi:10.18637/jss.v025.s01.
  8. ^ "A Hansl Primer" (PDF).
  9. ^ Cottrell, Allin (2017). "Hansl". Hansl: a DSL for econometrics. pp. 1–10. doi:10.1145/3039895.3039896. ISBN 9781450348454. S2CID 15784497.
  10. ^ Yalta, A. Talha; Schreiber, Sven (2012). "Random Number Generation in gretl". Journal of Statistical Software. 50 (Code Snippet 1). doi:10.18637/jss.v050.c01. ISSN 1548-7660.
  11. ^ "Lee Adkins' book".