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

Mosaic UI
=========

After `installing <https://docs.continuum.io/anaconda/mosaic/install.html>`_
mosaic, make sure that the *mosaic* environment is active and type the
following command in your terminal:

.. code-block:: python

   anaconda-mosaic

The default browser will open and show the following window:

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

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.

Once 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.

.. 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
