seasonal (version 1.2.0)

seasonal-package: seasonal: R interface to X-13ARIMA-SEATS

Description

seasonal is an easy-to-use and (almost) full-featured R-interface to X-13ARIMA-SEATS, the newest seasonal adjustment software developed by the United States Census Bureau. X-13ARIMA-SEATS combines and extends the capabilities of the older X-12ARIMA (developed by the Census Bureau) and TRAMO-SEATS (developed by the Bank of Spain). The best way to start is to have a look at the vignette: vignette("seas")

Installation

Seasonal depends on the x13binary package, which downloads and installs the X-13 binaries. To install both packages, simply type to the R console:

install.packages("seasonal")

A startup message is given if the path to X-13 is specified manually. To surpress the message, use suppressPackageStartupMessages.

Setting the X-13 path manually

Sometimes, you either cannot or don't want to rely on the binaries provided by x13binary:

• because you are on an unsupported system, like Solaris.
• because you cannot run executable files in your R library folders, due to corporate IT policy.
• because you are using your own Fortran compilation of X-13ARIMA-SEATS.

Setting the path manually can be done as in previous versions of seasonal. In order to tell seasonal where to find the binary executables of X-13ARIMA- SEATS, the specific environmental variable X13_PATH needs to be set. This may be done during your active session in R:

Sys.setenv(X13_PATH = "YOUR_X13_DIRECTORY")

Exchange YOUR_X13_DIRECTORY with the path to your installation of X-13ARIMA- SEATS. You can always check your installation with:

checkX13()

If it works, you may want to set the environmental variable permanently, by adding the Sys.setenv line to one of your .Rprofile files. The easiest is to use the one located in your home directory, which can be written directly from R:

write('Sys.setenv(X13_PATH = "YOUR_X13_DIRECTORY")', file = "~/.Rprofile", append = TRUE)

If the file does not exist (by default), it will be created. Make sure that you get the quotes right: double quotes around your directory, single quotes around the whole Sys.setenv line, such that R understands your string. Check first that the the Sys.setenv line works correctly; once it is written you may have to edit .Rprofile manually. (Or add a second, overwriting line to it.) For other ways to set an environmental variable permanently in R, see Startup.

See Also

seas for the core function and more information on package usage.