]> git.donarmstrong.com Git - neurodebian.git/blob - artwork/brochure/brochure_debian-neurodebian.tex
Andy's review.
[neurodebian.git] / artwork / brochure / brochure_debian-neurodebian.tex
1 %-*- mode: latex; fill-column: 70 -*-
2 % ex: set sts=4 ts=4 sw=4 et tw=70:
3 %&pdflatex
4
5 \documentclass[letterpaper,landscape]{report}
6 \usepackage[landscape,margin=0.5cm]{geometry}
7 \usepackage{color}
8 \usepackage{flowfram}
9 %\usepackage{booktabs}           % for rules in tables
10 \usepackage{tabularx}           % for column-width tables
11 \usepackage[table]{xcolor}      % color control
12
13 \usepackage[colorlinks]{hyperref}
14
15 \usepackage{multicol}
16 %\setlength{\columnseprule}{1pt} % for visible divider
17 \setlength{\columnsep}{1cm}
18
19 \usepackage{graphicx}
20 \graphicspath{
21  {../}
22 }
23
24 \usepackage{enumitem}           % useful for control of listings
25 \usepackage[compact,raggedright]{titlesec}
26 \usepackage{comment}
27
28 \newcommand{\epigraph}[3]{\textit{#1}\linebreak \vspace{-1.5em} \begin{flushright}\hspace{5em}\ --\ #2\linebreak\small{#3} \end{flushright}}
29
30 \pagestyle{empty}
31 \parindent=0pt
32
33 % Attempts to change bg color of *section headings
34 %\definecolor{secbgcol}{rgb}{0.9, 0.85, 0.85}
35 %\titleformat{\section}
36 %{\color{red}\normalfont\Large\bfseries}{\ndsection}{1em}{}
37 %\titleformat{\subsection}
38 %{\color{red}\normalfont\large\bfseries}{\begin{flushright}\hfill\thesubsection
39 %  \end{flushright}}{1em}{}
40 %
41 %\usepackage{pstricks}
42
43 % To create tables within multicols
44 \makeatletter
45 \newenvironment{ndtable}
46   {\def\@captype{table}}
47   {}
48
49
50 \newcommand{\ndheading}[3]{%
51 \vspace{0.5em}
52 \begin{ndtable}%
53 \rowcolors[\hline]{1}{#2}{} \arrayrulecolor{#3}
54 \begin{tabularx}{\columnwidth}{>{\centering\arraybackslash}X}\vspace{-.5em}\normalfont\large\bfseries
55   #1\vspace{0.05em}\\\end{tabularx}
56 \end{ndtable}
57 \vspace{-.5em}
58 }
59
60 \definecolor{secfgcol}{RGB}{215, 6, 83}
61 \definecolor{secbgcol}{RGB}{255, 241, 248}
62 \newcommand{\ndsection}[1]{\ndheading{#1}{secbgcol}{secfgcol}}
63 \newcommand{\ndsubsection}[1]{\ndheading{#1}{secbgcol}{secfgcol}}
64
65
66 \begin{document}
67
68 %%
69 %% DEBIAN
70 %%
71 \begin{multicols}{3}    % 3 columns
72
73 \section*{The Universal Operating System}
74 \begin{center}
75 \noindent
76 \includegraphics[width=0.5\columnwidth]{openlogo}
77 %\includegraphics[width=0.5\columnwidth]{openlogo-vsop}
78
79 \url{http://www.debian.org}
80 %\ndsection{Debian GNU/Linux}
81
82 % \hrule
83 \end{center}
84 \vspace{-1em}
85
86 \ndsection{Debian}
87
88 was founded by Ian Murdock in August 1993 with the goal
89 to create an easy-to-install and maintain non-commercial GNU/Linux
90 operating system that would be able to compete in the
91 commercial market.  Since then Debian established itself as an
92 independent and unique project driven by more than 3000
93 enthusiastic contributors all around the globe.
94 Principles of \emph{do-ocracy} and democracy backed up by evolving transparent
95 standards allowed Debian to deliver the most comprehensive operating system -- not
96 only by amount of integrated software, but also by
97 number of the supported hardware architectures.
98 % Current installer of Debian has been translated more that to 60 languages.
99 % (12 ???  officially supported architectures).
100 % Well appreciated
101 The high quality and openness of Debian made it the foundation of choice for
102 more than 120 derivative GNU/Linux distributions, such as Ubuntu and
103 Mint.
104
105 \ndsubsection{Debian is}
106 \begin{description}[nolistsep,leftmargin=0.8em]
107 \item[V\textnormal{ersatile}]\hfill\url{http://packages.debian.org}\\
108   Over 15000 software packages maintained by experts to provide
109   a stable system for \textit{any} field of application.
110 \item[S\textnormal{ecure}]\hfill\url{http://www.debian.org/security}\\
111   Security updates guarantee safe operation.
112 %\item[S]table
113 % \item[S\textnormal{imple}]\blank\\
114 %   Single command is enough to install or upgrade single
115 %   software or the entire system at once
116 \item[O\textnormal{pen}]\hfill\url{http://www.debian.org/social_contract}\\
117   All software is free and open-source (FOSS).\\
118   Debian is governed by public democratic processes.
119 \item[P\textnormal{opular}]\hfill\url{http://www.debian.org/users}\\
120   Used by governments, companies, educational institutions.
121 \end{description}
122
123 \begin{comment}
124 Original: Very Special Old Pale
125
126 Could also stand for
127 Very (Special|Stable) Operating Platform
128 \end{comment}
129
130 %\ndsection{Understand Debian}
131 \columnbreak
132 \ndsubsection{Three Debian suites}
133
134 % Debian distribution comes in 3 major flavors
135
136 \begin{description}[nolistsep,leftmargin=1pc,topsep=0em]
137
138 %\item[Unstable] \emph{Constantly changing distribution}\\
139 \item[Development]\hfill\emph{Unstable} (always \emph{sid})\\
140   Never \emph{released}, constantly evolving platform to integrate new
141   versions of software into Debian.\\
142   %entry point for the software to appear in Debian.\\
143   Despite its name, \emph{Unstable} is a good platform for those
144   requiring the most recent versions of software.
145
146 %\item[Testing] \emph{Constantly changing future release candidate}\\
147 \item[``Almost-ready-to-release'']\hfill\emph{Testing} (now \emph{squeeze})\\
148 %  What to become a next \emph{Stable} release candidate.\\
149   Software versions known to be secure and of good quality.
150 %  Software migrated from \emph{Unstable} which is known to be of good
151 %  quality.  Immediate updates are provided only
152 %  to assure secure and robust performance. \\
153   \emph{Testing} provides a good balance between stability and recency
154   of software.
155
156 %\item[Stable] \emph{Official release}\\
157 \item[Official release]\hfill\emph{Stable} (now \emph{lenny})\\
158   % Software verified to be well tested and secure,
159   % Very stable (hence the name) and secure
160   % but might be lacking the most recent versions.\\% of the software.\\
161   % of not the most recent versions. \\
162   \emph{Stable} is released ``when it is ready'', \emph{i.e.} when
163   \emph{Testing} is assured to be robust. %, on average bi-yearly.
164   Complementary updates keep the
165   system secure. \\
166   \emph{Stable} is the choice where stability and security are of
167   primary importance.
168 \end{description}
169
170 \begin{comment}
171 \ndsubsection{It has names}
172
173 The code names of Debian releases are names of characters from the Toy
174 Story animation, e.g. sid, squeeze, lenny.  \emph{Unstable}
175 flavor always called \emph{sid}, while a new name chosen for every
176 upcoming release and assigned to \emph{Testing} to become a code name
177 of the release when it becomes \emph{Stable}.\\  At the moment
178 \emph{squeeze} is \emph{Testing}, and \emph{lenny} is \emph{Stable}.
179 As soon as \emph{squeeze} gets released, \emph{Testing} will be given
180 a new name -- \emph{wheezy}.
181 \end{comment}
182
183 \ndsubsection{Three Debian components}
184
185 % Debian distribution comes in 3 major flavors
186 %Debian Free Software Guidelines (DFSG)\\
187 %\url{http://www.debian.org/social_contract}
188
189 \begin{description}[nolistsep,leftmargin=1pc,topsep=0em]
190 \item[Free as in freedom]\hfill\emph{main}\\
191   % This is the actual Debian with full support.\\
192   All software in \emph{main} is distributed under FOSS licenses
193   compliant with Debian Free Software Guidelines (DFSG) to assure
194   complete freedom to use, modify, and (re-)distribute.
195 \item[Wanna-be free]\hfill\emph{contrib}\\
196   FOSS depending on \emph{non-free} 3rd party software.
197 %  Software which, despite being free itself, depends on
198 %  \emph{non-free} 3rd party software, rendering it useless without
199 \item[Somewhat free]\hfill\emph{non-free}\\
200   Software under restrictive licenses available at no charge.
201  % removing some freedoms
202  % (\emph{e.g.} non-commercial use only), but which is allowed to be
203  % used for free and re-distributed (\emph{e.g. NVidia drivers})
204 \end{description}
205
206
207 \ndsubsection{Debian enthusiastic experts}
208 % could be simply 'Debian People' or 'Debian Community'
209
210 Debian is the only major operating system developed
211 solely by volunteer individuals who collaborate via the Internet.
212 Debian developers, teams or individual contributors improve the operating
213 system not by writing new applications (in most cases), but by
214 \begin{itemize}[nolistsep,topsep=0em,leftmargin=1pc]
215 \item integrating existing software into Debian
216 \item fixing and communicating bug reports to original developers
217 \item assuring overall quality of the distribution
218 \item improving documentation and translations
219 \item providing user support
220 \end{itemize}
221
222 Packaged software in Debian have individual maintainers who are
223 often also users of a particular software, and who are therefore interested in its
224 reliable operation. Certain fields of applications have dedicated maintainer
225 teams, such as Debian-Science or Debian-Med.
226
227 %\columnbreak
228 \ndsubsection{How to get Debian}
229
230 %\subsubsection*{Stable}
231 \begin{description}[nolistsep,leftmargin=1pc,style=nextline]
232 \item[Install on a hard-drive] \url{http://get.debian.net/}
233 \item[Boot from CD/USB] \url{http://get.debian.net/live/}
234 \item[Run in a Virtual Machine] \url{http://neuro.debian.net/vm.html}
235 \item[More options (e.g. buy pre-installed machine)] \url{http://debian.org/distrib}
236 \item[Testing/Unstable version] \url{http://www.debian.org/devel/debian-installer}
237 \end{description}
238
239 % \ndsubsection{Get \emph{Testing/Unstable} Debian}
240 %
241 % Install on a hard-drive or in a Virtual Machine\\
242 % \url{http://www.debian.org/devel/debian-installer}
243 %
244
245 \ndsubsection{How to install software}
246
247 GUI (Synaptic): \textit{Select and click ``Apply''}\\
248 \includegraphics[width=\columnwidth]{shots/synaptic-fslview}
249
250 Command line: \texttt{apt-get install <packagename>}
251
252
253
254 \ndsubsection{How to upgrade the entire system}
255
256 GUI (Synaptic):
257
258 \quad\textit{Click ``Mark All Upgrades'', ``Apply''}\\
259 Command line:
260
261 \quad\texttt{apt-get update; apt-get dist-upgrade}
262
263 \ndsubsection{How to get support}
264
265 \url{http://www.debian.org/support}
266
267 \begin{description}[nolistsep,leftmargin=1pc,style=nextline]
268 %\item[GUI]
269 %  Use \emph{Synaptic Package Manager}
270 \item[Software bug]
271   \texttt{reportbug <packagename>}
272 \item[Community support]
273   %\begin{description}[nolistsep,leftmargin=1pc]
274   %\item[Mailing lists] 
275   \url{http://www.debian.org/MailingLists}\\
276   \url{http://forums.debian.net}\\
277   \url{http://ask.debian.net}
278   %\end{description}
279 \item[Commercial support]
280   \url{http://www.debian.org/consultants}
281 \end{description}
282
283 \begin{comment}
284 \ndsection{Reasons to choose Debian}
285 \paragraph{It is maintained by its users}
286
287 If something needs to be fixed or improved, we just do it.
288
289 \paragraph{Unparalleled support}
290
291 Mail sent to the mailing lists often gets answers within 15 minutes (or less),
292 for free, and by the people who developed it. Compare that to typical phone
293 support: hours spent on the phone, for money, only to get someone who doesn't
294 know the system well enough to even understand your question.
295
296 \paragraph{You wouldn't be alone in your choice}
297
298 A wide range of organizations and individuals use Debian. See our Who's Using
299 Debian? page for a description of some high-profile sites which use Debian, and
300 have chosen to submit a short description of how they use Debian and why.
301
302 \paragraph{The best packaging system in the world.}
303
304 Tired of old files from software three versions old cluttering your system? Or
305 installing a piece of software only to find it causes your system to crash
306 because of software conflicts? Dpkg, Debian's endured packaging system, takes
307 care of these issues for you.
308
309 \paragraph{Easy installation}
310
311 If you have heard that GNU/Linux is difficult to install, then you haven't
312 tried Debian lately. We are constantly improving the installation process. You
313 can do the installation directly from CD, DOS, floppies or even over the
314 network.
315
316 \paragraph{Incredible amounts of software}
317
318 Debian comes with over 25000 different pieces of software. Every bit of it is
319 free. If you have proprietary software that runs under GNU/Linux, you can still
320 use it - in fact, there may even be an installer in Debian that will
321 automatically install and set up everything for you.
322
323 \paragraph{Packages well integrated}
324
325 Debian surpasses all other distributions in how well its packages are
326 integrated. Since all software is packaged by a coherent group, not only can
327 all packages be found at a single site, but you can be assured that we have
328 already worked out all issues regarding complicated dependencies. While we feel
329 that the deb format has some advantages over the rpm format, it is the
330 integration between the packages that makes a Debian system more robust.
331
332 \paragraph{Source code}
333
334 If you are a software developer, you will appreciate the fact that there are
335 hundreds of development tools and languages, plus millions of lines of source
336 code in the base system. All of the software in the main distribution meets the
337 criteria of the Debian Free Software Guidelines (DFSG). This means that you can
338 freely use this code to study from, or to incorporate into new free software
339 projects. There are also plenty of tools and code suitable for use in
340 proprietary projects.
341
342 \paragraph{Easy upgrades}
343
344 Due to our packaging system, upgrading to a new version of Debian is a snap.
345 Just run apt-get update ; apt-get dist-upgrade (or aptitude update; aptitude
346 dist-upgrade in newer releases) and you can upgrade from a CD in a matter of
347 minutes or point apt at one of the over 300 Debian mirrors and upgrade over the
348 net.
349
350 \rotatebox{90}{\includegraphics[height=.9\columnwidth]{distro-dev}}
351 \rotatebox{90}{Description}
352
353 \paragraph{Multiple architectures and kernels}
354
355 Currently Debian supports an impressive number of CPU architectures: alpha,
356 amd64, armel, hppa, i386, ia64, mips, mipsel, powerpc, s390, and sparc. It also
357 runs on GNU Hurd and FreeBSD kernels besides Linux, and with the debootstrap
358 utility you will be hard-pressed to find a device that can't run Debian.
359
360 \paragraph{Bug tracking system}
361
362 Debian's bug tracking system is publicly available. We don't try to hide the
363 fact that software doesn't always work the way users want. Users are encouraged
364 to submit bug reports and are notified when and why the bug was closed. This
365 system allows Debian to respond to problems quickly and honestly.
366
367
368 \ndsection{Acknowledgements}
369 \end{comment}
370
371 \end{multicols}
372
373
374 \pagebreak
375 %%
376 %% NeuroDEBIAN
377 %%
378 \begin{multicols}{3}    % 3 columns
379
380 \section*{The Universal Research Platform}
381 \begin{center}
382 \includegraphics[width=\columnwidth]{logo_tuned/label}
383 \url{http://neuro.debian.net}
384 %\ndsection{NeuroDebian Project:}
385 % \hrule
386 \end{center}
387
388 \ndsection{NeuroDebian is}
389
390 a Debian project that provides the Neuroscience community with a
391 stable and versatile research platform -- the Debian OS.
392 Since 2005, NeuroDebian integrates neuroscience software into the Debian
393 operating system to allow neuroscientists to benefit from the advantages of
394 the universal operating system in their day-to-day research activities.
395 The NeuroDebian repository
396 (\url{http://neuro.debian.net}) offers the latest research software for
397 all Debian suites (and various releases of Ubuntu).
398 The combination of a stable generic
399 operating system, Debian, and a variety of conveniently accessible research
400 software creates a versatile research platform for neuroscience that offers the
401 latest methodologies of the field to everyone, for free.
402 These advantages make NeuroDebian increasingly popular among
403 neuroscientists and scientific software developers.
404
405 \vspace{2em}
406
407 \ndsubsection{NeuroDebian is NOT}
408
409 yet another Debian GNU/Linux derivative distribution.  All work done
410 by the NeuroDebian project targets the official Debian operating system. This
411 approach helps to increase the longevity of the project by relying on the
412 efforts of thousands of Debian contributors.
413
414 \vspace{3em}
415 \columnbreak
416
417 \ndsubsection{NeuroDebian software coverage}
418 \begin{flushright}
419 \vspace{-0.5em}
420 \url{http://neuro.debian.net/pkgs.html}
421 \end{flushright}
422 \textit{Electrophysiology:} BioSig, Sigviewer, Brian, \ldots\\
423 \textit{Machine Learning:} PyMVPA, scikits.learn, \ldots\\
424 \textit{Imaging:} AFNI, FSL, Mricron, NiPy, Voxbo, \ldots\\
425 \textit{Psychophysics:} PsychoPy, PyEPL, PyOptical, \ldots\\
426 \vspace{-0.5em}
427
428 \ndsubsection{Benefits from Debian integration}
429
430 \begin{itemize}[nolistsep,leftmargin=1pc]
431
432 % rephrase to outline the benefit, not burden
433 \item Debian standards and policies guarantee quality and robustness
434
435 \item Debian's centralized bug tracking system provides a unified
436   single-point of entry for bug reporting and troubleshooting for any
437   software in Debian
438
439 \item Debian makes software available through a world-wide distribution
440   network, thus offloading bandwidth demands
441
442 \item Other Debian contributors handle large-scale aspects of
443   deployment, quality assurance, porting and integration at the level
444   of the entire distribution:
445
446 \begin{description}[nolistsep,leftmargin=1pc]
447 \item[Porting] Software sources get built for 11 hardware
448   architectures and 3 kernels (Linux, HURD, kFreeBSD). Porter teams
449   maintain build infrastructure and help make the code
450   platform-agnostic.
451 \item[QA] Whole-archive rebuilds assure robustness of packaging and
452   warn about upcoming problems (core libraries upgrades) beforehand.
453 \item[Internationalization (I18n)] Translator teams help localize
454   software for more than 60 languages.
455 \end{description}
456
457 \item Neuroscience software becomes a 1st-class citizen within the Debian
458   project, which guarantees its availability, longevity, smooth
459   installation and upgrades.
460
461 %\item Participation in the Debian community helps to assure Debian's
462 %  aptness for the neuroscientific software demands
463
464 \end{itemize}
465
466
467
468 %\columnbreak
469
470 \ndsubsection{How to get NeuroDebian}
471
472 \textit{Debian/Ubuntu:} \url{neuro.debian.net} repository \\
473 \textit{Others:} NeuroDebian Virtual Machine
474
475 % Here place a left-top corner of OSX with seamless mode
476 \vspace{3mm}
477 \includegraphics[width=\columnwidth]{../shots/mac_vm_mricron}
478
479 \begin{comment}
480 \ndsubsection{Developers oriented information}
481
482 %\columnbreak
483
484 \ndsubsection{Who is using NeuroDebian}
485
486 \noindent
487 %\includegraphics[width=\columnwidth]{usage_worldmap}
488
489 buga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga duga
490 \end{comment}
491
492
493 \def\blank{\hspace{0em}\vspace{-1em}}
494 \columnbreak
495
496 \ndsubsection{Work-in-progress}
497 \begin{description}[nolistsep,leftmargin=1pc,style=nextline]
498 \item[Increased coverage]
499 \textit{Electrophysiology:} NEURON, OpenElectrophy, \ldots \\
500 \textit{Matlab/Octave toolboxes:} SPM, EEGLAB, \ldots \\
501 \textit{Distributed computing:} Condor \\
502 \textit{Imaging:} Connectomeviewer, Freesurfer, MIPAV \\
503
504 \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}
505 \item[Improved quality assurance]
506   Extended integration and regression testing
507 \item[Available snapshotting service]
508   % Entire NeuroDebian repository for any given past moment
509   All versions of packages readily available
510 \item[Data as the 1st class citizen]
511   \url{http://neuro.debian.net/datasets.html}
512 \item[Universal availability]
513   % \begin{itemize}[nolistsep,leftmargin=1pc,topsep=0em]
514   % \item Virtual Appliance enhancements
515   %\item
516   Cloud computing
517   %\end{itemize}
518
519 \end{description}
520
521
522 \ndsubsection{Testimonials}
523 \begin{flushright}
524 \vspace{-0.5em}
525 \url{http://neuro.debian.net/testimonials.html}
526 \vspace{-0.5em}
527 \end{flushright}
528
529
530 \epigraph{The approach taken with NeuroDebian is plainly the most appropriate
531 approach to software distribution for the dominant platform in brain
532 image analysis, and I have great confidence that this project will be
533 a major asset to the neuroscience community in facilitating the
534 distribution of stable software, improving the reliability and
535 replicability of analyses, and in helping to improve software
536 development practices.}{Prof. Daniel Y. Kimberg}{Director, Data
537 Processing Facility, Center for Functional Neuroimaging, University of
538 Pennsylvania, Philadelphia, USA}
539
540 \ndsubsection{Acknowledgements}
541
542 NeuroDebian is grateful to all Debian developers and contributors for the
543 development of Debian OS, and to Prof. James V. Haxby (PBS Department,
544 Dartmouth College) for his continued support and endless supply of
545 Italian espresso (\url{http://neuro.debian.net/coffeeart.html}).
546
547 %\columnbreak
548 \end{multicols}
549
550
551
552 \end{document}
553
554
555 %%% Local Variables:
556 %%% mode: latex
557 %%% TeX-master: t
558 %%% TeX-PDF-mode: t
559 %%% whizzy-viewers: (("-pdf" "okular") ("-dvi" "xdvi") ("-ps" "gv"))
560 %%% End: