About the scipy lecture notes¶

Authors
What’s new
License
Contributing

Authors ¶

Editors¶

Gaël Varoquaux
Emmanuelle Gouillart
Olav Vahtras

Chapter authors¶

Listed by alphabetical order.

Christopher Burns
Adrian Chauve
Robert Cimrman
Christophe Combelles
André Espaze
Emmanuelle Gouillart
Mike Müller
Fabian Pedregosa
Didrik Pinte
Nicolas Rougier
Gaël Varoquaux
Pauli Virtanen
Zbigniew Jędrzejewski-Szmek
Valentin Haenel (editor from 2011 to 2015)

Additional Contributions¶

Listed by alphabetical order

arunpersaud
Matthew Brett
Lars Buitinck
Pierre de Buyl
Ozan Çağlayan
Adrien Chauve
Robert Cimrman
Christophe Combelles
David Cournapeau
egens
Andre Espaze
André Espaze
Corey Farwell
Robert Gieseke
Philip Gillißen
Ralf Gommers
Emmanuelle Gouillart
Julia Gustavsen
Valentin Haenel
Pierre Haessig
Jonathan Helmus
Tarek Hoteit
Gert-Ludwig Ingold
Zbigniew Jędrzejewski-Szmek
kikocorreoso
mhemantha
nicoguaro
Sergio Oller
Fabian Pedregosa
Tiago M. D. Pereira
Nicolas Pettiaux
Didrik Pinte
reverland
Maximilien Riehl
Nicolas Rougier
Helen Sherwood-Taylor
Simon
strpeter
Wes Turner
Akihiro Uchida
Utkarsh Upadhyay
Olav Vahtras
Gael Varoquaux
Nelle Varoquaux
Olivier Verdier
VirgileFritsch
Pauli Virtanen
Yosh Wakeham
Stefan van der Walt
yasutomo57jp

What’s new ¶

Release 2017.1 (September 2017)¶

Release 2016.1 (September 2016)¶

Rework of intro chapter (Gaël Varoquaux)
Integrate sphinx-gallery: examples are now Jupyter notebooks (Gaël Varoquaux, Gert-Ludwig Ingold, Óscar Nájera)
Better Python 3 tests and support (Gert-Ludwig Ingold)
Adapt examples to Matplotlib 1.5 (Gaël Varoquaux)
Modernize numpy chapter (Bartosz Telenczuk)

Release 2015.3 (November 2015)¶

Collapsed sidebar can now pop up for mid-sized display (Gaël Varoquaux)
Replaced pictures of Lena by racoon face (Thouis Jones)

Release 2015.2 (October 2015)¶

Authors on cover ordered as in bibtex entry (Nicolas Rougier)
Better rendering on mobile (Gaël Varoquaux)
Fix restructured text markup errors (Olav Vahtras)

Release 2015.1 (September 2015)¶

New chapter on statistics with Python (Gaël Varoquaux)
Better layout in PDF (Gaël Varoquaux)
New HTML layout, simplified formatting, mobile-friendly and sidebar (Gaël Varoquaux, Nelle Varoquaux)
Logos on the HTML front page and on the PDF cover (Nicolas Rougier)
Python 3 compatible code (Gaël Varoquaux, Olav Vahtras)
Code put up to date for more recent versions of project (Pierre de Buyl, Emmanuelle Gouillart, Gert-Ludwig Ingold, Nicolas Pettiaux, Olav Vahtras, Gaël Varoquaux, Nelle Varoquaux)
Matplotlib updated with removal of deprecated pylab interface (Nicolas Rougier)

Release 2013.2 (21 August 2013)¶

Numpy chapter simplified (Valentin Haenel)
New layout for the HTML rendering (Gaël Varoquaux)

Release 2013.1 (10 Feb 2013)¶

Improvements to the advanced image manipulation chapter (Emmanuelle Gouillart)
Upgrade of the introductory language chapter (Valentin Haenel)
Upgrade of the introductory numpy chapter (Valentin Haenel)
New advanced chapter on interfacing with C (Valentin Haenel)
Minor fixes and improvements in various places (Robert Gieseke, Ozan Çağlayan, Sergio Oller, kikocorreo, Valentin Haenel)

Release 2012.3 (26 Nov 2012)¶

This release integrates the changes written for the Euroscipy conference:

Matplotlib chapter completely redone (Nicolas Rougier, Gaël Varoquaux)
New advanced chapter on mathematical optimization (Gaël Varoquaux)
Mayavi chapter redone (Gaël Varoquaux)
Front page layout slightly improved: folding TOC (Gaël Varoquaux)

Release 2012.2 (22 Jun 2012)¶

Minor release with a few clean ups (Gael Varoquaux).

Release 2012.1 (20 Jun 2012)¶

This is a minor release with many clean ups. In particular, clean up of the layout (Gael Varoquaux), shortening of the numpy chapters and deduplications across the intro and advanced chapters (Gael Varoquaux) and doctesting of all the code (Gael Varoquaux).

Release 2012.0 (22 Apr 2012)¶

This is a minor release with a few clean ups. In particular, clean up the scikit-learn chapter (Lars Buitinck), more informative section titles (Gael Varoquaux), and misc fixes (Valentin Haenel, Virgile Fritsch).

Release 2011.1 (16 Oct 2011)¶

This release is a reworked version of the Euroscipy 2011 tutorial. Layout has been cleaned and optimized (Valentin Haenel and many others), the Traits chapter has been merged in (Didrik Pinte)

Release 2011 (1 Sept 2011)¶

This release is used for the Euroscipy 2011 tutorial. The numpy introductory chapter has been rewamped (Pauli Virtanen). The outline of the introductory chapters has been simplified (Gaël Varoquaux). Advanced chapters have been added: advanced Python constructs (Zbigniew Jędrzejewski-Szmek), debugging code (Gaël Varoquaux), optimizing code (Gaël Varoquaux), image processing (Emmanuelle Gouillart), scikit-learn (Fabian Pedregosa).

License ¶

All code and material is licensed under a

Creative Commons Attribution 4.0 International License (CC-by)

http://creativecommons.org/licenses/by/4.0/

See the AUTHORS.rst file for a list of contributors.

Contributing ¶

The SciPy lecture notes are a community-based effort and require constant maintenance and improvements. New contributions such as wording improvements or inclusion of new topics are welcome.

Contributing guide¶

The directory guide contains instructions on how to contribute:

Example chapter

How to contribute

Building instructions¶

To generate the html output for on-screen display, Type:

make html

the generated html files can be found in build/html

The first build takes a long time, but information is cached and subsequent builds will be faster.

To generate the pdf file for printing:

make pdf

The pdf builder is a bit difficult and you might have some TeX errors. Tweaking the layout in the *.rst files is usually enough to work around these problems.

Requirements¶

A complete list of requirements with information on the versions presently used to build the SciPy lecture notes, can be inferred from the requirements file:

numpy==1.11
scipy==0.19
scikit-learn==0.18
matplotlib==1.5
scikit-image==0.12
sympy==1.0
statsmodels==0.6
seaborn==0.7
pandas==0.18
pytest>=3.2.1
sphinx==1.6.3
coverage==4.4.1
pillow==3.3.1
# For conda, pip installable
sphinx-gallery==0.1.12

Building on Debian/Ubuntu

The environment needed to create an html version of the SciPy lecture notes can be based on miniconda. We first download the latest version of miniconda and rename it to miniconda.sh for simplicity:

wgethttps://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh-Ominiconda.sh

To ensure that the file has been downloaded correctly, one can compare the MD5 sum obtained by means of:

md5summiniconda.sh

with the value listed on https://repo.continuum.io/miniconda/ . Miniconda can now be installed:

bashminiconda.sh

Review the license agreement and choose a target directory (here we assume it to be $HOME/miniconda3). Unless you intend to work more extensively with miniconda, you do not want to modify .bashrc. In this case, you need:

export PATH=$HOME/miniconda3/bin:$PATH

to find the correct binaries. Note that the path depends on the target directory chosen above.

Now, we use environment.yml from the main directory of the scipy-lecture-notes repository to install the required dependencies. Note that environment.yml yields an environment named testenv. If you prefer a more telling name, make a copy of environment.yml, replace testenv in line 4 by a more appropriate name and use this name in the following instead of testenv. The conda environment is created by:

condaenvcreate-fenvironment.yml

Now, the environment can be activated:

sourceactivatetestenv

and deactivated:

source deactivate

With an activated environment, you are now able to produce the html version of the SciPy as explained above. Generating a pdf version requires the system packages texlive, texlive-latex-extra, texlive-fonts-extra, and latexmk.

Building on Fedora

As root:

yuminstallpythonmakepython-matplotlibtexlive-pdfjamtexlivescipy \
texlive-framedtexlive-threeparttabletexlive-wrapfigtexlive-multirow
pipinstallSphinx
pipinstallCython
pipinstallscikit-learn
pipinstallscikit-image