Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
TanguyBarthelemy committed Dec 21, 2023
2 parents 28e32c8 + 96c4cfe commit a4f65c3
Show file tree
Hide file tree
Showing 10 changed files with 2,148 additions and 876 deletions.
2,729 changes: 1,979 additions & 750 deletions Fiches/Fiche_1_Installation_des_outils_FR.html

Large diffs are not rendered by default.

67 changes: 35 additions & 32 deletions Fiches/Fiche_1_Installation_des_outils_FR.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,17 +47,17 @@ d’utiliser en production.**
Il existe une autre version de JDemetra+ qui en est uniquement au stade
de **test** :

- [v3.1.1](https://github.com/jdemetra/jdplus-main/releases/tag/v3.1.1)
- [v3.2.1](https://github.com/jdemetra/jdplus-main/releases/tag/v3.2.1)
: la nouvelle version de JDemetra+ avec de nouvelles fonctionnalités
et une nouvelle interface

La v2.2.4 de JDemetra+ nécessite une version de Java $\geq 8$ alors que
la v3.1.1 nécessite une version de Java $\geq 17$ :
la v3.2.1 nécessite une version de Java $\geq 17$ :

| JDemetra+ version | Java version |
|-------------------|--------------|
| v2.2.4 | $\geq 8$ |
| v3.1.1 | $\geq 17$ |
| v3.2.1 | $\geq 17$ |

Pour la suite, les processus d’installation de ces 2 versions sont les
mêmes. Il suffit de les répéter pour chaque version que l’on veut
Expand All @@ -82,9 +82,9 @@ fichiers `nbdemetra.exe` (version 32-bit) et `nbdemetra64.exe` (version
64-bit).

ℹ️ Conseil : si vous comptez utiliser plusieurs version de JDemetra+
(v2.2.4, v3.1.1, …), vous pouvez renommer les dossiers dézippés en
(v2.2.4, v3.2.1, …), vous pouvez renommer les dossiers dézippés en
${\textsf{\color{#006817}{\\\\nbdemetra-2.2.4\\\\}}}$ et
${\textsf{\color{#006817}{\\\\nbdemetra-3.1.1\\\\}}}$.
${\textsf{\color{#006817}{\\\\nbdemetra-3.2.1\\\\}}}$.

ℹ️ Remarque : Vous pouvez créer des raccourcis des exécutables si vous
souhaitez les lancer depuis le bureau ou d’autres dossiers.
Expand Down Expand Up @@ -139,30 +139,31 @@ jPortable 64-bit (en bas de la page).

ℹ️ Remarques

La version 3.1.1 de JDemetra+ contient une jdk 17 (version de java 17)
La version 3.2.1 de JDemetra+ contient une jdk 17 (version de java 17)
packetée dans le
[.zip](https://github.com/jdemetra/jdplus-main/releases/tag/v3.1.1).
[.zip](https://github.com/jdemetra/jdplus-main/releases/tag/v3.2.1).
Ainsi pour utiliser l’interface, il n’est pas nécessaire d’installer
java 17.

En revanche, pour utiliser les packages R en version 3 sans télécharger
la GUI (en version 3.1.1), il est obligatoire d’avoir java 17 et donc de
l’installer soit même.
la GUI (en version 3.2.1), il est obligatoire d’avoir java \>= 17 et
donc de l’installer soit même.

### Installation

Pour installer Java 17, il faut aller à l’adresse
<https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html>.
<https://whichjdk.com/>.

- **Télécharger** la version `Compressed Archive` de Windows
(<https://download.oracle.com/java/17/archive/jdk-17.0.4.1_windows-x64_bin.zip>)
(<https://whichjdk.com/>)
- **Dézipper** le dossier ${\textsf{\color{#006817}{jdk-17.0.6}}}$ sous
${\textsf{\color{#006817}{C:\\\\Users\\\\Software}}}$ (*par exemple*)

Après avoir installé Java (en version 8, 17 ou autre), il faut :

- **Modifier** les variables d’environnement de `PATH` de Rstudio et de
Windows (voir section [Variables d’environnement](#var_env))
Windows et `JAVA_HOME` de Rstudio (voir section [Variables
d’environnement](#var_env))

# Installation de **R** et Rstudio

Expand Down Expand Up @@ -210,13 +211,13 @@ Pour installer un package **R**, il y a plusieurs méthodes :

Les packages en version 2 sont les suivants :

| Nom | Disponible sur le CRAN | Disponible sur AUS | Lien Github |
|---------------|------------------------|--------------------|----------------------------------------------|
| RJDemetra | ✔️ | ✔️ | <https://github.com/jdemetra/rjdemetra> |
| rjdworkspace || ✔️ | <https://github.com/InseeFrLab/rjdworkspace> |
| JDCruncheR || ✔️ | <https://github.com/InseeFr/JDCruncheR> |
| rjwsacruncher | ✔️ | ✔️ | <https://github.com/AQLT/rjwsacruncher> |
| rjdmarkdown | ✔️ | ✔️ | <https://github.com/AQLT/rjdmarkdown> |
| Nom | Disponible sur le CRAN | Disponible sur AUS | Lien Github |
|------------------------------------------------|------------------------|--------------------|----------------------------------------------|
| <span class="RPackages">{RJDemetra}</span> | ✔️ | ✔️ | <https://github.com/jdemetra/rjdemetra> |
| <span class="RPackages">{rjdworkspace}</span> || ✔️ | <https://github.com/InseeFrLab/rjdworkspace> |
| <span class="RPackages">{JDCruncheR}</span> || ✔️ | <https://github.com/InseeFr/JDCruncheR> |
| <span class="RPackages">{rjwsacruncher}</span> | ✔️ | ✔️ | <https://github.com/AQLT/rjwsacruncher> |
| <span class="RPackages">{rjdmarkdown}</span> | ✔️ | ✔️ | <https://github.com/AQLT/rjdmarkdown> |

Le code d’installation des packages est ci-dessous :

Expand Down Expand Up @@ -269,8 +270,8 @@ fonction `install_github()`. Ainsi, si le package n’est pas sur le CRAN
ni sur le nexus d’AUS, il doit être téléchargé au format binaire. Pour
cela, il faut aller chercher le dossier compressé `.zip` sous GitHub.

Exemple pour le package **rjd3toolkit**, le `Source code (tar.gz)` se
trouve sous
Exemple pour le package <span class="RPackages">{rjd3toolkit}</span>, le
`Source code (tar.gz)` se trouve sous
<https://github.com/rjdemetra/rjd3toolkit/releases/tag/v3.1.0>
(*release* Section). Après l’avoir récupéré, il faut lancer la commande
d’installation :
Expand Down Expand Up @@ -534,21 +535,22 @@ Deux solutions :

## La commande `library("RJDemetra")` renvoie un message d’erreur

Le package **RJDemetra** a besoin de la version 8 (au minimum) de Java
pour fonctionner. Si au moins un autre package a déjà été chargé via la
fonction `library()` et quil ne nécessite pas une version très à jour
de Java, cest cette ancienne version qui sera sollicitée pendant toute
la durée de la session (**R** est réfractaire au changement de version
en cours de session). En cas dutilisation de **RJDemetra** au cours
dun programme, il faut donc impérativement spécifier dès le début de
Le package <span class="RPackages">{RJDemetra}</span> a besoin de la
version 8 (au minimum) de Java pour fonctionner. Si au moins un autre
package a déjà été chargé via la fonction `library()` et quil ne
nécessite pas une version très à jour de Java, cest cette ancienne
version qui sera sollicitée pendant toute la durée de la session (**R**
est réfractaire au changement de version en cours de session). En cas
dutilisation de <span class="RPackages">RJDemetra</span> au cours dun
programme, il faut donc impérativement spécifier dès le début de
programme que **R** aille chercher la version 8, via la commande :

``` r
# Là où est installé java
Sys.setenv(JAVA_HOME = "C:/Users/Software/Java17/jdk17")
```

ou charger **RJDemetra** en premier
ou charger <span class="RPackages">{RJDemetra}</span> en premier

``` r
# En début de programme
Expand All @@ -564,10 +566,11 @@ auxiliaire non trouvée. Il peut s’agir de régresseurs CJO ou d’autres
variables définies par l’utilisateur (effet de Pâques spécifique, PSO =
pure seasonal outlier…).

## La fonction `cruncher_and_param(...)` du package **JDCruncheR** renvoie un message d’erreur
## La fonction `cruncher_and_param(...)` du package <span class="RPackages">{JDCruncheR}</span> renvoie un message d’erreur

Lorsqu’on lance la fonction `cruncher_and_param(...)` du package
**JDCruncheR**, on peut obtenir l’erreur suivante :
Lorsqu’on lance la fonction `cruncher_and_param(...)` du package <span
class="RPackages">{JDCruncheR}</span>, on peut obtenir l’erreur suivante
:

## Error in eval(expr, envir, enclos): Error in cruncher(workspace = workspace, cruncher_bin_directory = cruncher_bin_directory, :
## There is an error in the path to the cruncher bin folder
Expand Down
Binary file modified Fiches/Fiche_1_Installation_des_outils_FR.pdf
Binary file not shown.
59 changes: 29 additions & 30 deletions Fiches/Fiche_1_Installation_des_outils_FR.tex
Original file line number Diff line number Diff line change
Expand Up @@ -1218,21 +1218,21 @@ \subsection{Version de JDemetra+ et
\begin{itemize}
\tightlist
\item
\href{https://github.com/jdemetra/jdplus-main/releases/tag/v3.1.1}{v3.1.1}
\href{https://github.com/jdemetra/jdplus-main/releases/tag/v3.2.1}{v3.2.1}
: la nouvelle version de JDemetra+ avec de nouvelles fonctionnalités
et une nouvelle interface
\end{itemize}

La v2.2.4 de JDemetra+ nécessite une version de Java \(\geq 8\) alors
que la v3.1.1 nécessite une version de Java \(\geq 17\) :
que la v3.2.1 nécessite une version de Java \(\geq 17\) :

\begin{longtable}[]{@{}ll@{}}
\toprule()
JDemetra+ version & Java version \\
\midrule()
\endhead
v2.2.4 & \(\geq 8\) \\
v3.1.1 & \(\geq 17\) \\
v3.2.1 & \(\geq 17\) \\
\bottomrule()
\end{longtable}

Expand Down Expand Up @@ -1266,9 +1266,9 @@ \subsection{Processus d'installation}\label{processus-dinstallation}}
\texttt{nbdemetra64.exe} (version 64-bit).

ℹ️ Conseil : si vous comptez utiliser plusieurs version de JDemetra+
(v2.2.4, v3.1.1, \ldots), vous pouvez renommer les dossiers dézippés en
(v2.2.4, v3.2.1, \ldots), vous pouvez renommer les dossiers dézippés en
\textcolor{windows_path_color}{\nolinkurl{\\nbdemetra-2.2.4\\}} et
\textcolor{windows_path_color}{\nolinkurl{\\nbdemetra-3.1.1\\}}.
\textcolor{windows_path_color}{\nolinkurl{\\nbdemetra-3.2.1\\}}.

ℹ️ Remarque : Vous pouvez créer des raccourcis des exécutables si vous
souhaitez les lancer depuis le bureau ou d'autres dossiers.
Expand Down Expand Up @@ -1337,28 +1337,27 @@ \subsection{Java 17}\label{java-17}}

ℹ️ Remarques

La version 3.1.1 de JDemetra+ contient une jdk 17 (version de java 17)
La version 3.2.1 de JDemetra+ contient une jdk 17 (version de java 17)
packetée dans le
\href{https://github.com/jdemetra/jdplus-main/releases/tag/v3.1.1}{.zip}.
\href{https://github.com/jdemetra/jdplus-main/releases/tag/v3.2.1}{.zip}.
Ainsi pour utiliser l'interface, il n'est pas nécessaire d'installer
java 17.

En revanche, pour utiliser les packages R en version 3 sans télécharger
la GUI (en version 3.1.1), il est obligatoire d'avoir java 17 et donc de
l'installer soit même.
la GUI (en version 3.2.1), il est obligatoire d'avoir java \textgreater=
17 et donc de l'installer soit même.

\hypertarget{installation}{%
\subsubsection{Installation}\label{installation}}

Pour installer Java 17, il faut aller à l'adresse
\textcolor{html_color}{\url{https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html}}.
\textcolor{html_color}{\url{https://whichjdk.com/}}.

\begin{itemize}
\tightlist
\item
\textbf{Télécharger} la version \texttt{Compressed\ Archive} de
Windows
(\textcolor{html_color}{\url{https://download.oracle.com/java/17/archive/jdk-17.0.4.1_windows-x64_bin.zip}})
Windows (\textcolor{html_color}{\url{https://whichjdk.com/}})
\item
\textbf{Dézipper} le dossier
\textcolor{windows_path_color}{\nolinkurl{jdk-17.0.6}} sous
Expand All @@ -1372,7 +1371,7 @@ \subsubsection{Installation}\label{installation}}
\tightlist
\item
\textbf{Modifier} les variables d'environnement de \texttt{PATH} de
Rstudio et de Windows (voir section
Rstudio et de Windows et \texttt{JAVA\_HOME} de Rstudio (voir section
\protect\hyperlink{var_env}{Variables d'environnement})
\end{itemize}

Expand Down Expand Up @@ -1468,15 +1467,15 @@ \subsubsection{En version 2}\label{en-version-2}}
\end{minipage} \\
\midrule()
\endhead
RJDemetra & ✔️ & ✔️ &
{\{RJDemetra\}} & ✔️ & ✔️ &
\textcolor{html_color}{\url{https://github.com/jdemetra/rjdemetra}} \\
rjdworkspace & ❌ & ✔️ &
{\{rjdworkspace\}} & ❌ & ✔️ &
\textcolor{html_color}{\url{https://github.com/InseeFrLab/rjdworkspace}} \\
JDCruncheR & ❌ & ✔️ &
{\{JDCruncheR\}} & ❌ & ✔️ &
\textcolor{html_color}{\url{https://github.com/InseeFr/JDCruncheR}} \\
rjwsacruncher & ✔️ & ✔️ &
{\{rjwsacruncher\}} & ✔️ & ✔️ &
\textcolor{html_color}{\url{https://github.com/AQLT/rjwsacruncher}} \\
rjdmarkdown & ✔️ & ✔️ &
{\{rjdmarkdown\}} & ✔️ & ✔️ &
\textcolor{html_color}{\url{https://github.com/AQLT/rjdmarkdown}} \\
\bottomrule()
\end{longtable}
Expand Down Expand Up @@ -1539,7 +1538,7 @@ \subsubsection{Cas AUS}\label{cas-aus}}
téléchargé au format binaire. Pour cela, il faut aller chercher le
dossier compressé \texttt{.zip} sous GitHub.

Exemple pour le package \textbf{rjd3toolkit}, le
Exemple pour le package {\{rjd3toolkit\}}, le
\texttt{Source\ code\ (tar.gz)} se trouve sous
\textcolor{html_color}{\url{https://github.com/rjdemetra/rjd3toolkit/releases/tag/v3.1.0}}
(\emph{release} Section). Après l'avoir récupéré, il faut lancer la
Expand Down Expand Up @@ -1924,15 +1923,15 @@ \subsection{\texorpdfstring{La commande \texttt{library("RJDemetra")}
renvoie un message
d'erreur}{La commande library("RJDemetra") renvoie un message d'erreur}}\label{la-commande-libraryrjdemetra-renvoie-un-message-derreur}}

Le package \textbf{RJDemetra} a besoin de la version 8 (au minimum) de
Java pour fonctionner. Si au moins un autre package a déjà été chargé
via la fonction \VERB|\FunctionTok{library}\NormalTok{()}| et qu'il ne
Le package {\{RJDemetra\}} a besoin de la version 8 (au minimum) de Java
pour fonctionner. Si au moins un autre package a déjà été chargé via la
fonction \VERB|\FunctionTok{library}\NormalTok{()}| et qu'il ne
nécessite pas une version très à jour de Java, c'est cette ancienne
version qui sera sollicitée pendant toute la durée de la session
(\textbf{R} est réfractaire au changement de version en cours de
session). En cas d'utilisation de \textbf{RJDemetra} au cours d'un
programme, il faut donc impérativement spécifier dès le début de
programme que \textbf{R} aille chercher la version 8, via la commande :
session). En cas d'utilisation de {RJDemetra} au cours d'un programme,
il faut donc impérativement spécifier dès le début de programme que
\textbf{R} aille chercher la version 8, via la commande :

\begin{Shaded}
\begin{Highlighting}[]
Expand All @@ -1941,7 +1940,7 @@ \subsection{\texorpdfstring{La commande \texttt{library("RJDemetra")}
\end{Highlighting}
\end{Shaded}

ou charger \textbf{RJDemetra} en premier
ou charger {\{RJDemetra\}} en premier

\begin{Shaded}
\begin{Highlighting}[]
Expand All @@ -1962,13 +1961,13 @@ \subsection{\texorpdfstring{\texttt{Error\ array\ index\ =\ -1}}{Error array ind

\hypertarget{la-fonction-cruncher_and_param...-du-package-jdcruncher-renvoie-un-message-derreur}{%
\subsection{\texorpdfstring{La fonction
\texttt{cruncher\_and\_param(...)} du package \textbf{JDCruncheR}
renvoie un message
d'erreur}{La fonction cruncher\_and\_param(...) du package JDCruncheR renvoie un message d'erreur}}\label{la-fonction-cruncher_and_param...-du-package-jdcruncher-renvoie-un-message-derreur}}
\texttt{cruncher\_and\_param(...)} du package {\{JDCruncheR\}} renvoie
un message
d'erreur}{La fonction cruncher\_and\_param(...) du package \{JDCruncheR\} renvoie un message d'erreur}}\label{la-fonction-cruncher_and_param...-du-package-jdcruncher-renvoie-un-message-derreur}}

Lorsqu'on lance la fonction
\VERB|\FunctionTok{cruncher\_and\_param}\NormalTok{(...)}| du package
\textbf{JDCruncheR}, on peut obtenir l'erreur suivante :
{\{JDCruncheR\}}, on peut obtenir l'erreur suivante :

\begin{verbatim}
## Error in eval(expr, envir, enclos): Error in cruncher(workspace = workspace, cruncher_bin_directory = cruncher_bin_directory, :
Expand Down
69 changes: 44 additions & 25 deletions Sheets/Sheet_1_Tools_installation_EN.html

Large diffs are not rendered by default.

Loading

0 comments on commit a4f65c3

Please sign in to comment.