amsnyder / ds-pipelines-targets-1

https://lab.github.com/USGS-R/intro-to-targets-pipelines
0 stars 0 forks source link

Why use a dependency manager? #5

Closed github-learning-lab[bot] closed 3 years ago

github-learning-lab[bot] commented 3 years ago

We're asking everyone to invest in the concepts of reproducibility and efficiency of reproducibility, both of which are enabled via dependency management systems such as remake, scipiper, drake, and targets.

Background

We hope that the case for reproducibility is clear - we work for a science agency, and science that can't be reproduced does little to advance knowledge or trust.

But, the investment in efficiency of reproducibility is harder to boil down into a zingy one-liner. Many of us have embraced this need because we have been bitten by issues in our real-world collaborations, and found that data science practices and a reproducibility culture offer great solutions. Karl Broman is an advocate for reproducibility in science and is faculty at UW Madison. He has given many talks on the subject and we're going to ask you to watch part of one of them so you can be exposed to some of Karl's science challenges and solutions. Karl will be talking about GNU make, which is the inspiration for almost every modern dependency tool that we can think of. Click on the image to kick off the video.

reproducible workflows with make

:computer: Activity: Watch the above video on make and reproducible workflows up until the 11 minute mark (you are welcome to watch more)

Use a GitHub comment on this issue to let us know what you thought was interesting about these pipeline concepts using no more than 300 words.


I'll respond once I spot your comment (refresh if you don't hear from me right away).

amsnyder commented 3 years ago

I hadn't considered automating reports before. I really liked this recommendation to reduce the manual labor of copy/pasting and also to avoid dreaded typos in your final report.

github-learning-lab[bot] commented 3 years ago

Great comments @amsnyder! :sparkles:

You could consider GNU make to be a great grandparent of the packages we referred to early in this lesson (remake, scipiper, drake, and targets). Will Landau, the lead developer of targets, has added a lot of useful features to dependency management systems in R, and has a great way of summarizing why we put energy into using these tools: "Skip the work you don't need"

We'd like you to next check out a short part of Will's video on targets

reproducible workflows with R targets

:tv: Activity: watch video on targets from at least 7:20 to 11:05 (you are welcome to watch the full talk if you'd like)

Use a github comment on this issue to let us know what contrasts you identified between solutions in make and what is offered in R-specific tools, like targets. Please use less than 300 words. Then assign your onboarding cohort team member this issue to read what you wrote and respond with any questions or comments.


When you are satisfied with the discussion, you can close this issue and I'll direct you to the next one.

amsnyder commented 3 years ago

R-specific tools like targets are specifically designed to support modular, function-oriented programming in R. It also abstracts files as R objects.

hcorson-dosch-usgs commented 3 years ago

Yes, exactly. One of the coolest capabilities of targets is how it tracks functions. With make, you specify the file (e.g., .R files or a data file) that a target depends on, and 'make' tracks the file. If the timestamp of a .R file has changed, make considers downstream targets that depend on that file to be out of date, even if the function steps defined within that file haven't changed. targets (like other R-specific pipelining tools) goes one step further, and actually tracks the operations of each function defined within a given .R file. It only marks targets that use that function as 'out of date' if the actual operations have changed, ignoring any edits to comments, formatting, or whitespace. So that means if you go back into a script to add comments or parameter definitions, it won't trigger a rebuild! 🎉

github-learning-lab[bot] commented 3 years ago


When you are done poking around, check out the next issue.