- •Table of Contents
- •Chapter 1. Introduction
- •Using Commands
- •Batch Program Use
- •How to Use this Manual
- •Chapter 2. Object and Command Basics
- •Object Declaration
- •Object Commands
- •Object Assignment
- •More on Object Declaration
- •Auxiliary Commands
- •Managing Workfiles and Databases
- •Managing Objects
- •Basic Command Summary
- •Chapter 3. Matrix Language
- •Declaring Matrices
- •Assigning Matrix Values
- •Copying Data Between Objects
- •Matrix Expressions
- •Matrix Commands and Functions
- •Matrix Views and Procs
- •Matrix Operations versus Loop Operations
- •Summary of Automatic Resizing of Matrix Objects
- •Matrix Function and Command Summary
- •Chapter 4. Working with Tables
- •Creating a Table
- •Assigning Table Values
- •Customizing Tables
- •Labeling Tables
- •Printing Tables
- •Exporting Tables to Files
- •Customizing Spreadsheet Views
- •Table Summary
- •Chapter 5. Working with Graphs
- •Creating a Graph
- •Changing Graph Types
- •Customizing a Graph
- •Labeling Graphs
- •Printing Graphs
- •Exporting Graphs to Files
- •Graph Summary
- •Chapter 6. EViews Programming
- •Program Basics
- •Simple Programs
- •Program Variables
- •Program Modes
- •Program Arguments
- •Control of Execution
- •Multiple Program Files
- •Subroutines
- •Programming Summary
- •Chapter 7. Strings and Dates
- •Strings
- •Dates
- •Appendix A. Object, View and Procedure Reference
- •Alpha
- •Coef
- •Equation
- •Graph
- •Group
- •Link
- •Logl
- •Matrix
- •Model
- •Pool
- •Rowvector
- •Sample
- •Scalar
- •Series
- •Sspace
- •System
- •Table
- •Text
- •Valmap
- •Vector
- •Appendix B. Command Reference
- •addassign
- •addinit
- •addtext
- •align
- •alpha
- •append
- •arch
- •archtest
- •area
- •arlm
- •arma
- •arroots
- •auto
- •axis
- •bdstest
- •binary
- •block
- •boxplot
- •boxplotby
- •bplabel
- •cause
- •ccopy
- •cdfplot
- •cellipse
- •censored
- •cfetch
- •chdir
- •checkderivs
- •chow
- •clabel
- •cleartext
- •close
- •coef
- •coefcov
- •coint
- •comment
- •control
- •copy
- •correl
- •correlsq
- •count
- •create
- •cross
- •data
- •datelabel
- •dates
- •dbcopy
- •dbcreate
- •dbdelete
- •dbopen
- •dbpack
- •dbrebuild
- •dbrename
- •dbrepair
- •decomp
- •define
- •delete
- •derivs
- •describe
- •displayname
- •draw
- •drawdefault
- •driconvert
- •drop
- •dtable
- •edftest
- •endog
- •equation
- •errbar
- •exclude
- •exit
- •expand
- •fetch
- •fill
- •fiml
- •fixedtest
- •forecast
- •freeze
- •freq
- •frml
- •garch
- •genr
- •grads
- •graph
- •group
- •hconvert
- •hfetch
- •hilo
- •hist
- •hlabel
- •impulse
- •jbera
- •kdensity
- •kerfit
- •label
- •laglen
- •legend
- •line
- •linefit
- •link
- •linkto
- •load
- •logit
- •logl
- •makecoint
- •makederivs
- •makeendog
- •makefilter
- •makegarch
- •makegrads
- •makegraph
- •makegroup
- •makelimits
- •makemap
- •makemodel
- •makeregs
- •makeresids
- •makesignals
- •makestates
- •makestats
- •makesystem
- •matrix
- •means
- •merge
- •metafile
- •model
- •name
- •nnfit
- •open
- •options
- •ordered
- •output
- •override
- •pageappend
- •pagecontract
- •pagecopy
- •pagecreate
- •pagedelete
- •pageload
- •pagerename
- •pagesave
- •pageselect
- •pagestack
- •pagestruct
- •pageunstack
- •param
- •pcomp
- •plot
- •pool
- •predict
- •probit
- •program
- •qqplot
- •qstats
- •range
- •ranhaus
- •read
- •rename
- •representations
- •resample
- •reset
- •residcor
- •residcov
- •resids
- •results
- •rndint
- •rndseed
- •rowvector
- •sample
- •save
- •scalar
- •scale
- •scat
- •scatmat
- •scenario
- •seas
- •seasplot
- •series
- •setbpelem
- •setcell
- •setcolwidth
- •setconvert
- •setelem
- •setfillcolor
- •setfont
- •setformat
- •setheight
- •setindent
- •setjust
- •setline
- •setlines
- •setmerge
- •settextcolor
- •setwidth
- •sheet
- •show
- •signalgraphs
- •smooth
- •smpl
- •solve
- •solveopt
- •sort
- •spec
- •spike
- •sspace
- •statby
- •stategraphs
- •statefinal
- •stateinit
- •stats
- •statusline
- •stom
- •stomna
- •store
- •structure
- •svar
- •system
- •table
- •template
- •testadd
- •testbtw
- •testby
- •testdrop
- •testexog
- •testfit
- •testlags
- •teststat
- •text
- •textdefault
- •trace
- •tramoseats
- •tsls
- •unlink
- •update
- •updatecoefs
- •uroot
- •usage
- •valmap
- •vars
- •vector
- •wald
- •wfcreate
- •wfopen
- •wfsave
- •wfselect
- •white
- •workfile
- •write
- •wtsls
- •xyline
- •xypair
- •Appendix C. Special Expression Reference
- •@expand
- •nrnd
- •Appendix D. Operator and Function Reference
- •Operators
- •Basic Mathematical Functions
- •Time Series Functions
- •Descriptive Statistics
- •By-Group Statistics
- •Special Functions
- •Trigonometric Functions
- •Statistical Distribution Functions
- •Appendix E. Workfile Functions
- •Basic Workfile Information
- •Dated Workfile Information
- •Panel Workfile Functions
- •Appendix F. String and Date Function Reference
- •@dateadd
- •@datediff
- •@datefloor
- •@datepart
- •@datestr
- •@dateval
- •@dtoo
- •@eqna
- •@insert
- •@instr
- •@isempty
- •@left
- •@len, @length
- •@lower
- •@ltrim
- •@makedate
- •@neqna
- •@otod
- •@replace
- •@right
- •@rtrim
- •@strdate
- •@strlen
- •@strnow
- •@trim
- •@upper
- •Appendix G. Matrix Reference
- •@cholesky
- •colplace
- •@columnextract
- •@columns
- •@cond
- •@convert
- •@eigenvalues
- •@eigenvectors
- •@explode
- •@filledmatrix
- •@filledrowvector
- •@filledsym
- •@filledvector
- •@getmaindiagonal
- •@identity
- •@implode
- •@inner
- •@inverse
- •@issingular
- •@kronecker
- •@makediagonal
- •matplace
- •mtos
- •@norm
- •@outer
- •@permute
- •@rank
- •@resample
- •@rowextract
- •rowplace
- •@rows
- •@solvesystem
- •stom
- •stomna
- •@subextract
- •@trace
- •@transpose
- •@unitvector
- •@vech
- •Appendix H. Programming Language Reference
- •call
- •@date
- •else
- •endif
- •endsub
- •@errorcount
- •@evpath
- •exitloop
- •include
- •@isobject
- •next
- •open
- •output
- •poff
- •program
- •return
- •statusline
- •step
- •stop
- •subroutine
- •@temppath
- •then
- •@time
- •wend
- •while
- •Index
- •Symbols
- •% (percent sign)
- •+ (plus)
- •addition 35
- •@crossid 593
- •@date 148, 590, 633
- •@eqna 124, 575, 599
- •@-functions
- •@inner 578, 619
- •@insert 126, 600
- •@instr 124, 600
- •@inverse 620
- •@isempty 124, 601
- •@isna 575
- •@isobject 637
- •@isperiod 591
- •@issingular 620
- •@kronecker 620
- •@kurtsby 580
- •@last 474
- •@lastmax 474
- •@lastmin 474
- •@left 125, 601, 606
- •@length 124, 602
- •@logit 583
- •@logx 576
- •@lower 127, 602
- •@ltrim 126, 602
- •@makedate 142, 603
- •@makediagonal 621
- •@maxsby 579
- •@meansby 579
- •@median 578
- •@mediansby 579
- •@minsby 579
- •@month 148, 591
- •@movav 576
- •@movsum 576
- •@nasby 580
- •@neqna 125, 575, 604
- •@ngroups 580
- •@norm 623
- •@obsby 579
- •@obsid 593
- •@obsnum 589
- •@obsrange 590
- •@obssmpl 590
- •@otod 128, 605
- •@outer 623
- •@pcha 577
- •@pchy 577
- •@permute 624
- •@quantile 579
- •@quantilesby 580
- •@quarter 148, 591
- •@rank 624
- •@recode 576
- •@replace 126, 605
- •@resample 625
- •@RGB specification of colors 454
- •@right 126
- •@round 576
- •@rowextract 625
- •@rows 626
- •@rtrim 126, 606
- •@seas 591
- •@skewsby 580
- •@solvesystem 626
- •@sqrt 576
- •@stdev 579
- •@stdevsby 579
- •@strdate 128, 148, 591, 607
- •@strlen 607
- •@strnow 128, 607
- •@subextract 628
- •@sumsby 579
- •@sumsq 579
- •@sumsqsby 579
- •@temppath 641
- •_ (continuation character) 84
- •Numerics
- •Add factor
- •align 203
- •views 154
- •Alpha series
- •append 205
- •ARCH
- •Arguments
- •in programs 98
- •ARMA
- •ASCII file
- •open as workfile 532
- •Autocorrelation
- •Autogressive error. See AR.
- •Autowrap text 83
- •Axis
- •rename label 371
- •axis 217
- •Beta
- •Binary
- •Binomial
- •customize 231
- •Breusch-Godfrey test
- •call 633
- •Cell
- •censored 238
- •Cholesky factor
- •Chow test 241
- •Close
- •Coefficient
- •See Coef.
- •update default coef vector 521
- •Cointegration
- •Color
- •Column
- •extract from matrix 612
- •stack matrix 630
- •Conditional standard deviation
- •Conditional variance
- •Control variable 88
- •Convert
- •date to observation number 599
- •matrix to sym 618
- •Coordinates
- •Copy
- •cross 260
- •matrix 259
- •Create
- •Cross section member
- •of squares 424
- •Data
- •Database
- •Date
- •Dates
- •current date and time 147
- •string representation 598
- •Declare
- •Delete
- •Derivatives
- •Directory
- •Distribution function
- •DRI database
- •fetch series 239
- •Drop
- •group series or cross-section from pool definition 281
- •Eigenvalues 615
- •Element
- •else 634
- •Error correction model
- •Errors
- •exclude 289
- •Exclude variables from model solution 289
- •Exit
- •Exponential
- •Export
- •matrix 41
- •Extract
- •row vector 625
- •Files
- •Fill
- •Filled
- •Fixed effects
- •For loop
- •Forecast
- •Freeze
- •frml 306
- •Full information maximum likelihood 296
- •GARCH
- •Gauss file 532
- •Gaussian distribution 586
- •Generalized autoregressive conditional heteroskedasticity
- •Generate series
- •Gompit models 222
- •Gradients
- •display 315
- •create 59
- •high-low-open-close 320
- •pie graph 406
- •XY graph 556
- •graph 316
- •greater than comparison 36
- •add series 198
- •group 317
- •Hausman test 413
- •hconvert 318
- •HTML
- •If statement 100
- •Include
- •Inverse of matrix 620
- •Jarque-Bera
- •Johansen cointegration test 245
- •Kernel
- •label 330
- •specify as range 643
- •Lagrange multiplier
- •Legend
- •line 334
- •Link object
- •Local
- •Logistic
- •logl 344
- •Loop
- •exit loop 108, 635
- •Lotus file
- •Matrix
- •resample rows from 625
- •matrix 366
- •Maximum 578
- •Median 578
- •Merge
- •Messages
- •model solution 371
- •Model 170
- •Models
- •block structure 223
- •solve 475
- •Multiplication operator (*) 35
- •Negative binomial
- •Number
- •evaluate a string 608
- •Numbers
- •converting from strings 124
- •store 16, 490
- •Open
- •database 266
- •Output
- •Output redirection 638
- •override 382
- •Override variables in model solution 382
- •Page
- •resize 399
- •Panel
- •Panel data
- •Percent change
- •Poisson
- •Pool 171
- •declare 408
- •delete identifiers 272
- •pool 408
- •portrait 8
- •probit 410
- •create 83
- •open 84
- •P-value functions 587
- •QQ-plot
- •Quantile function 579
- •Random effects
- •Random number
- •Read
- •Recode values 576
- •Regressors
- •Rename
- •Resample
- •Residuals
- •Results
- •return 639
- •height 50
- •Run program
- •multiple files 108
- •Sample
- •set current 474
- •Save
- •with kernel fit 329
- •scenario 438
- •seas 440
- •Second moment matrix 619
- •declare 442
- •formula 306
- •show 470
- •Signal variables
- •Singular matrix
- •test for 620
- •Smoothing
- •Solve
- •linear system 626
- •sort 478
- •Sspace
- •declare 482
- •procs 180
- •State space
- •State variables
- •display graphs of 484
- •Static forecast 297
- •insert string into 600
- •relational comparison 121
- •String variable 89
- •in for loop 104
- •return from 109, 639
- •Symmetric matrix
- •declare 497
- •Table 187
- •text color 54
- •Test
- •Chow 241
- •for ARCH 210
- •mean, median, variance equality 501
- •mean, median, variance equality by classification 502
- •Text file
- •Then 642
- •Time
- •current as string 607
- •trace 512
- •Trigonometric functions 583
- •Uniform distribution 587
- •Valmap 189
- •vector 529
- •Verbose mode 85
- •append contents of workfile page to current page 383
- •close 12
- •contract page 385
- •create 260
- •end date of observation interval 590
- •open existing 12, 532
- •period indicators 591
- •save 12, 540
- •stack page 396
- •Write
- •wtsls 547
- •xypair 561
Appendix D. Operator and Function Reference
The reference material in this section describes basic operators and functions that may be used with series and (in some cases) matrix objects. A general description of the use of these operators and functions may be found in Chapter 6, “Working with Data”, beginning on page 127 of the User’s Guide.
This material is divided into several topics:
•Operators.
•Basic mathematical functions.
•Time series functions.
•Descriptive statistics.
•By-group statistics.
•Additional and special functions.
•Trigonometric functions.
•Statistical distribution functions.
•String functions.
•Date functions.
•Workfile functions.
•Value map functions.
•Matrix functions.
Documentation on libraries of more specialized functions is provided elsewhere:
•For a description of functions related to string and date manipulation, see “String Function Summary” on page 129 and “Date Function Summary” on page 152.
•For details on workfile functions that provide information about each observation of a workfile based on information contained in the structure of the workfile, see Appendix E, “Workfile Functions”, on page 589.
•Functions for working with value maps are documented in “Valmap Functions” on page 171 of the User’s Guide.
574—Appendix D. Operator and Function Reference
•For a list of functions specific to matrices, see “Matrix Function and Command Summary” on page 44.
Operators
All of the operators described below may be used in expressions involving series and scalar values. When applied to a series expression, the operation is performed for each observation in the current sample. The precedence of evaluation is listed in “Operators” on page 127 of the User’s Guide. Note that you can enforce order-of-evaluation using parentheses.
.
Expression |
Operator |
Description |
|
|
|
+ |
add |
x+y adds the contents of X and Y. |
|
|
|
– |
subtract |
x–y subtracts the contents of Y from X. |
|
|
|
* |
multiply |
x*y multiplies the contents of X by Y. |
|
|
|
/ |
divide |
x/y divides the contents of X by Y. |
|
|
|
^ |
raise to the power |
x^y raises X to the power of Y. |
|
|
|
>greater than x>y takes the value 1 if X exceeds Y, and 0 other-
|
|
wise. |
|
|
|
< |
less than |
x<y takes the value 1 if Y exceeds X, and 0 oth- |
|
|
erwise. |
|
|
|
= |
equal to |
x=y takes the value 1 if X and Y are equal, and 0 |
|
|
otherwise. |
|
|
|
<> |
not equal to |
x<>y takes the value 1 if X and Y are not equal, |
|
|
and 0 if they are equal. |
|
|
|
<= |
less than or equal |
x<=y takes the value 1 if X does not exceed Y, |
|
to |
and 0 otherwise. |
|
|
|
>= |
greater than or |
x>=y takes the value 1 if Y does not exceed X, |
|
equal to |
and 0 otherwise. |
|
|
|
and |
logical and |
x and y takes the value 1 if both X and Y are |
|
|
nonzero, and 0 otherwise. |
|
|
|
or |
logical or |
x or y takes the value 1 if either X or Y is non- |
|
|
zero, and 0 otherwise. |
|
|
|
In addition, EViews provides special functions to perform comparisons using special rules for handling missing values (see “Missing Values” on page 132) :
Basic Mathematical Functions—575
@eqna(x,y) |
equal to |
takes the value 1 if X and Y are equal, and |
|
|
0 otherwise. NAs are treated as ordinary |
|
|
values for purposes of comparison. |
|
|
|
@isna(x) |
equal to NA |
takes the value 1 if X is equal to NA and 0 |
|
|
otherwise. |
|
|
|
@neqna(x,y) |
not equal to |
takes the value 1 if X and Y are not equal, |
|
|
and 0 if they are equal. NAs are treated as |
|
|
ordinary values for purposes of compari- |
|
|
son. |
|
|
|
Basic Mathematical Functions
These functions perform basic mathematical operations. When applied to a series, they return a value for every observation in the current sample. When applied to a matrix object, they return a value for every element of the matrix object. The functions will return NA values for observations where the input values are NAs, or where the input values are not valid. For example, the square-root function @sqrt, will return NAs for all observations less than zero.
Name |
Function |
Examples/Description |
|
|
|
@abs(x), abs(x) |
absolute value |
@abs(−3) = 3 . |
@ceiling(x) |
smallest integer not less |
@ceiling(2.34) = 3 ; |
|
than |
@ceiling(4) = 4 . |
|
|
|
@exp(x), exp(x) |
exponential, ex |
@exp(1) ≈ 2.71813 . |
@fact(x) |
factorial, x! |
@fact(3) = 6 ; @fact(0) = 1 . |
|
|
|
@factlog(x) |
natural logarithm of the fac- |
@factlog(3) = 1.7918 ; |
|
torial, loge( x!) |
@factlog(0) = 0 . |
@floor(x) |
largest integer not greater |
@floor(1.23) = 1 ; |
|
than |
@floor(−3.1) = −4 . |
|
|
|
@inv(x) |
reciprocal, 1 ⁄ x |
@inv(2) = 0.5 . |
@mod(x,y) |
floating point remainder |
returns the remainder of x ⁄ y with |
|
|
the same sign as x . If y = 0 the |
|
|
result is 0. |
|
|
|
@log(x), log(x) |
natural logarithm, loge( x) |
@log ( 2) ≈ 0.693 ; |
|
|
log ( 2.71813) ≈ 1 . |
@log10(x) |
base-10 logarithm, |
@log10(100) = 2 . |
|
log10( x) |
|
576—Appendix D. Operator and Function Reference
@logx(x,b) |
base-b logarithm, logb( x) |
@log(256, 2) = 8 . |
@nan(x,y) |
recode NAs in X to Y |
returns x if x<>NA , and y if |
|
|
x = NA . |
|
|
|
@recode(s,x,y) |
recode by condition |
returns x if condition s is true; oth- |
|
|
erwise returns y . |
|
|
|
@round(x) |
round to the nearest integer |
@round(-97.5) = −98 ; |
|
|
@round(3.5) = 4 . |
|
|
|
@sqrt(x), sqr(x) |
square root |
@sqrt(9) = 3 . |
|
|
|
Time Series Functions
The following functions facilitate working with time series data. Note that NAs will be returned for observations for which lagged values are not available. For example, d(x) returns a missing value for the first observation in the workfile, since the lagged value is not available.
Name |
Function |
Description |
|
|
|
|
|
|
|
d(x) |
first difference |
( 1 − L )X = X − X ( −1 ) |
|
|
|
|
where L is the lag operator. |
|
|
|
|
|
|
|
d(x,n) |
n-th order difference |
( 1 |
− L )nX . |
|
|
|
|
|
|
d(x,n,s) |
n-th order difference with a |
( 1 |
− L )n( 1 − Ls) X . |
|
|
seasonal difference at s |
|
|
|
dlog(x) |
first difference of the logarithm |
( 1 − L) log ( X ) |
. |
|
|
|
= log ( X) − log ( X( −1) ) |
|
|
|
|
|
|
|
dlog(x,n) |
n-th order difference of the log- |
( 1 |
− L )nlog ( X) . |
|
|
arithm |
|
|
|
dlog(x,n,s) |
n-th order difference of the log- |
( 1 |
− L )n( 1 − Ls) log ( X) . |
|
|
arithm with a seasonal differ- |
|
|
|
|
ence at s |
|
|
|
|
|
|
|
|
@movav(x,n) |
n-period backward moving |
@movav(x, 3) |
|
|
|
average |
= ( X + X ( −1 ) + X( −2 ) ) |
|
|
|
|
⁄ 3 |
|
|
@movsum(x,n) |
n-period backward moving |
@movsum(x,3) |
|
|
|
sum |
= ( X + X ( −1 ) + X( −2 ) ) |
|
|
|
|
|
|
|
