<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Apolitically Incorrect &#187; OpenSource</title>
	<atom:link href="http://www.oak-tree.us/blog/index.php/tag/opensource/feed" rel="self" type="application/rss+xml" />
	<link>http://www.oak-tree.us/blog</link>
	<description>The Rants and Raves of an Unsettled Mind</description>
	<lastBuildDate>Mon, 31 Oct 2011 21:56:43 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.2.1</generator>
		<item>
		<title>Hannibal, Napoleon, and Joseph Charles Minard</title>
		<link>http://www.oak-tree.us/blog/index.php/2010/02/22/minard-maps</link>
		<comments>http://www.oak-tree.us/blog/index.php/2010/02/22/minard-maps#comments</comments>
		<pubDate>Mon, 22 Feb 2010 21:49:11 +0000</pubDate>
		<dc:creator>Rob Oakes</dc:creator>
				<category><![CDATA[Computer]]></category>
		<category><![CDATA[Cool Stuff]]></category>
		<category><![CDATA[Illustration]]></category>
		<category><![CDATA[rapidBOOKS]]></category>
		<category><![CDATA[Science and Medicine]]></category>
		<category><![CDATA[Writing and Literature]]></category>
		<category><![CDATA[Charles Joseph Minard]]></category>
		<category><![CDATA[Charts and Graphs]]></category>
		<category><![CDATA[Inkscape]]></category>
		<category><![CDATA[Maps]]></category>
		<category><![CDATA[OpenSource]]></category>
		<category><![CDATA[OpenSource Writing]]></category>
		<category><![CDATA[Statistics]]></category>

		<guid isPermaLink="false">http://www.oak-tree.us/blog/?p=1396</guid>
		<description><![CDATA[	
	<span class="Z3988" title="ctx_ver=Z39.88-2004&amp;rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Adc&amp;rfr_id=info%3Asid%2Focoins.info%3Agenerator&amp;rft.title=Hannibal%2C+Napoleon%2C+and+Joseph+Charles+Minard&amp;rft.aulast=Oakes&amp;rft.aufirst=Rob&amp;rft.subject=Computer&amp;rft.subject=Cool+Stuff&amp;rft.subject=Illustration&amp;rft.subject=rapidBOOKS&amp;rft.subject=Science+and+Medicine&amp;rft.subject=Writing+and+Literature&amp;rft.source=Apolitically+Incorrect&amp;rft.date=2010-02-22&amp;rft.type=blogPost&amp;rft.format=text&amp;rft.identifier=http://www.oak-tree.us/blog/index.php/2010/02/22/minard-maps&amp;rft.language=English"></span>
No study of the history of scientific communication can be complete without mention of Joseph Charles Minard, a 19th Century French civil engineer and cartographer. At the end of his life, Minard created two very famous examples of statistical charts, called flow maps, that every scientist, engineer and student should be familair with.  The first [...]<p>Copywrite 2009: Rob Oakes.  <a href="http://www.oak-tree.us/blog">Apolitically Incorrect</a><br/><br/><a href="http://www.oak-tree.us/blog/index.php/2010/02/22/minard-maps">Hannibal, Napoleon, and Joseph Charles Minard</a></p>
]]></description>
			<content:encoded><![CDATA[	
	<span class="Z3988" title="ctx_ver=Z39.88-2004&amp;rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Adc&amp;rfr_id=info%3Asid%2Focoins.info%3Agenerator&amp;rft.title=Hannibal%2C+Napoleon%2C+and+Joseph+Charles+Minard&amp;rft.aulast=Oakes&amp;rft.aufirst=Rob&amp;rft.subject=Computer&amp;rft.subject=Cool+Stuff&amp;rft.subject=Illustration&amp;rft.subject=rapidBOOKS&amp;rft.subject=Science+and+Medicine&amp;rft.subject=Writing+and+Literature&amp;rft.source=Apolitically+Incorrect&amp;rft.date=2010-02-22&amp;rft.type=blogPost&amp;rft.format=text&amp;rft.identifier=http://www.oak-tree.us/blog/index.php/2010/02/22/minard-maps&amp;rft.language=English"></span>
<p><img style="margin: 0px 15px 0px 0px; display: inline; border-width: 0px;" title="Charles Minard - Railroad Routes" src="http://www.oak-tree.us/blog/wp-content/uploads/2010/02/CharlesMinardRailroadRoutes.jpg" border="0" alt="Charles Minard - Railroad Routes" width="200" height="347" align="left" /></p>
<p>No study of the history of scientific communication can be complete without mention of Joseph Charles Minard, a 19th Century French civil engineer and cartographer.</p>
<p>At the end of his life, Minard created two very famous examples of statistical charts, called flow maps, that every scientist, engineer and student should be familair with.  The first showed Hannibal’s crossing of the Alps (218 BC, Second Punic War), and the second describes Napoleon’s disastrous invasion of Russia (1812-1813).</p>
<p>Both examples are beautiful works of art and masterful examples of evidence.  But they are also more than that, they tell cohesive and interesting stories.  In this post, I thought it might be interesting to take a closer look at the history of Hannibal and Napoleon, and highlight the ways which Minard’s charts help us to explain their eventual outcome.</p>
<p><em>(Note: High resolution, PDF versions of the two maps are available for download.  These versions have been translated from the original French.  To download, either click on the images, or <a href="http://www.oak-tree.us/stuff/OpenSource-Writing/Minard-Hannibal.pdf">here</a> for the Hannibal invasion of Northern Italy, and <a href="http://www.oak-tree.us/stuff/OpenSource-Writing/Minard-Napoleon.pdf">here</a> for the French Invasion of Russia.)</em><span id="more-1396"></span></p>
<h2>Hannibal Invasion of Italy (218 BC, Second Punic War)</h2>
<p><!--adsensestart--><a href="http://en.wikipedia.org/wiki/Hannibal">Hannibal</a> was perhaps the single greatest threat to Roman power to ever live.  At the same time that Roman legions marched unopposed through most of the Mediterranean world, Hannibal lead a force of twenty-five thousand soldiers into the heart of Roman territory. He then spent the next fifteen years occupying portions of the Italian peninsula and generally wreaking havoc.  But even though he ravaged the Roman countryside, Hannibal was never successful in subduing Rome.  Ironically, this might be due to one of his greatest exploits: the overland crossing of the Alps.</p>
<p>Hannibal departed his home base in Spain with nearly 90,000 troops (one of the largest armies that had ever been fielded at that point in history) and had a number of early successes.  He marched north over the Pyrenee mountains and into Gaul (modern day France).  He subdued the Celtic tribes and crossed the Rhone River before the Romans could take measures to stop his advanced.  He forged important alliances and found unexpected friends in his fight against the Romans.</p>
<p>After crossing the Rhone, however, Hannibal’s luck began to change.  He received word that a large Roman force was marching from the Mediterranean coast to intercept and destroy him.  As the force outnumbered him by a significant margin, Hannibal was faced with a difficult choice.  Should he stay at his current location and engage the Roman army or retreat and prepare a defense?</p>
<p>Not content with either choice, Hannibal ultimately chose a third option; which, ironically, would have enormous consequences for his overall campaign.  To evade the Romans, Hannibal took the unprecedented action of turning inland and marching over the Alps.  (It is thought that he probably crossed over the valley of the Drome and south of the Col de Montgenevre or near the Col de Mont Cenis.)  This had never been done before – indeed many thought it impossible – and has long been praised as a brilliant tactical decision.</p>
<p>Minard’s reconstruction of Hannibal’s journey shows the journey from Spain, through Transalpine Gaul and eventual arrival in Italy, allows it to be seen a slightly different light, however.  Through use of a flow line, Minard shows how the strength of Hannibal’s army waned through the march, with a disastrous loss of twenty thousand men while passing over the Alps.  This steady loss of strength, subtly reinforced by Minard’s map, helps to explain why Hannibal failed to subdue Rome.<!--adsensestop--></p>
<p>Hannibal’s brilliant tactical decision was also a strategical disaster.  It came at a dramatic loss of men, war elephants, and material with the most disastrous loss being the destruction of his siege engines.  Without the siege engines, Hannibal was never able to successfully attack Rome.  And eventually the Romans realized this and changed their tactics.  Instead of engaging Hannibal directly, they instead fought a long-pitched war of attrition and eventually destroyed the one resource he couldn’t replace: his men.  Thus, even though crossing the Alps helped Hannibal to win a few stunning victories, the decision eventually caused him to lose the war.</p>
<p><a href="http://www.oak-tree.us/stuff/OpenSource-Writing/Minard-Hannibal.pdf"><img style="display: inline; border-width: 0px;" title="Hanibal's invasion of Italy over the Italian Alps." src="http://www.oak-tree.us/blog/wp-content/uploads/2010/02/MinardHannibal.png" border="0" alt="Hanibal's invasion of Italy over the Italian Alps." width="600" height="286" /></a></p>
<h2>Napoleon’s Invasion of Russia (1812-1813)</h2>
<p>Like in the case of the Hannibal, Minard’s depiction of the 1812-1813 invasion of Russia also tells an extraordinary story.  It combines information about the size of the army, geography, sub-campaigns and temperature into a single narrative.  This time, though, it is anything but subtle.</p>
<p><em>Note: Because of  the elegant management of all this information – at any time showing the army’s direction, size, and loss relative to the start – some statisticians and data visualization experts (such as Edward Tufte, Etieene Jules Marey and Howard Wainer) have declared Minard’s depiction of Napoleon’s Invasion of Russia to be the greatest numerical graphic ever created.</em></p>
<p>From the very beginning, the army met with tremendous hardship.  The cold temperatures and lack of available resources took an enormous toll.  Napoleon had planned on scavenging for supplies to support his massive army, but the Russians had destroyed all of their crops and burned their villages so that Napoleon wouldn’t be able to make use of them.  As a result, the army was heavily reliant on slow supply trains from Europe that were unable to keep pace with its quick advance.  Hundreds of thousands died from starvation and exposure, greatly outnumbering those lost in combat.</p>
<p>Minard’s map shows this trend of devastating loss.  Napoleon’s Grand Army starts out as a wide, brown line to the left of the map.  As the army progresses across Russia, the number of men decreases dramatically.   A few ribbons of men are dispatched to other targets, but by far the majority succumb to the elements.</p>
<p>Eventually, a substantially reduced force (100,000 men, about 20% of those who began the campaign) arrived in Moscow.  What they found did little to improve their circumstances.  The city had been abandoned and burned to the ground.  No food was available.  The only available option was to return to France.</p>
<p>Demoralized and broken, the Grand Army began a slow retreat to the west.  Their progress is shown in the black.  As they crossed the vast Russian wilderness, the temperature turned bitter cold (shown in the bottom third of the map).  When the army arrived at the Niemen river, there were a scant 10,000 troops.  More than 400,000 had died.</p>
<p>Such a devastating loss of life crippled Napoleon’s young empire and left him open to invasion by his enemies.  He was defeated later in 1813 and exiled to the island of Elba.</p>
<p><a href="http://www.oak-tree.us/stuff/OpenSource-Writing/Minard-Napoleon.pdf"><img style="display: inline; border-width: 0px;" title="Minard's map showing Napoleon's invasion of Russia and the catastrophic losses he suffered." src="http://www.oak-tree.us/blog/wp-content/uploads/2010/02/MinardNapoleon.png" border="0" alt="Minard's map showing Napoleon's invasion of Russia and the catastrophic losses he suffered." width="600" height="292" /></a></p>
<h2>Conclusion</h2>
<p>Minard’s graphics are successful because they demonstrate powerful trends and place evidence within its proper context.  In the case of Hannibal, it shows how he began in a position of strength and then undermined himself through a brilliant tactical innovation.  In the case of Napoleon, it shows how distance and temperature ravaged an army and destroyed an emperor.</p>
<p>The clear evidence and thoughtful presentation define the story, they show where things are headed and help to foreshadow the inevitable conclusion.  For this reason, they are powerful examples of clear communication.</p>
<p>____________________________________________________</p>
<h3>Unrelated Thoughts: Re-Visioning Minard with Open Source Tools</h3>
<p>Since first seeing these charts as part of an undergraduate statistics course, I’ve been obsessed with them.  I even have a poster sized copy of the Russian invasion (available from <a href="http://www.edwardtufte.com/tufte/posters">Graphics Press</a>) hanging in my office.  Given this obsession, it should come as no surprise that I’ve wanted to include the maps in my book.</p>
<p>There is, however, just one problem; there is not anything new to say about them.  Edward Tufte has held up Minard as a “Da Vinci of Data” for the better part of thirty years.  Nearly every one of his books includes a copy of the maps (in the case of Beautiful Evidence, his most recent work, there is an entire chapter devoted to the graphics; including eight different reproductions).  Other than, “They’re beautiful, study them carefully, read Tufte’s analysis,” there just isn’t that much to say.</p>
<p>That is, until I started looking for examples of scientific illustration that could be reproduced using the vector illustration program, Inkscape. Any such example should have simple lines and clean integration of text and images.  I'm not sure that a better description of Minard's work exists.</p>
<p>The two images above (and attendant PDFs) were my first pass at re-drawing the maps.  And I have to say, I’m rather happy with the result.  For the most part, I was able to get a very faithful reproduction (with the exception of the type face, which I deliberately changed because I hate script fonts), and only required a couple of hours worth of work.</p>
<p>I think that I may have found my book examples.  It allows me to include one of the best statistical charts of all time, talk about flow maps, and even include some interesting how-tos which show how the graphics can be built in an automated fashion.  Which, come to think of it, might just count as a new contribution after all.</p>
<h3>Acknowledgements and Further Reading</h3>
<p>More information on the book can be found at the <a href="http://rapidbooks.ca/">publisher’s website</a>.</p>
<p>The source images for the two maps included “Re-Visions of Minard” by Michael Friendly (1999) and the reproductions in “Beautiful Evidence” by Edward Tufte.  Translation for the Hannibal map was adapted from those available on <a href="http://www.edwardtufte.com/tufte/minard-hannibal">Edward Tufte’s website</a> (Dawn Finley) and sources available at <a href="http://www.math.yorku.ca/SCS/Gallery/re-minard.html">Re-Visions of Minard</a>.  Translation for the Russian campaign map were taken from the reproduction in Edward Tufte’s “Beautiful Evidence”, <a href="http://commons.wikimedia.org/wiki/File:Minard.png">Wikimedia Commons</a> and sources available from <a href="http://www.math.yorku.ca/SCS/Gallery/re-minard.html">Re-Visions of Minard</a>.</p>
<p>Additionally, the Re-Visions of Minard Website include a number of interesting adaptations of the Napoleon graphic that might be of interest, including both Matlab and GGPlot2 reconstructions.<br />
<h3>Similar Posts:</h3>
<ul class="similar-posts">
<li><a href="http://www.oak-tree.us/blog/index.php/2009/03/09/anathem" rel="bookmark" title="March 9, 2009">Anathem: Big Book, Big Ideas</a></li>
<li><a href="http://www.oak-tree.us/blog/index.php/2009/11/14/customize-lyx-character-styles" rel="bookmark" title="November 14, 2009">Customizing LyX: Character Styles and the LyX Local Layout</a></li>
<li><a href="http://www.oak-tree.us/blog/index.php/2009/03/24/af-mri" rel="bookmark" title="March 24, 2009">Heart Arrhythmias and MRI</a></li>
<li><a href="http://www.oak-tree.us/blog/index.php/2008/12/16/wpf-svg-xaml-part3" rel="bookmark" title="December 16, 2008">WPF – SVG Graphics and XAML – Part 3</a></li>
<li><a href="http://www.oak-tree.us/blog/index.php/2009/11/25/latex-cv-part1" rel="bookmark" title="November 25, 2009">Typeset Your Curriculum Vitae &ndash; Part 1: The xetexCV Document Class</a></li>
</ul>
<p><!-- Similar Posts took 264.356 ms --></p>
<p>Copywrite 2009: Rob Oakes.  <a href="http://www.oak-tree.us/blog">Apolitically Incorrect</a><br/><br/><a href="http://www.oak-tree.us/blog/index.php/2010/02/22/minard-maps">Hannibal, Napoleon, and Joseph Charles Minard</a></p>
]]></content:encoded>
			<wfw:commentRss>http://www.oak-tree.us/blog/index.php/2010/02/22/minard-maps/feed</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
		<item>
		<title>Creating the Perfect Writing Tool: A Proposal</title>
		<link>http://www.oak-tree.us/blog/index.php/2009/03/04/perfect-tool</link>
		<comments>http://www.oak-tree.us/blog/index.php/2009/03/04/perfect-tool#comments</comments>
		<pubDate>Thu, 05 Mar 2009 02:32:33 +0000</pubDate>
		<dc:creator>Rob Oakes</dc:creator>
				<category><![CDATA[Computer]]></category>
		<category><![CDATA[Programming]]></category>
		<category><![CDATA[Writing and Literature]]></category>
		<category><![CDATA[LyX]]></category>
		<category><![CDATA[OpenSource]]></category>

		<guid isPermaLink="false">http://www.oak-tree.us/blog/?p=760</guid>
		<description><![CDATA[	
	<span class="Z3988" title="ctx_ver=Z39.88-2004&amp;rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Adc&amp;rfr_id=info%3Asid%2Focoins.info%3Agenerator&amp;rft.title=Creating+the+Perfect+Writing+Tool%3A+A+Proposal&amp;rft.aulast=Oakes&amp;rft.aufirst=Rob&amp;rft.subject=Computer&amp;rft.subject=Programming&amp;rft.subject=Writing+and+Literature&amp;rft.source=Apolitically+Incorrect&amp;rft.date=2009-03-04&amp;rft.type=blogPost&amp;rft.format=text&amp;rft.identifier=http://www.oak-tree.us/blog/index.php/2009/03/04/perfect-tool&amp;rft.language=English"></span>
In addition to nouns, verbs, and adjectives; there are other tools which supplement the writer's arsenal. some writers, this is a moleskin notebook and ballpoint pen. For others, writing is synonymous with the usage of computer word processors, such as Microsoft Word.&#160; What is a given, however, is that the choice is intensely personal. If [...]<p>Copywrite 2009: Rob Oakes.  <a href="http://www.oak-tree.us/blog">Apolitically Incorrect</a><br/><br/><a href="http://www.oak-tree.us/blog/index.php/2009/03/04/perfect-tool">Creating the Perfect Writing Tool: A Proposal</a></p>
]]></description>
			<content:encoded><![CDATA[	
	<span class="Z3988" title="ctx_ver=Z39.88-2004&amp;rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Adc&amp;rfr_id=info%3Asid%2Focoins.info%3Agenerator&amp;rft.title=Creating+the+Perfect+Writing+Tool%3A+A+Proposal&amp;rft.aulast=Oakes&amp;rft.aufirst=Rob&amp;rft.subject=Computer&amp;rft.subject=Programming&amp;rft.subject=Writing+and+Literature&amp;rft.source=Apolitically+Incorrect&amp;rft.date=2009-03-04&amp;rft.type=blogPost&amp;rft.format=text&amp;rft.identifier=http://www.oak-tree.us/blog/index.php/2009/03/04/perfect-tool&amp;rft.language=English"></span>
<p><img alt="" align="left" src="http://www.oak-tree.us/blog/wp-content/uploads/2009/03/030509-0231-creatingthe1.jpg" />In addition to nouns, verbs, and adjectives; there are other tools which supplement the writer's arsenal. some writers, this is a moleskin notebook and ballpoint pen. For others, writing is synonymous with the usage of computer word processors, such as Microsoft Word.&#160; What is a given, however, is that the choice is intensely personal. If you ask ten different writers, &quot;What is the perfect tool?&quot; Expect ten different answers.</p>
<p>For those who create software, however, this is big problem. Programs can't be customized to the individual whims of every writer. (A more diverse or idiosyncratic group does not exist.)&#160; It is necessary to select a cross section of features that meet the needs of most people.&#160; Unfortunately, however, this has resulted in some serious compromises and an emphasis on the technical process of writing, often to the exclusion of the creative process.</p>
<p> <span id="more-760"></span>
</p>
<h2>The Problem</h2>
<p>Like most writers, I have some strong feelings about the tools I use; and like most writers, I have never found one that fits my needs.&#160; But this is not for a lack of trying.&#160; In fact, I’ve been searching “perfect tool” for a very long time, at least since I was a senior in high school.</p>
<p>At that time, I enjoyed writing things out in longhand, with separate drafts copied over from the first iteration. I fancied myself a budding novelist and fervently believed that such an exercise would stimulate my creativity.</p>
<p>A decade later, however, I have become impatient. Now, I prefer to peck out my thoughts at the keyboard.&#160; Sometime in college, I realized that writing by hand is slow and while it can focus the mind on word choice, it's a plodding and frustrating exercise. In contrast, typing at the computer is quick; and since I can type nearly as fast as I can think, it allows the text to keep pace with my thoughts.</p>
<p>Moreover, working on the computer is organic. There isn't a discrete first, second, and final draft; instead, I can add, modify or change my writing as I form the ideas. If I want to jump back and change a word or sentence, I do so. Pen and paper isn't nearly so adaptable and many ideas are lost before they can be captured and expanded. </p>
<h3>The Limitations of Existing Tools</h3>
<p>But even though I prefer to write at the computer, I haven’t been able to find a writing program that lets me creatively adapt the structure and flow of my document.&#160; I have tried nearly everything available, but nothing fully meets my needs.</p>
<p>Consider <a href="http://office.microsoft.com/en-us/word/default.aspx">Microsoft Word</a>, for example.&#160; Even with all of its power, there are a number of things that it doesn't handle very well. Ever tried to work with a complex Word document, numbering into the hundreds or thousands of pages? If not, I don't recommend that you do.&#160; Large Word documents cause the program to slow down or crash and they have a tendency to become corrupted.&#160; There is nothing more disconcerting than finding out one of your book chapters is no longer usable due to bit rot.</p>
<h3>Introducing LyX: The Document Processor</h3>
<p>Luckily, there may a potential solution.&#160; The open source document processor, LyX, meets many of Word’s shortcomings.&#160; LyX encourages people to approach writing based on the structure and content of the document, rather than the appearance. Thus, it isn't a &quot;<strong>W</strong>hat <strong>Y</strong>ou <strong>S</strong>ee <strong>I</strong>s <strong>W</strong>hat <strong>Y</strong>ou <strong>G</strong>et&quot; so much as a &quot;<strong>W</strong>hat <strong>Y</strong>ou <strong>S</strong>ee <strong>I</strong>s <strong>W</strong>hat <strong>Y</strong>ou <strong>M</strong>ean&quot; (WYSIWYM).</p>
<p>When used right, LyX focuses the user on writing the content. The program handles the mechanics of layout and output. To do so, LyX leverages the LaTeX typesetting system, which is used heavily in the engineering and science disciplines to publish dissertations, grant proposals, journal articles, and books.</p>
<p>When I first found LyX three or four years ago, it fundamentally changed the way that I worked. Before, I manually formatted everything in a given document. While this approach is okay for simple letters or lists, it quickly breaks down in anything longer than a few pages.</p>
<p>In contrast, LyX makes extensive use of tags that tell the program what a given piece of text is. The title is enclosed by a &quot;title&quot; tag, book sections by the &quot;section&quot; tag, chapter headings by the &quot;chapter&quot; tag, block quotes by the &quot;quote&quot; tag, and paragraph text by the &quot;body&quot; tag. The program then applies formatting rules globally and in a consistent manner. Text within LyX has a meaning and will be processed in a specific way.</p>
<p>And thus we have the first important component of a perfect writing environment: the program is aware of what content is. Such awareness allows for extremely complicated written pieces to be assembled in a relatively easy fashion.</p>
<h3>A Sloppy Process</h3>
<p>Despite its strengths, though, LyX is an incomplete solution. It focuses on the mechanical aspects of writing and ignores what is arguably the more important component: the creative process. Using LyX, I can assemble a true monstrosity of a manuscript replete with footnotes, endnotes, references, tables, lists of figures, indices, appendices, and all of the other components of something unreadable. Yet such elements are mere after-thoughts rather than the heart and soul of the work. The center is all about ideas.</p>
<p>Which brings me to the serious limitations inherent in most word processing programs: joining ideas together is a <img alt="" align="right" src="http://www.oak-tree.us/blog/wp-content/uploads/2009/03/030509-0231-creatingthe2.png" />sloppy process and they simply don’t facilitate the sloppiness.</p>
<p>Every writer is creative in a different way. I personally start by making a miscellaneous brain dump. Everything relevant to the topic is listed out and then I start to type additional thoughts which seem relevant. After a while, I run out of steam which prompts research, reference collection, reference reading and chicken scratch notes.&#160; Then I groan, swear a little, go for a walk, and kick ideas around in my head.</p>
<p>When I come back to the computer, I move things around even further and excise any bits that now seem irrelevant (carefully saving them for later). Usually by this point, I have probably started over a few times and hopefully clarified my goals.&#160; If the process works, I get a slightly better fix on direction I intend to take and, eventually, a first draft magically seems to appear.&#160; That is when the real fun starts.</p>
<p>Unfortunately, LyX was designed to work linearly. You start at the beginning and continue to the end. All of the words and ideas are supposed to come marching out like perfect little soldiers on parade day. Using such a tool can be extremely frustrating to someone who doesn't think in a linear fashion: I want the freedom to be intuitive! </p>
<p>And in the name of freedom, I will probably use of four or five programs spanning two operating systems: OneNote for data collection, KDissert or FreeMind for MindMapping, and Word or LyX for the actual writing. Then I go back and update my files in the other programs.</p>
<p>There should be a better way! I want to use the same tool from beginning to end, not continually move between the word processor, the outliner, the mind mapper, and the note taker.</p>
<h2>A Potential Solution: Scrivener</h2>
<p>There just happens to be a program on Mac OS X that was apparently made for scattered people: <a href="http://www.literatureandlatte.com/">Scrivener</a>. Scrivener employs a number of simple (yet profoundly powerful) metaphors that let you manage the anarchy of creativity. These include:</p>
<ol>
<li>An intuitive and simple map of the project (similar to Word's Outline View). </li>
<li>A corkboard that lets you create any number of &quot;index cards&quot; with a title and short summary of the card's contents. </li>
<li>An outline view where the entire structure of your document can be seen and manipulated through drag and drop. </li>
</ol>
<p>Scrivener leverages its corkboard metaphor and outliner by linking the &quot;index card&quot; to a real piece of text. Thus, the index card actually represents the physical chunk of text in the underlying draft. The index cards can be moved, nested and set into folders and any changes made to the index cards are then instantly applied to the overall structure of the document. Pretty cool, huh? A given index card can represent a section, paragraph, chapter, or sentence. Even better is that cards can be split or joined together easily.</p>
<p>The practical result is that the entire draft is instantly fluid. You can experiment with new ideas, split away sections of text for later use, and re-arrange things as inspiration strikes you. It substantially enhances the organic process already provided by the computer. I know a surprising number of people who have moved to the Mac platform just so that they can use Scrivener.</p>
<p>While other programs (like Semantik, formally known as KDissert) use similar metaphors, the use of a &quot;summary&quot; field is what makes Scrivener stand apart. The summary begins life as an outline point and later becomes the synopsis of the section. It can keep notes, goals, or thoughts in addition to a regurgitation of what is in the text.&#160; And no other program uses anything like it. Therefore, while you can replicate many of Scrivener's best features through Word or LyX's outline view, you are stuck manipulating the entire text (which becomes impractical and unwieldy very quickly).</p>
<p style="text-align: center"><img alt="" src="http://www.oak-tree.us/blog/wp-content/uploads/2009/03/030509-0231-creatingthe3.png" /></p>
<p style="text-align: justify; margin-left: 18pt"><strong>The Outliner. </strong>Scrivener includes a high quality outliner that allows individual elements to be repositioned via drag and drop. Each outline item is connected to the text in the actual draft; therefore, changes in the outline view are immediately reflected in the structure of the document. Scrivener's outliner is particularly effective via the inclusion of a &quot;synopsis&quot; field that contains a summary of the text. This summary field isn't part of the full draft, and as a result, can begin life as an outline point that reflects the goal of the section. In contrast, the outline view in Microsoft Word uses the text of the actual document. In long or complicated documents, it is a slightly less than effective way to add new ideas.</p>
<p style="text-align: center"><img alt="" src="http://www.oak-tree.us/blog/wp-content/uploads/2009/03/030509-0231-creatingthe4.png" /></p>
<p style="margin-left: 18pt"><strong>The Corkboard. </strong>As an alternative to the outliner, Scrivener also provides a &quot;corkboard&quot; where parts of the document can be moved around on index cards. Each card has a title and summary that is is linked to a block of text in the document. Unlike the outliner, however, the corkboard only deals with one navigational element of the document. When at the top level, the cards might represent the parts or chapters of a book. When working on the corkboard of a book chapter, they might represent sections or individual scenes. There is no limit to the number of cards or nesting that can be done.</p>
<h3>Scrivener's Singular Strength</h3>
<p>Though Scrivener handles the creative process beautifully, it isn't a serious word or document processor. On the program's <a href="http://www.literatureandlatte.com/scrivener.html">website</a>, the primary developer states that Scrivener is a &quot;personal writing tool.&quot; As a result, it seems uniquely geared to creative writing; that is to say, novels and screenplays. Not many novels or screenplays have a need for a bibliography, index, appendix, footnotes, or endnotes. As a result, Scrivener cannot handle the minutiae of complicated documents.</p>
<p>Just forget support for hyperlinks, cross-links, cross-references, figures, legends or graphics. They're outside the developer's stated need and are unlikely to appear. That's too bad, because it makes Scrivener worthless to those who need support for these features. Microsoft Word has them and LyX has them, OpenOffice pretends that it has them. However, Word, LyX, OpenOffice and other word processors completely lack the creative tools that make Scrivener a joy to use.</p>
<p style="text-align: center"><img alt="" src="http://www.oak-tree.us/blog/wp-content/uploads/2009/03/030509-0231-creatingthe5.png" /></p>
<p style="margin-left: 18pt"><strong>A Glorified Text Editor. </strong>The weakest component of Scrivener is the actual word processor. Advanced (and even not so advanced) features like footnotes, endnotes, cross references of links are completely unsupported. It is simply unsuited to writing a complicated document like an article or cross-referenced book.</p>
<h2>A Combined Approach</h2>
<p>The simplicity of Scrivener's word processor causes a semi-crisis. If given my choice, I would compose nearly everything in it for the convenience of its outliner and index cards. However, it isn't up to supporting the type of heavy lifting I am often asked to do. While I could use it as my creative crutch, that worsens the overall problem. Instead of four programs across two platforms (Window/Linux), I would be using five programs across three platforms; not what I'm aiming for. I want to simplify my work process, not make it more complicated.</p>
<p>I've tried to find what I want in the software of others and determined that it doesn't exist. The fallback is to develop it myself by turning to opensource solutions. Since LyX already meets my needs as a document processor, it is a great place to start. As a front-end to LaTeX, it automatically supports the advanced features I need. It is cross-platform, which means that the writing environment would be the same regardless of whether I am working on Windows, Mac OS X, or Linux. Additionally, it has deep integration with <a href="http://www.oak-tree.us/blog/index.php/science-and-technology/svn">revision control systems</a>, which greatly simplify collaboration. Last, it is available under the GNU public license, which means that I can access the source code. LyX combined with the same creative tools found in Scrivener would be nearly perfect.</p>
<p><img alt="" align="left" src="http://www.oak-tree.us/blog/wp-content/uploads/2009/03/030509-0231-creatingthe6.png" /></p>
<h3>Almost There: LyX's Existing Features</h3>
<p>After a careful review of LyX, it becomes obvious that much of the functionality required for a robust outliner and corkboard is already present. At left is the outline panel in LyX. The outline is automatically generated from the heading information in a given document and any child documents. The particular example shown here is series of three essays kept in four different files: a master document and three child documents.</p>
<p>LyX already recognizes blocks of text and understands their contextual meaning. In fact, you can already specify the order of any element and what position it holds. Further, individual text elements can be moved from one child document to another. In other words, nearly all of the background elements for a Scrivener-like outliner or corkboard are already present.</p>
<h3>Form and Function</h3>
<p>What is missing is the ability to assign a summary or &quot;synopsis&quot; to a given chunk of text. This would ideally exist as associated meta-data and affiliated with a particular tag. Additionally, it might prove convenient to associate other meta-data in addition to the summary.</p>
<p>To add the &quot;creative elements,&quot;&#160; most development could focus on creating a user interface that&#160; blends the existing outline view with the functional equivalents of the corkboard and outliner from Scrivener. Convenient drag and drop of document sections from within the document map, outliner, or corkboard would allow text to be moved and positioned. The outliner would show the complete document with the option to expand or collapse a given section. The corkboard, in contrast, would show only the elements contained in one particular outline node.</p>
<p>The figures below show an example of what such a user-interfaces might look like. The first figure shows the outliner and the second shows the corkboard. (Though the index cards and outline points of the example correspond to the chapters and sections of the document map, this should not necessarily be required in an ideal implementation. Instead, the user would be able to determine which index cards correspond to sections and which correspond to a specific piece of evidence, argument, or narrative. That is to say, the user should be allowed the freedom to create the outline structure, rather than have it imposed.)</p>
<h2>Proposal</h2>
<p>I propose to create an add-on for LyX which would combine the best features of Scrivener with the already powerful capabilities of LyX. As described above, this would consist of two inter-related tools:</p>
<p>1) The Outliner. The outliner would be an expandable panel where the structure and rough content of a document could be laid out prior to beginning the first draft. Specific features of the Outliner would include:</p>
<p>a. Each outline point would have room for a title, synopsis and type of content (drawn from the list provided by the LaTeX class).</p>
<p>b. Individual nests in the outline can be expanded or collapsed.</p>
<p>c. Elements can be dragged and dropped from one point to another. The underlying document will be updated to reflect any changes.</p>
<p>d. Though most points in the outline might correspond to headings (e.g. book parts, chapters, sections, or subsections), this would not be required. Instead, any block of text could be assigned to a point in the outline. It would behave in precisely the same manner as other outline elements.</p>
<p style="text-align: center"><img alt="" src="http://www.oak-tree.us/blog/wp-content/uploads/2009/03/030509-0231-creatingthe7.png" /></p>
<p>2) The Corkboard. Housed in the same panel as the Outliner would also be a digital Corkboard which would display a small &quot;Index card&quot; with the title of an outline element in addition to the synopsis. However, in contrast to the outline, only the individual elements for a selected point in the document map would be shown. In the example below, the sections of a specific chapter, &quot;Eragon Shadeslayer: Sociopath&quot; are shown with their corresponding summaries. Changes in the order of the cards would be reflected in the underlying draft.</p>
<p style="text-align: center"><img alt="" src="http://www.oak-tree.us/blog/wp-content/uploads/2009/03/030509-0231-creatingthe8.png" /></p>
<h2>Conclusion</h2>
<p>The proposed additions to LyX would further expand its other excellent features, making it the only document/word processor with a powerful set of creative tools. By associating blocks of text with additional meta-data (like a synopsis), working with the document structure would become a visual and interactive process, thereby allowing for much greater flexibility. Indeed, such changes would bring LyX one step closer to writing perfection.</p>
<p><em>Note: A PDF copy of this article can be found <a href="http://www.oak-tree.us/stuff/LyX-Proposal.pdf">here</a>.</em></p>
<h3>Similar Posts:</h3>
<ul class="similar-posts">
<li><a href="http://www.oak-tree.us/blog/index.php/2009/05/13/lyx-outline" rel="bookmark" title="May 13, 2009">Introducing LyX-Outline 0.1</a></li>
<li><a href="http://www.oak-tree.us/blog/index.php/2009/11/30/latex-cv-part2" rel="bookmark" title="November 30, 2009">Typeset Your Curriculum Vitae &ndash; Part 2: Extending and Customizing an Existing Document Class</a></li>
<li><a href="http://www.oak-tree.us/blog/index.php/2008/11/20/software-cuttingoutclutter" rel="bookmark" title="November 20, 2008">On Writing &ndash; Software that cuts out distraction and clutter</a></li>
<li><a href="http://www.oak-tree.us/blog/index.php/2008/12/14/wpf-svg-xaml-part2" rel="bookmark" title="December 14, 2008">WPF – SVG Graphics and XAML – Part 2</a></li>
<li><a href="http://www.oak-tree.us/blog/index.php/2009/11/02/custom-lyx-nih" rel="bookmark" title="November 2, 2009">Customizing LyX: Create an NIH Grant Proposal Template</a></li>
</ul>
<p><!-- Similar Posts took 16.587 ms --></p>
<p>Copywrite 2009: Rob Oakes.  <a href="http://www.oak-tree.us/blog">Apolitically Incorrect</a><br/><br/><a href="http://www.oak-tree.us/blog/index.php/2009/03/04/perfect-tool">Creating the Perfect Writing Tool: A Proposal</a></p>
]]></content:encoded>
			<wfw:commentRss>http://www.oak-tree.us/blog/index.php/2009/03/04/perfect-tool/feed</wfw:commentRss>
		<slash:comments>6</slash:comments>
		</item>
	</channel>
</rss>

