add citation

NEWS

@@ -1,15 +1,19 @@
-OpenML v1.3 (Release date: 2017-03-09):
+OpenML v1.3 (Release date: 2017-04-01):
 ===========
   - Bugfixes
-  - listOMLRunEvaluations now returns additional columns for the flow
-  - runTask now allows to set the 'models' option to FALSE so that resulting objects will be smaller
+  - Updated citation
+  - Add html vignette and update its content.
+  - listOMLTasks and listOMLDataSets now additionally show a message when the limit of results is reached.
+  - listOML* functions return an empty data frame when no results are available.
+  - listOMLRunEvaluations now returns additional columns for the flow (flow version, flow source and learner name).
+  - runTask now allows to set the 'models' option to FALSE so that resulting objects will be smaller.
 
 OpenML v1.2 (Release date: 2017-02-07):
 ===========
   - Add support for multilabel datasets and tasks.
   - Replace download.file with httr::GET.
   - Add mlr 2.10 dependency (we internally use mlr::mergeBenchmarkResults and mlr::makePrediction now).
-  
+
 OpenML v1.1 (Release date: 2016-11-22):
 ===========
   - Setting default cache directory on package loading (fixes winbuilder).

README.md

@@ -9,6 +9,10 @@
 
 OpenML aims to create a frictionless, collaborative environment for exploring machine learning. This R package allows to interface the [OpenML](http://www.openml.org/frontend/page/home) server to download datasets, tasks, runs and upload results (see  [Tutorial](http://openml.github.io/openml-r)).
 
+# How to cite
+
+To cite the OpenML R package in publications, please use our [paper](https://arxiv.org/abs/1701.01293).
+
 # Installation of the package
 
 - Install the stable version from [CRAN](https://cran.r-project.org/web/packages/OpenML/index.html)

inst/CITATION

@@ -0,0 +1,26 @@
+citEntry(entry="Article",
+  title = "{OpenML}: An {R} Package to Connect to the Networked Machine Learning Platform {OpenML}",
+  author = personList(
+    person("Giuseppe", "Casalicchio"),
+    person("Jakob", "Bossek"),
+    person("Michel", "Lang"),
+    person("Dominik", "Kirchhoff"),
+    person("Pascal", "Kerschke"),
+    person("Benjamin", "Hofner"),
+    person("Heidi", "Seibold"),
+    person("Joaquin", "Vanschoren"),
+    person("Bernd", "Bischl")
+  ),
+  journal      = "ArXiv e-prints",
+  eprint       = "1701.01293",
+  year         = "2017",
+  url          = "https://arxiv.org/abs/1701.01293",
+  header = "To cite the OpenML package in publications, please use:",
+  textVersion = paste(
+    "Casalicchio Giuseppe, Jakob Bossek, Michel Lang, Dominik Kirchhoff, Pascal Kerschke,",
+    "Benjamin Hofner, Heidi Seibold, Joaquin Vanschoren and Bernd Bischl (2017)."
+    "OpenML: An R Package to Connect to the Networked Machine Learning Platform OpenML.",
+    "ArXiv e-prints.",
+    "URL https://arxiv.org/abs/1701.01293."
+  )
+)