X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=sphinx%2Findex.rst;h=55494d264a6cfbf0458c238ede447ef9497454af;hb=e0e41bbc705dd781a563fa53210b3d36924d9143;hp=b73c4729bbefa145630b458367c076d73cdff3c4;hpb=5090ef2209f59db97eb797724cd0d6e244717517;p=neurodebian.git diff --git a/sphinx/index.rst b/sphinx/index.rst index b73c472..55494d2 100644 --- a/sphinx/index.rst +++ b/sphinx/index.rst @@ -1,282 +1,377 @@ .. _WELCOme: -*********************************************** - Welcome to the Debian Neuroscience Repository -*********************************************** +********************************************* + The Ultimate Neuroscience Software Platform +********************************************* -.. quotes:: - :random: 1 - -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 `. -Take a look at the :ref:`list of our current and planned projects ` if -you want to get involved. If you appreciate this service, please |spread|. - -.. note:: +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 `. 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 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 + `_. + *Frontiers in Neuroinformatics*, 6:22. .. raw:: html -

- - - - - -

- -.. _Ubuntu: http://www.ubuntu.com +
more publications
+
+ +
+
-.. _news: - -News -==== +.. quotes:: + :random: 1 .. raw:: html - - - -Follow us on identi.ca_ or twitter_ to subscribe to the NeuroDebian news. +
+
more testimonials
-.. _identi.ca: http://identi.ca/neurodebian -.. _twitter: http://twitter.com/NeuroDebian +.. _Ubuntu: http://www.ubuntu.com .. _repository_howto: +.. _chap_installation: +Get NeuroDebian +=============== - -How to use this repository -========================== - -The easiest way to use this repository is to download an APT-configuration file -(`sources.list`). Simply choose your target distribution/release and download -the configuration for a mirror close to you (depending on your browser, you -might have to right-click and choose 'save as'). Once downloaded, put the file -in the `/etc/apt/sources.list.d/` directory on your system. Moving files in -this directory will require superuser privileges, therefore you should probably -download the file into a temporary directory and subsequently move it into -`/etc/apt/sources.list.d/`. APT-configurations are available for the following -releases and repository mirrors: +First select what kind of operating system you are using, and then choose a +download server close to you: .. include:: sources_lists -.. note:: - Thanks to the following institutions and individuals for hosting a mirror: - - * `Department of Psychological and Brain Sciences at Dartmouth College`_ - *[us-nh]* (primary mirror) - * `Department of Experimental Psychology at the University of Magdeburg`_ - *[de]* - * `Neurobot at Aristotle University of Thessaloniki, Greece`_ *[gr]* - * `Paul Ivanov`_ *[us-ca]* - * `Medical-image Analysis and Statistical Interpretation lab at Vanderbilt`_ - *[us-tn]* +.. raw:: html - If your are interested in mirroring the repository, please see the :ref:`faq`. +
+ This form requires javascript. If disabled, incomplete instructions are + displayed below
+
+
+ Instructions for Debian-derived systems +
+

Select desired components:
+ + + + + +
only software with guaranteed freedoms
+ all packages are + DSFG-compliant, + with permission to use, modify, re-distribute under any condition
all software
+ + individual packages may have restrictive licenses and you are required to + check license-compliance manually +
+

+ +You can enable NeuroDebian on your system by simply copying and pasting the +following two commands into a terminal window. This will add the NeuroDebian +repository to your native package management system, and you will be able to +install neuroscience software the same way as any other package. -.. _Department of Psychological and Brain Sciences at Dartmouth College: http://www.dartmouth.edu/~psych -.. _Department of Experimental Psychology at the University of Magdeburg: http://apsy.gse.uni-magdeburg.de -.. _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 +.. raw:: html -Once this is done, you have to update the package index. Use your favorite -package manager, e.g. synaptic, adept, or whatever you like. In the terminal -you can use :command:`aptitude` to achieve the same:: + 
+  After selecting a release the setup code will be shown here.
+
- sudo aptitude update +Now you can update the package index and you are ready to install packages. +Of course you can use your favorite package manager (e.g. synaptic, adept) +for this. In the terminal you can use :command:`apt-get`:: -Now, you can proceed to install packages, e.g.:: + sudo apt-get update + sudo apt-get install mricron - sudo aptitude install lipsia +You are ready to go -- enjoy NeuroDebian! .. note:: + Not every package is available for all distributions/releases. For information about which package version is available for which release and architecture, please have a look at the corresponding package pages. -After this initial setup you probably also want to configure your package -manager to recognize the NeuroDebian archive key. With this key the package -manager can verify that packages haven't been modified and are identical with -the ones in the main NeuroDebian archive, regardless of which mirror you -downloaded them from. The NeuroDebian key id is **2649A5A9**. If you need further -help setting up package authentication, please take a look at -:ref:`corresponding FAQ `. +.. raw:: html +
+
-.. _chap_installation: +
+
+ Instructions for non-Debian systems +
-Ways to use NeuroDebian -======================= +For all non-Debian operating systems we recommend to deploy NeuroDebian as a +`virtual appliance`_ (virtual machine) -- this will only take a few minutes. +On all modern hardware (built within +the last 3-4 years) a virtual appliance is a convenient solution to run +NeuroDebian simultaneously with the primary operating system -- without +noticeable performance loss. To start using NeuroDebian: -Virtual machine ---------------- +1. Download this image file: -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 -simple steps to setup the virtual machine, you will be able to use NeuroDebian_ -as an integral part of your existing working environment without any sacrifice. -The virtual machine is also a suitable environment to temporarily deploy -neuroscience software on machines running other operating systems, e.g. for the -purpose of teaching a neuroimaging data analysis course in a multipurpose -computer lab. +.. raw:: html + -Debian installation -------------------- +2. Import this image into VirtualBox_. If you do not have VirtualBox_ + installed yet, visit the `VirtualBox download page + `_ and get an installer for your + system (installers for Windows, Linux, Mac and Solaris are available). -Having been exposed to the wonders of NeuroDebian_ you are no longer -satisfied with your previous choice of operating system? We would -recommend installing Debian_ to replace or complement (dual-boot) your -existing OS. Please visit `"Getting Debian" -`_ to obtain the images for your -hardware architecture and then simply add |repos|. +3. Finish the configuration by following :ref:`the instructions on setting up + the virtual appliance `. `[Virtual machine + setup video tutorial] `_ -.. _chap_team: -The team -======== +You are ready to go -- enjoy 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 `_ was created -to formally join the forces of +.. note:: -* `Michael Hanke `_ -* `Yaroslav Halchenko `_ + If you still running an older VirtualBox 3.x, download one of the image files + listed below. These older releases are distributed as a `zip` file. Please + extract all files from the `.zip` file, using appropriate software + for your operating system. -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. + * `NeuroDebian 6.0.2 image (32bit) + `_ [~545MB] -.. _support: + * `NeuroDebian 6.0.2 image (64bit) + `_ [~560MB] -Contacts -======== +.. raw:: html -`Email us directly `_ with any "private" -communication. Otherwise please use our public mailing lists, which -exist not only to provide user-support but also to establish -communication channels within the NeuroDebian community +
-* neurodebian-users_: Discussions and support of NeuroDebian users +.. _virtual appliance: http://en.wikipedia.org/wiki/Virtual_appliance +.. _VirtualBox: http://www.virtualbox.org -* neurodebian-upstream_: General discussions and knowledge sharing - among developers of the neuroscience software. We will also use it - to update you with summaries of recent relevant developments in - Debian project +.. _news: -* neurodebian-devel_: Technical mailing list for discussions on - NeuroDebian development +News +==== +.. raw:: html -Acknowledgements -================ + +
+ +
+ The news widget requires javascript +
-We are grateful to Jim Haxby for his continued support and :ref:`endless supply of -Italian espresso `. +.. _identi.ca: http://identi.ca/neurodebian +.. _twitter: http://twitter.com/NeuroDebian + + +.. raw:: html +
+
-Publications -============ +* **About** +* :ref:`Team ` +* :ref:`chap_popularity` +* :ref:`FAQ ` +* :ref:`Blog ` +* :ref:`chap_publications` +* :ref:`testimonials` +* :ref:`coffeeart` -Hanke, M. & Halchenko, Y. O. (2010). :ref:`Report from the Debian booth at -SfN2010 `. *Annual meeting of the Society for -Neuroscience*, San Diego, USA. +.. start a new list -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 -annual meeting of the Society for Neuroscience*, San Diego, USA. +* **Services** +* :ref:`Software ` +* :ref:`Data ` +* :ref:`Appliance ` -Hanke, M., Halchenko, Y. O. (2010). `Debian: The ultimate platform for -neuroimaging research <_files/HankeHalchenko_NeuroDebianDebConf10.pdf>`_. -*Talk given at* DebConf10_, New York City, USA. [video: -`low resolution `_, -`high resolution `_] +.. start a new list -Hanke, M., Halchenko, Y. O., Haxby, J. V. & Pollmann, S. (2010). `Improving -efficiency in cognitive neuroscience research with NeuroDebian -<_files/NeuroDebian_CNS2010.pdf>`_. *Poster presented at the annual -meeting of the Cognitive Neuroscience Society*, Montréal, Canada. +* **Community** +* :ref:`Mailing lists ` +* `OpenHatch `_ +* `Identi.ca `_ +* `Twitter `_ +* `Google+ `_ +* `YouTube `_ +* `GitHub `_ -Halchenko, Y. O., Hanke, M. (2009). `An ecosystem of neuroimaging, -statistical learning, and open-source software to make research more -efficient, more open, and more fun -<_files/HalchenkoHanke_FossEcosystemDC09.pdf>`_. *Talk given at* -`Dartmouth College`_, New Hampshire, USA. +.. start a new list + +* **Related** +* `Debian `_ +* `Debian Med `_ +* `INCF `_ +* `NITRC `_ + +.. raw:: html -.. _DebConf10: http://debconf10.debconf.org/ -.. _Dartmouth College: http://www.dartmouth.edu/ +
+
.. toctree:: :hidden: + blog/index faq pkgs spread vm + publications coffeeart photoalbum projects testimonials + testimonials-topics + vm_welcome + derivatives + +.. are these supposed to be visible? +.. toctree:: + :hidden: + + machines + todo + +.. toctree:: + :hidden: + :glob: + + pkgs/* + pkglists/* .. probably should be purged altogether .. toctree:: :hidden: - booth_sfn2010 - datasets livecd quotes-nihr01 quotes-nitrc - sources_lists - vm_welcome + dump .. include:: link_names.txt .. include:: substitutions.txt + +.. raw:: html + +