Interface to the 'JWSACruncher' of 'JDemetra+'

'JDemetra+' (< https://github.com/jdemetra/jdemetra-app>) is the seasonal adjustment software officially recommended to the members of the European Statistical System and the European System of Central Banks. Seasonal adjustment models performed with 'JDemetra+' can be stored into workspaces. 'JWSACruncher' (< https://github.com/jdemetra/jwsacruncher/releases> for v2 and < https://github.com/jdemetra/jdplus-main/releases> for v3) is a console tool that re-estimates all the multi-processing defined in a workspace and to export the result. 'rjwsacruncher' allows to launch easily the 'JWSACruncher'.

rjwsacruncher

The goal of rjwsacruncher is to launch quickly and easily the JWSACruncher of JDemetra+. The JWSACruncher is a console tool that allows to update a JDemetra+ workspace and to export the results without having to open JDemetra+. More details on the JWSACruncher can be found on https://github.com/jdemetra/jwsacruncher/wiki.

Installation

# Install release version from CRAN
install.packages("rjwsacruncher")

# Install development version:
install.packages("rjwsacruncher", repos = c("https://aqlt.r-universe.dev", "https://cloud.r-project.org"))
# Or :
# install.packages("devtools")
# devtools::install_github("AQLT/rjwsacruncher")

The JWSACruncher is not included in the package. It can be downloaded from GitHub (https://github.com/jdemetra/jwsacruncher/releases or https://github.com/jdemetra/jdplus-main/releases) or with the function download_cruncher():

library(rjwsacruncher)
# Directory where to save the JWSACruncher:
directory <- tempdir()
download_cruncher(directory)

Since the version 2.2.0, the JWSACruncher needs Java 8 or higher to run. If you cannot install it (for example for security reasons) you can install a portable version of ‘Java’ (that does not require administrator rights) and configure the JWSACruncher to use this portable version with the function configure_jwsacruncher().

Usage

The JWSACruncher can be easily runned with the function cruncher_and_param(). To use it, the path to the “Bin” folder of the JWSACruncher has to be defined. For example, if the JWSACruncher is under D:/jdemetra-cli-2.2.3/:

options(cruncher_bin_directory = "D:/jdemetra-cli-2.2.3/bin/")

The export items can be changed with the function “default_matrix_item” and “default_tsmatrix_series”:

# To get the default values:
head(getOption("default_matrix_item"))
#> [1] "period"       "span.start"   "span.end"     "span.n"       "span.missing"
#> [6] "espan.start"
getOption("default_tsmatrix_series")
#> [1] "y"    "t"    "sa"   "s"    "i"    "ycal"
# To only export the seasonally adjusted series and its forecasts:
options(default_tsmatrix_series = c("sa", "sa_f"))

The run the JWSACruncher on the workspace D:/workspace.xml with the refresh policy “lastoutliers”:

cruncher_and_param(workspace = "D:/workspace.xml",
                   policy = "lastoutliers")