3.25.2010

PhD Dissertation - The End is Near

I thought maybe it would beneficial to document some of the process of writing my dissertation since I went about it a bit nontraditionally (not just taking too long to do too little) using predominantly open-source software.

Disclaimer: Although writing a chemistry dissertation with open-source software is readily accomplished, it is probably unwise to make a switch from MS Windows after already starting your writing. It is recommended that you make the decision a year-ish early and write at least one hefty report to acclimate :)

Software Used

OpenOffice.org 3.1 Office Suite:

OOO3 Writer - Word Processor

OOO3 Draw - Drawing Program - I used this to prepare all of my Figures and Schemes saving each one separately with a unique alpha-numeric identifier for easy renumbering at the end.

OOO3 Calc - Spreadsheet - Used to generate tables and graphs


JabRef 4.2 - Java-Based Reference Manager - Fast and flexible, however there is a bit of a learning curve (maybe a few hours) associated with using the "style file," a template that formats your bibliography. I know there are several others out there, but JabRef was easy enough that I could get started with it right away and it is very robust. Documentation on their web site is good, and you will find there the critical plugin for syncing to OOO3.


SciFinder Scholar - Chemical and Biological Database Search Engine - SciFinder Scholar is sooo expensive that you shouldn't have to pay for it. Your institution will likely have a site-license (mine has one with only 3 seats or simultaneous users for a student body of 12000) and you need only download the Windows executable and obtain a copy of the site.prf file (a key granting you access) from the school (check with the library). Yes it is windows only, but again I found it to run nearly flawlessly in WINE for Linux.


BKChem 0.13.0 - Python-based 2D Chemical Structure Editor - BKChem is far from perfect, but for my thesis it worked great. This may in part be due to most of the chemistry I do is with flat polycyclic aromatic hydrocarbons, however anyone looking for open-source 2D structure editors should have good success with BKChem (also look at JChemPaint). The only major set back I had was in resizing objects as BKChem would crash. Otherwise very robust. Since BKChem exports a scalable vector graphic (SVG) to OOO2 .odg format I had no resolution trouble with resizing in OOO3 Draw.


Avogadro 1.0 - Powerful 3D Chemical Structure Builder and Force-Field Minimizer - I can't say enough good things about Avogadro. It is my front end to all of my computational chemistry. It is easier to use than GaussView (almost as intuitive as Spartan's Builder), offers beautiful, fast graphics, implements MMFF, UFF and Ghemical force-fields, reads loads of file-types including Gaussian Cube files, displays MOs, cross-platform (YES Mac and Windows too!) and it's bloody free!! (I don't know how but thanks to Marcus Hanwell and his faculty advisor Geoff Hutchison).


PyMOL - 3D Chemical Structure Viewer and Graphics Renderer - Although a little clunky, PyMol's greatest strength is producing very nice graphics which are saved in .png format. I know it has many additional uses, however, I only used it to prepare beautiful 3D molecular visualizations for my thesis. It is only missing a "ball-and-stick" display style (which is available in avogadro) but the "stick" style is clean and the images do come out much sharper and scale well.


WinDNMR in WINE - Dynamic NMR Line Shape Simulator - Although not available for Linux or Mac, WinDNMR worked without any trouble through WINE for Linux. The program is free-ware, but the author H. Reich requires e-mail registration in exchange for an activation code. This program requires adequate knowledge and skill for proper execution but the manual/tutorial is available and thorough.


MestReNOVA - Advanced NMR Workup Software - MestReNOVA is not free, but a 45 day trial is available for Windows/Mac/Linux, giving the average graduate student enough time (I got a 15 day extension) to do the final workup of all NMR FIDs.


pdftk - PDF merge/split Command Line Tool - This little gem came in real handy to manage my dissertation in 5 parts. Splitting up the OOO3 .odt files allows for faster save times and handling. I didn't learn how to start page numbering from a different number than 1 until after I merged my 3 chapters and appendix into the .odt file which was a little frustrating to manage the 155 page document for final minor edits. Still saving each part separate and exporting as a PDF worked well and pdftk seamlessly merges one printable document. Most likely pdftk is downloadable from your package manager (that's what I did with Ubuntu) and type pdftk --help for a list of command options.


Hurdles and Lessons for Writing a Dissertation/Thesis with this Software:

The OOO3 office suite is nearly as powerful as MS Office but there are some significant differences, some advantageous. There is no way I can give a complete overview of these differences, but there are a few helpful points I may make.

1. Page Numbering in OOO3 is tricky. It is a good idea to break your document up into sections as it saves time in the end. However, this is only true if you learn how to number starting with a different page than 1 well in advance. OOO-Writer uses page "styles" to manage this information. For example to number your preface with Roman Numerals and then start Chapter 1 with page 1 (as is usually the case), the preface pages must be designated a separate style "preface" than the rest of the document which will probably remain "default." It is imperative to sort this out early with some test pages. Consult the following website documentation: OOO3 Wiki, Taming OOO3, OOBlog. I'm sure there are lots of other sites with this information, but the first 2 alone basically got me up-and-running (although a bit late!).

2. Build a detailed and "Advisor Approved" outline for your entire thesis. Use the Outline Formatter in OOO3 (usually defaults as you build) for this and you'll be happy you did. My outline literally became my headings and subheadings for each section of my dissertation which I could easily reformat numerically after I was finished using the Bullets/Numbering toolbar.

3. Use a reference manager to keep your bibliography organized. I used JabRef with an OOO-plugin (see above) and it worked well for me. I did the best with my "style-file" for ACS formatting and left it alone until I was finished the document before a final format.

4. Organize your Tables, Figures, Schemes and Componds with a well designed alpha-numeric coding system so you can use "Find/Replace" tool in OOO3 at the end to provide a final number. I used "T" for Table, "F" for figure and so on, followed by a 1,2,3 for which chapter the table or figure was in, followed by Roman Numeral designation for which part within the chapter it was in, followed by a capital letter. The trouble I ran into was when substituting C2II (the "I-th" compound of part I Chapter 2) with the number 16, compounds C2IIA-C2IIZ (compounds in part II of Chapter 2) became 16A-16Z!!! So don't do that! Use a better system and you'll be golden.

5. Export and test as you go. Your advisor will probably want to use your well-crafted figs, schemes, tables in journal submissions later on (hopefully) so you should save each one individually with a good systematic archiving method and export them into a format that will be useful for collaboration purposes (MS Word 2003 / 2007). Also deal with your text. I found exporting to .rtf worked well for keeping my text formatting, but my figures/schemes/etc were botched. It is useful to figure out a system that you know will work early on so you're not "stuck like chuck... cuz chuck was stuck" -MM.


2 comments:

  1. Hi,

    I just stumbled upon your blog post and thought that you might be interested in “SciPlore MindMapping”, a mind mapping software I am developing. SciPlore MindMapping integrates mind mapping with PDF and reference management (especially BibTeX). In my opinion it’s the (almost) perfect solution for managing academic PDF files. You can watch a video on YouTube http://www.youtube.com/watch?v=jRHqLktIMWw&hd=1 and download the software here: http://www.sciplore.org/software/sciplore_mindmapping/

    It’s running on Windows, Linux and MacOS, is GPL and based on the popular mind mapping software FreeMind. The main (additional) features are that you can 1. import PDF bookmarks to organize the content of PDFs 2. Watch folders for new PDFS (they are automatically listed in your mind map) and 3. Add reference keys (BibTeX) to mind map nodes. Furthermore you can backup all your mind maps to our servers and access them online.

    Regards
    Jöran

    ReplyDelete
  2. Joran, Thank you. Your software seems like it could be very useful to researchers!

    ReplyDelete