Code and documentation for the Brains for Publication proposal for the 2016 OHBM Hackathon
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Join the chat at

Code and documentation for the Brains for Publication proposal for the 2016 OHBM Hackathon.

Release information


The BrainsForPublication repository is backed up on Zenodo and can be cited either with the concept DOI - 10.5281/zenodo.596845 - or the doi associated with the specific version you used for your analyses (which can be found by looking on the righthand side of project's Zenodo page. For more information about the difference between concept and version DOIs check out this blog post from the Zenodo team.

An example specific citation would be:

Kirstie Whitaker, Michael Notter, & Sarah Morgan. (2017, December 1). BrainsForPublication (Version v0.2.1). Zenodo.

Some pretty pictures

Want to project your 3D statistical maps through a glass brain? Check out

Want to see where the clusters in your 3D statistical maps are? Check out

Want to make beautiful images of your freesurfer results? Check out

Want to make a snazzy gif of your own brain? Check out

Online processing

If you don't want to download anything, you can actually run these scripts online. Click Binder to get started.

The proposal in brief

The problem: You bust your butt figuring out how to do all the complicated neuroimaging analyses, then you write up all the steps in your methods section (whether you do it well is a project for another day) and interpret your results in your discussion section. And then to make the figures for your manuscript you make a screen shot and copy and paste the image into powerpoint before adding some labels and saving as a high res image.

The inequality: So many other groups have much better images than you! They have code they use to generate 3D renders of your results, or movies though the many slices, or spinning renderings! They have the expertise probably because they have developed some of the code to do "fancy" analyses and you're not sure how you can jump in with your output from a different analysis package to make their beautiful pictures.

The solution: At the OHBM BrainHack unconference in Lausanne we'll work together to provide examples and documentation for how to transform your 3D nifti images into various different types of figures (and movies and gifs) so your publication will entice readers to read about your work based on the lovely images you present.

The side effect: By providing the tools we will ensure that graduate students and other early career researchers maintain much better standards of reproducibility and replicability when presenting their work for publication.

Contributing to the project

If you'd like to contribute to the project please read our guidelines. Please also read through our code of conduct. We want this project to be open and supportive of anyone at any level of seniority or GitHub/coding/statistical/neuroantomical/aesthetic expertise.