datacarpentry / shell-genomics

Introduction to the Command Line for Genomics
https://datacarpentry.org/shell-genomics
Other
60 stars 190 forks source link

Time estimate #121

Open dleehr opened 6 years ago

dleehr commented 6 years ago

I'm teaching shell at GCB Academy's Introduction to Scientific Computing for Genomics next week and was very excited to see this lesson in such good shape. We have 3.5 hours minus breaks for each lesson. Since shell-genomics is estimated at 4:00, I'm concerned if it'll fit.

I recognize that the lesson has not been released yet, but was curious how accurate the 4:00 is and how the lesson compares to software carpentry's shell lesson, estimated at 1:35.

Thanks!

ErinBecker commented 6 years ago

@dleehr - Thanks for the question! We're in the process of putting the final touches on this lesson in preparation for publication. The timing estimates are rough guesses, as there have been significant changes to these lessons since they were taught last and they have not been re-timed. My suggestion as you prepare for your workshop is to time yourself working through the lesson and multiply by two! If you wouldn't mind submitting a PR afterwards with your timing so that this lesson could be updated, that would be great.

samnooij commented 6 years ago

Even though it may be a bit late, I'd like to share my experiences with teaching the Shell Genomics lesson. (This is the workshop link: https://aschuerch.github.io/2017-12-13-amsterdam/) We had planned to teach this part in 5 hours, for a mixed group of 15 graduate students/post-docs/technicians. In practice, it took me about 5 hours to teach from the introduction up to redirection. Writing scripts and project management had to be postponed to the second day (one hour extra - so about 6 hours total). The exercises took the most time, especially those in Working with Files and Directories and Redirection. Most learners were done in a few minutes, but some needed more time (10 minutes or more per exercise). So the hardest part was making sure everybody had enough time to finish the exercises by themselves or in pairs. The estimated times in the material is probably right if you strictly give your learners only so many minutes per exercise. We preferred to use some extra time and make sure everybody could follow. Hope this helps! Good luck with teaching and finding the right timing for your audience!

-- P.S. Let me add some time estimates per episode: Introducing the Shell (few exercises, estimates are probably right) Teaching: 20 min Exercises: 10 min Navigating Files and Directories (again, estimates look good) Teaching: 30 min Exercises: 20 min Working with Files and Directories (from here on it becomes trickier: 4 exercises; for me it took longer) Teaching: 30 min Exercises: 40 min (+25) Redirection (7 exercises, certainly longer than 15 minutes) Teaching: 30 min Exercises: 60 min (+45) Writing Scripts (from here on we had to speed up a bit, so I mostly just showed how to approach the exercises) Teaching: 15 min (-5) Exercises: 15 min (-5) Project Organization Teaching: 15 min Exercises: 15 min

TOTAL time: 300 min, or 5 hours

So I seem to have lost some more time... Perhaps I took some extra time explaining. I don't remember many extra breaks to get everybody up to speed.

aschuerch commented 6 years ago

Do you have time estimates for the shell lesson for your recent workshop @taylorreiter @raynamharris @ryanpeek ?

taylorreiter commented 6 years ago

@shannonekj

ryanpeek commented 6 years ago

@taylorreiter https://github.com/taylorreiter @raynamharris https://github.com/raynamharris @shannonekj https://github.com/shannonekj can confirm, but I think in total we worked through lessons shell 01, 02, and 03 in about ~2 hours, broken up by lunch and a break...there was some additional time/material from connecting to the cloud that may have bled into the shell lessons as well. The Redirection lesson (shell 04) ran about 45 min to an hour. R

On Fri, Jun 29, 2018 at 9:31 AM Taylor Reiter notifications@github.com wrote:

@shannonekj https://github.com/shannonekj

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/datacarpentry/shell-genomics/issues/121#issuecomment-401406858, or mute the thread https://github.com/notifications/unsubscribe-auth/AFl9sP4Cqs4DAJa68fWXQRr_ktP__cR-ks5uBlZpgaJpZM4QmWLA .

--

"When we try to pick out anything by itself, we find it hitched to everything else in the universe."John Muir (My First Summer in the Sierra, 1911) ----------------------------------------------------- Ryan Peek PhD Candidate, Graduate Group in Ecology Center for Watershed Sciences, UC Davis ryanpeek.github.io http://ryanpeek.github.io @riverpeek 530.754.5351

-----------------------------------------------------

ErinBecker commented 5 years ago

See also: https://github.com/datacarpentry/shell-genomics/issues/176

ErinBecker commented 5 years ago

Arizona Bug BBQ - we just taught this lesson in 4 hours, however, we skipped a significant section of the scripts episode. The timings are currently incorrect, but the group is talking about proposing some cuts to the lesson, so these timings would be reevaluated then.

ErinBecker commented 5 years ago

@ryneches - wanna take a stab at this? 😄 (see also #176 for suggested timings)

p-j-smith commented 9 months ago

Current timings are:

https://github.com/datacarpentry/shell-genomics/blob/faf5a236ec8d8df83773a6929d0d036456ae3ae1/episodes/01-introduction.md?plain=1#L2-L4

https://github.com/datacarpentry/shell-genomics/blob/faf5a236ec8d8df83773a6929d0d036456ae3ae1/episodes/02-the-filesystem.md?plain=1#L2-L4

https://github.com/datacarpentry/shell-genomics/blob/faf5a236ec8d8df83773a6929d0d036456ae3ae1/episodes/03-working-with-files.md?plain=1#L2-L4

https://github.com/datacarpentry/shell-genomics/blob/faf5a236ec8d8df83773a6929d0d036456ae3ae1/episodes/04-redirection.md?plain=1#L2-L4

https://github.com/datacarpentry/shell-genomics/blob/faf5a236ec8d8df83773a6929d0d036456ae3ae1/episodes/05-writing-scripts.md?plain=1#L2-L4

https://github.com/datacarpentry/shell-genomics/blob/faf5a236ec8d8df83773a6929d0d036456ae3ae1/episodes/06-organization.md?plain=1#L2-L4

Total time: 4 hours

I don't think these have been updated since this discussion began, but perhaps some content has been removed? Does anyone have some more up-to-date timings for this course, or any plans to run it in the near future? If not, it sounds like the timings for episode 3 and 4 could be extended (based on https://github.com/datacarpentry/shell-genomics/issues/121#issuecomment-358234115 and https://github.com/datacarpentry/shell-genomics/issues/176).

Also, @akshayparopkari I see you labelled this as 'refer to cac' - is there any update from that referral?

vhmcck commented 2 months ago

I also see a total of 4 hours for the 6 episodes within the lesson but without the details on timings for teaching vs. exercises. The totals match. I agree with time adjustments based on previous reports.

The consensus between #121 and #176 would be:

  1. Introducing the shell - 30 minutes.
  2. Navigating files and directories - 40 minutes.
  3. Working with files and directories - 90 minutes.
  4. Redirection - 120 minutes.
  5. Working with files and data - 30 minutes.
  6. Project organisation - 30 minutes.

TOTAL: 340 minutes = 5.7 hours.

However, this does not fit into the 4-hour window. Should agree on the next steps.