| | 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 | |