| 1 | {{{ |
| 2 | #!comment |
| 3 | <LEFT-MENU> |
| 4 | }}} |
| 5 | {{{ |
| 6 | #!div style="width:15%; float:left; clear:none; margin-right:1em; background:#ffb; border:1px solid #b00; padding-left:1em; padding-right:1em" |
| 7 | [wiki:WikiStart Home] [[BR]] [[BR]] |
| 8 | '''Software''' [[BR]] [wiki:Download Download] [[BR]] [wiki:Installation Installation] [[BR]] [wiki:Documentation Documentation] [[BR]] [wiki:Packages Packages] [[BR]] [[BR]] |
| 9 | '''TOL Project''' [[BR]] [wiki:TolDevelopment Development] [[BR]] [wiki:TolPeople Contributors] [[BR]] [[BR]] |
| 10 | '''Others''' [[BR]] [wiki:Rprojects R-Projects] [[BR]] [https://mmm.tol-project.org MMS] [[BR]] [wiki:TolGrid TOLGrid] |
| 11 | }}} |
| 12 | {{{ |
| 13 | #!div style="margin-left:20%; margin-right:0%; padding-left:2em; padding-right:2em" |
| 14 | {{{ |
| 15 | #!comment |
| 16 | </LEFT-MENU> |
| 17 | }}} |
| 18 | |
| 19 | = R Projects = |
| 20 | |
| 21 | A set of R-packages are developed to use TOL from the R framework. |
| 22 | |
| 23 | Download and installation details are shown below: [#Installation] |
| 24 | |
| 25 | == R-Packages == |
| 26 | |
| 27 | Currently there are three R-packages: |
| 28 | |
| 29 | * {{{tolBasis}}}: Contains the basis of TOL in R. |
| 30 | * {{{tolRlink}}}: Links to TOL kernel via {{{tolRlink.dll}}} (or {{{tolRlink.so}}}). |
| 31 | * {{{tolKit}}}: Kit of TOL utilities with an R-API. |
| 32 | |
| 33 | === tolBasis === |
| 34 | |
| 35 | {{{tolBasis}}} is the main package for using TOL from R. It is the basis on which TOL in R developments are supported. |
| 36 | |
| 37 | There is not necessary a TOL software installation to be used. |
| 38 | |
| 39 | It imports the fundamental definitions and utilities of the Time Oriented Language (TOL) such as: datings, time series, lag polynomials, etc. |
| 40 | |
| 41 | For more information see: [wiki:tolBasis]. |
| 42 | |
| 43 | === tolRlink === |
| 44 | |
| 45 | {{{tolRlink}}} is the package responsible for connecting to the TOL kernel. This package links to TOL via the library {{{tolRlink.dll}}} (or {{{tolRlink.so}}}). |
| 46 | |
| 47 | Therefore it requires an installation of TOL compatible (release 3.3 or posterior). |
| 48 | |
| 49 | It contains methods for load and initialize TOL, evaluate TOL code, obtain TOL objects, send R objects to TOL, etc. |
| 50 | |
| 51 | For more information see: [wiki:tolRLink]. |
| 52 | |
| 53 | === tolKit === |
| 54 | |
| 55 | {{{tolKit}}} is a package with some TOL utilities adapted to be used in R as usual. |
| 56 | |
| 57 | This package needs to the previous packages: {{{tolBasis}}} and {{{tolRlink}}}. |
| 58 | |
| 59 | Current version imports TOL funcionts: {{{Estimate}}} and {{{CalcForecasting}}}. |
| 60 | |
| 61 | For more information see: [wiki:tolKit]. |
| 62 | |
| 63 | |
| 64 | == Installation == |
| 65 | |
| 66 | There are different ways to install these developments: |
| 67 | * install the compiled packages (zip files for Windows) |
| 68 | * download the source (tar.gz file) and compile it. |
| 69 | |
| 70 | The package {{{tolBasis}}} is already available at CRAN: [https://cran.r-project.org/web/packages/tolBasis/index.html tolBasis] and can be installed as usual: |
| 71 | {{{ |
| 72 | #!ruby |
| 73 | install.packages("tolBasis") |
| 74 | }}} |
| 75 | |
| 76 | === Dependencies === |
| 77 | |
| 78 | The R-packages depend on other R-packages: |
| 79 | |
| 80 | * {{{tolBasis}}} depends on: {{{lubridate}}} and {{{polynom}}}: |
| 81 | {{{ |
| 82 | #!ruby |
| 83 | install.packages("lubridate") |
| 84 | install.packages("polynom") |
| 85 | }}} |
| 86 | |
| 87 | * {{{tolRlink}}} needs {{{tolBasis}}} and also depends on: {{{base64enc}}}: |
| 88 | {{{ |
| 89 | #!ruby |
| 90 | install.packages("base64enc") |
| 91 | }}} |
| 92 | |
| 93 | * {{{tolKit}}} only depends on: {{{tolLink}}} |
| 94 | |
| 95 | === Installation from ZIP files (Windows) === |
| 96 | |
| 97 | --La mejor manera actualmente de instalar los paquetes en Windows es descargar los paquetes ya compilados e instalarlos en R. |
| 98 | |
| 99 | --Los paquetes en formato ZIP (con los binarios para Windows) se pueden descargar desde: |
| 100 | * [export:tolp/Rprojects/tolBasis_1.0.zip tolBasis_1.0.zip] |
| 101 | * [export:tolp/Rprojects/tolLink_1.0.zip tolLink_1.0.zip] |
| 102 | * [export:tolp/Rprojects/tolKit_1.0.zip tolKit_1.0.zip] |
| 103 | |
| 104 | --Para instalar los archivos ZIP podemos usar la opción {{{"Instalar paquete(s) a partir de archivos zip locales..."}}} del menú {{{"Paquetes"}}}. |
| 105 | |
| 106 | |
| 107 | === Installation from source === |
| 108 | |
| 109 | |
| 110 | --Para descargar el código utilizamos SVN: |
| 111 | |
| 112 | {{{ |
| 113 | svn co https://www.tol-project.org/svn/tolp/Rprojects c:/users/<user>/svn/tolp/Rprojects |
| 114 | }}} |
| 115 | |
| 116 | --Cámbiese la ruta de destino por la que considere. |
| 117 | |
| 118 | --Para instalar los paquetes desde el código, estableceremos el directorio de trabajo con la ruta donde descargamos los paquetes |
| 119 | y los instalaremos como sigue: |
| 120 | |
| 121 | {{{ |
| 122 | #!ruby |
| 123 | setwd("c:/users/<user>/svn/tolp/Rprojects") |
| 124 | # Cambiese la ruta adecuadamente |
| 125 | install.packages("tolBasis", repos=NULL, type="source") |
| 126 | install.packages("tolLink", repos=NULL, type="source") |
| 127 | install.packages("tolKit", repos=NULL, type="source") |
| 128 | }}} |
| 129 | |
| 130 | --Nótese que para compilar {{{tolLink}}} necesitamos una instalación válida (acorde a nuestro sistema) de TOL-GNU. |
| 131 | |
| 132 | --En la instalación de TOL-GNU asegúrese también de instalar las librerías y las cabeceras para C/C++. |
| 133 | Éstas se buscarán en el directorio de instalación según la ruta especificada en la variable de entorno: {{{TOLGNU_ROOT}}}. |
| 134 | Véase el archivo: {{{tolLink/src/Makevars}}} |
| 135 | |