#!/usr/bin/env python
# coding: utf-8

# <!--BOOK_INFORMATION-->
# <img align="left" style="padding-right:10px;" src="fig/cover-small.jpg">
# *This notebook contains an excerpt from the [Whirlwind Tour of Python](http://www.oreilly.com/programming/free/a-whirlwind-tour-of-python.csp) by Jake VanderPlas; the content is available [on GitHub](https://github.com/jakevdp/WhirlwindTourOfPython).*
# 
# *The text and code are released under the [CC0](https://github.com/jakevdp/WhirlwindTourOfPython/blob/master/LICENSE) license; see also the companion project, the [Python Data Science Handbook](https://github.com/jakevdp/PythonDataScienceHandbook).*
# 

# <!--NAVIGATION-->
# | [Contents](Index.ipynb) | [How to Run Python Code](01-How-to-Run-Python-Code.ipynb) >

# # 1. Introduction

# Conceived in the late 1980s as a teaching and scripting language, Python has since become an essential tool for many programmers, engineers, researchers, and data scientists across academia and industry.
# As an astronomer focused on building and promoting the free open tools for data-intensive science, I've found Python to be a near-perfect fit for the types of problems I face day to day, whether it's extracting meaning from large astronomical datasets, scraping and munging data sources from the Web, or automating day-to-day research tasks.
# 
# The appeal of Python is in its simplicity and beauty, as well as the convenience of the large ecosystem of domain-specific tools that have been built on top of it.
# For example, most of the Python code in scientific computing and data science is built around a group of mature and useful packages:
# 
# - [NumPy](http://numpy.org) provides efficient storage and computation for multi-dimensional data arrays.
# - [SciPy](http://scipy.org) contains a wide array of numerical tools such as numerical integration and interpolation.
# - [Pandas](http://pandas.pydata.org) provides a DataFrame object along with a powerful set of methods to manipulate, filter, group, and transform data.
# - [Matplotlib](http://matplotlib.org) provides a useful interface for creation of publication-quality plots and figures.
# - [Scikit-Learn](http://scikit-learn.org) provides a uniform toolkit for applying common machine learning algorithms to data.
# - [IPython/Jupyter](http://jupyter.org) provides an enhanced terminal and an interactive notebook environment that is useful for exploratory analysis, as well as creation of interactive, executable documents. For example, the manuscript for this report was composed entirely in Jupyter notebooks.
# 
# No less important are the numerous other tools and packages which accompany these: if there is a scientific or data analysis task you want to perform, chances are someone has written a package that will do it for you.
# 
# To tap into the power of this data science ecosystem, however, first requires familiarity with the Python language itself.
# I often encounter students and colleagues who have (sometimes extensive) backgrounds in computing in some language – MATLAB, IDL, R, Java, C++, etc. – and are looking for a brief but comprehensive tour of the Python language that respects their level of knowledge rather than starting from ground zero.
# This report seeks to fill that niche.
# 
# As such, this report in no way aims to be a comprehensive introduction to programming, or a full introduction to the Python language itself; if that is what you are looking for, you might check out one of the recommended references listed in [Resources for Learning](16-Further-Resources.ipynb).
# Instead, this will provide a whirlwind tour of some of Python's essential syntax and semantics, built-in data types and structures, function definitions, control flow statements, and other aspects of the language.
# My aim is that readers will walk away with a solid foundation from which to explore the data science stack just outlined.

# ## Using Code Examples
# 
# Supplemental material (code examples, exercises, etc.) is available for download at https://github.com/jakevdp/WhirlwindTourOfPython/.
# This book is here to help you get your job done.
# In general, if example code is offered with this book, you may use it in your programs and documentation.
# You do not need to contact us for permission unless you’re reproducing a significant portion of the code.
# For example, writing a program that uses several chunks of code from this book does not require permission.
# Selling or distributing a CD-ROM of examples from O’Reilly books does require permission.
# Answering a question by citing this book and quoting example code does not require permission.
# Incorporating a significant amount of example code from this book into your product’s documentation does require permission.
# 
# We appreciate, but do not require, attribution.
# An attribution usually includes the title, author, publisher, and ISBN.
# For example: "A Whirlwind Tour of Python by Jake VanderPlas (O’Reilly). Copyright 2016 O’Reilly Media, Inc., 978-1-491-96465-1."
# 
# If you feel your use of code examples falls outside fair use or the per‐ mission given above, feel free to contact us at permissions@oreilly.com.

# ## Installation and Practical Considerations
# 
# Installing Python and the suite of libraries that enable scientific computing is straightforward whether you use Windows, Linux, or Mac OS X. This section will outline some of the considerations when setting up your computer.

# ### Python 2 vs Python 3
# 
# This report uses the syntax of Python 3, which contains language enhancements that are not compatible with the *2.x* series of Python.
# Though Python 3.0 was first released in 2008, adoption has been relatively slow, particularly in the scientific and web development communities.
# This is primarily because it took some time for many of the essential packages and toolkits to be made compatible with the new language internals.
# Since early 2014, however, stable releases of the most important tools in the data science ecosystem have been fully-compatible with both Python 2 and 3, and so this book will use the newer Python 3 syntax.
# Even though that is the case, the vast majority of code snippets in this book will also work without modification in Python 2: in cases where a Py2-incompatible syntax is used, I will make every effort to note it explicitly.

# ### Installation with conda
# 
# Though there are various ways to install Python, the one I would suggest – particularly if you wish to eventually use the data science tools mentioned above – is via the cross-platform Anaconda distribution.
# There are two flavors of the Anaconda distribution:
# 
# - [Miniconda](http://conda.pydata.org/miniconda.html) gives you Python interpreter itself, along with a command-line tool called ``conda`` which operates as a cross-platform package manager geared toward Python packages, similar in spirit to the ``apt`` or ``yum`` tools that Linux users might be familiar with.
# - [Anaconda](https://www.continuum.io/downloads) includes both Python and ``conda``, and additionally bundles a suite of other pre-installed packages geared toward scientific computing.
# 
# Any of the packages included with Anaconda can also be installed manually on top of Miniconda; for this reason I suggest starting with Miniconda.
# 
# To get started, download and install the Miniconda package – make sure to choose a version with Python 3 – and then install the IPython notebook package:
# ```
# [~]$ conda install ipython-notebook
# ```
# For more information on ``conda``, including information about creating and using conda environments, refer to the Miniconda package documentation linked at the above page.

# ## The Zen of Python
# 
# Python aficionados are often quick to point out how "intuitive", "beautiful", or "fun" Python is.
# While I tend to agree, I also recognize that beauty, intuition, and fun often go hand in hand with familiarity, and so for those familiar with other languages such florid sentiments can come across as a bit smug.
# Nevertheless, I hope that if you give Python a chance, you'll see where such impressions might come from.
# And if you *really* want to dig into the programming philosophy that drives much of the coding practice of Python power-users, a nice little Easter egg exists in the Python interpreter: simply close your eyes, meditate for a few minutes, and ``import this``:

# In[1]:


import this


# With that, let's start our tour of the Python language.

# <!--NAVIGATION-->
# | [Contents](Index.ipynb) | [How to Run Python Code](01-How-to-Run-Python-Code.ipynb) >