Skip to content

Commit

Permalink
typo
Browse files Browse the repository at this point in the history
  • Loading branch information
psilentp committed Sep 12, 2018
1 parent 6ae26b9 commit 369013c
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions docs/introduction.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ Introduction

What is figurefirst?
--------------------
Constructing figures for publication in scientific journals requires some attention to the details of styling and layout. For example, consider the descriptive analysis of the iris dataset below. The plot on the left was constructed using the matplotlib gridspec tool, and is perfectly acceptable representation of the data; but a more efficient use of the space can be achieved with a little manual adjustments. Note how in the version on the right, the x axis is shared across distributions and how the layout helps clarify the structure of the data. The main objective of figurefirst is to facilitate the construction of these more organic layouts with minimal work.
Constructing figures for publication in scientific journals requires some attention to the details of styling and layout. For example, consider the descriptive analysis of the iris dataset below. The plot on the left was constructed using the matplotlib gridspec tool, and is perfectly acceptable representation of the data; but a more efficient use of the space can be achieved with a little manual adjustment. Note how in the version on the right, the x axis is shared across distributions and how the layout helps clarify the structure of the data. The main objective of figurefirst is to facilitate the construction of these more organic layouts with minimal work.

.. image:: images/comparison.png

Expand All @@ -24,4 +24,4 @@ The ```figurefirst``` library seeks allow effort devoted to the raw analysis and

Should I use figurefirst?
-----------------------------
The traditional work-flow may be suitable in many cases, but it is inherently a uni-directional process: an experiment is designed, data are collected, analyzed, a manuscript is written, and the analyzed data are assembled into a final figure sequence. Science rarely advances in such a linear manner: new data are collected, analyses are revised and even new experiments are conceived well after the writing process has commenced. `Some authors <https://www.youtube.com/watch?v=q3mrRH2aS98>`_, have proposed initiating the process of manuscript assembly at the most preliminary findings by constructing an outline. and iteratively building the manuscript as you perform experiments by filling out this outline. The Figurefirst philosophy is analogous, with the layout serving much like the outline, allowing figure to be filled out as hypothesis are tested and experiments are performed.
The traditional work-flow may be suitable in many cases, but it is inherently a uni-directional process: an experiment is designed, data are collected, analyzed, a manuscript is written, and the analyzed data are assembled into a final figure sequence. Science rarely advances in such a linear manner: new data are collected, analyses are revised and even new experiments are conceived well after the writing process has commenced. `Some authors <https://www.youtube.com/watch?v=q3mrRH2aS98>`_, have proposed initiating the process of manuscript assembly at the most preliminary findings by constructing an outline. and iteratively building the manuscript as you perform experiments by filling out this outline. The Figurefirst philosophy is analogous, with the layout serving much like the outline, allowing figure to be filled out as hypothesis are tested and experiments are performed.

0 comments on commit 369013c

Please sign in to comment.