JDemetra+ documentation

Published

October 18, 2024

What is JDemetra+?

JDemetra+ is an open source software for seasonal adjustment and time series analysis, developed in the framework of Eurostat’s “Centre of Excellence on Statistical Methods and Tools” by the National Bank of Belgium with the support of the Bundesbank and Insee. It has been officially recommended by Eurostat to the members of the European Statistical System since 2015. It is unique in its combination of very fast Java routines, a Graphical User Interface and an ecosystem of R packages (rjdverse). The graphical interface provides structured visual feedback suitable for refined analysis and training. R tools allow the user to combine the capabilities of JDemetra+ with the versatility of the R world, be it for mathematical functions or data wrangling. A pdf version of this documentation is available here

Main Features

JDemetra+ provides algorithms for:

  • Seasonal Adjustment

  • Trend estimation

  • Benchmarking and temporal disaggregation

  • Nowcasting

  • Revision analysis

Currently available versions

The highest version currently recommended for production purposes is 2.2.4.

Version 3.x family provides, among other things, extended features for seasonal adjustment and trend estimation, including high frequency data. The latest version 3.2.4 was released on July 11th 2024.

Background

This website is under construction, in the meantime you can fill a large number of the gaps by referring to the previous version of the on-line documentation, coordinated by Sylwia Grudkowska-Kubik (National Bank of Poland).

Eurostat’s recommendations on the statistical processes described in this documentation are outlined in:

Key methodological explanations and state-of-the-art description and references can be found in:

How to contribute

If you want to help us improve this book, you can fork this repository on GitHub and create pull requests with your contributions.

Installing the software

The sections below detail how to install JDemetra+ (Graphical user interface and Cruncher) and how to configure R to run rjd3 packages.

Graphical User Interface (GUI)

You can find the latest releases

  • in the v2.x family: here

As of April 2024, the latest version is v2.2.4

Scroll down the page, download and unzip the file jdemetra-2.2.4-bin.zip.

To start the application, run the file nbdemetra64.exe located in the following subfolder …\jdemetra-2.2.4-bin\nbdemetra\bin

Remark: You can create shortcuts to the executable files if you want to launch them from another folder (Desktop, project folder…).

  • in the v3.x family: here

You should install the latest release available denoted from now on v3.x.y

Scroll down the page, download and unzip the file jdemetra-standalone-3.x.y-windows-x86_64.zip, if you use Windows, or the zip corresponding to you OS in the list.

To start the application, run the file nbdemetra64.exe located in the following subfolder …\jdemetra-standalone-3.x.y-windows-x86_64\nbdemetra\bin

Version 3.x requires Java 17 or higher, jdemetra-standalone-3.x.y-windows-x86_64.zip contains a portable version of Java 21, so you don’t have to deal with this issue on your computer.

R packages related to version 3.x (rjd3…) also require Java 17 or higher, you can (and should) use the portable version provided with the graphical user interface to run them, this is explained here.

Additional plugins

To benefit from extended features of the graphical user interface installing additional plug-ins is required. The list of available extensions and the installation procedure are detailed here. How to access the added features in the GUI is described here.

In the v2.x family some of the additional features are:

In the v3.x family some of the additional features are:

  • Benchmarking and Temporal disaggregation Github page

  • Seasonal adjustment of high frequency data Github page

  • Additional algorithms for seasonal adjustment Github page

Cruncher

JDemetra+ has an executable module, called the Cruncher, allowing to automate tasks

To install it :

  • in v2, go to the JWSACruncher page, download and unzip the compressed folder jwsacruncher-2.2.4-bin.zip.

  • in v3, go to the jdplus-main page, download and unzip the compressed folder jwsacruncher-standalone-3.x.y-windows-x86_64.zip.

R packages

JDemetra+ algorithms can be accessed in R, which is detailed here

You can directly head over to this GitHub page, then for each package indications for installation and basic use are provided in the readme files.

Configuration needed to run rjd3 packages

To use rjd3 packages in R, you need Java 17 or higher.

You can (and should) use the version of Java that comes with the Graphical User Interface (GUI). It is contained in the file jdemetra-standalone-3.2.4-windows-x86_64.zip available on this page, in the “Assets” section, which you might have to expand to be able to see all the files.

Once unzipped, the Java will be in located in C:\Software\jdemetra-standalone-3.x.y-windows-x86_64\nbdemetra\jdk-21.0.2+13-jre (path to be adapted to your computer/server): this location must be declared in R.

After unzipping the file:

  • run this code at the beginning of your programs
Sys.setenv("JAVA_HOME" = ".../jdemetra-standalone-3.x.y-windows-x86_64/nbdemetra/jdk-21.0.2+13-jre")

or

  • declare it “permanently” is the Renviron file (where environment variables specific to R are stored), following the steps below:

    • in the R console run file.edit("~/.Renviron")

    • in the file that opens add the line :

    JAVA_HOME= "C:/Software/jdemetra-standalone-3.x.y-windows-x86_64/nbdemetra/jdk-21.0.2+13-jre"
    • save the file and restart R

Follow R packages installation procedure and run basic examples from the readme files of each package. They are all listed on this page