= R Projects =

Esta página trata sobre el conjunto de paquetes de R creados para utilizar TOL desde R. Véase #1842.

Los detalles sobre la descarga e instalación de estos paquetes se encuentra más abajo: [#Instalación].

== Paquetes ==

Actualmente se han desarrollado tres paquetes:
 * {{{tolBasis}}}: Cimientos de TOL en R.
 * {{{tolRlink}}}: Enlace con el núcleo de TOL vía la librería {{{tolRlink.dll}}} (o {{{tolRlink.so}}}).
 * {{{tolKit}}}: Kit de utilidades básicas de TOL.

=== tolBasis ===

{{{tolBasis}}} es el paquete fundamental para la incorporación de TOL en R. 
Son los cimientos sobre los que se apoyan los desarrollos de TOL en R.

No necesita de una instalación de TOL para ser usado. 

Incorpora los conceptos TOL a R: fechados, series temporales, polinomios de retardos, etc.

Más información en: [wiki:tolBasis].

=== tolRlink ===

{{{tolRlink}}} es el paquete encargado de conectar con el núcleo de TOL. El enlace lo hace a través de la librería {{{tolRlink.dll}}} (o {{{tolRlink.so}}}).

Necesita por tanto de una instalación de TOL compatible con R (TOL-GNU). 

Dispone de métodos para cargar y descargar la dll, iniciar y cerrar la sesión TOL, compilar código en el núcleo de TOL, obtener en R objetos de TOL, trasladar objetos de R hacia TOL, etc.

Más información en: [wiki:tolRlink].

=== tolKit ===

{{{tolKit}}} es un paquete con utilidades básicas de TOL adaptadas a su uso en R.

Este paquete hace uso de los paquetes elementales {{{tolBasis}}} y {{{tolRlink}}}.

Incorpora las funciones {{{Estimate}}} y {{{CalcForecasting}}}.

Más información en: [wiki:tolKit].


== Instalación ==

Para instalar los paquetes en R, disponemos de dos opciones:
 * instalar los paquetes ya compilados (binarios), o
 * descargar el código de los paquetes y compilarlos nosotros mismos, si no están disponibles para nuestro sistema.

=== Dependencias ===

Los paquetes de TOL para R dependen a su vez de otros paquetes de R:

 * {{{tolBasis}}} depende de: {{{lubridate}}} y {{{polynom}}}:
{{{
#!ruby
install.packages("lubridate")
install.packages("polynom")
}}}

 * {{{tolRlink}}} además de necesitar {{{tolBasis}}}, depende de: {{{Rcpp}}} y {{{RCurl}}}:
{{{
#!ruby
install.packages("Rcpp")
install.packages("RCurl")
}}}

 * {{{tolKit}}} sólo depende de: {{{tolRlink}}}


=== Instalación desde los binarios (Windows) ===

La mejor manera actualmente de instalar los paquetes en Windows es descargar los paquetes ya compilados e instalarlos en R.

Los paquetes en formato ZIP (con los binarios para Windows) se pueden descargar desde:
 * [export:tolp/Rprojects/tolBasis_1.1.zip tolBasis_1.1.zip]
 * [export:tolp/Rprojects/tolRlink_1.1.zip tolRlink_1.1.zip]
 * [export:tolp/Rprojects/tolKit_1.2.zip tolKit_1.2.zip]

Para instalar los archivos ZIP podemos usar la opción {{{"Instalar paquete(s) a partir de archivos zip locales..."}}} del menú {{{"Paquetes"}}}.

=== Instalación desde el código ===

Para descargar el código utilizamos SVN:

{{{
svn co https://www.tol-project.org/svn/tolp/Rprojects c:/users/<user>/svn/tolp/Rprojects
}}}

Cámbiese la ruta de destino por la que considere.

Para instalar los paquetes desde el código, estableceremos el directorio de trabajo con la ruta donde descargamos los paquetes
y los instalaremos como sigue:

{{{
#!ruby
setwd("c:/users/<user>/svn/tolp/Rprojects")
# Cambiese la ruta adecuadamente
install.packages("tolBasis", repos=NULL, type="source")
install.packages("tolRlink", repos=NULL, type="source")
install.packages("tolKit", repos=NULL, type="source")
}}}

Nótese que para compilar {{{tolRlink}}} necesitamos una instalación válida (acorde a nuestro sistema) de TOL-GNU.

En la instalación de TOL-GNU asegúrese también de instalar las librerías y las cabeceras para C/C++. 
Éstas se buscarán en el directorio de instalación según la ruta especificada en la variable de entorno: {{{TOLGNU_ROOT}}}. 
Véase el archivo: {{{tolRlink/src/Makevars}}}