Enables users to handle the dataset cleaning for conducting specific analyses with the log files from two international educational assessments: the Programme for International Student Assessment (PISA, < http://www.oecd.org/pisa/>) and the Programme for the International Assessment of Adult Competencies (PIAAC, < http://www.oecd.org/skills/piaac/>). An illustration of the analyses can be found on the LOGAN Shiny app (< https://loganpackage.shinyapps.io/shiny/>) on your browser.
An R package for log file analysis. It can be used as a standalone R package or as a backend for the accompanying Shiny application.
In the spirit of the open science movement, LOGAN is free and open source software, licensed under the GNU General Public License v3.0. Contributions to the package are welcome, and we recommend you contact the package creator if you're interested in it. Please read our style and git guidelines if you intend to contribute with code; the document is available in the package's
In order to use LOGAN, you can install it directly in R. An illustration of the analyses can be found on the Shiny app on your browser.
The latest official, stable version of LOGAN is available on CRAN and can be installed like any other R package, i.e., by issuing the following in your R prompt:
LOGAN's GitHub repository is the central hub for development of the package. Previous and test versions of LOGAN can be built from there, but they are to be considered unstable and are not guaranteed to work properly. The development team has several coding standards in place to avoid issues at any branch, especially the master one, but unless you know what you are doing, we recommend you stick with the CRAN version of our package.
To install LOGAN from GitHub, first make sure you have an up-to-date version of the
devtools package installed in your machine. Then, run the following command in you R terminal:
Alternatively, package releases can be downloaded as compressed files from https://github.com/derecost/LOGAN/releases. These files can be installed in R using the
install.packages() command with the downloaded file path as argument.
LOGAN is currently under active development, so it is always a good idea to check which version you have just installed. To do so, run
packageVersion("LOGAN") in R.
After installing LOGAN, either through CRAN or GitHub, the package can be used after issuing
library(LOGAN) in R.
LOGAN is organized in modules, so each function must be called as a subset of
their modules, e.g.
m0$CleanActions() instead of
calls to function documentation and examples must be made directly, e.g.
Bugs should be reported by creating a new issue on https://github.com/derecost/LOGAN/issues. Please send feature requests by e-mail to the package maintainer. If you would rather implement those changes yourself, please issue a pull request when you are ready to have us review your contribution.