What are the best practices in documentation, archiving, publishing of code, data, and other materials? How to keep your file structure organized on your own computers?
This series featured two awesome guests from University of Pennsylvania:
Steven Weissberg (https://stevenmweisberg.com/) from the Chatlab at Upenn (http://ccn.upenn.edu/chatterjee/) talked about OSF and how to use it for open science and archiving (from 5:14).
Giulia Frazetta (https://github.com/gfrazzetta) from Geoffrey Aguirre’s lab at UPenn ( https://github.com/gkaguirrelab) talked about versioning and how to make the best use of github (from 11:39).
Quick summary of the most important points:
- Always keep future you in mind. And with future, we don’t mean the next few weeks, but the next few years.
- Keep your files on your computer tidy. Organize things which you are likely to recycle (e.g. slides, writing, graphics) together. Organize your research material (e.g. data, analysis files, stimuli) in project folders and stay consistent with folder structure and naming.
- Don’t panic-save everything. Archive data files at the most important steps in a separate folder (raw, preprocessed, analysis#1, analysis#2, wide format) and use the copies in your analysis directory for ongoing analyses and trying out things. Overwrite old files when moving on (Don’t panic, you have that safety copy).
- Write up the documentation of your study directly into a manuscript file which will later be the basis of a published paper. Writing up the experiment protocols, materials and methods descriptions, analysis steps, and the results right away will save you a lot of time and frustration.
- Use OSF (https://osf.io) to archive your materials and data. This is also great for working with multiple people on one project. Keep this as tidy as possible. As soon as you make it public eventually (which we recommend for most projects) this should be the best reflection of your work as a scientist with highest standards.
- If your work entails any kind of coding or writing analysis scripts, github is a great way to keep version control and publish your code.
- Always work as if a stranger would have to pick up your project at any time and finish it for you.
How to juggle multiple projects
In the first Academic Crisis Line session, we talked about tips and tools which help organizing your work time efficiently so that you can manage multiple projects without getting overwhelmed. You can rewatch the video here:
Here is a mini summary:
- Day to day business (microlevel managing)
- Tools: timetable, calendars, planners, spreadsheets, post its, Google Tasks, Trello,…
- Make a week overview with all the regular events to see which blocks of time you have available to work on your projects. Don’t forget to insert private events to see which evening you can realistically work longer and which not.
- Your week will now be chunked up into smaller and bigger time windows. Try to get two entire days of uninterrupted work without meetings, lecture series or other obligations (1 full + 2 half days will do, too). These are the days on which you can work on more challenging or demanding tasks or for writing, developing new ideas etc. Protect these days! This is where you get the important work done!
- Use all the smaller chunks for smaller tasks which can be divided into small units easily like admin, emails, meetings with students.
- Don’t waste your time. Do things when they are fresh and you are on top of things (e.g. write up your analysis and results during or after analyzing). When you have to go back to things weeks after you did them it costs you much more time to do it.
- Review your progress weekly and reassess tasks and important next steps. Make a plan for the coming weeks!
- Avoid micromanaging! It feels productive, but don’t let it fool you. Organizing should save you time, not eat it up!
- Procrastinate efficiently: Ask yourself why you are procrastinating (Overwhelmed? Waiting for feedback? Unclear were to start? Too much of the same type of work for too long?). Take immediate action to find a solution (Ask for a meeting with adviser. Look for help online. Send the email.). If your problem cannot be solved immediately (Yay Google! Someone had exactly this problem and wrote about it!), leave this problem for now and work on something else. Most importantly: Don’t allow yourself to get stuck!
- Organizing multiple projects over months (and years)
- Tools: progress charts, calendars, spreadsheets, OSF, Trello,… (whatever you do, stay consistent!).
- Be clear about your role and workload in each of your projects. Plan realistically how much work it will be (plan buffer and downtime!!!) and when work intense periods will occur (e.g. data acquisition, deadlines for conferences).
- Avoid having too many projects in the same progress stage. Ask yourself which tasks can go in parallel and which not. Plan some downtime after each step in a project to allow yourself to reflect about it before moving forward. In addition, plan some buffer time for certain phases in the projects where things can go wrong (e.g. data acquisition taking longer than expected, technical hiccups, etc…).
- Take a few minutes to write up new ideas and store them in a central location for when you have time o start a new project.
- Regularly rethink priorities and project progress (what are the consequences if a task does not finish on time) and adapt your plan if something changes. Even with the best planning, things can go wrong and you have to be flexible in finding a solution.
- Accept that you cannot every variable which can influence project progress and that you won’t be able to give 100% at all times. Talk about it with people involved in the project and try to redefine priorities and find solutions.
- Don’t loose track of your big plan (macro managing to achieve your career goals)
- Tools: 5 year plan, 10 year plan, annual goals
- Take sometime at least once per year (Christmas break?) to reflect upon where you are in your career, where you want to be, and how you can achieve this.
- Write down what you want to achieve this year (publish this paper, submit these other two, apply for this grant, learn a new analysis technique) and keep this list visible. This will help you decide on priorities.
- Make time in your schedule once in a while to learn new things, keep up with the literature, reflect on research lines and brainstorm new ideas.
If you have questions, please send them to me or comment underneath. I will answer but want to keep all in one place.
UPDATE: I now upgraded my project planning to a digital online based method allowing direct collaboration. Have a look: Upgrade to digital project planning. A follow up on ‘how to juggle multiple projects’.