- •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
boxplotby—225
ci=arg |
95% confidence interval for median: “none” (do not |
(default= |
display), “shade” (display interval as shaded area), |
“shade”) |
“notch” (display interval using notched boxes). |
Options to control calculation of boxplots
b |
Balance sample. |
|
|
q=arg |
Compute quantiles using the specified definition: “b” |
(default=“r”) |
(Blom), “r” (Rankit-Cleveland), “o” (simple fraction), |
|
“t” (Tukey), “v” (van der Waerden). |
Other options
p Print the view.
Examples
grp1.boxplot
displays default boxplots for all of the series in the group GRP1.
grp2.boxplot(b, nowhisk)
displays boxplots for the series in GRP2 after balancing the sample. The boxplots will not have whiskers drawn.
Cross-references
See “Boxplots” on page 407 of the User’s Guide for additional discussion.
See also boxplotby (p. 225) and stats (p. 487). For customization of a boxplot graph object, see setelem (p. 449) and setbpelem (p. 445).
boxplotby |
Series View |
|
|
Display the boxplots of a series classified into categories.
Create a boxplot graph view containing boxplots of the elements of a series classified into categories by one or more series.
Syntax
Series View: |
series_name.boxplotby(options) classifier_names |
Follow the series name with a period, the keyword, and a name (or a list of names) for the series or groups by which to classify. The default settings are to display fixed width box-
226—Appendix B. Command Reference
plots for each category, with all basic elements drawn (mean, med, staples, whiskers, near outliers, far outliers), and with shading representing the approximate confidence intervals for the median.
Options
Options to control display
nomean |
Do not display means. |
|
|
nomed |
Do not display medians. |
|
|
nostaple |
Do not display staples. |
|
|
nowhisk |
Do not display whiskers. |
|
|
nonearout |
Do not display near outliers. |
|
|
nofarout |
Do not display far outliers. |
|
|
nolabel |
Do not display axis labels. |
|
|
width=arg |
Boxplot width: “fixed” (fixed width boxplots), “n” |
(default= |
(width proportional to number of observations), |
“fixed”) |
“rootn” (width proportional to square root of number of |
|
observations). |
|
|
ci=arg |
95% confidence interval for median: “none” (do not |
(default= |
display), “shade” (display interval as shaded area), |
“shade”) |
“notch” (display interval using notched boxes). |
|
|
Options to control calculation of boxplots
dropna (default), |
[Drop/Keep] NA as a category. |
keepna |
|
|
|
total |
Create category for entire series. |
|
|
q=arg |
Compute quantiles using the specified definition: “b” |
(default=“r”) |
(Blom), “r” (Rankit-Cleveland), “o” (simple fraction), |
|
“t” (Tukey), “v” (van der Waerden). |
|
|
Options to control binning
v=integer |
Bin categories if classification series take on more than |
(default=100) |
the specified number of distinct values. |
|
|
nov |
Do not bin based on the number of values of the classi- |
|
fication series. |
bpf—227
a=number |
Bin categories if average cell count is less than the spec- |
(default=2) |
ified number. |
|
|
noa |
Do not bin based on the average cell count. |
|
|
b=integer |
Set maximum number of binned categories. |
(default=5) |
|
|
|
Other options
p |
Print the view. |
|
|
Examples
wage.boxplotby sex race
displays boxplots for the series WAGE categorized by the values of SEX and RACE.
income.boxplotby(total, keepna, width=n) sex race
displays boxplots for INCOME classified by SEX and RACE, with missing values in the classifier series treated as categories, and an additional boxplot drawn for the entire sample of observations. The boxes will be drawn with variable widths proportional to the number of observations in each category.
Cross-references
See “Boxplots” on page 407 of the User’s Guide.
See also boxplot (p. 224), and statby (p. 482). For customization of a boxplot graph object, see setelem (p. 449) and setbpelem (p. 445).
bpf |
Series Proc |
|
|
Compute and display the band-pass filter of a series.
Computes, and displays a graphical view of the Baxter-King fixed length symmetric, Chris- tiano-Fitzgerald fixed length symmetric, or the Christiano-Fitzgerald full sample asymmetric band-pass filter of the series.
The view will show the original series, the cyclical component, and non-cyclical component in a single graph. For non time-varying filters, a second graph will show the frequency responses.
Syntax
Series Proc: |
series_name.bpf(options) [cyc_name] |
228—Appendix B. Command Reference
Follow the bpf keyword with any desired options, and the optional name to be given to the cyclical component. If you do not provide cyc_name, the filtered series will be named BPFILTER## where ## is a number chosen to ensure that the name is unique.
Options
type=arg
(default=“bk”)
Specify the type of band-pass filter: “bk” is the BaxterKing fixed length symmetric filter, “cffix” is the Chris- tiano-Fitzgerald fixed length symmetric filter, “cfasym” is the Christiano-Fitzgerald full sample asymmetric filter.
low=number, |
Low (PL ) and high (PH ) values for the cycle range to |
high=number |
be passed through (specified in periods of the workfile |
|
frequency). |
|
Defaults to the workfile equivalent corresponding to a |
|
range of 1.5–8 years for semi-annual to daily workfiles; |
|
otherwise sets “low=2”, “high=8”. |
|
The arguments must satisfy 2 ≤ PL < PH . The corre- |
|
sponding frequency range to be passed through will be |
|
(2π ⁄ PH, 2π ⁄ PL) . |
|
|
lag=integer |
Fixed lag length (positive integer). Sets the fixed lead/ |
|
lag length for fixed length filters (“type=bk” or |
|
“type=cffix”). Must be less than half the sample size. |
|
Defaults to the workfile equivalent of 3 years for semi- |
|
annual to daily workfiles; otherwise sets “lag=3”. |
|
|
iorder=[0,1] |
Specifies the integration order of the series. The default |
(default=0) |
value, “0” implies that the series is assumed to be |
|
(covariance) stationary; “1” implies that the series con- |
|
tains a unit root. |
|
The integration order is only used in the computation of |
|
Christiano-Fitzgerald filter weights (“type=cffix” or |
|
“type=cfasym”). When “iorder=1”, the filter weights |
|
are constrained to sum to zero. |
bpf—229
detrend=arg |
Detrending method for Christiano-Fitzgerald filters |
(default=“n”) |
(“type=cffix” or “type=cfasym”). |
|
You may select the default argument “n” for no |
|
detrending, “c” to demean, or “t” to remove a constant |
|
and linear trend. |
|
You may use the argument “d” to remove drift, if the |
|
option “iorder=1” is also specified. |
|
|
nogain |
Suppresses plotting of the frequency response (gain) |
|
function for fixed length symmetric filters (“type=bk” |
|
or “type=cffix”). By default, EViews will plot the gain |
|
function. |
|
|
noncyc=arg |
Specifies a name for a series to contain the non-cyclical |
|
series (difference between the actual and the filtered |
|
series). If no name is provided, the non-cyclical series |
|
will not be saved in the workfile. |
|
|
230—Appendix B. Command Reference
w=arg |
Store the filter weights as an object with the specified |
|
|
name. For fixed length symmetric filters (“type=bk” or |
|
|
“type=cffix”), the saved object will be a matrix of |
|
|
dimension 1 × ( q + 1 ) where q is the user-specified |
|
|
lag length order. For these filters, the weights on the |
|
|
leads and the lags are the same, so the returned matrix |
|
|
contains only the one-sided weights. The filtered series |
|
|
zt may be computed as: |
|
|
q + 1 |
q + 1 |
|
zt = Σ w( 1, c) yt + 1 − c + Σ w( 1, c) yt + c − 1 |
|
|
c = 1 |
c = 2 |
|
for t = q + 1, …, n − q . |
|
|
For time-varying filters, the weight matrix is of dimen- |
|
|
sion n × n where n is the number of non-missing |
|
|
observations in the current sample. Row r of the |
|
|
matrix contains the weighting vector used to generate |
|
|
the r -th observation of the filtered series, where col- |
|
|
umn c contains the weight on the c -th observation of |
|
|
the original series. The filtered series may be computed |
|
|
as: |
|
|
T |
|
|
zt = Σ w( r, c) yc |
r = 1, …, T |
|
c = 1 |
|
|
where yt is the original series and w( r, c) is the |
|
|
( r, c) element of the weighting matrix. By construc- |
|
|
tion, the first and last rows of the weight matrix will be |
|
|
filled with missing values for the symmetric filter. |
|
|
|
|
p |
Print the graph. |
|
|
|
|
Examples
Suppose we are working in a quarterly workfile and we issue the following command:
lgdp.bpf(type=bk,low=6,high=32) cyc0
EViews will compute the Baxter-King band-pass filter of the series LGDP. The periodicity of cycles extracted ranges from 6 to 32 quarters, and the filtered series will be saved in the workfile in CYC0. The BK filter uses the default lag of 12 (3 years of quarterly data).
Since this is a fixed length filter, EViews will display both a graph of the cyclical/original/ non-cyclical series, as well as the frequency response (gain) graph. To suppress the latter graph, we could enter a command containing the “nogain” option:
