Importing Datasets
==================

Mosaic supports several data file types. As mentioned before, Mosaic uses Blaze
as backed, which provides a single interface for many different data computing
systems.

To import a new dataset click the plus icon next to the filter filed on the
left-hand pane:

.. image:: /img/mosaic-userguide28.png
   :align: center

This opens the following:

.. image:: /img/mosaic-userguide29.png
   :align: center

The *Data URI* drop-down list shows a list to select a Uniform Resource
Identifier (URI). The options are: File path, HDFStore, SQLite, PostgreSQL,
MongoDB, Other SQL DB, HTTP, Lux and Blaze Server. Once you select the URI
chose a name to label it. Optionally a short description can be provided.

Excel files may be imported in .xls, .xlsx or .csv format (1.3+). The following 
screenshot shows a csv file imported from the local file system:

.. image:: /img/mosaic-userguide30.png
  :align: center

Optionally, enable custom arguments for every computational backend. In the 
Add Custom Fields section, click the "+" icon and add one or more extra 
options, which correspond to key-value pairs. Values must be string, integer, 
or list. Keys will be parsed as strings. Input examples: 1, "two", [3, 4, 5].

NOTE: You can edit and add custom arguments from the top right "Settings" icon, 
Edit Dataset Metadata.

The new dataset will be displayed on the left-hand column. Click it to open it
in a new tab:

.. image:: /img/mosaic-userguide31.png
   :align: center
