Skip to content

charithn/outreach

Repository files navigation

b-roll-binder

Binder

'for the future when the camera crew wants B-roll and asks you to sit at your desk "doing bioinformatics"' - Mike Love in this post

Binderizes the featured software and some other techy-looking command line apps in order make a fancy-looking 'science-ing' background dashboard look using a Jupyter session or an Rstudio session served from MyBinder.org.

b-roll_layout_look

Flavors available:

  • Jupyter
  • Rstudio

Additional inspiration also added from Mara Averick and some other resources I deemed cool.

Features

How To: Step-by-Step

For Jupyter, follow the steps in this section. RStudio is covered under 'Prefer RStudio' below.

Launch Binder session from the launch binder badge above or click here and then follow the steps below to fill the panels with the running tech like in the image above:

  • When the session launches, the four terminal panels should already be arranged in your browser window much like in the image above. You'll probably want to stretch out the browser window to fill your screen as much as possible. <=== UPDATE: Don't be surprised if the automatic arranging of the terminal panels does not happen. I had seen it stop working about a year ago as JupyterLab workspaces and Binder changed some things. However, today I noticed it was working again. Then after deleting an old note mentioning it wasn't working, upon rebuild it seemed to show the correct arrangement for split second and then it goes away. In short you may need to make and arrange the terminal windows yourself. Hopefully eventually things will stabilize so the window opens with the correct arrangement reliably again.

  • The remaining steps just step through placing code into each of the terminal panels to execute so that the appropriate program starts.

If it helps in getting the code into the right terminals, this README file can be opened in the running session. But how do you get to that file in the session? Because when the session opens the layout is set with the file browser hidden, you'll need to toggle open the file browser. To do this, click the File Browser icon that looks like a folder on the left upper side of the panels, or in the menu from under toggle on 'View' > 'Show LeftSidebar' to open the file navigation panel. The shortcut for this on Macs is command-B.
Note: It is easiest to view and copy the code if you open the READEME in the running session by right-clicking on the file and choosing to Open With > Markdown Preview.
You may wish to click on the name of the README.md file in its tab and drag it over to cover the panel on the far right because the one on the left that it opens into by default gets compressed the most when you open the file browser pane.

  • In the panel on the far left, kick off the scrolling helix using the included FASTA sequence with the command below followed by hitting return.
bash drawHelix.sh chrmt.fsa
  • Want a sequence more to your liking to be scrolling by on your screen?
    OPTIONAL:
    Hit q to stop the included sequence from scrolling, upload a different DNA of you choosing (you can drag and drop into JupyterLab's file navigation panel)m and point the script at that. Such as the following, where myDNA.fa is replaced with the name of your sequence file:
bash drawHelix.sh myDNA.fa
  • If too much open space is displaying on the right side of the panel, move the right-hand border, found to the right of the scrolling DNA, over to the left.

  • In the panel in the middle top, start the matrix-like rain, as if it is featuring DNA, by running the command below:

unimatrix -s 96 -u 'ACTG'

You can click in the matrix-like rain panel and type q at any point to stop it.
OPTIONAL:
If you don't want the matrix-looking panel restricted to DNA bases, when starting or restarting it just type the following instead to start the matrix-like panel running:

unimatrix
  • In the panel in the middle bottom pane, start the countdown by executing the command below:
termdown 59m
  • Finally, in the far-right pane, start gtop by typing the command below and hitting return:
gtop
  • Enjoy. If you followed all those steps, you should now have something like below.

b-roll_layout_look

The panels are actually fully able to be moved and you can drag the borders to adjust to arrange the panels as you prefer.

Optional: open any interesting structure in PyMol or UCSF Chimera and place the window to either side of your browser.

Optional: You can also run DustinKirkland's Hollywood by typing hollywood.

Optional for tmux pros: You could instead just launch one terminal window and use tmux to launch and arrange panes in which you can then run the software highlighted above.

TROUBLESHOOTING:
Note: That if any of the middle, stacked panels seem to not be filling their area or the timer is really small, just use q to stop each one indivdually. And then use the up arrow to bring up the command last run and hit return to start running again. That usually fixes them.

(Of course it would be nice if the terminals opened with the commands needed to be run in them already at the prompts; however, due to security concerns that isn't possible.)

Prefer RStudio?

RStudio is limited to one terminal window at a time(?).
Use the following badge to launch RStudio and then you can choose what tech tool to run in the active terminal pane:

badge

Click on the 'Terminal' tab to bring it to the front.
From the menu, use 'Tools' > 'Global Options' > 'Appearance', and then under 'Editor theme' choose 'Tomorrow Night Bright' from towards the bottom of the list.
Excute what you want in the terminal from the command line tech tools. Options:

  • drawHelix.sh chrmt.fsa
  • unimatrix or unimatrix -s 96 -u 'ACTG'
  • gtop
  • termdown 59m
  • hollywood

See the How to for Jupyter section to see some other options for the drawHelix.sh one. Seem you use Ctrl-C to stop drawHelix in RStudio terminal.

Further Suggestions for Running in RStudio:
Move the right border of the terminal pane over to the right to expand real estate as much as you'd like for the terminal window.

Licenses

The four featured software packages have the licenses linked below (most are GNU General Public License v3.0 and one is MIT:

Technical notes

I added tmux permanently now so that panes in a single terminal it can be used if desired. I added DustinKirkland's Hollywood, suggested in response to Mara Averick's post later using apt.txt.

To get started click the badge below:

Binder

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages