Tips | DEZERAECOX

Toolbox talk: Lights, Camera, Action!

Sun, 03 Oct 2021 14:28:49 +0000

Toolbox talk: Lights, Camera, Action!

It is more important than ever for scientists to be concise, engaging and easy to understand. Most importantly, we need to diversify our means of communication to meet the audience where they live. In the age of TikToks and Reels, it seems our digital lives increasingly revolve around easily digestible visual media. So: time to go video! I realise, as I am writing this, the irony of that statement… But, as part of a recent communication course, I produced my first scientific videos for a general audience - and I think it should be part of every scientist’s toolbox! If you’re keen to see the finished product, head straight to the . Otherwise, if you’d like to hear more about the tools, tips and tricks I picked up along the way, read on! Who knows, maybe I’ll even make a video version.. 😉

The Art of Science Communication: A little learning, a lot of fun!

Last year I tackled my first official professional development course: . Hosted by the ASBMB, this course covers basic communication skills for scientists looking to increase their public and professional impact. Thanks to a well-paced course, dedicated instructors and a diverse cohort of participants, this course was not only hugely informative but also a lot of fun!

The main goal, achieved over seven weeks, was to craft our own individual message which would introduce a general audience to our primary research topic. From the very start, we were thrust into the deep end as the first week required us to record a short video detailing our research for the cohort. This was something entirely new to me, and at first watching yourself on screen is incredibly daunting! But after the initial icky-ness wears off, these practice videos turned out to be a great resource for identifying areas of opportunity in our speaking practice. After establishing this ‘baseline’, the instructors set to work helping us take the bones of that video and craft the message, increase engagement, remove jargon, and improve production. Together, these iterative exercises left each of us with a developed skill set, covering everything from scientific presentations to a non-expert elevator pitch, and a video product showcasing these skills.

Scripting, recording, editing and posting a video was something I had never done, much less for science communication purposes. So, just in case you (like me) missed that whole YouTube vloggers phase, I thought I would cover here some of the hardware, software and general lessons that I learned along the way to creating my final video product.

Lights: Setting up for success means starting with software

While you certainly don’t need any fancy software to shoot videos (just take a look at everyday people shooting Reels) a handful of (free!) software programs can really make a difference for professional content. A few tools that I found useful were a teleprompter-style recording app, and a video editing suite.

When it comes to talking about science, many academics are used to giving presentations where some multimedia slides guide the content you deliver, and there is a conversational meandering that actually enhances talks like this. When you’re recording, however, maintaining eye contact with the camera is much trickier. This is where a good teleprompter app comes in - it allows you to take these cues in the form of text without breaking your connection to the audience through the screen. There are a bunch of free versions depending on your operating system - I used my iPhone for recording, so I found on the App store. Features to look out for include the ability to change the text size and speed, and the option to export without a watermark.

For video editing, again this choice is OS-dependent. iMovie on macOS seems to be fantastic. On PC, I had reasonable success with , but there are quite a few others gaining traction too. Most will have the same functionality - but, importantly, I would suggest looking for something that has a decent online community and plenty of resources for beginners. As novice filmmakers, it can be hard to know where to start otherwise!

Camera: A little investment goes a long way

As with software, you certainly do NOT need any expensive or fancy equipment. I shot all my videos on my phone, and the quality was sufficient. For a small investment though (~$50 AUD) you can get a great quality boost from two simple tools; a lapel microphone that connects to your recording device, and a tripod.

Lapel microphones help improve the sound quality, particularly as captured by a phone - and there are lots of cheap options available. The has a built-in clip for attaching to clothing, allowing it to be positioned low on the chest out of frame during recording. These are particularly great for people living in places of high background noise (hello friendly neighbourhood leaf-blower that seemed to always be running when I wanted to record!), as they allow you to better isolate speech from contaminating noises during editing.

A tripod might seem like a large ask for a simple scicomm video. But hear me out - it has a few benefits! 1) It allows you to easily and stably position your recording device to free your hands entirely, letting you fall into a natural speaking rhythm with optional props, and 2) you can easily use a teleprompter app. Again, another excuse for all you online shopaholics to bust out your best bargain hunting skills!

The only other equipment I used when recording was already lying around the house - a black sheet as a backdrop, and a floor lamp to help with even illumination of my glasses. For any fellow bespectacled scicommers out there, are some great tips on getting rid of the annoying mirror effect light on glasses can have when recording.

Action: Time to talk the talk!

Now for the best (and most important) bit - the doing! All the great equipment in the world does nothing until you have a great science story to tell.

Before thinking about what you want to talk about, start by reflecting a little on the audience that you want to engage. Audiences composed of fellow scientists outside your field will of course require a very different approach to a collection of non-experts. Likewise, a room full of adults requires a different approach to a room full of children. It’s important to hit the right contextual notes, and this rings especially true in video format where people’s attention is so easily lost scrolling to the next video in line.

Once you know your audience, it’s time to draft your story. Unlike normal scientific presentations, I recommend writing a script here. This lets you make sure you have a reproducible story that can be honed, helping you to fit the time limit and minimise the number of recording attempts. Yes - attempts with an s - there will be many. But that’s ok, it’s just part of the process!

Some things to think about when honing your story:

Be critical of how engaging your storywill be for your audience - we all love our science emplicitly, but don’t forget to let your audience know why they should love your science too. What is the important problem or question? What makes your work unique?
Be cautious of spewing facts, figures or findings - instead, take the audience on a journey with you, just like a good book they can’t put down. Have you woven a narrative? What are the challenges this research faces, how have you overcome these?
Be creative in your description of complex topics- ditch the fancy words in favour of metaphors. A good metaphor can take some time to work through, but don’t underestimate their power in helping your audience grasp complicated concepts. Jargon is a huge no-no, even for scientists outside your field.

Ok, you have a story written out. Now, it’s time to set your scene. For example, I used a plain black backdrop, with some soft glasses-friendly lighting, and the tripod, phone and microphone about 1 m away. Then it’s time to record! This is the part where you really just have to feel it. Feel the right pace (conversational, not rushing, with nice pauses), feel your body in space (remember you are a person, not a robot, and if you’re anything like me you talk with your hands, like, a lot), and feel the excitement of your story (even on the fifth or sixth time you read it through). To start, I would suggest reading through the whole story on camera from start to finish - ignoring any missteps in favour of practising the whole story. From there, record a few more tries until you are happy. Depending on the video format (and if you plan to have cut sections along the way or a single-take read) you can even piece together sections from different versions that you like the most - this is where editing comes in!

Movie magic: remix your way to the red carpet.

Once you have recorded a few versions, this is where the movie magic happens. Head over to your editor, where you will be able to add transitions (fade-in, fade-out) music, images, sound effects, remove background noise, crop and combine different videos to get a final product you are proud of. In some cases, you might even want to bring in some - a little out of my league so far but something I am keen to try!

I decided to add a lead-in image from (a fantastic collection of images that are free to use with attribution) and in one case I recorded a PowerPoint slideshow that also had a black background, timed to match my finished video. I then overlayed the PowerPoint recording onto my video content, and viola, animated video! There are lots of neat ways to engage your audience beyond a talking head on the screen, so be sure to be creative and take full advantage of this aspect of the medium.

With the complete version, the last step is sharing it with the world. This is actually quite easy to do via youtube - simply sign up for an account (if you don’t have one already) then head to the “YouTube Studio” section where you will find the “Content” tab.

Uploading a video is as simple as selecting the “Create” icon, and following the prompts to upload your masterpiece. There are a few options, like whether or not your video should be indexed with the searchable youtube content, that you can toggle to suit your needs. Don’t forget a catchy title if you want your content to be found!

And that’s a wrap!

That’s it, you are officially a scicomm superstar! While producing video content can seem a daunting task, once you get past the weirdness of seeing yourself recorded it really is a great way to share your science. I am super proud of the content I produced during the course - with a few simple tools and a couple of hours work, for the first time I feel confident to share my passion for science in a whole new context. So, without further ado, here are the videos I created!

Party tunes: A new phase in the hunt for happy brain cells

Turning brain cells into origami masters

That’s all for now. Hopefully, I’ve inspired you to capture your story on camera and share it with the world! Have you made your own scicomm video? Do you have a favourite editing software? Head over to the , or let me know on !

Image credits: via unsplash

Toolbox Talk: Notion

Sat, 04 Sep 2021 21:23:03 +0000

Toolbox Talk: Notion

Notion is the type of software that, if you know, you know. After hitting the scene only a few years ago, it has amassed a somewhat cult-like following among personal productivity buffs. For me, Notion is a love affair that started during Melbourne’s extended COVID lockdown in 2020. During this profoundly confronting time, where life seemed beyond control, I found solace in taking control of my tools and systems. A whole new consolidated and streamlined workflow emerged with Notion at its centre - and wow, do I have some thoughts! If you came purely for the Notion nitty-gritty, feel free to skip to the Getting Started section. Otherwise, for Notion newbies, here are a few of my feelings about digital tools for science and how Notion fits the bill for me.

Need a notion about Notion?

First and foremost, Notion is a blank canvas that you can make and mould into (almost) anything! In fact, its versatility is often something sceptics point to as a reason to steer clear. But really, this is where the magic happens. Unfortunately, it also makes Notion incredibly hard to describe! So, here goes.

First: think spreadsheets on steroids. At its core, Notion provides an architecture for building relational databases which are like spreadsheets that can be linked. But, **more than that, each entry itself is a ‘page’ that can contain another database. Which brings me to… Second: think lego! The second aspect of Notion’s design strategy is that all content is considered individual Blocks (even databases). This means that you can stack and link different types of content (from normal text, quotes, callouts, bulleted and numbered lists to more complex structures like embedded webpages, code blocks, equations, date reminders, embedded google drive files, and even databases). Layered on top of this is the ability to display databases as tables, boards, galleries or lists, plus filtering and sorting that makes sure you can see the information you need in the context you need it. Last but not least is the aesthetic! With a simple palette for labelling metadata, headings and text, coupled with optional icons and header images it is super simple to make pretty pages

What we arrive at is a highly versatile and customisable ecosystem that you can use to build and personalise any architecture you need, from a to a to a workplace wiki to a … The possibilities are endless! And for people like me, it presents the opportunity to unify all the disparate digital tools that we had cobbled together to take care of these functions in the past, like Evernote and . In this way, Notion for me embodies the principle of removing friction, by letting me focus on the work without context switching.

A simple sneak peek

In honesty, Notion is sometimes a tool you need to see to understand. So, here is a quick toy task management example. I’ve even provided this page as an template in case you want to try it out!

To start, databases can look just like a regular spreadsheet, but can also be displayed as a board ( think: Trello), list, gallery, timeline or calendar. Here is an example of two databases: “My First Database” viewed as a gallery, and “My Second Database” viewed as a table, placed on a single page titled “Example Relational Databases”. Each column of the table view shows some of the metadata for the individual elements. There are lots of types of metadata you can add, including dates, categories from a dropdown, checkboxes, formulas which calculate a property based on other metadata columns, urls, emails, attachments - so many choices!

Most importantly, we can link these two databases using a relational property, such that we assign Task 1 as associated with Project A. This opens up lots of possibilities, including new formula options called ‘rollups’ which let you see how many tasks for a project are complete.

Now, to this point most of these features you could fandangle out of a spreadsheet if you tried hard enough. But here comes the magic. Each of the entries in the database are themselves pages, which can contain any of the rich content blocks I described above, including more databases. It can also include filtered views of a database so, within a single project, you can overview associated elements.

Last but not least, one of my favourite time-saving functions - templates! You can add templates to any database, such that when you add a new entry to the database it can be prefilled with page content. This is a super-efficient way to capture essential and consistent information for each new entry beyond the metadata options. You can even pre-filter included databases, such that the filtered view automatically includes only related sub-entries.

Ok… But what about Notion for science?

In my 10 years as a scientist, I was not once introduced to the idea of “project management”, much less software fit for the task. It was mostly something that we were inherently supposed to do; keeping track of the overarching aim of our individual project, tracking goals and milestones and tasks. It wasn’t until my first post-doc, when suddenly the number of projects I was involved in exploded, that I found myself reaching for help in the form of digital project management tools.

In contrast, Electronic Lab Notebooks (ELNs) are a digital platform that is slowly permeating all levels of science. The available options seem to be multiplying at a steady rate, and institutional uptake is slowly increasing. Many of the front runner ELNs have connectivity covered, being accessible via browser or app across devices, and provide documentation processes, like versioning and witnessing, in line with funding body and research institution requirements. However, all of the many platforms I have tried suffer from similar issues: (i) they have quite a rigid structure for what constitutes an “experiment”, (ii) data storage size is limited, (iii) structured similarly to a paper notebook which treats experiments as a single entity, not just one of a number of specialised outputs researchers manage and produce, (iv) have no mechanism to track what stage in the experimental process that experiment is in (idea, design, data gathering, data analysis, summary and storage) and (v) are somewhat of an isolated island.

Needless to say, Notion has now alleviated most of these pain points. A few of the best bits:

It works where you do - in an app, browser, mobile, PC, Mac… Wherever you need to be, with synced content meaning everything is always accessible when and where you need it
It is less rigid than Windows file structures, taking full advantage of the interlinked nature of what we do as scientists, building a web of research
Allows you to automate some of the ‘boring’ (although I never find them boring!) organisational bits through templating
Functional web clipper to capture resources and info while you browse
Good selection of commenting, collaboration and automatic versioning features
(Almost) infinite customisability enables you to work in a way that works for you

This being said, there are some important caveats to bear in mind:

Funding bodies sometimes mandate data storage conditions, including the global location of servers for digital data. Notion may not always satisfy this criteria.
Similarly, Notion should not be used for confidential information such as clinical data
Due to the unique nature of Notion’s architecture, there is a limited ability to transfer to alternative systems - however there are substantial backup options to get your data out of Notion if you ever need to
Small number of direct integrations with Google products (like calendar) has been limiting, although the fledgling API will hopefully help this to thrive in the near future.
Some functionality has been slow to materialise - like the ability to natively add symbols outside equations, column-wise formatting within other blocks, and native drawing/writing/pdf annotation (I stick with the Notes app on my iPad, where the export-as-image and copy-as-text functions are my fired)

For me, none of these things were deal-breakers. But certainly, Notion is not fit for every purpose! Buyer beware, as they say.

My Notion Nitty Gritty

For my workspace, I started with the broad buckets of Science, Coding, Communication and Personal. Parallel to this are my Projects, Milestones, Tasks and Resources databases ( think: P.A.R.A.), where individual items are linked to their overarching bucket. From here, filtered views of each of the Project, Milestone and Resource databases form the basis of my daily work ecosystem. I can open a Project page and see each of the Milestones on the go for that project (manuscripts, experiments, funding applications), Resources pertaining to that project (like articles, funding, and ideas), and Tasks for that project (of course sorted by priority and due date). I treat all individual research outputs as Milestones; whether that be a single experiment, a manuscript I’m writing, a presentation I’m giving, a funding application I’m preparing, or a seminar I’ve attended. As well as linked databases, you can also ‘mention’ pages or people inline using the ‘@’ function (almost like a hyperlink) that helps to link together pages to create your very own web of knowledge.

To help with easy access and focusing, I also have a Dashboard page, with some of these @ links to my current priority projects, milestones and tasks - plus a filtered and sorted linked database with some friendly reminders to focus my day!

Some of my other favourite Science databases include my Virtual Lab Book (a filtered version of my Milestones database, which has separate properties for Experiments as they move from conception to data gathering to analysis to writeup), my Reading List (captured as a filtered database from my Resources), and my CV database with which I can filter to produce tailored versions of my CV for individual applications. I have templates set up for different types of Milestones, making it easy to create a new Experiment versus a Manuscript. On the personal front, a sneaky favourite of mine is my recipes database - drool worthy organisation if I do say so myself!

Tips for getting started

If you made it this far, I’m sure you’re thinking “Ok - you sold me. Now, where do I start?”. For many people, staring at the blank screen of a fresh Notion workspace will be quite daunting. If you’ve only ever used out-of-the-box systems, the requirement to create your own from scratch can be overwhelming! However, I truly believe this is where the magic happens. A few tips:

Start with stepping back - the first thing I recommend after installing Notion and creating your first workspace is to close the computer. Yup, put it away and find yourself a pen and paper. First, set to thinking about the broad buckets you want to encapsulate within the workspace. For this process, I found an adaptation of the . method of project management was a great place to start.
Remember to be flexible - your initial workspace should provide some guiding principles to start with, but should be fluid over time as you learn what works, what could be better and, most importantly, what you need. This is the true power of Notion - to grow with you.
Prepare for growing pains - changing to a new system (especially if you are planning a whole-life overhaul like I did!) will invariably present some challenges. But, it will be worth it. Stick with it, and pay attention to the pain points at what you need to adapt.
Face the future - with new systems, the temptation to retrofit your past outputs can be seductive. But (!) you should resist this temptation. Focus instead on ingesting only those things that you currently need into Notion, and leave the rest as the BN (before Notion) archive. You will know where to find things (hopefully) by sticking to the BN and AN line!

Once you have decided what your Notion might look like from a top-down point of view, it’s time to set to work creating the databases and entries that will comprise your workspace. If you’re still struggling with the basics, there are many great tutorials (like from the Notion team) and you can find plenty of inspiration, like and and .

Wrapping up

Wow, what a marathon! In my defence, I warned you I had plenty of feelings when it comes to Notion! My hope is that this post serves as a basic run-through of how I use Notion on a daily basis to capture my research process and enhance my productivity by providing a platform designed and curated by me. Beyond the infrastructure that I provide for myself in Notion, there are a host of strategies I use to link outputs across various other platforms, such that Notion serves as my catch-all and launch point, but I can leave more specialised operations like task management and writing code to specific apps that were tailor-made for those purposes.

In short, Notion may be the broadest tool in my research organisation toolbox, but it is still only a tool that helps bring together other essential tools in the box. You could almost think about it as the toolbelt which keeps all my other tools handy!

That’s all for now. As organisation is intensely personal (what works for you will be very different to what I like and need!), I don’t think it is especially useful to go through my workspace in-depth here. If you’re keen to chat details, make sure to drop me a note on or on the page!

Happy organising 📚

Image credits: via unplash

Learning to code: it's as easy and as complex as that.

Sun, 05 Jul 2020 15:12:56 +0000

Learning to code: it’s as easy and as complex as that.

Many life scientists have used their time under pandemic-induced lockdown to learn their first programming language. Yay! Coding has many many advantages (reproducibility, more complex analyses, reusability, time-saving) that I have espoused all too many times before.

Many people start with a tutorial or two, then jump straight in and analyse a dataset. They get a plot, maybe a few statistics and voila! They are now scientists who can code.

Kinda.

See, the thing is there is more (much more) to implementing programmatic workflows in a biological context. Unfortunately, these are the skills that intro-to-programming courses often fail to teach you (or sometimes even mention) - but without them, adding scripts to your workflow can often make your work less reproducible, not more. For the sake of the argument, lets pick one.

Version control.

Imagine a bowl of spaghetti (lots of lines of code), which you admire briefly before throwing at a canvas (your interpreter). You create a beautiful work of art (your plot), and stand back to admire your handiwork. Maybe you show it to a few friends, and they are super impressed. (Awesome!). And then they ask - how did you do it? Not just the throwing motion, or the rough distance between the bowl and the canvas. They want to know the precise location of every single strand of spaghetti in the bowl before you threw it at the canvas. They want to know the recipe you used for the sauce, down to the precise number of grams of oregano.

Now, of course, we aren’t actually talking about a bowl of spaghetti - we are talking about your code. So - of course - you can simply show them the script! Huzzah! The precise instructions that enabled you to make that very specific plot. But here’s the kicker. The code is not static. In fact, chances are that you poured over it for hours (maybe days) adjusting, tweaking, changing, testing and rerunning - all to get the glorious, awe-inspiring plot at the end.

By this stage, you’ve probably made over 100 spaghetti-splattered-spectacles (plots) and your house is starting to smell like an Italian Pizza joint. If I asked you to produce the exact recipe, down to the very position of each strand of spaghetti, for plot number 47 - could you do it?

My guess is probably no.

Conducting experiments is at the heart of science. However, without the essential extracurricular activities like maintaining backups, organising your results files and optimising project management systems, you wouldn’t last very long in academic research. The same is true of coding. Learning to write a functioning script is just the tip of the iceberg when it comes to implementing reproducible computing workflows in biology.

So, with this in mind, what are those all important skills you ask? Well, luckily, far more experienced scholars than I have written on this topic and provided guides (like and ) for those starting out in the computational space. These are highly applicable to biologists learning to code, and I encourage you to check them out before you stray too far down the spaghetti-on-the-wall path (like I did). As with any system, it is easiest to implement new routines before you have become to set in the old ones! At the very least, here are a few things to consider:

, including Github/GitLab/BitBucket
, including efficient folder layouts
and docker containers
practices
, including repositories and citing software you use

For more, make sure you check out the resources below.

Oh, and one last thing.

Unfortunately, this type of organisational work is not typically measured as a key performance outcome for biologists. Your number of git repositories or test coverage for an analysis suite is unlikely to come up in an award nomination or promotion application. And yet, it is entirely crucial as we move toward bigger and more complicated data and analyses - and so I encourage you to take the time to learn anyway. Maybe one day it will be recognised as essential work by the powers that be - but until then, at the very least, it remains essential for anyone wanting to do good reproducible science. And who doesn’t want that?

Final thoughts

So you want to learn to code? Yes - do it, 100%. I honestly couldn’t recommend or encourage it more. But please do so mindfully. If you want to have the best possible chance of integrating this wonderful tool into your scientific ecosystem in the long-term, you have to lay solid foundations and develop sustainable practice/methods.

Have you used any of these techniques as a budding bench-to-bytes biologist? Find me on or head over to the to tell me more!

Resources:

Image credits: Tomwsulcer via & olamishchenko via

Book Review: If I Understood You, Would I Have This Look on My Face?

Sat, 13 Jun 2020 03:57:13 +0000

I know, I know, book reviews are so seventh grade. But I am making a conscious effort not only to read more, but also to actively engage with the media I consume. So, I thought writing down a few tid bits about each of the books I conquer might help me stay accountable and promote some great popular science literature that I think everyone should get around!

Down with the details:

Title: If I understood you, would I have this look on my face? My Adventures in the Art and Science of Relating and Communicating

Author: Alan Alda

Theme: Science Communication

Target audience: Good for everyone, Great for scientists

Overall thoughts:

A vibrant and engaging read that was over in a flash - but not before challenging my view of what it means to tell a story and the importance of communication in everything we do (not just science!)
Alda imparts many gems of wisdom of value for anyone who wants to communicate better - whether you are a scientist sharing your latest research or a partner trying to find a deeper connection with a loved one. In fact, one of the common threads Alda weaves is that in order to engage in effective communication, you must find common ground with your audience. Effective communication is a team effort.
These insights were borne from years of comedic brilliance coupled with dedicated cultivation of the scientific literature investigating method, efficiency and effectiveness of communication. Far from being dry, the narrative glistens with Alda’s characteristic warmth and conversational style making for a truly pleasurable read.
Some of my favourite tips and tricks were “The three rules of three”. To paraphrase:
- When talking to an audience, try to make no more than three points - any more than this are unlikely to stick.
- Try to explain difficult ideas in three different ways - provide your audience with the means to triangulate their way to an understanding, where they can use the conceptual description that most resonates with them
- Find a subtle way to make your ’take-home message’ three times - like a callback in comedy, use this to prompt retention and tie your story together
Overall, this was a fantastic new addition to my fledgeling extracurricular reading activities, and one I cannot recommend enough.

*Some of the best bits:**

… pretty much everybody misunderstands everybody else. Maybe not all the time, and not totally, but just enough to mess everything up.

The person who’s communicating something is responsible for how well the other person follows

- pg 30

… real conversation can’t happen if listening is just my waiting for you to finish talking

- pg 10

Would IQ be the most important factor, or was there some other deciding factor for a team’s success? … average intelligence of a group could not significantly predict the groups performance. - pg 56

- pg 58

Women’s social skills lead in part to better decision making overall and … gender diversity in particular facilitates creatvity

- pg 58

… assuming students are totally responsible for their own motivation … can lead researchers to blame group members for their lack of motivation.

- pg 59

Collaborators in a lab can listen to one another’s ideas, no matter how odd they are, and add constructively to them. … There is a lot of blocking that takes place in science, but Yes And frees ideas to grow

- pg 62

\[When communicating\]
knowing what they are ready to hear is critical, and coming in too early or too late
\[in the story\]
can be confusing

- pg 64

While leadership is important, just as important is how leadership is communicated

- pg 68

Good communication with the person you’re closest to may be the hardest challenge of them all

- pg 77

I value the opinions of people I disagree with. It’s the yin and yang of understanding.

- pg 111

The stereotypical view of empathy is that it makes you soft. On the contrary, when you have to be tough, empathy can be a useful tool.

- pg 125

The reader expects thoughts to be laid out in a certain order, and that effects how the reader reacts.

- pg 135

A couple of emotional words can often turn a recital of the facts into something more engaging that will stick in the mind

- pg 151

Emotion is not a broad-brush amplifier of all things … It doesn’t simply turn up the volume knob. The kind of emotion matters.

- pg 157

Our lives are filled with stories, and yet when we want to communicate something important to us we often forget there’s a story behind it

- pg 163

The trouble with a lecture is that it answers questions that haven’t been asked

- pg 169

In an experiment, you don’t always figure out in the end what you had hoped to figure out. In an experiment, in life, and in a good story, obstacles get in the way

- pg 173

At first it seems nonsensical that knowledge could be a burden, even a curse. The problem, of course, is not in the knowledge itself. The problem is when you can’t imagine what it’s like not to have that knowledge.

- pg 190

Try again. Fail again. Fail better. Those words rest on my desk and remind me almost every day that the ashes of failure can be a place of despair or they can be where the pheonix comes from.

- pg 194

* Please note these are direct quotes from the reviewed material and do not represent independently conceived ideas.

Handy links:

Buy the book
Follow Alan Alda on

Have you read any of Alan Alda’s work, or have another science-adjacent book you can recommend? Find me on or head over to the to tell me more!

Image credits: cover photo

Toolbox Talk: VSCode and Conda

Mon, 13 Apr 2020 07:51:36 +0000

There have been many rapid changes to how, and where, we work as the world settles into a pandemic-induced hibernation. After coming to terms with the fact that many labs could be closed for several months, life scientists around the world are increasingly resolving to make the most of their ‘downtime’. For some, this means upskilling in leading data analysis tools and techniques - and of course, I whole-heartedly encourage this initiative!

In my experience, this often takes two forms - those who use a course to learn and tackle generic coding projects, and the learn-by-doing camp who google as they go and tackle their own projects. I was a bit of both: using a few tutorials to understand the basic concepts and the remainder by going to work on real analysis problems. With that in mind, I thought it might be helpful to share a little about my setup and why a combination approach is useful (maybe even important) for self-taught data detectives.

One of the issues I have with generic online python courses is their often-overly simplistic approach to interpreted development environments (IDE’s) and package management. In my case, I had been dabbling in coding for a year or two before I came across the concept of virtual environments, and it took me another year or two to get comfortable in making, using and deploying these environments. Ditto with version control. Don’t get me wrong - I think it is great that scientists are diving headfirst into coding, and jumping into a course with a simple editor helps you hit the ground running. Unfortunately, this only defers the learning curve - if you are serious about integrating these tools into your workflow a grounding in the most basic of programming hygiene habits is essential. Shortcuts were necessary in days past, as installing and running python could be … cough … tricky for beginners. However, these processes have come along in leaps and bounds - meaning that it is now incredibly simple to get going with a basic python install in an editor that is easily expandable to incorporate, even encourage, basic code hygiene.

You may have come across my previous Toolbox talk about - these were the collection of tools I relied on to manage my coding, from writing to running to environments to version control. However, over the last 12 months, I have migrated to Visual Studio Code (VSCode) and Conda. I might be (a little!) biased, but this is a great place to start for anyone new to coding in python!

Conda: easy environment management

Before we dive into an editor, let’s start with creating and managing virtual environments. If you’re still not sure what virtual environments are and why you might need to use them, check out these great tutorials from and . In essence, virtual environments are essential for keeping your base install of python from becoming littered with packages, many of which might have dependencies that break each other.

Conda solves this problem for python and non-python dependencies alike, and it comes bundled with the ability to install various python versions. In fact, Anaconda and Miniconda have become the most popular Python distributions for data science in research laboratories worldwide. For a more in-depth discussion of these features, and whether you should choose the complete (Anaconda) or lite installation (Miniconda) check out the documentation .

Installating MiniConda

For many purposes, Miniconda is ample and is easy to and install by simply following the prompts. Real Python has an extra-detailed walk-through of the installation and starting your first environment in their fantastic , including creating your first environment and installing packages within that environment.

Once you’ve created your first environment using the conda create --name=my_env command, install the ipython and jupyter packages using the conda install ipython jupyter command. These packages will enable VSCode to locate and use this environment as a python kernel (more on that later!)

VSCode: a full-featured, user-friendly editor

Although technically VS Code is not a dedicated IDE, an abundance of out-of-the-box features supplemented with a few extensions gives you an editor that supports debugging, embedded Git, syntax highlighting, intelligent code completion, snippets, and code refactoring, among an abundance of other features. In short, it is incredibly customisable, user-friendly, language-agnostic, and seamlessly integrates with code hygiene tools to give every budding research software scientist the best start in their programming journey. In case I haven’t convinced you yet, here is a quick run-through from zero to coding hero with VSCode.

Basic installation

Download install VSCode for your operating system . Once installed, VSCode will open to the Welcome Screen. This is a great place to get familiar with VSCode functionality,including a number of helpful customisation portals (helloooo colour themes and keybindings!). For first-time users, your first stop should be the interactive playground. This window walks through some of the key features of VSCode and gets you started moving around the editor.

Getting started

The next stop is the Extensions tab, which is your gateway to much of VSCode’s fabulous functionality. You can explore the offerings and pick your favourites (there are extensions for almost anything you could want to do!), but the one must-have for our purposes is the Python extension.

python-extension

After installation, open the command palette using ctrl-shift-p and search for settings. In the settings search box, type “python” then scroll through the settings until you find the Python > Data Science: Send Selection to Interactive Window and make sure this setting is ticked. After this, you’re good to go!

python-setting

Piecing it all together: using your conda environment in VSCode

Now let’s get to work running your first python script in VSCode with your brand new environment! If you don’t have an existing python file to test out, not to worry we can make one!

Open a new file within VSCode, and save with a .py extension.
Inside the file, add the following line:
print(“Hello World”)
Save the file, then place the cursor in the ‘print’ line.

You should see in the bottom left corner of the editor that there is a python version displayed, followed by the name of your current environment. This will likely be the ‘base’ environment to start with. If you click on the environment name, then you should be able to select your new environment from the pop-up list. This will then be used to run the code selection.

To run your code within the built in interactive window, highlight the line and shift+enter

This will send the code to the interactive interpreter, which will open in a new tab within the VSCode window. The kernel may take a little while to start in the first instance, but you should see the Jupyter server details listed in the top right corner - note that it should be the name of your environment. Once it has run, it will look something like this:

hello-world

That’s it! You are all set to run python files for exploratory data analysis in VSCode.

Favourite features

Now we have mastered the basics, you have enough to get going with python in VSCode. A few features that make VSCode my one-stop-shop for all my coding adventures and beyond include:

The python extension itself! It is an evolving masterpiece - huge shout-out to the creators and maintainers - with a multitude of features packed within the interactive window that, frankly, could occupy a post on their own. Highlights include the variable explorer, ability to save the current state of the interactive window directly to a Jupyter notebook, and the ability to render a Jupyter notebook in a standalone tab where you can edit and run code cells without spawning a browser window.

The second important, must-use feature is version control. If you haven’t incorporated version control into your workflow yet, or aren’t familiar with it, you can read more . In short, even if you have never written a single line of code in your life, version control is a must for anyone routinely creating and editing documents of any kind. And the best news is, VSCode makes it only too easy! You can create repositories, then stage and commit changes from right there in the version control tab. More advanced functionality is also available in the extension.

Another handy feature is the ability to launch a command-line terminal within VSCode. This can be done via the “Terminal” menu, or keyboard shortcut ctrl+shift+` . As a bonus, if you have an active conda environment, this command will launch a conda terminal with the conda environment pre-activate on the command line. This makes it easy to install new packages and create new environments right from within the editor.

Last but certainly not least is the dynamic documentation display for functions derived from imported packages. For example, when using a the pandas melt function, typing pd.melt() prompts a popup which contains the function definition and variable explanation. This means no more googling docs to check that you have set all the required arguments!

VSCode also features all the best bits of Atom, like being able to set the colour theme and change the layout of windows, and a built-in debugger window that allows you to investigate the state of variable and monitor breakpoints in your code. The more you use and explore, the more functions you will undoubtedly find that make your life better. However, here are a few more of my favourites for inspiration:

Collaboration: (think googledocs for code)
Text functionality: , ,
Coding cheats: , ,
Prettifying the editor: , ,
Preview functionality: ,

Some final thoughts

I’ve gone through a number of IDE’s since my coding journey began. As a general rule, IDE’s suit my style of work better than command-line activities and the ability to run and interact with code and plots in short succession is essential for this. However, a good programmer needs at least some level of experience with the command line, so try not to avoid it! Luckily, VSCode makes transitioning between the command line and interactive windows so easy that there really is no excuse.

When picking an editor, getting comfortable with a single system setup can make it difficult to leap into something new - especially with the time and effort investment required to get everything customised and functional for how you work best. However, it is worthwhile keeping in mind that where the field moves as a whole is often where the greatest level of innovation will be (extensions, support etc). It is good to keep an eye on what the ’next big thing’ is, but don’t be afraid to wait it out until you are happy with the level of stability and usefulness to make the tradeoff worthwhile.

Last but certainly not least, don’t worry if there were parts of this post that sounded like mumbo-jumbo: everyone is at different stages in their coding journey. One idea I hope I have instilled is that VSCode caters to all skill levels, from the ease of installation and setup to the massive extensibility provided by the extension marketplace. In short, VSCode ticks all of my must-have boxes for an editor and I thoroughly recommend you try it out!

Do you have a favourite IDE for editing python code? Having trouble getting started in VSCode? Or maybe you tried VSCode and found it doesn’t quite suit? Get in touch via the or on - I’d love to hear about your experiences!

Image credits: via unsplash

Toolbox Talk: Scientific posters

Tue, 30 Jul 2019 10:39:57 +0000

Going to a large, often international, conference jam-packed with superstars in your field is one of the privileges of being a scientist. Conferences are essential for building your network, keeping up-to-date with the progress inside your niche and more broadly in your field, and establishing or maintaining collaborations. If you’d like to know more about my conference experiences, check out . I was lucky enough to attend and present short talks at a few conferences in 2017, and it was a wonderful opportunity to show the scientific community what I have been working on.

However, there are only so many oral presenter slots available at such events, and often these are used by the organising committee to highlight the very best and newest science. But what about the rest of us? It can be really difficult to get the most out of a conference, especially as a student, if you don’t have an opportunity to showcase your work. Enter: poster presentations.

Wait, like in elementary school?

If you are thinking of a giant piece of butcher’s paper, covered with scribbles in multi-coloured permanent markers, you aren’t too far wrong. But things have evolved a little since the school days, and we do have slightly more developed tools for displaying our work these days. Unfortunately, making an engaging scientific poster is often not something we are formally prepared for during our scientific training. We are being moulded into the next generation of scientists, after all - what no one tells you is that artist is just one of the many additional hats that you will wear often as your career progresses.

With this in mind, I thought I would share a little about my process and tools for making an engaging poster. It is by no means a one-stop-shop, as every time I make a new poster I learn a little more about the process, but hopefully, you will find something useful as you prepare for that next science-filled conference adventure.

Tools

There are plenty of purpose-built design software packages out there specifically for making commercial posters, and some even targetted at producing scientific visuals. I have included a few links in the additional resources, but to be honest, I have had mixed success with these - if you find any that I have missed or that you’ve found particularly helpful to let me know!

In the meantime, I have settled on a combination of a freely-available vector graphics program (Inkscape) for compiling individual panels into standalone figures and presentation software (e.g. or ) for the overall poster design. If you haven’t heard of vector graphics programs before, or are unsure why you might want to use one, you can read more . In essence, because of the way they are constructed, vector graphics are easy to manipulate and can be scaled indefinitely without losing their quality as they are not composed of pixels, in contrast to the raster-based file types jpeg and png.

For data-laden figure panels, I will usually stick with python or (if you are interested in this, check out some of my other toolbox posts ). For any work dealing with protein structure, is your friend. The learning curve can be quite steep (I am only just now mastering the basics of opening a structure file, editing the colours and changing the display type from ball and stick to ribbon!) but it is relatively easy to produce a striking visual that will aid in any handwavy descriptions of a protein’s structure. Keep an eye out for my beginner’s basic guide to PyMol in a future Toolbox Talk!

Last, but definitely not least, I use a to create a link to this website. Even if the name is not familiar, I am sure that you would have come across in the wild before - they are a type of matrix barcode that links to a website or application when scanned with a smartphone camera. There are plenty of free online platforms for creating your own QR codes, and many that give you the ability to adjust the shape and colour of the individual elements, however be careful to know the difference between static (meaning you have no flexibility to adjust where the link directs after printing) or dynamic (that contain an automatic redirect which you can adjust after printing) to make sure you get one that suits your particular needs. I have found this especially handy for posters - by encoding your contact details or link to your website, it is easy for conference attendees to get in touch without having to hastily scribble down your email on their crumbled napkin.

Techniques and tips

Even the most exciting and life-changing data can find itself on a poor poster. There are many unwritten (and written) rules for making an engaging and eye-catching scientific poster, and many more experienced people than I have written guidelines and tips, some of which you can find in the resources section below. In any case, I thought I would throw in a few of my trusty tips here:

Layouts should be simple and easy to follow. I find that creating boxes to guide the reader through the poster in a logical fashion can be helpful. Remember a poster is about walking someone through your science and stories that jump backwards and forwards can make it hard to stay engaged. As a general rule, try not to require your audience to do too many optical gymnastics to follow the narrative of your science. When creating a new poster from scratch, I like to sketch out the layout, brief text tidbits and figure ideas by hand in A4 format to help get a handle on what data I need to track down and figures I need to produce. I also find drafting this initial layout in A4 size helps to keep my final poster from getting too overcrowded.
Find SVG versions of logos for the institutes that contributed to the work. It is good practice to acknowledge the financial support any project receives, and posters are no exception. In practice, I typically will have anywhere from 1 - 3 logos on my poster and any additional smaller contributions can be acknowledged in the text if you feel it is necessary. I will always find SVG versions of the logos, such that they can be edited and resized without losing any quality. Generally, you will be able to access these from your University brand team, or a quick google search with an advanced filter to find SVGs works well too.

Never underestimate the power of a good colour scheme. There is nothing worse than a poster that looks more like a rainbow kaleidoscope than a scientific document. Try to steer clear of elaborate colour schemes, and away from anything too light or bright. Also, keep in mind that picking a simple colour scheme to use throughout the entire poster (e.g. one type of sample is the same colour in all panels) helps to provide continuity for your reader. For those who are colour-coordinator challenged, a quick google search for colour palettes will provide all the inspiration you need.

Remember the power of size, shape and colour for drawing attention. With the limited time and large amount of information available at poster sessions, conveying the most important points from your work is crucial. Using accent colours, bold fonts or larger sizes can help to draw your reader’s eye to the key aspects of your work, and hopefully prompt them to ask more about the details!
Consistency is key. A poster, aside from displaying scientific results and information, is at the end of the day a piece of art. As with any beautiful artwork, the little things matter! Use the handy aligning and specific dimension setting functions in powerpoint to make sure everything is balanced and consistent. Check that the text sizes, fonts, line widths etc are identical throughout your poster, especially for things like headers and panel outlines. There will always be one or two typos that sneak past you, but it’s also a good idea do several final read-throughs to check for typos - once your masterpiece is printed, there is no turning back!
Print smaller versions for proofing. Printing an A4 version of your poster is a great way to check for readability and those last-minute alignment or spelling errors. As a general rule, anything that is not readable in this format will not become more-so simply by being printed bigger - remember you want to be able to engage your visitors in conversation, not have them glueing their nose to your poster trying to make out the details!
PDF is your friend. Particularly if you include transparent artwork or special characters, it is good practice to export your poster from powerpoint to PDF before submitting for printing. There are also a few tricks with powerpoint to ensure the quality is maximal, which can be found in the ‘Options’ menu of the dialogue box during export.
Be prepared to print early. Some institutions have their own print services, and these can be a cost-effective way to have your poster printed. I have a lot of experience with Officeworks and have generally been thrilled with their service, although I would recommend visiting a store in person to submit and collect your poster. They will generally give you a test print which is handy to make sure your creation survived the file format change. Regardless of which route you choose, plan to have your poster finalised and printed several days before departure - this way you will have a few days up your sleeve to handle the inevitable curve-balls!

Useful resources

from Animate Your Science has some straightforward tips for layout and content. I will admit to disobeying a few of their “rules” but generally great advice!
Toolbox talk on and the

Did I miss your favourite tool or technique? Find me on or head over to the to tell me more!

Image credits: codytdavis, greyritualstudio, alecuffia and arterbury via

Toolbox Talk: Storing data using HDF5 files

Sun, 28 Apr 2019 05:43:45 +0000

As an early-career researcher, I am still figuring out the best way to get stuff done. Every day it seems as though my to-do list gets longer and longer, for every item I tick off two more take its place and I have no doubt it will only get worse. I am all about finding the best, most efficient and connected technologies to help alleviate some unnecessary legwork. I have decided to write more on the programs, apps and integrations that I use every day in this Toolbox series. This post focuses on how I store and organise the currency of science: big data!

Data: the invisible bits and bytes of modern life.

Data is an invisible and yet fundamental driver of our digital life in 2019, and the amount of data worldwide is growing every single day. In fact, the International Data Corporation (IDC) estimates the amount of data in the world will grow from an estimated 33 zettabytes (one zettabyte is equivalent to a trillion gigabytes) in 2018 to 175 zettabytes by 2025, an almost unfathomable amount of bits and bytes. Every industry is grappling with the growing mountain of data, and science is no different. Scientists use data as the fuel that powers insight, discovery, and innovation. This demands new infrastructure from the institutes in which we gather data; but it also demands new approaches to the way we as scientists collect, store and analyse data.

During the first five years of my university career, everything I needed for my degree fit safely on a single 16 GB USB stick. Then I went and learnt how to do single-molecule microscopy during the second year of my PhD, and suddenly I was generating 16 GB of data in a single experiment. To cope with this rapid explosion, I invested in the hardware needed to store this data as text or csv files and stumbled my way through establishing a folder-based filing system.

It was during this stint early in my PhD that I first got a taste of programming to deal with this data (for more, check out some of my other programming posts ), however, this still centred on csv/text files for importing data, calculating results, and exporting the final findings. This meant that the data along the way, including input, intermediate and final files, could still be opened by easily-human-readable programs such as Microsoft Excel, and kept supervisors/collaborators without programming experience comfortable.

Recently, this storage pattern was no longer adequate for the size of results I was dealing with. Enter: HDF5 format. If you’ve never heard of this format before, it’s somewhat similar to an Excel document, without the proprietary software tag. Read on for more about what it is, why it’s useful for those dealing with large datasets and how I implemented a storage workflow in HDF5 format using python.

What on earth is HDF5?

Heirarchical Data Format (HDF) is a collection of file formats designed to store large amounts of data in an organised manner. Similar to the way .txt refers to text files or .pdf refers to Portable Document Format files, HDF files are adorned with .hdf, .hdf5, .h5 style extensions. The ongoing development and accessibility of the HDF file format is maintained by the non-profit organisation “The HDF Group”, meaning the tools to store and use HDF files will never rely on proprietary (and often expensive!) software.

More specifically, HDF5 files consist of Datasets that can store arrays of data (think individual sheets in an Excel document), Groups which can store datasets or other groups (think a folder of Excel documents, or folders of folders), and metadata consisting of mapped key-value pairs for attributes of the data (think a detailed description notes page for each sheet/document).

Pros and Cons of the HDF5 format

As with anything, there are good bits and bad bytes about using HDF5 to store data.

Some of the Cons:

Unable to easily open HDF5 with excel or notepad (although there are some being developed that could help overcome this)
No inbuilt calculation or manipulation options
Not readily used by many researchers in the life sciences, including many senior researchers making it difficult to share data with collaborators unfamiliar with the format

A few of the Pros:

Heirarchical format allows for logically storing data in a single file with folder-like architechture
Allows pre-processed data, such as date-time data, to be stored efficiently without loosing the effect of preprocessing (as would otherwise happen in .csv format)
Fast. Compared to other file formats, reading and writing HDF5 files is speedy. For example, writing to HDF5 is 16 times faster than to simple csv file, not to mention the extra overhead that comes from Excel documents. For a comparison to other common formats, check out the
Storing metadata within the file architechture makes sure that these attributes are accessible to anyone wanting/needing to access this data at a later date, and doesn’t rely on the bundling of additional “description” files to make sense of all the parameters and conditions under which the data was collected.
There are advanced options to create datasets that can be edited (rows added etc), and those that are read-only. This is provides an extra level of flexibility that allows, for example, intermediate datasets to be appended to making sure the raw data is not inadvertantly changed.

Sounds great.. But how do I use HDF5 files?

If you have no experience with programming, to get started you can download , which is freeware available from the HDF Group that will allow you to open and edit HDF5 files. In the interest of full disclosure, I have never used this software but it seems to work similarly to graphical user interfaces like Excel (without the price tag!).

If you have a programming language of choice, chances are there are - my tool of choice is of course Python! Even within python, however, there are a few choices for how to interface with the HDF5 machinery. Given that I use Pandas most often for data wrangling, it makes sense to leverage Pandas’ built in support. This includes methods that allows dataframes to be written to directly to HDF5 files using a method provided by the dataframe itself:

df = pd.DataFrame({'A': [1, 2, 3], 'B': [4, 5, 6]}, index=['a', 'b', 'c'])
df.to_hdf('data_filename.h5', key='Key_1', mode='w')

This method also allows another object to be written to the same file, with a second key ’s':

s = pd.Series([1, 2, 3, 4])
s.to_hdf('data_filename.h5', key='Key_2')

In this case, the heirarchy is quite simple: two datasets are stored under the single file. To get your data back, it is simple to then read back into a dataframe:

new_df = pd.read_hdf('data_filename.h5', 'Key_1')

For storing multiple files in this manner (i.e. using key-dataframe pairs), I have created a utility function using the HDFStore module (another interface provided by Pandas) that collects dataframes that have been loaded into a dictionary, then saves them to a single HDF5 file:

def dict_to_h5(filename, dictionary, **kwargs):
 store = pd.HDFStore(filename)
 for key, df in dictionary.items():
 store.put(key, df)
 store.get_storer(key).attrs.metadata = kwargs
 store.close()

NB: using the HDFStore in Pandas requires PyTables v3.0.0 or higher. To update your existing Tables installation run the ``pip install –upgrade tables``` command in your terminal.

These are both simple examples in which there is a ‘flat’ data storage pattern. This is great for storing a few large dataframes, or sequentially processed intermediate dataframes for a single result. In most cases, however, you will find it useful to introduce an additional level of hierarchical organisation similar to the folder storage system we are familiar with from OS interfaces. To do this, the keys should have a file-path structure which lists the group hierarchy that the dataset is to be added to. For example:

hdf =HDFStore('storage.h5')
hdf.put('tables/t1',DataFrame(np.random.rand(20,5)))
hdf.put('tables/t2',DataFrame(np.random.rand(10,3)))
hdf.put('new_tables/t1',DataFrame(np.random.rand(15,2)))

This will yeild the following data structure within the single HDF5 file:

/new_tables/t1 frame (shape->[15,2])
/tables/t1 frame (shape->[20,5])
/tables/t2 frame (shape->[10,3])

Python also has other packages specifically for HDF5 manipulation, which have a few more specialised tools. If you’d like to know more about these packages, or how to generate more complicated heirarchies, check out the list of resources below.

A few final thoughts.

Data is a part of life as a scientist, and as life scientists we must strive for better, more versatile approaches to storing and handling the ever-growing datasets produced by our experiments. For me, HDF5 has provided a simple and elegant way to interface with my data. It allows me to store raw and computationally-expensive intermediate ‘checkpoints’, and also means that I can maintain a single HDF5 file that combines data and metadata in a single place. The barrier to entry is quite low, and there are plenty of versatile ways to access data stored in HDF format.

Resources

A to HDF5 with Pandas
You can find additional utitility functions that make it simple to create and store HDF5 files for my projects in my package on GitHub.
For more complicated heirarchies, check out
Some other Python HDF utilities include , for which there are some great on how to generate structured heirarchies.

Do you have a favourite way to store, access and manipulate large datasets? Get in touch on and let me know!

Banner image credit: @ gabons via unsplash

A year in review: 2018 edition

Tue, 15 Jan 2019 09:52:30 +0000

The last few weeks have seen a flood of people posting their 2018 achievements, promoting the academic currency of papers published, grants won, students mentored and conferences attended.

Without taking away from these achievements, I wanted to focus on viewing myself as more than my work, and especially more than the ‘publish or perish’-driven manuscript list. And so, here lives my reflection on the year that was. Lessons remain a crucial part; after all,

“If a man looks at the world when he is 50 the same way he looked at it when he was 20 and it hasn’t changed, then he has wasted 30 years of his life,”

Muhamed Ali

Of course, I would be remiss not to celebrate the high points - but I have tried to temper the ‘gloating’ with a few honest low points. Finally, I take a look to the future. By defining goals which will drive my personal and professional life in 2019, I hope to kick off a fulfilling and smooth-sailing year with the course charted and the wind in my sails.

Wins

A snapshot of the high points

I received my first personal scientific project funding through an Early-Career Researcher Grant
I had four papers published, including the last of my PhD research, and landed travel funds for an international conference
I was priviledged to give too many conference presentations to count (Lornes, ABS-ABA, Winter School..)
I developed and grew this page, with 20 blog posts including tools, conference reviews, book reviews and scicomm
I produced hundreds (maybe thousands?) of lines of brand new code - but more importantly, saw a significant improvement in my ability and confidence when programming which has allowed me to assist others
I attended my first PyLadies meetup, where I met people like me (in science, learning python independently) and some less like me (employed full time in programming or data analysis positions)
I developed closer relationships with family and friends, as I worked harder to maintain and build these ties
I read two more books than last year
I consistently, regularly exercised, losing 15 kilograms
I hit a saving milestone and we bought a house

Losses

A snapier shot of the low points

I worked for two months on experiments that were to resuscitate one of my major projects
I’m now left with no papers in the pipeline, leaving lots for the year ahead to wrap up these projects
My coding projects are in somewhat of a state of disarray, in desperate need of a tidy and some documentation
I only read 2 books, and put 8 kilograms back on
I spent more than 50 hours writing six grants, all of which were unsuccessful
I was quick to judge others and less approachable than I would like to be, letting my stress seep to the outside
We unbought a hous

Lessons

The bits I wish I knew at the start of 2018, but had to learn the hard way

Have the hard conversations - with your boss, your partner, yourself
Self-care is about what you need - not what everyone else’s definition of rest and relaxation tells them (and they, therefore, tell you) you should be doing
“There are less qualified people than you doing what you want to do, just because they decided to believe in themselves. Period.”
Make a positivity folder and actively collect the warm fuzzy moments: emails, photos, messages, compliments, congratulations…
If you want to do something, really want to, then make time. Do it. No one else is going to do it for you, and your schedule will not magically clear. Life is never going to get less hectic or stressful.
Every day, hour, minute you spend wishing your way to the next thing (job, house, friend, partner) you will equally spend wishing you had taken the time to value what you had, to revel in it.
Prioritise, prioritise, prioritise

Goals

Hopefully to help me meander with purpose through 2019

It might be a little meta, but a big goal of mine this year is to learn to set SMART goals. Not so much “new years resolutions” - but personal and professional goals that I would like to work towards every day.
If you’ve never heard of the SMART goal concept, you can find a more detailed description , but in a nutshell SMART goals are:
- S - specific, significant, stretching
- M - measurable, meaningful, motivational
- A - agreed upon, attainable, achievable, acceptable, action-oriented
- R - realistic, relevant, reasonable, rewarding, results-oriented
- T - time-based, time-bound, timely, tangible, trackable
With this in mind, I have the following goals for 2019:
- Yoga at least two days in a fortnite during 2019. A flexible body -> flexible mind -> clarity of ideas, increased alertness and engagement with the task at hand. I would like to be able to better calm my mind when distraction threatens. I will track this goal via a calendar which records each session.
- Land the next job - be strong enough to throw myself into the applications and let go of the guilt of not chasing (limited) Australian funds. This will be measured via my application for at least 3 more Fellowship programs.
- Attitude adjustment - I will track this goal via weekly mini-reflections, where I will focus on (1) Learning to take control of what is within my reach, and to more rapidly accept that which is outside my control and move on, (2) Doing one self-positive task per day - learning, physical activity, kindness, and (3) Fostering self belief to replace self doubt, in personal relationships, professional settings and long-term career prospects
- Prioritise, prioritise, prioritise!

And with that, it’s time to say sayonara 2018 - bring on 2019.

May science be kind to you!

Image credit: @brookelark via

Toolbox talk: Atom, Jupyter and Hydrogen

Sun, 23 Sep 2018 11:47:32 +0000

As an early-career researcher, I am still figuring out the best way to get stuff done. Every day it seems like my to-do list gets longer and longer, for every item I tick off two more take its place and I have no doubt it will only get worse. I am all about finding the best, most efficient and connected technologies to help alleviate some unnecessary legwork. I have decided to write more on the programs, apps and integrations that I use every day in this Toolbox series. This post focuses on what is currently the best (in my humble opinion) hackable text editor for writing, programming and data analysis: Atom!

The basics: Atom as a building block.

Billed as the “hackable text editor for the 21st Century”, is a free, open-source, cross-platform desktop application for editing plain text and source code. While the base program was developed by GitHub, many of best functionalities are community built and maintained under free liscences. This combination of core support and extensibility has resulted in an unparalleled level of customisability, and makes Atom my editor of choice for everything from simple text documents, to data analysis to developing python packages. For coders and non-coders alike, there is something for everyone in the Atom ecosystem.

From an aesthetic point of view, Atom has a nice panelled interface which can be extended at will. Below you can see a standard layout I gravitate towards while I am analysing data. The leftmost pane (the file tree) allows you to open an entire folder or folder tree to easily see all of the files associated with the project you are currently working on, complete with coloured file-type icons for easy visual grepping. In addition, I can have multiple panes open side-by-side which allows me to operate on code/data in one building and document the analysis approach in the second. Finally, to the right is the output/Git pane (more on that later).

An example analysis layout in Atom.

Atom also has a vast array of installable themes to customise the window colour and aesthetic. I myself am partial to a dark theme, with a subdued syntax highlighting (check out the OneDark theme). If you prefer a more traditional light theme, there are plenty of those too!

The best bits: Git(Hub), Integrated Development Environment and Real-time Collaboration functionality

Being built by GitHub, it is fair to expect some level of integration with Git. If you’re not yet familiar with Git, or version control in general, you can read more about it . In short, even if you have never written a single line of code in your life, version control is a must for anyone routinely creating and editing documents of any kind. For now, suffice to say that Git has traditionally been a command-line tool and therefore mildly intimidating to those of us who found it with little experience. Recently, GitHub introduced a which alleviates some of the hassles of interacting with Git via the command line. However, Atom takes this functionality and seamlessly integrates it within the environment where the work is being done. No longer do I need to switch windows to another app or terminal - I can immediately see the documents that have detected changes, stage and commit those changes and push to GitHub from within Atom. More than this, Atom allows you to create and change branches, and push/fetch/pull from remote repositories all without ever having to change windows.

One of the reasons I came to it in the first place was the flexibililty to create an Integrated Development Environment (IDE) for any programming language. An IDE typically provides comprehensive facilities to edit, build and debug source code for a given language. Atom has taken on this task to provide support for a long long list of the most popular languages. This is achieved via installation of community-driven packages - more on this in a little bit.

Finally, Atom provides an interface for real-time collaborative coding. While I am yet to test this functionality, Atom’s “Teletype” promises the ability for users to share their workspace with team members and collaborate on code in real time using a shared portal. If you have used this feature, be sure to let me know how you find it!

Easy extensions: Size may not matter, but it’s all about the package(s)

They don’t call Atom the most hackable text editor for nothing! Although the Git interface is packaged as part of the raw Atom install, many of the other features I’ve already described rely on the installation of community developed and maintained packages. The variety and functionality of these packages is seemingly endless, and installing a new package is as simple as opening the settings view and searching for the package. No matter what language you intend to use Atom for (or even just for general editing of plain text or markdown documents), there are bound to be a few packages that will make life easier.

Given Atom is agnotistic to language, there are plenty of packages for common languages like R, Java, C #…. If any of these is your language of choice, I encourage you to poke around online and see what packages people recommend. For the remainder of this post, I will focus on how I set up Atom as a home for my Python development and data analysis.

Accessorising Atom: a Python perspective

When first learning python, I used Spyder as my development environment. After a while, I got itchy feet and investigated Sublime (another text editor) and was intrigued by it’s customisability. After a brief stint, it wasn’t long before I discovered Atom and, as they say, the rest is history! There are plenty of generic “how-to-set-up-Atom-for-Python” articles (you can find examples and ), so I won’t spend too much time rehashing these here. Suffice to say, there are a few basic packages you will want to install to get the most out of Atom for your python projects. A few examples include:

Perhaps my favourite aspect of Atom (and in fact the reason I know recommend it to everyone I help get started with python) is the easy integration with Jupyter. If you haven’t come across Jupyter yet, Jupyter Notebooks provide an open-source web application that allows you to create and share documents that contain live code, equations, visualizations and narrative text in a whole host of languages. Notebooks support over 40 programming languages at the time of writing, including Python, R, Julia….This is managed through the installation of different , and if you are keen to run additional languages then check out how to access different kernels . In the case of python, IPython is the central dependency of Jupyter and thus is preinstalled. Jupyter Notebooks are in and of themselves a great environment for data cleaning and transformation, numerical simulation, statistical modelling, data visualization and much more. However, they require the analysis, version control and file management to be completed in different locations (other windows, apps, etc). Enter . This neat package brings all the functionality of Jupyter notebooks (documentation, in-line plotting and results etc) to your atom environment using the installed kernels. In my opinion, this is a must have for someone getting started with Python in Atom. To get started, follow the installation guide . As a bonus, is an extension package providing variable exploration in beta. If this is an IDE feature you cannot live without, check it out!

Better than basics: integrating python virtual environments

Similar to Git, using virtual environments with Python (despite being important best practice!) can be extremely intimidating for a newbie. Again, having to make and activate virtual environments via the terminal, and keep track of potential leftmost to use, set the bar above what I could digest and integrate into my workflow initially. Without this essential tool, my base install of python became littered with packages, many of which had dependencies that broke other packages. And don’t even get me started on the nightmare that was needing a safe install of both Python 2 and Python 3 for different projects!

Eventually, I got my act together and installed both and . If you need a little more advice, check out these great tutorials from and . For a little while, I was content that I could activate different environments if I desperately needed to - but was not overly inclined to use them on a regular basis! That was until I found the Atom package specifically designed to integrate this functionality: . This package lets you activate different virtual environments from within Atom, and combined with Hydrogen’s kernel manageraesthetic can have complete control of the python environment within which you are trying to run code!

Conclusions

Atom is a great multipurpose ecosystem with huge extensibility to tackle common tasks, both for general text documents and coding projects. There is support in the form of community developed packages, and complete customisability. By combining a few of these packages, it is possible to build a friendly development/analysis environment for those new to coding, or seasoned veterans alike, which encourages best practices at every turn.

That’s all from me for now - happy coding!

Toolbox talk: Trello

Thu, 30 Aug 2018 12:34:06 +0000

As an early-career researcher, I am still figuring out the best way to get stuff done. Every day it seems like my to-do list gets longer and longer, for every item I tick off two more take its place and I have no doubt it will only get worse. I am all about finding the best, most efficient and connected technologies to help alleviate some unnecessary legwork. After my first , I have decided to write more on the programs, apps and integrations that I use every day starting with one of the newest additions: Trello!

The basics: What the Tr-hell-o is all the fuss about??

Trello is fundamentally a project management application with a simple but sophisticated hierarchical interface consisting of boards, lists and cards. Trello thrives in settings suited to organisation. In the context of Trello, kanban is most often laid out as three stages (lists) - to-do, doing, done - and each element (or card) of a project (board) is represented within a list according to its state of completion. Elements progress through each list, giving a simple, visual overview of the project’s overall state.

This style works well when you work alone on individual projects - but it is also something you could easily accomplish with a chalkboard and some post-it notes. Where Trello really comes into its own is the ability to share and collaborate, such that individual tasks can be assigned to different people, comments can be added to cards specific for that task, and everyone can know at a glance the current big picture.

Trello is free (for the basic version, which is all I have needed thus far!), and accessible via the web interface, PC and iOS apps. It also integrates with all manner of other productivity apps, including GoogleDrive, GitHub, Dropbox, Slack, Evernote, OneDrive… Together, these features enrich the functionality of boards, providing a kind of dashboard from which to tackle projects and giving unparalleled flexibility for teams with diverse computing and file storage preferences.

Trello in action: managing your research projects

First things first: keeping track of experiments. There are many many electronic lab notebooks currently on the market, and I have tried more than my fair share. If you are not stuck in your ways (like I am) I highly recommend shopping around and picking one that you can integrate into your work as soon as possible. Unfortunately, I am a control freak and I am yet to find one that fits seamlessly with my workflow, and so I have resorted to building my own system using Trello!

The basic elements include lists for Ideas, Planned experiments, Lab work in progress, Analysis in progress, Ready to writeup, and Complete. Each new experiment or idea gets a card, for which I quickly note the purpose, reagents to be used, techniques and instrument details, and any pertinent references in the description. I then link this card (using the GoogleDrive powerup) to the folder containing the full experimental plan, results, analysis and write-up. The card then gets moved across the columns (lists) as each stage of the experiment is completed. For similar types of experiments, I have a checklist that allows me to easily track specific small elements of the experiment (e.g. plating cells, collecting results etc). If I complete a particular action for the experiment, I will also note in the comments any details specifically about that action. These comments are date and time stamped, helping to keep track of my activity on a day-to-day basis.

Another awesome Trello feature is the ability to label cards with a customisable category, which appears as a coloured bar on the front of the card. I use this feature here to label experiments with which one of my (many) projects it is specifically associated with.

This brings me to my second board - my project board. This is a board with which I track all of the ongoing projects I am involved in. There are lists for my individual projects (think: first author work), students projects I am involved with, collaborators projects, and ideas to keep in mind. The cards on each of these lists refer to a specific project, which can then also link to another Trello board or card which contains information, ideas and important references specifically for that project. That’s right baby, it’s Trello-ception!

Along similar lines, I have a board for manuscripts which tracks each manuscript I am involved in (cards) as they progress from the first draft to submission to revision to (if I’m lucky!) acceptance. In this case, labels are assigned to indicate my author position, and whether my contribution is required to move the article to the next stage. Individual cards link to additional Trello boards for each manuscript (normally only those for which I am the first author) where I can store more detailed information and ideas, tasks etc in a kanban layout.

By starring the top-level boards for Projects, Manuscripts and my Virtual Lab Book (starring is an inbuilt Trello function that allows you to favourite boards to be displayed at the top of your home page) I can easily get an overview of current progress, then by clicking a specific project or manuscript card I am automatically linked to all the more specific information I might need when working on that project, article or experiment.

The bigger picture: managing your science

When I first started with Trello, the ability to modularly (and very visually) manage and monitor my projects was a great tool. Since then, I have expanded my use of Trello boards to include the peripherals necessary for managing life as an ECR. Things like how to prioritise your workload, manage your short-term and long-term goals and keep on top of your reading list all become easier using Trello. My most recent addition was a prioritisation board, based on the priorities list shared by Corey J. A. Bradshaw in his amazing book “The Effective Scientist” (stay tuned for a book review - I really cannot recommend this book highly enough!). In short, Bradshaw runs through an exemplary list of how to prioritise the many competing interests vying for the time of an academic to get the maximum bang-for-your-buck in terms of career returns. These include things like writing articles, doing experiments (duh), helping students and colleagues, social media and writing grants.

When I first filled in all of the elements of the board, I realised just how unbalanced I have been in allocating time to each of these aspects. It was a great way to put into perspective where I should be spending the majority of my time and revisiting this structured big-picture priority list once a fortnight has helped refocus my research output.

Resources

That’s enough from me for now - if I have convinced you to give Trello a go, there are a couple of handy links below. I have included template examples for each of the board types that I mentioned above: feel free to use, abuse, copy and manipulate them to fit your own workflow, I honestly believe one of the best assets of Trello is it’s customisability - so don’t be afraid to make it your own. Just be sure to let me know if you find it helpful!

Template boards:

Additional info (from those who’ve said it better than me!):

Happy organising!

Image credit: @sidneyperryphotography via @unsplash

a weekend walk around the Bokeh library

Sun, 13 May 2018 11:13:53 +0000

If you’ve read my , you will know that I (somewhat arrogantly) consider myself “a passionate advocate for the use of programming by life scientists”. This came about following my Cambridge trip during my doctoral degree, in which I began to code analysis programs to derive meaning from the large (tens of gigabyte) datasets that we were collecting on a daily basis. At the time, I first learnt IgorPro - a proprietary language used by the other members of my host lab. While it was a steep learning curve, I was hooked. The power of being able to analyse huge reams of data without a single copy-paste-formula manouver normally completed in spreadsheets? Sign me up! Take out the human error of transferring data from program to program (Excel, GraphPad…) to achieve a result? Tell me more!

After my initial introduction, I quickly went in search of a more versatile language to learn. I disliked the feeling of being locked into the facilities provided within the commercial platform, and was tired of not being able to easily find support for this program online. And so, I met Python. And boy, did we hit it off! Python is easily the most friendly programming language I have come across, it is versatile and open source, the community is amazingly friendly, and I am yet to come across a problem I can’t solve via a quick trip to StackOverflow (seriously, where would I be without you guys?).

Little by little, I have worked on building my skills and I learn a little more each day. For a while now I have been comfortable writing small scripts that assist in my data analysis and plotting needs. However, I was yet to venture into the world of interactive plotting. I have always been intrigued by all of the different ways we can visualise data, and believe interactive plotting is a great way to allow both myself and someone else to explore a dataset. With this in mind, I set out this weekend to explore an interactive plotting library in python - Bokeh.

“Bokeh is an interactive visualization library that targets modern web browsers for presentation… Bokeh can help anyone who would like to quickly and easily create interactive plots, dashboards, and data applications.”

Sounds pretty good right? So, I gave it a go. As a test dataset, I decided to recreate the scatter plot from a published by our group for which the supplementary data is readily available. This plot displays the proteins whose cysteine residues significantly changed their reactivity following treatment with the drug Tunicamycin (an inducer of endoplasmic reticulum stress). Below you can find my version of Figure 6b, constructed as it is displayed in the article using Excel and GraphPad.

To recreate this plot in python, I took the raw data and constructed the scatter plot, colouring each datapoint according to the level of significance (as determined by the p-value). I also mapped the gene names associated with each datapoint via the UniProt API (a second learning exercise for this weekend!). This provides a second layer of data which I used to create the interactive feature of the graph - instead of displaying static names for only a few of the genes (which is limited by the need to not overcrowd the plotting area), gene names and ontology information is displayed by hovering over the point of interest. My final product is below - go ahead, give it a try! I found it super simple to embed the output here, plus there is also some handy toolbars provided by Bokeh out of the box that allow the plot to be saved to png or svg from the current view.

Bokeh Plot

I must say, I have been thoroughly impressed so far. Bokeh makes it extremely easy to build simple plots from existing pandas dataframes (think: spreadsheets) and to overlay interactivity without too much extra hassle. It offers the ability to completely customise the plots and layouts with widgets and extra functionality, although I think even the standard plotting elements I used here look pretty stunning in comparison to the original version!

So, here it is - my first passionate post about the benefits of programming for life scientists. Even if you take away the amazing benefits of reproducibilty, shareability, scalability and efficiency - the sheer ability to easily produce stunning visualisations that can be shared is a great asset. If you haven’t jumped on the programming bandwagon yet, what are you waiting for??

what to do when you can't get a word in edge ways

Sat, 28 Apr 2018 03:45:17 +0000

I don’t believe in resolutions, mostly because I have finally learnt (after 20-something years) that I will never stick to them. However, January 1st this year saw me looking to make a few key changes in my lifestyle. A few of these resulted from lessons I learnt throughout 2017 (you can read more about those ), and some were personal decisions that I felt would contribute to my mental, professional and physical health. One of those decisions was a commitment to reading and writing more. What you see here is my attempt at writing - but what about reading? I consume a steady stream of media everyday, and I decided it was high time that I put the constant onslaught of information to better use - to make it work for me, instead of feeling like I was drowning under it’s weight. My answer to this challenge came in a few forms:

1. A new system for prioritising and tracking purely scientific reading. This includes journal articles and media pieces with direct relevance to my current project, or project ideas that I hope to pursue one day. For more on my new system, and how I automate some of the process, keep an eye out for a future post coming soon.

2. A more balanced and positive social media environment. For me, this meant migrating to Instagram and Twitter (in favour of Facebook). Given I was a relative late comer to Twitter, I was able to curate my social network to generate an environment filled with positive stories, useful information, scicomm and professional opportunities etc. Not only does my time spent on these social channels no longer feel cumbersome and negative, but I have also found a brand new way to stay up to date with new science and funding opportunities, as well as a group of positive uplifting scientists working to effect real change in the systems they see failing scientists (and particular female scientists) worldwide.

3. A conscious effort to read something for leisure. While I allowed myself to choose books loosely based in science, it had to be in an expanded real-life paperback-in-hand book (no online journal articles) that I would sit with and focus solely on for at least half an hour at a time. I have only managed a single book this year (more on that ), but these ‘unplugged’ moments have helped anchor my self-care for the past few months. I find it refreshing to have a single focus for a defined time period (no electronic attention-grabbing distractions), and it was great to stretch my mind and take in broad science outside my niche that was designed for a popular audience.

After almost four months, my media-rich life is finally beginning to feel manageable. Tackling the barrage of text and images head on, I have found a balance between reading I have to do (articles), reading I am inevitably going to do (socials) and reading I would like to do (books). And if nothing else, this really reinforces for me the biggest lesson of 2017 - call it yin and yang, call it … call it whatever you like - it’s all about the balance!

My toolbox: 2018 Edition

Tue, 28 Nov 2017 10:27:50 +0000

After coming back from a wonderful conference, I feel refreshed. I heard a lot about the state of my field of research, the cutting edge ideas and the direction our research is taking. You can read more about it .

Of course this aspect of science is important - the research outcomes, equipment and techniques we use are all critical pieces of information that make up the substance of oral and poster presentations. However, this year’s conference brought with it a stark realisation. I feel there is a large part of the conversation that is missing that is equally as important.

In fact, I think it is the true essence of how it is that we do what we do.

How do we, on a daily basis, manage a varied and conflicting schedule with experimental, administration and personal demands? What are the tools and techniques the help us balance these elements with efficiency and efficacy, ensuring nothing falls through the cracks?

I guess in a sense what I am talking about is a best practice discussion for the practicalities of doing research. Not a one size fits all approach, but at least a discussion of how the tools I use are beneficial and what I think I could use or need more of. While this may not fit a conference panel, here is my current toolbox.

This one is definitely top of the list, one of the more recent additions but easily the most life changing. This is essentially my digital brain, the place where I collect, sort and store information. Everything from web clippings (using my handy integrated chrome extension), papers of interest, post ideas, project ideas, meeting notes to shopping lists - it all lives here. Completely synced across all my devices, and easily searchable. All of the major ’life’ aspects have a notebook folder (e.g. manuscripts I’m coauthoring) with notebooks for each element (e.g. “Paper Name #327”), and individual notes for each idea or aspect of that element (e.g. introduction ideas, responding to reviewers comments etc). I think of this as a virtual brain dump - so that as long as I remember a particular piece of information is in evernote, I know it will always be there when I need it.

My digital assistant. I use Calendar to manage meetings, equipment bookings and deadlines. In addition, the daily tasks feature keeps track of experiment steps or analysis projects. For me, this is one of the most crucial features, for a couple of reasons. First, tasks can be assigned to a specific day and live above that day in the calendar. This makes it easy to see what I need to do for the day, as well as what times I will have to play with. Second, I get to tick off completed tasks! I have found the most effective way to keep momentum is to break everything into small, manageable elements, so 8-10 specific tasks that give me a sense of accomplishment each time I tick off something. Finally (and most importantly) tasks are easily reassigned to other days using drag and drop. This means that it is so easy to be flexible, and doesn’t require tasks to be rewritten as with typical hand written to-do lists.

Drive at the moment is simply my backup storage place that provides some functionality when my hard drive is not plugged in. In some situtations it is really helpful to share documents and easily manage sharing permissions, although I dislike having to download and resync non-google files. I am still figuring out how best to incorporate this into my workflow.

Basically a freeware version of adobe Illustrator, I use Inkscape for all figure preparation. This includes figures destined for manuscripts, posters, or presentations. But also just as a neat way to collate image data from experiments. I am yet to come across something that I have wanted to do with a figure that Inkscape can’t handle. There is a relatively steep learning curve, but for a piece of free software it is remarkably versatile. One thing I will note is that it does not play well with iOS (admittedly this is not from personal experience, but from colleagues who have had a tough time getting started), however windows works well.

& : As a self-taught python enthusiast, I am always looking for the best way to write, edit and run code to analyse my ever-growing data sets. This is my current configuration (although I have been through many others - Spyder, Jupyter, Sublime to name a few) and I am happy with the ease with which I can run scripts within atom, as well as manage my git commits with a few keyboard shortcuts. As someone relatively new to git version control, being able to see the folder layout and files which require an updated commit is incredibly helpful. Also, the ability to test, then tweak my code using attached iPython kernels within the editor is a great time saver.

Until very recently, I was an EndNote purist. I was first given access during my Undergraduate degree, and it did a wonderful job at managing my bibliography compared to the manual method. So I amassed a reference library, despite many issues leaving me disgruntled, and established a pipleline that included downloading the referencing file, downloading and saving the pdf separately, and then linking the two together using EndNote. To find articles, I would search in EndNote then locate the pdf and open it to view my notes and highlighted sections. If I lost you there - apologies - but it goes to illustrate my point: long and tedious. I have recently rediscovered Mendeley, and in terms of accessibility to my articles and notes, and ease of import, Mendeley beats EndNote hands down: click the Mendeley extension in my browser (or drag and drop to import a pdf), add notes/highlight and that’s it. All managed and searchable within a single program, again synced across all my devices. There are still a few kinks to work out (sometimes the imported reference information is a little clunky) but overall much more functional.

I have recently come across the idea of ‘story-boarding’ an article during the initial planning and write-up phases. Coming into a new lab, my writing style was at odds with my new boss and needed a little TLC - I am great at the technical reporting language but struggle to tell a narrative. The basic idea behind story-boarding is to layout the elements of a manuscript as discrete chunks and move them around like puzzle pieces to get the flow right. This also helps to identify holes - more experiments or more detailed analysis etc. I am using Trello as a way to trial this concept - each manuscript gets a ‘board’, the lists correspond to ‘Intro’, ‘Methods’, etc. and cards are tiny chunks - text prompts for the intro, individual figures or panels for the results. While this is the newest addition to my workflow, and firmly still in the trial phases, I am pleased with the outcomes so far. It has encouraged me to think about what papers I am working towards (helping to focus my research), as well as getting me thinking about the story to go with it.

So there you have it - my toolbox. It’s worthwhile noting that many of these I adopted from watching/hearing how someone else achieves a particular goal and making it work for me. I hope you find something new and useful, or maybe you have some ideas for something better? Feel free to let me know in the comments - I’d love to learn from you!

ideas on what helps and hinders symposium speakers

Mon, 27 Nov 2017 20:28:25 +0000

During the recent , a friend was scheduled to give a talk about her work. Sitting in the audience watching a parade of marvellous speakers is a special kind of torture, when you are convinced you could not possibly achieve a similar performance. I should know - until the very last year of my PhD, I was not a very talented communicator either. However, after a venture overseas and a stint in a different lab, I found my voice. I wouldn’t say I’m brilliant (far from it), but I have realised the importance of this aspect of science communication and worked hard at being able to at least stomach the idea.

My friend asked how I’d done it. How do you overcome the paralysing fear most people associate with public speaking? I didn’t really have an answer for her at the time - I encouraged her to be confident, which is of course the main ingredient. However, I have thought about it since then, and while watching the remaining conference talks I came across a few things that as an audience member I think can make or break a presentation.

1. Don’t repeat your talk name and title - people can read the program and your first slide (we are mostly smart cookies after all), and it is the job of a good session to chair (also presumably a smart cookie) to give those details when they introduce you. Instead, open by thanking the organisers for the opportunity to present some exciting new work, and a one line teaser to grab the audience - tell them why they should pay attention RIGHT NOW, and not wait until five minutes into your talk. If you don’t have them at the beginning, there will be no getting them back.

2. Oh, you’re skipping your introduction? Because EVERYONE ELSE has given this intro? At a conference specifically about your topic? NO WAY?! Think about your audience early on in the talk’s preparation stage and don’t be afraid to adjust on Day 1 of a three day event. If available, check out the program/other abstracts early, highlight talks with relevance to yours and gauge the level of any remaining introduction that you will need to give. Being able to refer to someone else’s intro not only shows you have engaged with the symposium but also gives you more time to go through the exciting bits (your results!)

3. Keep it simple, stupid. Most of the time you will have a very short window in which to convey your story, which will inevitably be the result of months and months of your blood, sweat and tears. Trying to cram too much into this time window makes your story confusing and hard to follow (10 tiny bar graphs on one slide, anyone?) and people will loose interest. Focus on a simple message, tell people what they need to understand that message, tell them what the message is, then reiterate why your message is important. Simple. As a bonus, people will chase down details with questions, avoiding the dreaded crickets-and-tumbleweeds at the end of a particularly confusing or dense talk.

4. Following on from this, constantly telling people you don’t have time to present this, that or the other (in an effort to keep the slides simple), sounds arrogant and selfish - figure out a story that you CAN tell in the allocated time and reiterate that you are happy to talk details during the breaks.

5. Fake it till you make it. This one has stood the test of time, and for good reason. So much of our perception of a good presenter is taken from their physical cues - and that stems entirely from confidence. If you are nervous beyond belief and terrified of doing something wrong, that will inevitably come through in your body language. If you own your talk and your work, that will come across instead. I think of this like you are the pilot of a plane - if you sound scared and uncertain, your passengers are going to be unsettled and anxious, leading to this cycle of negative reinforcement. If instead you get on the PA system, calmly detail the weather or flight plan (how would they really know how high you’re going to fly??) and make them believe you are in control of the situation, your passengers (the audience) will be calm and the atmosphere relaxed. Everyone will make it out alive and live happily ever after. Or so we hope.

Got any good tips that I’ve missed? Let me know your secret ingredient!

Tips | DEZERAECOX

Toolbox talk: Lights, Camera, Action!

Toolbox talk: Lights, Camera, Action!

The Art of Science Communication: A little learning, a lot of fun!

Lights: Setting up for success means starting with software

Camera: A little investment goes a long way

Action: Time to talk the talk!

Movie magic: remix your way to the red carpet.

And that’s a wrap!

Toolbox Talk: Notion

Toolbox Talk: Notion

Need a notion about Notion?

A simple sneak peek

Ok… But what about Notion for science?

My Notion Nitty Gritty

Tips for getting started

Wrapping up

Learning to code: it's as easy and as complex as that.

Learning to code: it’s as easy and as complex as that.

Final thoughts

Resources:

Book Review: If I Understood You, Would I Have This Look on My Face?

Down with the details:

Overall thoughts:

Some of the best bits:*

Handy links:

Toolbox Talk: VSCode and Conda

Conda: easy environment management

Installating MiniConda

VSCode: a full-featured, user-friendly editor

Basic installation

Getting started

Piecing it all together: using your conda environment in VSCode

Favourite features

Some final thoughts

Toolbox Talk: Scientific posters

Wait, like in elementary school?

Tools

Techniques and tips

Useful resources

Toolbox Talk: Storing data using HDF5 files

Data: the invisible bits and bytes of modern life.

What on earth is HDF5?

Pros and Cons of the HDF5 format

Sounds great.. But how do I use HDF5 files?

A few final thoughts.

Resources

A year in review: 2018 edition

Wins

A snapshot of the high points

Losses

A snapier shot of the low points

Lessons

The bits I wish I knew at the start of 2018, but had to learn the hard way

Goals

Hopefully to help me meander with purpose through 2019

Toolbox talk: Atom, Jupyter and Hydrogen

The basics: Atom as a building block.

The best bits: Git(Hub), Integrated Development Environment and Real-time Collaboration functionality

Easy extensions: Size may not matter, but it’s all about the package(s)

Accessorising Atom: a Python perspective

Better than basics: integrating python virtual environments

Further Reading: Example Atom/Jupyter/Hydrogen/VirtualEnv Setup

Step 1: Checking your default Python install

Step 2: Install virtualenv, virtualenvwrapper

Step 3: Configure virtualenvwrapper

Step 4: Create virtual environment

Step 5: List, activate and deactive virtual environments

Step 6: Install relevant packages for your new environment

Step 7: Install new ipython, and configure a kernel from within the environment

Step 8: Install Atom packages

Step 9: Using the virtualenvwrapper package in Atom

Conclusions

Toolbox talk: Trello

The basics: What the Tr-hell-o is all the fuss about??

Trello in action: managing your research projects

The bigger picture: managing your science

Resources

a weekend walk around the Bokeh library

what to do when you can't get a word in edge ways

*Some of the best bits:**