.. _WELCOme:
-***********************************************
- Welcome to the Debian Neuroscience Repository
-***********************************************
+*************
+ NeuroDebian
+*************
-.. quotes::
- :random: 1
+NeuroDebian provides a large collection of popular neuroscience research
+software for the Debian_ operating system as well as Ubuntu_ and other
+derivatives. Popular packages include FSL, Freesurfer, AFNI, PyMVPA and
+:ref:`many others <pkglists>`. While we do strive to maintain a high level of
+quality, we make no guarantee that a given package works as expected, so use
+them at your own risk. If you do encounter problems or would just like to thank
+us, simply `send us an email <#contacts>`_.
-This repository provides mostly neuroscience-related packages to be used on
-Debian_ systems (or Debian-derivatives like Ubuntu_). It contains both unofficial
-or prospective packages which are not (yet) available from the main Debian_
-archive, as well as backported or simply rebuilt packages also available
-elsewhere. Please see the :ref:`faq` for more information about the goals of
-this project, and :ref:`read what people say about it <testimonials>`.
-Take a look at the :ref:`list of our current and planned projects <projects>` if
-you want to get involved. If you appreciate this service, please |spread|.
-
-.. note::
-
- This service is provided "as is". There is no guarantee that a package
- works as expected, so use them at your own risk. If you encounter problems,
- please `report <#contacts>`_ them.
+Learn more about NeuroDebian, the goals of this project, and help us |spread|!
+ Halchenko, Y. O. & Hanke, M. (2012). `Open is not enough. Let’s take the
+ next step: An integrated, community-driven computing platform for neuroscience
+ <http://www.frontiersin.org/Neuroinformatics/10.3389/fninf.2012.00022/full>`_.
+ *Frontiers in Neuroinformatics*, 6:22.
.. raw:: html
- <p>
- <a href="pkgs.html"><img border="0" src="_static/package.png" title="Software package list" /></a>
- <a href="pkglists/pkgs-by_release-datasets_(data).html"><img border="0" src="_static/datasets.png" title="Dataset package list" /></a>
- <a href="vm.html"><img border="0" src="_static/machine.png" title="Get NeuroDebian for your non-Debian computer" /></a>
- <a href="debian/pool"><img border="0" src="_static/pool.png" title="Go to the package pool (deep and cold, only for experts)" /></a>
- <a href="projects.html"><img border="0" src="_static/workarea.png" title="Current and planned projects: Get involved!" /></a>
- <a href="blog/index.html"><img border="0" src="_static/rssfeeds.png" title="NeuroDebian Insider Blog" /></a>
- </p>
-
-.. _Ubuntu: http://www.ubuntu.com
+ <!-- for dynamic quote update via javascript -->
+ <hr />
+ <div id="randomquote" title="Feedback from the community">
-.. _news:
-
-News
-====
+.. quotes::
+ :random: 1
.. raw:: html
- <script src="_static/jquery.livetwitter.min.js"></script>
- <div id="identica_widget"></div>
- <script type="text/javascript">
- $("#identica_widget").liveTwitter('neurodebian',
- {service: 'identi.ca',
- mode: 'user_timeline',
- limit: 10,
- rate: 300000});
- </script>
-
-For more news and information see our :ref:`blog <blog>`. Older news items are
-available on identi.ca_. Follow us on identi.ca_ (preferred) or twitter_ to
-subscribe to the NeuroDebian news.
+ </div><!-- randomquote -->
-.. _identi.ca: http://identi.ca/neurodebian
-.. _twitter: http://twitter.com/NeuroDebian
+.. _Ubuntu: http://www.ubuntu.com
.. _repository_howto:
+.. _chap_installation:
+Get NeuroDebian
+===============
+Make your selection to enable NeuroDebian on your computer:
-How to use this repository
-==========================
+.. include:: sources_lists
-To enable the NeuroDebian repository on your system, select your Debian or
-Ubuntu release and a repository mirror from the lists below. Upon selection
-a short command snippet will be displayed that can be copied and pasted into
-a terminal session. These commands will configure the system package manager
-with the NeuroDebian repository key and package source information.
+.. raw:: html
-.. include:: sources_lists
+ <div id="reposetup" style="display:none">
+
+ <p>Copy and paste the following command into a terminal window:</p>
+ <pre id="code">
+ After selecting a release the setup code will be shown here.
+ </pre>
Once this is done, you have to update the package index and you are ready to
install packages. Use your favorite package manager, e.g. synaptic, adept. In
about which package version is available for which release and architecture,
please have a look at the corresponding package pages.
+.. raw:: html
-.. _chap_installation:
-
-Ways to use NeuroDebian
-=======================
+ </div> <!-- end reposetup -->
-Virtual machine
----------------
+ <div id="vmsetup" style="display:none">
If you are not running Debian_ on a particular machine a :ref:`chap_vm` is
provided as a convenient testing and evaluation environment. After a few
<http://www.debian.org/distrib/>`_ to obtain the images for your
hardware architecture and then simply add |repos|.
+.. raw:: html
-.. _chap_team:
+ </div> <!-- end vmsetup -->
+.. _news:
-The team
-========
+News
+====
+
+.. raw:: html
+
+ <script src="_static/jquery.livetwitter.min.js"></script>
+ <div id="identica_widget"></div>
+ <script type="text/javascript">
+ $("#identica_widget").liveTwitter('neurodebian',
+ {service: 'identi.ca',
+ mode: 'user_timeline',
+ limit: 10,
+ rate: 300000});
+ </script>
+
+For more news and information see our :ref:`blog <blog>`. Older news items are
+available on identi.ca_. Follow us on identi.ca_ (preferred) or twitter_ to
+subscribe to the NeuroDebian news.
+
+.. _identi.ca: http://identi.ca/neurodebian
+.. _twitter: http://twitter.com/NeuroDebian
-Our main goal is to provide neuroscience FOSS_ for Debian_. Thus the
-whole project would not be possible without the work of over 3,000
-Debian_ developers and contributors who are as enthusiastically pursuing
-a similar goal. To add our share -- Debian_ packages of FOSS_ for
-neuroscience research -- the `Experimental Psychology Debian packaging
-project <http://alioth.debian.org/projects/pkg-exppsy>`_ was created
-to formally join the forces of
-* `Michael Hanke <http://mih.voxindeserto.de>`_
-* `Yaroslav Halchenko <http://www.onerussian.com>`_
-A number of packages that are now available from the NeuroDebian repository
-were not packaged by our team, but similar Debian teams. Therefore we want to
-express particular gratitude to the `Debian Med`_ and `Debian Science`_ teams
-for all their work.
.. _support:
* neurodebian-users_: Discussions and support of NeuroDebian users
* neurodebian-upstream_: General discussions and knowledge sharing
- among developers of the neuroscience software. We will also use it
+ among developers of neuroscience software. We also use it
to update you with summaries of recent relevant developments in
Debian project
You are welcome also to join #neurodebian IRC room on OFTC network if
you have quick questions or want to join a live discussion.
+.. _chap_team:
+
+The team
+========
+
+`Michael Hanke <http://mih.voxindeserto.de>`_ and `Yaroslav Halchenko
+<http://www.onerussian.com>`_ originally started NeuroDebian (formerly the
+`Experimental Psychology Debian packaging project
+<http://alioth.debian.org/projects/pkg-exppsy>`_) and are the current project
+leaders. However, the whole project would not be possible without the work of
+over 3,000 Debian_ developers and contributors who are as enthusiastically
+building the Debian operating system.
+A number of packages that are available from the NeuroDebian repository have
+been contributed by various individuals and other teams in Debian, such as
+`Debian Med`_ and `Debian Science`_. We want to express our gratitude to all
+maintainers_ that help to make Debian_ the ultimate software platform for
+neuroscience.
+
+.. _maintainers: pkgs.html#by-maintainer
+
+
Acknowledgements
================
* `Department of Psychological and Brain Sciences at Dartmouth College`_
*[us-nh]* (primary mirror)
* `Department of Experimental Psychology at the University of Magdeburg`_
- *[de]*
+ *[de-md]*
* `Neurobot at Aristotle University of Thessaloniki, Greece`_ *[gr]*
* `Paul Ivanov`_ *[us-ca]*
* `Medical-image Analysis and Statistical Interpretation lab at Vanderbilt`_
*[us-tn]*
+* `Australia's research and education network (AARNET)
+ <http://www.aarnet.edu.au>`_ *[au]*
+* Kiyotaka Nemoto (AKA Mr. Lin4Neuro_) *[jp]*
+* Iaroslav Iurchenko *[ua]*
+* `Nikolaus Valentin Haenel`_ *[de-v]*
If your are interested in mirroring the repository, please see the :ref:`faq`.
.. _Neurobot at Aristotle University of Thessaloniki, Greece: http://neurobot.bio.auth.gr
.. _Paul Ivanov: http://www.pirsquared.org
.. _Medical-image Analysis and Statistical Interpretation lab at Vanderbilt: https://masi.vuse.vanderbilt.edu
+.. _Nikolaus Valentin Haenel: http://haenel.co
Publications
============
-Hanke, M. & Halchenko, Y. O. (Accepted). Neuroscience runs on GNU/Linux.
-*Frontiers in Neuroinformatics*.
+Hanke, M. (2012). `Share your tools! But fear the wombat! Seriously.
+<http://neuro.debian.net/_files/Hanke_FearTheWombat_Brainhack2012.pdf>`_ *Talk
+given at* `Brainhack <http://brainhack.org/2012/04/06/brainhack-2012-unconference>`_ 2012 at the
+Max-Planck-Institute for Human Cognitive and Brain Sciences*, Leipzig, Germany.
+[`video <http://youtu.be/8t6znEOEDVo>`_]
+
+Hanke, M. (2012). `Computational and cognitive neuroscience boosted by Debian
+OR Just using Debian is not enough
+<http://neuro.debian.net/_files/Hanke_UsingDebianIsNotEnough_ESRF2012.pdf>`_.
+Talk given at the workshop "Debian for Scientific Facilities Days" at the
+European Synchrotron Radiation Facility (ESRF), Grenoble, France.
+
+Halchenko, Y. O. & Hanke, M. (2012). `Open is not enough. Let’s take the
+next step: An integrated, community-driven computing platform for neuroscience
+<http://www.frontiersin.org/Neuroinformatics/10.3389/fninf.2012.00022/full>`_. *Frontiers in Neuroinformatics*,
+6:22.
+
+.. raw:: html
+
+ <span id="morepublicationsbutton" class="button" title="Click to toogle more"></span>
+ <div id="morepublications">
+
+Hanke, M. (2012). `The why and how of getting packaged
+<_files/Hanke_GetPackaged_CodeJam5_2012.pdf>`_.
+*Talk given at BrainScaleS CodeJam 5, Convergence in Computational Neuroscience*,
+University of Edinburgh, Edinburgh, UK.
+
+Halchenko, Y. O. & Hanke, M. (2012). `Environments for efficient
+contemporary research in neuroimaging: PyMVPA and NeuroDebian
+<_files/HalchenkoHanke_ContemporaryNeuroimaging_PENN2012.pdf>`_.
+*Talk given at the University of Pennsylvania School of Medicine*,
+Philadelphia, PA, USA.
+
+Hanke, M. (2012). `Rock solid, brand new, everyday, for free, not a joke:
+NeuroDebian <_files/Hanke_NeuroDebian_MPI2012.pdf>`_.
+*Talk given at the Max-Planck-Institute for Human Cognitive and Brain
+Sciences*, Leipzig, Germany.
+
+Hanke, M. (2011). `More than batteries included: NeuroDebian
+<_files/Hanke_NeuroDebian_EuroSciPy2011.pdf>`_.
+*Talk given at the Python in Neuroscience satellite of EuroScipy 2011*,
+Paris, France.
+
+Halchenko, Y. O. (2011). `π's in Debian or Scientific Debian: NumPy, SciPy and beyond
+<_files/Halchenko_EuroScipy11_3_14s_in_Debian.pdf>`_.
+*Talk given at* `EuroScipy 2011 <http://www.euroscipy.org/talk/4379>`_,
+Paris, France.
+
+Hanke, M. & Halchenko, Y. O. (2011). `Neuroscience runs on GNU/Linux
+<http://www.frontiersin.org/Neuroinformatics/10.3389/fninf.2011.00008/full>`_.
+*Frontiers in Neuroinformatics, 5:8*.
+
+Hanke, M., Halchenko, Y. O. & Haxby, J. V. (2011). `NeuroDebian -- versatile
+platform for brain-imaging research <_files/NeuroDebian_HBM2011.png>`_
+*Poster presented at the annual meeting of the Organisation for Human Brain
+Mapping*, Quebec City, Canada.
Hanke, M. (2011). `Integrating Condor into the Debian operating system
<_files/Hanke_CondorDebianIntegration_CondorWeek2011.pdf>`_.
Halchenko, Y. O., Hanke, M., Haxby, J. V., Pollmann, S. & Raizada, R. D.
(2010). `Having trouble getting your Nature paper? Maybe you are not using the
-right tools? <_files/NeuroDebian_SfN2010.png>`_ *Poster to be presented at the
+right tools? <_files/NeuroDebian_SfN2010.png>`_ *Poster presented at the
annual meeting of the Society for Neuroscience*, San Diego, USA.
Hanke, M., Halchenko, Y. O. (2010). `Debian: The ultimate platform for
<_files/HalchenkoHanke_FossEcosystemDC09.pdf>`_. *Talk given at*
`Dartmouth College`_, New Hampshire, USA.
+.. raw:: html
+
+ </div>
+
.. _DebConf10: http://debconf10.debconf.org/
.. _Dartmouth College: http://www.dartmouth.edu/
+Popularity
+==========
+
+.. raw:: html
+
+ <p><img border="0" src="_files/nd_subscriptionstats.png" title="Statistics of new repository subscriptions for all supported releases. Note: subscription is only done once per machine." /></p>
+
+Popularity Contest
+------------------
+
+We encourage you to participate in the `popularity
+contest <http://popcon.debian.org>`_ (popcon), which anonymously
+collects the list of packages you installed/use on your system.
+Collecting such statistics is of particular importance for research
+software projects as a prove of an existing user-base. If upon
+installation of the system you rejected the invitation to participate
+you can always change your decision by running::
+
+ sudo dpkg-reconfigure popularity-contest
+
+.. note::
+
+ If you are deploying multiple systems through cloning, to not have
+ all systems considered as one, it would be necessary to re-generate
+ the random MY_HOSTID. Following commands ran as root should do it
+ (as root) without any interactive dialog::
+
+ sed -i -e 's,PARTICIPATE *= *.no.,PARTICIPATE="yes",g' -e '/^ *MY_HOSTID/d' /etc/popularity-contest.conf
+ DEBIAN_FRONTEND=noninteractive dpkg-reconfigure popularity-contest
+
+In addition to popcon pages for your "core" distribution (e.g. `Debian
+<http://popcon.debian.org/>`__ or `Ubuntu
+<http://popcon.ubuntu.com/>`__) you can see/get statistics for
+submissions to `NeuroDebian <http://neuro.debian.net/popcon/>`__ and
+know that you are already contributing back to the community.
+
.. toctree::
:hidden:
+ blog/index
faq
pkgs
spread
photoalbum
projects
testimonials
+ testimonials-topics
.. probably should be purged altogether
.. toctree::
.. include:: link_names.txt
.. include:: substitutions.txt
+
+.. raw:: html
+
+ <script type="text/javascript">
+ $(document).ready(function($) {
+ setInterval(function(){
+ $.get('testimonials.html', function(data) {
+ var quotes = $("blockquote", data);
+ var idx = Math.floor(quotes.length * Math.random());
+ $('#randomquote').html(quotes[idx]);
+ }); // update callback
+ }, 60000); // set interval
+ }); // doc ready
+ //$("h1").html("NeuroDebian <span style=\"font-size:14px\">— the ultimate neuroscience software platform</span>")
+
+ function foldbuttontoggle(foldname) {
+ var foldid = '#' + foldname;
+ var buttonid = foldid + 'button';
+ $(buttonid).on('click', function() {
+ $('#' + foldname).slideToggle();
+ if ($(buttonid).html() == "↓↓↓") {
+ $(buttonid).html("↑↑↑");
+ }
+ else {
+ $(buttonid).html("↓↓↓");
+ }
+ });
+ $(foldid).slideUp();
+ $(buttonid).html("↓↓↓");
+ };
+
+ function createrepourl(rel, mir) {
+ if(rel in rel2name && mir in mirrors) {
+
+ var retrepo = "wget -O- http://neuro.debian.net/lists/" + rel2name[rel] + "."
+ + mir + " | sudo tee /etc/apt/sources.list.d/neurodebian.sources.list\n"
+ + "sudo apt-key adv --recv-keys --keyserver pgp.mit.edu 2649A5A9\n";
+ return retrepo;
+ }
+
+ };
+ function updateout(rel, mir) {
+ if (rel != '' && mir != '') {
+ $('#code').text(createrepourl(rel, mir));
+ if (rel in {'win':'', 'rel':''}) {
+ $('#vmsetup').slideDown();
+ $('#reposetup').slideUp();
+ } else {
+ $('#reposetup').slideDown();
+ $('#vmsetup').slideUp();
+ };
+ }
+ else
+ {
+ $('#reposetup').slideUp();
+ $('#vmsetup').slideUp();
+ };
+ };
+ $('#release').change(function() {
+ var singleValues = $("#release").val();
+ var mirrorVal = $("#mirror").val();
+ updateout(singleValues, mirrorVal);
+ });
+ $('#mirror').change(function() {
+ var singleValues = $("#release").val();
+ var mirrorVal = $("#mirror").val();
+ updateout(singleValues, mirrorVal);
+ });
+
+
+ foldbuttontoggle('morepublications');
+
+
+ </script>
+
+