{"Package":"rromeo","Type":"Package","Title":"Access Publisher Copyright & Self-Archiving Policies via the\n'SHERPA/RoMEO' API","Version":"0.1.1","Authors@R":"c(\nperson(\"Matthias\", \"Greni\", email = \"matthias.grenie@gmail.com\",\nrole = c(\"aut\", \"cre\"), comment = c(ORCID = \"0000-0002-4659-7522\")),\nperson(\"Hugo\", \"Gruson\",\nrole = \"aut\", comment = c(ORCID = \"0000-0002-4094-1476\"))\n)","Description":"Fetches information from the 'SHERPA/RoMEO' API\n which indexes policies of\njournal regarding the archival of scientific manuscripts before and/or after\npeer-review as well as formatted manuscripts.","License":"GPL-3","Encoding":"UTF-8","LazyData":"true","Imports":"httr, xml2","RoxygenNote":"7.0.2","Suggests":"knitr, rmarkdown, testthat, vcr (>= 0.5.0), ISOcodes, mockery","Language":"en-US","VignetteBuilder":"knitr","URL":"https://docs.ropensci.org/rromeo/,\nhttps://github.com/ropensci/rromeo","BugReports":"https://github.com/ropensci/rromeo/issues","NeedsCompilation":"no","Packaged":"2020-03-11 13:47:24 UTC; grenie","Author":"Matthias Greni [aut, cre] (),\nHugo Gruson [aut] ()","Maintainer":"Matthias Greni ","Repository":"CRAN","Date/Publication":"2020-03-11 14:10:02 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/rromeo_0.1.1.tar.gz","jsonAuthors":[{"name":"Matthias Greni","email":"matthias.grenie@gmail.com","maintainer":true},{"name":"Hugo Gruson","email":null,"maintainer":false}],"readme":"\n\n\n# `rromeo` – an R interface for SHERPA/RoMEO API\n\n[![Project Status: Active – The project has reached a stable, usable\nstate and is being actively\ndeveloped.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n[![Travis build\nstatus](https://travis-ci.org/ropensci/rromeo.svg?branch=master)](https://travis-ci.org/ropensci/rromeo)\n[![AppVeyor build\nstatus](https://ci.appveyor.com/api/projects/status/github/ropensci/rromeo?branch=master&svg=true)](https://ci.appveyor.com/project/ropensci/rromeo)\n[![codecov](https://codecov.io/gh/ropensci/rromeo/branch/master/graph/badge.svg)](https://codecov.io/gh/ropensci/rromeo)\n[![cran\nchecks](https://cranchecks.info/badges/summary/rromeo)](https://cran.r-project.org/web/checks/check_results_rromeo.html)\n[![CRAN-version](https://www.r-pkg.org/badges/version/rromeo)](https://cran.r-project.org/package=rromeo)\n[![](https://badges.ropensci.org/285_status.svg)](https://github.com/ropensci/onboarding/issues/285)\n\n`rromeo` is an R client for the [SHERPA/RoMEO\nAPI](http://www.sherpa.ac.uk/romeo/index.php?la=en&fIDnum=&mode=simple).\nSHERPA/RoMEO is a database that gives information on editorial policies\nof scientific journals regarding the archival of preprint, postprint and\npublishers’ manuscripts. `rromeo` is aimed at scientists interested in\narchival practices of scientific journals, such as professionals of\n[scientometrics](https://en.wikipedia.org/wiki/Scientometrics) but also\nat scientist of specific fields interested in the practices of their\nfields.\n\n## Install\n\nThe latest stable release of `rromeo` is available on CRAN and can be\ninstalled with:\n\n``` r\ninstall.packages(\"rromeo\")\n```\n\nYou can also install the development version from GitHub:\n\n``` r\n# install.packages(\"remotes\")\nremotes::install_github(\"Rekyt/rromeo\")\n```\n\n## API Key\n\nNote that SHERPA/RoMEO lets you run 500 requests per day per IP address,\nby [registering for a free API\nkey](http://www.sherpa.ac.uk/romeo/apiregistry.php) you can bypass this\nlimit.\n\n`rromeo` can use your registered SHERPA/RoMEO API key; you can either\npass it as a string when querying the data with the argument `key`:\n\n``` r\nrr_journal_name(\"Journal of Geology\", key = \"Iq83AIL5bss\")\n```\n\nor you can specify the environment variable `SHERPAROMEO_KEY` in an\n`.Rprofile` or in an `.Renviron` file and `rromeo` will automatically\nretrieve the API key.\n\n## Usage\n\n`rromeo` contains functions to retrieve data from the SHERPA/RoMEO API\n(for a complete overview please refer to the\n[vignette](https://docs.ropensci.org/rromeo/articles/rromeo.html)). The\ndata is released under the [Creative Commons\nAttribution-NonCommercial-ShareAlike 2.5 (CC BY-NC-SA 2.5)\nlicense](https://creativecommons.org/licenses/by-nc-sa/2.5/). A\nsuggestion of citation is included in `rromeo` via `citation(\"rromeo\")`.\n\n`rromeo` functions are prefixed with `rr_` such as `rr_journal_name()`\nthat lets you retrieve a journal policy information using the title of a\njournal:\n\n``` r\nrromeo::rr_journal_name(\"Journal of Biogeography\", qtype = \"exact\")\n#> title provided_issn issn romeocolour preprint\n#> 1 Journal of Biogeography 0305-0270 yellow can\n#> postprint pdf pre_embargo post_embargo pdf_embargo\n#> 1 restricted cannot 12 months \n```\n\nthe `qtype` argument indicates the type of query to make (`exact` for\nexact matching of the title, `contains` for partial matching and `starts\nwith` to match only the beginning of the title).\n\nYou can also retrieve a journal information using its ISSN:\n\n``` r\nrromeo::rr_journal_issn(\"0305-0270\")\n#> title provided_issn issn romeocolour preprint\n#> 1 Journal of Biogeography 0305-0270 0305-0270 yellow can\n#> postprint pdf pre_embargo post_embargo pdf_embargo\n#> 1 restricted cannot 12 months \n```\n\n`rromeo` also provides a function to retrieve information based on\npublisher ID `rr_publisher()`.\n\nSHERPA/RoMEO provides a synthetic “colour” for each journal, the colour\nsummarizes the editorial policy of a journal:\n\n| RoMEO colour | Archiving policy |\n| :----------- | :------------------------------------------------------ |\n| `green` | can archive preprint, postprint and publisher’s version |\n| `blue` | can archive postprint **or** publisher’s version |\n| `yellow` | can archive preprint |\n| `white` | archiving not formally supported |\n\n(Table taken from\n)\n\n`rromeo` lets you retrieve the policies of all journals of a given\ncolour using the function `rr_romeo_colour()` (**NOTE:** this function\ncan be slow as there are many journals to retrieve):\n\n``` r\ngreen_journals = rromeo::rr_romeo_colour(\"green\")\ngreen_journals[8:12,]\n#> romeoid publisher\n#> 8 1128 Association for Information Science and Technology (ASIS&T)\n#> 9 1937 University of Arizona\n#> 10 2951 Geological Society of America\n#> 11 2521 University of California Press\n#> 12 2306 Optical Society of America\n#> alias romeocolour preprint postprint pdf\n#> 8 JASIS&T green can can cannot\n#> 9 Radiocarbon green can can restricted\n#> 10 GSA Today green can can can\n#> 11 Collabra green can can can\n#> 12 No Paid Open Access green can can cannot\n```\n\n## Dependency network (Imports only)\n\n

\n\n## Dependency network (Imports and Suggests)\n\n

\n\n## Contributing to `rromeo`\n\nWe welcome contribution to `rromeo`\\! Please read the [contribution\nguidelines](https://docs.ropensci.org/rromeo/CONTRIBUTING.html) if you\nwant to contribute, as well as the below-mentioned Code of Conduct.\n\n## Code of Conduct\n\nPlease note that the `rromeo` project is released with a [Contributor\nCode of Conduct](https://docs.ropensci.org/rromeo/CODE_OF_CONDUCT.html).\nBy contributing to this project, you agree to abide by its terms.\n\n[![ropensci\\_footer](https://ropensci.org/public_images/ropensci_footer.png)](https://ropensci.org)","jobInfo":{"package":"rromeo","version":"0.1.1","parsingStatus":"success","parserVersion":1,"parsedAt":"2020-03-11T15:30:04+0000"}}

Description

Usage

Arguments