=============================
Installing and running Pandas
=============================

Pandas is a common Python tool for data manipulation and analysis.
This task explains how to use Navigator to set up and begin working with
Pandas in your choice of Terminal, Python, IPython or Jupyter Notebook.
The steps are similar for :ref:`installing and opening <navigator-basic-workflow>` nearly any package.

#. :ref:`Start Navigator <navigator-starting>`.

#. Click the **Environments** tab.

#. Click the Create button. When prompted, enter a descriptive name for the environment, such as "Pandas."

   .. figure:: /img/navigator-pandas1-2.png
      :width: 50%

      ..

   |

#. Select a Python version to run in the environment.
#. Click OK.

   The new environment appears in the environments list.

#. Click the name of the new environment to activate it.
   
   The environment is highlighted with a green background.

#. In the list above the packages table, select All to filter the table 
   to show all packages in all channels.

   .. figure:: /img/navigator-pandas4.png

      ..

   |

#. In the Search Packages box, type ``Pandas``.

   Pandas appears as a package available for installation.

   .. figure:: /img/navigator-pandas5.png

      ..

   |

#. Select the checkbox next to the Pandas package name.

#. In the menu that appears, select Mark for specific version installation.

#. In the list that appears, select the Pandas version you want to install.

   .. figure:: /img/navigator-pandas6.png

      ..

   |

#. Click the Apply button.

   .. figure:: /img/navigator-pandas7.png

      ..

   |

   A progress bar appears below the Packages pane while Pandas and its 
   dependencies are installed.

#. To begin using your new environment, click the **Environments** tab.

#. Click the arrow button next to the Pandas environment name.

#. In the list that appears, select the tool to use to open Pandas: 
   Terminal, Python, IPython or Jupyter Notebook.

   .. figure:: /img/navigator-pandas8.png

      ..

   |

Learn more about Pandas
=======================

* `10 Minutes to Pandas <http://pandas.pydata.org/pandas-docs/stable/10min.html>`_

* `Pandas Cookbook <http://pandas.pydata.org/pandas-docs/stable/cookbook.html>`_
