==========
User Guide
==========

Mosaic UI
=========

After `installing <https://docs.continuum.io/anaconda/mosaic/install.html>`_
mosaic, start by activating the mosaic environment.

On OS X or Linux::

  source activate mosaic

On Windows::

  activate mosaic

Now that the *mosaic* environment is active, type the
following command in your terminal window:

.. code-block:: python

   anaconda-mosaic

The default browser will open and show the following window:

.. image:: /img/mosaic_intro1.png
   :align: center    

Add a new dataset by clicking the "+" icon at the top left, then following the 
prompts in the Add Dataset dialog box:

.. image:: /img/mosaic_intro3.png
   :align: center  

As of Mosaic 1.3 you can add Excel spreadsheets in .xls, .xlsx or .cvs format.

The `Iris` dataset is provided as built-in sample for initial exploration. Most
of the examples in this documentation use this dataset to show how each
component of Mosaic works.

After a dataset is selected, there are three main components in the Mosaic
window:

* The left column, which displays a list of datasets currently opened. Provides a
  quick search bar and the **+** button to import new data.

* The main panel displays the data. You can work on several datasets using
  embedded tabs, each tab contains a top bar with several buttons to perform
  data transformations. Below that bar you can see a text field to introduce
  Blaze commands, then click *Preview* to see if the command works, *Apply* to
  apply that command to the dataset, and *Commit* to create a new dataset from
  the command. Below the command field there are four buttons to explore your
  data: *Table*, *Plot*, *List* and *Stats*.

* The right column shows some information about the dataset you are currently
  working on. It also shows a button to open the dataset in a Jupyter Notebook. 
  Refresh your row count at any time by clicking the "Refresh" icon.

.. image:: /img/mosaic_intro2.png
   :align: center


.. include:: data-transformations.rst

.. include:: explore-data.rst

.. include:: open-in-jupyter.rst

.. include:: import-datasets.rst

.. toctree::
   :hidden:

   data-transformations
   explore-data
   open-in-jupyter
   import-datasets
