Installer (R)JDemetra+ et le JWSACruncher

Installation de JDemetra+

Pour utiliser JDemetra+ il faut deux logiciels : JDemetra+ et Java.

Installation de JDemetra+

JDemetra+ est téléchargeable depuis le lien github de l’application : https://github.com/jdemetra/jdemetra-app/releases (et la version 3 est disponible https://github.com/jdemetra/jdplus-main/releases). Deux solutions pour l’installer : télécharger le fichier .exe qui nécessite des droits d’administrateur ou télécharger le .zip qui permet d’avoir une version portable du logiciel.
Attention : pour la seconde option ne pas télécharger le fichier Source code (zip) mais le fichier jdemetra+-2.2.2-bin.zip (pour la version 2.2.2) :
JDemetra+ téléchargement

Une fois le fichier téléchargé, il suffit de le dézipper : le logiciel se trouve alors dans le dossier \nbdemetra\bin\, ce sont les fichiers nbdemetra.exe (version 32-bit) et nbdemetra64.exe (version 64-bit).

Utilisation d’une version portable de Java

Pour utiliser la version 2.2.4 de JDemetra+ (et les packages R associés) il faut avoir la version 8 de Java (ou une version supérieure). Pour la version 3.0 de JDemetra+ (et les packages R associés) il faut avoir la version 17 de Java (ou une version supérieure) : nous utiliserons donc la version 17 de Java pour s’assurer une compatibilité avec tous les logiciels Si l’on a pas cette version d’installée et que l’on n’a pas les droits d’administrateur pour installer Java il faut alors installer une version portable de Java et lancer JDemetra+ avec cette version de java.

Pour installer une version portable de java, vous pouvez aller ici :

Pour lancer JDemetra+ avec cette nouvelle version de Java il faut :

  • créer un raccourci vers l’application
    Créer raccourci

  • faire un clique-droit sur le raccourci et ensuite cliquer sur « Propriétés ». Il reste alors à modifier la variable « Cible » en ajoutant le paramètre suivant : --jdkhome "[chemin du dossier Java17]".
    Modifier cible raccourci
    Par exemple, si JDemetra+ et Java sont installés sous D:\Programmes\, la variable Cible contiendra l’adresse D:\Programmes\nbdemetra\bin\nbdemetra64.exe --jdkhome "D:\Programmes\Java17".
    Attention : le chemin du raccourci est absolu, il doit donc être modifié à chaque fois qu’un des répertoires racines de JDemetra+ ou Java est déplacé.

Installation du JWSACruncher

Le cruncher (JWSACruncher) est un outil qui permet de mettre à jour un workspace de JDemetra+ à partir de la console, sans devoir ouvrir JDemetra+. La mise à jour d’un workspace peut alors se faire à partir d’un autre logiciel statistique (R ou SAS par exemple). La version 2.2.4 du cruncher peut être téléchargée ici https://github.com/jdemetra/jwsacruncher/releases (fichier jwsacruncher-x.y.z-bin.zip) et les anciennes versions sont téléchargeables sous https://github.com/jdemetra/jdemetra-core/releases.

Si l’on utilise une version portable de Java (voir section précédente) il faut encore modifier certains paramètres pour utiliser le cruncher :

  • dézipper le fichier téléchargé ;
  • dans le dossier dézippé, ouvrir (par exemple avec Notepad++) le fichier jwsacruncher.bat présent dans le sous-dossier \bin\ (c’est-à-dire sous jdemetra-cli-2.2.4\bin\ dans la version 2.2.4 du cruncher) ;
  • modifier la valeur de la variable JAVACMD de la ligne 71 (actuelle JAVACMD=java) par l’adresse vers le fichier java.exe de la version portable . Ainsi, si Java est installé sous D:\Programmes\, la nouvelle ligne est if "%JAVACMD%"=="" set JAVACMD="D:\Programmes\Java17\bin\java".

Le téléchargement et la configuration du cruncher peut également se faire via rjwsacruncher:

library(rjwsacruncher)
download_cruncher() # Pour télécharger le cruncher
configure_jwsacruncher() # Pour le configurer avec une version portable

Téléchargement de JDemetra+ 3.x.y

Les version 3.0.0 et plus de JDemetra+ et du JWSACruncher sont disponibles ici : https://github.com/jdemetra/jdplus-main/releases. Elles embarquent désormais une version portable de Java 17 et il n’est plus nécessaire de faire les configurations précédentes. Les nouvelles versions peuvent être utilisées sur des workspaces créés avec une version 2.x.y mais l’inverse n’est pas possible.

Configuration des packages R avec Java

Pour savoir quelle version de Java est utilisée par R, on peut utiliser le code suivant :

library(rJava)
.jinit()
.jcall("java/lang/System", "S", "getProperty", "java.runtime.version")

Pour configurer R avec une version portable de Java, trois solutions :

  1. Avant tout chargement de package nécessitant Java (rJava…) (si vous avez lancé le code précédent, relancez donc R) :
Sys.setenv(JAVA_HOME='D:/Programmes/jdk-17')

  1. Pour éviter de faire cette manipulation à chaque fois que l’on relance R, deux solutions :

    1. modifier le JAVA_HOME dans les variables d’environnement de Windows (voir https://confluence.atlassian.com/doc/setting-the-java_home-variable-in-windows-8895.html).

    2. modifier le .Renviron : depuis R lancer le code file.edit("~/.Renviron"), ajouter dans le fichier le chemin vers la version portable de Java comme précédemment (JAVA_HOME='D:/Programmes/jdk-17'), sauvegarder et relancer R.

Vous pouvez maintenant installer tous les packages nécessaires. Pour ceux qui ne sont pas sur le CRAN, il faut les installer directement depuis github :

remotes::install_github("rjdemetra/rjd3toolkit")

Si vous utilisez un ordinateur professionnel, pensez à configurer le proxy pour que ces commandes puissent fonctionner (voir https://www.book.utilitr.org/01_r_insee/fiche-personnaliser-r#le-fichier-.renviron). Pour cela vous pouvez utiliser curl::ie_get_proxy_for_url() pour récupérer l’adresse du proxy et ajouter deux variable http_proxy et https_proxy dans les variables d’environnement.