]> git.donarmstrong.com Git - neurodebian.git/blobdiff - artwork/brochure/brochure_debian-neurodebian.tex
minor refreshment to the brochure
[neurodebian.git] / artwork / brochure / brochure_debian-neurodebian.tex
index ecec6a3d32637c8634aab73eee9fa84698d6d391..bfb2b7fa0a4fd5b673f85e33fa58cbbad0e5598f 100644 (file)
@@ -13,7 +13,7 @@
 \usepackage[colorlinks]{hyperref}
 
 \usepackage{multicol}
-\setlength{\columnseprule}{1pt} % for visible divider
+%\setlength{\columnseprule}{1pt} % for visible divider
 \setlength{\columnsep}{1cm}
 
 \usepackage{graphicx}
 \begin{ndtable}%
 \rowcolors[\hline]{1}{#2}{} \arrayrulecolor{#3}
 \begin{tabularx}{\columnwidth}{>{\centering\arraybackslash}X}\vspace{-.5em}\normalfont\large\bfseries
-  #1\\\end{tabularx}
+  #1\vspace{0.05em}\\\end{tabularx}
 \end{ndtable}
 \vspace{-.5em}
 }
 
-\newcommand{\ndsection}[1]{\ndheading{#1}{red!20}{red!30!gray}}
-\newcommand{\ndsubsection}[1]{\ndheading{#1}{red!10}{red!30!gray}}
+\definecolor{secfgcol}{RGB}{215, 6, 83}
+\definecolor{secbgcol}{RGB}{255, 241, 248}
+\newcommand{\ndsection}[1]{\ndheading{#1}{secbgcol}{secfgcol}}
+\newcommand{\ndsubsection}[1]{\ndheading{#1}{secbgcol}{secfgcol}}
 
 
 \begin{document}
@@ -68,6 +70,7 @@
 %%
 \begin{multicols}{3}    % 3 columns
 
+\section*{The Universal Operating System}
 \begin{center}
 \noindent
 \includegraphics[width=0.5\columnwidth]{openlogo}
@@ -76,7 +79,6 @@
 \url{http://www.debian.org}
 %\ndsection{Debian GNU/Linux}
 
-\section*{The Universal Operating System}
 % \hrule
 \end{center}
 \vspace{-1em}
 was founded by Ian Murdock in August 1993 with the goal
 to create an easy to install and maintain non-commercial GNU/Linux
 operating system that would be able to compete in the
-commercial market.  Since then Debian established itself as an
+commercial market.  Since then, Debian established itself as an
 independent and unique project driven by more than 3000
 enthusiastic contributors all around the globe.
-Principles of \emph{do-ocracy} and democracy backed up by evolving transparent
+Principles of \mbox{\emph{do-ocracy}} and democracy backed up by evolving transparent
 standards allowed Debian to deliver the most comprehensive operating system -- not
 only by amount of integrated software, but also by
 number of the supported hardware architectures.
@@ -115,7 +117,7 @@ Mint.
   All software is free and open-source (FOSS).\\
   Debian is governed by public democratic processes.
 \item[P\textnormal{opular}]\hfill\url{http://www.debian.org/users}\\
-  Used by governments, companies, educational institutions
+  Used by governments, companies, educational institutions.
 \end{description}
 
 \begin{comment}
@@ -139,20 +141,20 @@ Very (Special|Stable) Operating Platform
   versions of software into Debian.\\
   %entry point for the software to appear in Debian.\\
   Despite its name, \emph{Unstable} is a good platform for those
-  requiring the most recent versions of software
+  requiring the most recent versions of software.
 
 %\item[Testing] \emph{Constantly changing future release candidate}\\
-\item[``Almost-ready-to-release'']\hfill\emph{Testing} (now \emph{squeeze})\\
+\item[``Always-ready-to-release'']\hfill\emph{Testing} (now \emph{jessie})\\
 %  What to become a next \emph{Stable} release candidate.\\
   Software versions known to be secure and of good quality.
 %  Software migrated from \emph{Unstable} which is known to be of good
 %  quality.  Immediate updates are provided only
 %  to assure secure and robust performance. \\
   \emph{Testing} provides a good balance between stability and recency
-  of software
+  of software.
 
 %\item[Stable] \emph{Official release}\\
-\item[Official release]\hfill\emph{Stable} (now \emph{lenny})\\
+\item[Official release]\hfill\emph{Stable} (now 7.7, \emph{wheezy})\\
   % Software verified to be well tested and secure,
   % Very stable (hence the name) and secure
   % but might be lacking the most recent versions.\\% of the software.\\
@@ -161,7 +163,7 @@ Very (Special|Stable) Operating Platform
   \emph{Testing} is assured to be robust. %, on average bi-yearly.
   Complementary updates keep the
   system secure. \\
-  \emph{Stable} is the choice where stability and security are of
+  \emph{Stable} is the best choice where reliability and security are of
   primary importance.
 \end{description}
 
@@ -169,13 +171,14 @@ Very (Special|Stable) Operating Platform
 \ndsubsection{It has names}
 
 The code names of Debian releases are names of characters from the Toy
-Story animation, e.g. sid, squeeze, lenny.  \emph{Unstable}
+Story animation, \emph{e.g.} sid, jessie, wheezy.  \emph{Unstable}
 flavor always called \emph{sid}, while a new name chosen for every
 upcoming release and assigned to \emph{Testing} to become a code name
 of the release when it becomes \emph{Stable}.\\  At the moment
-\emph{squeeze} is \emph{Testing}, and \emph{lenny} is \emph{Stable}.
-As soon as \emph{squeeze} gets released, \emph{Testing} will be given
-a new name -- \emph{wheezy}.
+\emph{jessie} is \emph{Testing} (actually \emph{Frozen} in preparation
+for the release), and \emph{wheezy} is \emph{Stable}.
+As soon as \emph{jessie} gets released, \emph{Testing} will be given
+a new name.% -- \emph{jessie}.
 \end{comment}
 
 \ndsubsection{Three Debian components}
@@ -189,26 +192,26 @@ a new name -- \emph{wheezy}.
   % This is the actual Debian with full support.\\
   All software in \emph{main} is distributed under FOSS licenses
   compliant with Debian Free Software Guidelines (DFSG) to assure
-  complete freedom to use, modify, and (re-)distribute
+  complete freedom to use, modify, and (re-)distribute.
 \item[Wanna-be free]\hfill\emph{contrib}\\
-  FOSS depending on \emph{non-free} 3rd party software
+  FOSS depending on \emph{non-free} 3rd party software.
 %  Software which, despite being free itself, depends on
 %  \emph{non-free} 3rd party software, rendering it useless without
 \item[Somewhat free]\hfill\emph{non-free}\\
-  Software under restrictive licenses available at no charge
+  Software under restrictive licenses available at no charge.
  % removing some freedoms
  % (\emph{e.g.} non-commercial use only), but which is allowed to be
  % used for free and re-distributed (\emph{e.g. NVidia drivers})
 \end{description}
 
 
-\ndsubsection{Debian enthusiastic experts}
+\ndsubsection{Who is Debian}
 % could be simply 'Debian People' or 'Debian Community'
 
 Debian is the only major operating system developed
 solely by volunteer individuals who collaborate via the Internet.
 Debian developers, teams or individual contributors improve the operating
-system not by writing new applications (in most cases), but by
+system not by writing new applications (in most cases) but by
 \begin{itemize}[nolistsep,topsep=0em,leftmargin=1pc]
 \item integrating existing software into Debian
 \item fixing and communicating bug reports to original developers
@@ -227,11 +230,12 @@ teams, such as Debian-Science or Debian-Med.
 
 %\subsubsection*{Stable}
 \begin{description}[nolistsep,leftmargin=1pc,style=nextline]
-\item[Install on a hard-drive] \url{http://get.debian.net/}
-\item[Boot from CD/USB] \url{http://get.debian.net/live/}
+\item[Install on a hard-drive] \url{http://www.debian.org/distrib/}
+\item[Live CD/DVD] \url{http://www.debian.org/CD/live/}
 \item[Run in a Virtual Machine] \url{http://neuro.debian.net/vm.html}
-\item[More options (e.g. buy pre-installed machine)] \url{http://debian.org/distrib}
-\item[Testing/Unstable version] \url{http://www.debian.org/devel/debian-installer}
+\item[Development version] \url{http://www.debian.org/devel/debian-installer}
+\item[Use in a cloud] \url{https://wiki.debian.org/Cloud}
+\item[Docker: \texttt{docker pull debian}]
 \end{description}
 
 % \ndsubsection{Get \emph{Testing/Unstable} Debian}
@@ -239,11 +243,15 @@ teams, such as Debian-Science or Debian-Med.
 % Install on a hard-drive or in a Virtual Machine\\
 % \url{http://www.debian.org/devel/debian-installer}
 %
-
+\vspace{-1em}
 \ndsubsection{How to install software}
 
 GUI (Synaptic): \textit{Select and click ``Apply''}\\
-\includegraphics[width=\columnwidth]{shots/synaptic-fslview}
+\begin{center}
+\vspace{-1.2em}
+\includegraphics[width=0.95\columnwidth]{shots/synaptic-fslview}
+\vspace{-0.7em}
+\end{center}
 
 Command line: \texttt{apt-get install <packagename>}
 
@@ -260,9 +268,11 @@ Command line:
 
 \ndsubsection{How to get support}
 
-\url{http://www.debian.org/support}
+\hspace{1em}\url{http://www.debian.org/support}
 
 \begin{description}[nolistsep,leftmargin=1pc,style=nextline]
+%\item[Overview]
+
 %\item[GUI]
 %  Use \emph{Synaptic Package Manager}
 \item[Software bug]
@@ -272,7 +282,8 @@ Command line:
   %\item[Mailing lists] 
   \url{http://www.debian.org/MailingLists}\\
   \url{http://forums.debian.net}\\
-  \url{http://ask.debian.net}
+  \url{http://ask.debian.net}\\
+  \url{irc://irc.debian.org/debian}
   %\end{description}
 \item[Commercial support]
   \url{http://www.debian.org/consultants}
@@ -375,24 +386,20 @@ system allows Debian to respond to problems quickly and honestly.
 %%
 \begin{multicols}{3}    % 3 columns
 
+\section*{The Universal Research Platform}
 \begin{center}
-\noindent
-\vspace{-3em}
 \includegraphics[width=\columnwidth]{logo_tuned/label}
-
 \url{http://neuro.debian.net}
 %\ndsection{NeuroDebian Project:}
-\section*{The Universal Research Platform}
 % \hrule
 \end{center}
-\vspace{-1em}
 
 \ndsection{NeuroDebian is}
 
-a Debian project aiming to provide the Neuroscience community with a
-stable and versatile research platform -- the Debian OS.
-Since 2005, NeuroDebian integrates neuroscience software into the Debian
-operating system to allow neuroscientists to benefit from the advantages of
+a Debian project that provides the Neuroscience community with a
+stable and versatile research platform -- the Debian operating system.
+Since 2005, \mbox{NeuroDebian} integrates neuroscience software into Debian
+to allow neuroscientists to benefit from the advantages of
 the universal operating system in their day-to-day research activities.
 The NeuroDebian repository
 (\url{http://neuro.debian.net}) offers the latest research software for
@@ -400,10 +407,11 @@ all Debian suites (and various releases of Ubuntu).
 The combination of a stable generic
 operating system, Debian, and a variety of conveniently accessible research
 software creates a versatile research platform for neuroscience that offers the
-latest methodologies of the field for everyone, for free.
+latest methodologies of the field to everyone, for free.
 These advantages make NeuroDebian increasingly popular among
 neuroscientists and scientific software developers.
 
+\vspace{2em}
 
 \ndsubsection{NeuroDebian is NOT}
 
@@ -412,67 +420,76 @@ by the NeuroDebian project targets the official Debian operating system. This
 approach helps to increase the longevity of the project by relying on the
 efforts of thousands of Debian contributors.
 
+\vspace{3em}
+\columnbreak
+
+\ndsubsection{Software at your fingertips}
+\begin{flushright}
+\vspace{-0.5em}
+\url{http://neuro.debian.net/pkgs.html}
+\vspace{-0.1em}
+\end{flushright}
+\textit{Distributed computing:} Condor, DMTCP, IPython, \ldots \\
+\textit{Electrophysiology:} BioSig, Neo, Sigviewer, \ldots\\
+\textit{Machine Learning:} MDP, PyMVPA, sklearn, \ldots\\
+\textit{Neural Modeling:} Brian, CNrun, PyNN, XPPAUT \ldots\\
+\textit{Imaging:} AFNI, CMTK, FSL, Mricron, NiPy \ldots\\
+\textit{Psychophysics:} PsychoPy, Psychtoolbox-3, PyEPL \ldots\\
+\vspace{-0.8em}
+
+% TODO: Environments... -- list avail cloud env using NeuroDebian
 
 \ndsubsection{Benefits from Debian integration}
 
 \begin{itemize}[nolistsep,leftmargin=1pc]
 
 % rephrase to outline the benefit, not burden
-\item Debian standards and policies guarantee quality and robustness
+\item Debian standards and policies guarantee quality and robustness.
 
-\item Debian centralized bug tracking system provides a unified
-  single-point of entry for bug reporting and troubleshooting for any
-  software in Debian
+\item Debian's centralized bug tracking system provides a unified
+  single-point of entry for bug reporting and troubleshooting
+  for any software in Debian.
 
 \item Debian makes software available through a world-wide distribution
-  network, thus offloading bandwidth demands
+  network, thus offloading bandwidth demands.
 
-\item Other Debian enthusiasts take care about large-scale aspects of
+\item Other Debian contributors handle large-scale aspects of
   deployment, quality assurance, porting and integration at the level
   of the entire distribution:
 
 \begin{description}[nolistsep,leftmargin=1pc]
 \item[Porting] Software sources get built for 11 hardware
   architectures and 3 kernels (Linux, HURD, kFreeBSD). Porter teams
-  maintain build infrastructure and help making the code
+  maintain build infrastructure and help make the code
   platform-agnostic.
 \item[QA] Whole-archive rebuilds assure robustness of packaging and
   warn about upcoming problems (core libraries upgrades) beforehand.
-\item[Internationalization (I18n)] Translator teams help localizing
-  software for more than 60 languages
+\item[Internationalization (I18n)] Translator teams help localize
+  software for more than 60 languages.
 \end{description}
 
-\item Neuroscience software becomes 1st-class citizen within Debian
-  project, which guarantees its availability, longevity, smooth
-  installation and upgrades
+\item Neuroscience software becomes a 1st-class citizen within the
+  Debian project, which guarantees its longevity, smooth installation
+  and upgrades.
 
-\item Participation in the Debian community helps to assure Debian's
-  aptness for the neuroscientific software demands
+%\item Participation in the Debian community helps to assure Debian's
+%  aptness for the neuroscientific software demands
 
 \end{itemize}
 
 
-\ndsubsection{NeuroDebian software coverage}
-\begin{flushright}
-\vspace{-0.5em}
-\url{http://neuro.debian.net/pkgs.html}
-\vspace{-1em}
-\end{flushright}
-\textit{Electrophysiology:} BioSig, Sigviewer, Brian, \ldots\\
-\textit{Machine Learning:} PyMVPA, scikits.learn, \ldots\\
-\textit{Medical Imaging:} AFNI, FSL, Mricron, NiPy, Voxbo, \ldots\\
-\textit{Psychophysics:} PsychoPy, PyEPL, PyOptical\\
-
-
 
 %\columnbreak
 
 \ndsubsection{How to get NeuroDebian}
-\begin{description}[nolistsep,leftmargin=1pc]
-\item[Debian/Ubuntu]\url{neuro.debian.net} repository
-\item[Others] NeuroDebian Virtual Machine
+
+\textit{Debian/Ubuntu:} \url{neuro.debian.net} repository \\
+\textit{Others:} NeuroDebian Virtual Machine
+
 % Here place a left-top corner of OSX with seamless mode
-\end{description}
+\vspace{3mm}
+\includegraphics[width=\columnwidth]{../shots/mac_vm_mricron}
+
 \begin{comment}
 \ndsubsection{Developers oriented information}
 
@@ -486,33 +503,34 @@ efforts of thousands of Debian contributors.
 buga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga duga
 \end{comment}
 
+
 \def\blank{\hspace{0em}\vspace{-1em}}
 \columnbreak
-\ndsubsection{Work-in-progress}
 
-\begin{description}[nolistsep,leftmargin=1pc,topsep=1em,style=nextline]
-
-\item[Expanded coverage]\blank
-  \begin{description}[nolistsep,leftmargin=1pc,topsep=0em,style=nextline]
-  \item[Electrophysiology] BioSig, Brian, NEURON, \ldots
-  \item[Matlab/Octave toolboxes] SPM, EEGLAB, \ldots
-  \end{description}
-\vspace{0.5em}
-\epigraph{Having FreeSurfer integrated into the Debian operating system by the NeuroDebian team would have enormous benefits for us, and for the thousands of users of FreeSurfer across the world.}{Prof. Bruce Fischl}{Director, Computational Core at Martinos Center at Massachusetts General Hospital, Charlestown, Massachusetts, USA}
+\ndsubsection{Work-in-progress}
+\begin{description}[nolistsep,leftmargin=1pc,style=nextline]
+\item[Increased coverage]
+\textit{Electrophysiology:} Fieldtrip \\
+\textit{Neural Modeling:} NEURON, (NEST), LFPy \\
+\textit{Imaging:} DTI-TK, Freesurfer, XNAT, \ldots
+% \epigraph{Having FreeSurfer integrated into the Debian operating system by the NeuroDebian team would have enormous benefits for us, and for the thousands of users of FreeSurfer across the world.}{Prof. Bruce Fischl}{Director, Computational Core at Martinos Center at Massachusetts General Hospital, Charlestown, Massachusetts, USA}
 \item[Improved quality assurance]
-  Extended integration and regression testing
+  Extended integration and regression testing\\
+  \url{http://testkraut.readthedocs.org}
 \item[Available snapshotting service]
   % Entire NeuroDebian repository for any given past moment
   All versions of packages readily available
-\item[Data as the 1st class citizen]
-  \url{http://neuro.debian.net/datasets.html}
-\item[Universal availability]\blank
-  % \begin{itemize}[nolistsep,leftmargin=1pc,topsep=0em]
-  % \item Virtual Appliance enhancements
-  %\item
-  Cloud computing
-  %\end{itemize}
-
+\item[Data as the 1st-class citizen]
+  \url{http://datalad.org} data distribution
+\item[Community knowledge exchange portal]
+  \url{http://community.neurodebian.org}
+% yoh: see TODO above -- we can say that it is available already
+%\item[Universal availability]
+%  % \begin{itemize}[nolistsep,leftmargin=1pc,topsep=0em]
+%  % \item Virtual Appliance enhancements
+%  %\item
+%  Cloud computing
+%  %\end{itemize}
 \end{description}
 
 
@@ -523,7 +541,8 @@ buga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dug
 \vspace{-0.5em}
 \end{flushright}
 
-
+% TODO  yoh: This one remains the best summary IMHO.  But may be
+% we would just kick this section out an place Testimonials into References
 \epigraph{The approach taken with NeuroDebian is plainly the most appropriate
 approach to software distribution for the dominant platform in brain
 image analysis, and I have great confidence that this project will be
@@ -536,10 +555,22 @@ Pennsylvania, Philadelphia, USA}
 
 \ndsubsection{Acknowledgements}
 
-NeuroDebian is grateful to all Debian developers and contributors for the
-development of Debian OS, and to Prof. James V. Haxby (PBS Department,
-Dartmouth College) for his continued support and endless supply of
-Italian espresso (\url{http://neuro.debian.net/coffeeart.html}).
+NeuroDebian is grateful to all Debian developers and contributors for
+developing the Debian operating system, to
+\href{http://www.incf.org}{INCF} for the support in community outreach
+and technical collaborations, and to
+Prof. \href{http://haxbylab.dartmouth.edu}{James V. Haxby}
+(\href{http://www.dartmouth.edu/~psych}{PBS Department, Dartmouth
+  College}) for his continued support and endless supply of Italian
+espresso (\url{http://neuro.debian.net/coffeeart.html}).
+
+
+\ndsubsection{References}
+
+Halchenko, Y. O. \& Hanke, M. (2012). \href{http://www.frontiersin.org/Neuroinformatics/10.3389/fninf.2012.00022/full}{Open is not enough. Let’s take the next step: An integrated, community-driven computing platform for neuroscience}. Frontiers in Neuroinformatics, 6:22.
+
+% TODO: adjust for the new layout
+\url{http://neuro.debian.net/#publications}
 
 %\columnbreak
 \end{multicols}