February 18, 2022 From rOpenSci (https://deploy-preview-488--ropensci.netlify.app/blog/2022/02/18/ropensci-news-digest-february-2022/). Except where otherwise noted, content on this site is licensed under the CC-BY license.
Dear rOpenSci friends, it’s time for our monthly news roundup!
You can read this post on our blog. Now let’s dive into the activity at and around rOpenSci!
Come be part of making our great community even better;
Help start a new program promoting diverse leadership in open source;
Join a remote, flexible, global, friendly community and team!
More details in the job ad.
Join us for social coworking & office hours monthly on 1st Tuesdays! Hosted by Steffi LaZerte and various community hosts. Everyone welcome. No RSVP needed. Consult our Events page to find your local time and how to join.
Our next sessions are:
Tuesday, 01 March 2022, 9 AM North American Pacific / 17:00 UTC “Changing package maintainers”, Hosted by Steffi LaZerte and Hannah Owens
Tuesday, 05 April 2022 9 AM Australian Western / 1:00 UTC “Making figures sparkle” Hosted by Steffi LaZerte and Nick Tierney
Find out about more events.
Maëlle Salmon (Research Software Engineer with rOpenSci) and Karthik Ram (rOpenSci executive director) authored a commentary “The R Developer Community Does Have a Strong Software Engineering Culture” in the latest issue of The R Journal edited by Di Cook, as a response to the discussion paper “Software Engineering and R Programming: A Call for Research” by Melina Vidoni (who’s an Associate editor of rOpenSci Software Peer Review).
Ready for more? Two other interesting reads are the commentaries “We Need Trustworthy R Packages” by Will Landau (who maintains rOpenSci packages targets and drake), and “The R Quest: from Users to Developers” by Simon Urbanek.
The following three packages recently became a part of our software suite:
frictionless, developed by Peter Desmet together with Damiano Oldoni: Read and write Frictionless Data Packages. A Data Package (https://specs.frictionlessdata.io/data-package/) is a simple container format and standard to describe and package a collection of (tabular) data. It is typically used to publish FAIR (https://www.go-fair.org/fair-principles/) and open datasets. It is available on CRAN. It has been reviewed by Beatriz Milz, and João Martins.
rfema, developed by Dylan Turner: rfema
allows users to access The Federal Emergency Management Agencys (FEMA) publicly available data through their API. The package provides a set of functions to easily navigate and access data from the National Flood Insurance Program along with FEMAs various disaster aid programs, including the Hazard Mitigation Grant Program, the Public Assistance Grant Program, and the Individual Assistance Grant Program. It has been reviewed by François Michonneau, and Marcus Beck.
tidytags, developed by K. Bret Staudt Willet together with Joshua M. Rosenberg: The tidytags package coordinates the simplicity of collecting tweets over time with a Twitter Archiving Google Sheet (TAGS; https://tags.hawksey.info/) and the utility of the rtweet package (https://docs.ropensci.org/rtweet/) for processing and preparing additional Twitter metadata. tidytags also introduces functions developed to facilitate systematic yet flexible analyses of data from Twitter. It has been reviewed by Lluís Revilla Sancho, and Marion Louveaux.
Discover more packages, read more about Software Peer Review.
The following fifteen packages have had an update since the last newsletter: frictionless (v1.0.0
), av (v0.7.0
), c14bazAAR (3.4.0
), gittargets (0.0.3
), katex (v1.4.0
), nasapower (v4.0.4
), osmdata (v0.1.9
), parzer (v0.4.1
), pdftools (v3.1.0
), rfema (v1.0.0
), rgbif (v3.7.0
), riem (v0.3.0
), terrainr (v0.6.0
), tic (v0.11.4
), and tidytags (v0.3.0
).
There are twenty recently closed and active submissions and 4 submissions on hold. Issues are at different stages:
Three at ‘6/approved’:
frictionless, Read and Write Frictionless Data Packages. Submitted by Peter Desmet.
rfema, Access the openFEMA API. Submitted by Dylan Turner.
tidytags, Simple Collection and Powerful Analysis of Twitter Data. Submitted by Bret Staudt Willet.
Three at ‘5/awaiting-reviewer(s)-response’:
gbifdb, Local Database Interface to GBIF. Submitted by Carl Boettiger.
tidyqpcr, Quantitative PCR Analysis with the Tidyverse. Submitted by Edward Wallace.
gendercoder, Recodes Sex/Gender Descriptions Into A Standard Set. Submitted by Emily Kothe.
Five at ‘4/review(s)-in-awaiting-changes’:
qualR, An R package to download Sao Paulo and Rio de Janeiro air pollution data. Submitted by Mario Gavidia Calderón.
OmicsMetaData, OmicsMetaData: an R-package for interoperable and re-usable biodiversity ‘omics (meta)data. Submitted by Maxime Sweetlove.
phruta, Phylogenetic Reconstruction and Time-dating. Submitted by Cristian Román-Palacios.
epair, Grabs data from EPA API, simplifies getting pollutant data. Submitted by Leo Orozco-Mulfinger.
healthdatacsv, Access data in the healthdata.gov catalog. Submitted by iecastro.
Six at ‘3/reviewer(s)-assigned’:
EDIutils, An API Client for the Environmental Data Initiative Repository. Submitted by Colin Smith.
ReLTER, An interface to the eLTER for the R statistical programming environment. Submitted by Alessandro Oggioni.
canaper, Categorical Analysis of Neo- And Paleo-Endemism. Submitted by Joel Nitta. (Stats).
tsbox, Class-Agnostic Time Series. Submitted by Christoph Sax. (Stats).
ROriginStamp, Interface to OriginStamp API to Obtain Trusted Time Stamps. Submitted by Rainer M Krug.
occCite, Querying and Managing Large Biodiversity Occurrence Datasets. Submitted by Hannah Owens.
Three at ‘1/editor-checks’:
octolog, Better Github Action Logging. Submitted by Jacob Wujciak-Jens.
bssm, Bayesian Inference of Non-Linear and Non-Gaussian State Space. Submitted by Jouni Helske. (Stats).
rdbhapi, Interface to DBH-API. Submitted by Marija Ninic.
Find out more about Software Peer Review and how to get involved.
A Blend of Package Build Failures by Maëlle Salmon. Some common and less common problems we saw in logs of package and pkgdown website builds.
pkgcheck now available as a GitHub action! by Mark Padgham, and Jacob Wujciak-Jens. All packages submitted for peer-review with rOpenSci are checked by our pkgcheck package. This post describes a new GitHub action which can be used to run pkgcheck. .
One use cases of our packages and resources have been reported since we sent the last newsletter.
Explore other use cases and report your own!
Some useful tips for R package developers. 👀
Have you designed (or commissioned) a beautiful logo for your package?
Use usethis::use_logo()
that will enforce a specific size and save it under man/figures/logo.png
, as well as providing you with the Markdown code to insert your logo in your package repo README.
Why do this? This has two advantages:
If you have a package-level doc (i.e. a manual page for ?package-name
), or create one via usethis::use_package_doc()
, roxygen2 will automatically add the logo to that doc page. Type ?usethis
in your R console for an example.
If you use pkgdown BS5 templates, which is the case if your package is part of rOpenSci suite, your package logo will appear on all pages, as well as in social media cards.
Some links about testing your package…
devtools::test()
) but not in another one (say, devtools::check()
): a conversation around usual suspects. One prevention strategy is to read and apply the advice in testthat Test fixtures vignette.We no longer recommend using Travis CI. The development version of our dev guide has updated advice on CI.
If you adopt GitHub Actions,
Have a look at the changelog for r-lib/actions if these are the actions you use;
Do not miss the tech note “pkgcheck now available as a GitHub action!".
See the tech note A Blend of Package Build Failures.
Thanks for reading! If you want to get involved with rOpenSci, check out our Contributing Guide that can help direct you to the right place, whether you want to make code contributions, non-code contributions, or contribute in other ways like sharing use cases.
If you haven’t subscribed to our newsletter yet, you can do so via a form. Until it’s time for our next newsletter, you can keep in touch with us via our website and Twitter account.