:topic: Importing Data to Chart

.. index::
   triple: DREAM3D-NX; Charting; Importing Data

.. _ImportingChartData:

Importing Data to Chart
################################

**In this section we will go over how to import data 
into the Charting Toolkit.**

Import Data From A Pipeline
===============================
The first way to import data into the Charting toolkit is 
by running a pipeline. The following steps will detail how to 
import your data from a pipeline.

1. **Load or create your pipeline.** See the :ref:`Creating a Pipeline <CreatingAPipeline>` 
   section in User Interface Overview for more detailed instructions.

2. Click on the Visualization Preferences eyeball icon at the bottom of
   the Pipeline View and make sure **Chart Pipeline Results** is
   **checked**.
   
   +-----------------------------------+-----------------------------------+
   | Pressing “Visualization           | Viewing “Visualization            |
   | Preferences” Eyeball              | Preferences” Settings             |
   +===================================+===================================+
   | |image1|                          | |image2|                          |
   +-----------------------------------+-----------------------------------+

3. While the preferences dialog is still open, go to the General tab and find the 
   *Temp DREAM3D-NX Files Directory* option. This option will inform the Charting
   Toolkit how to import the data structure. If this option is enabled, the 
   Charting Toolkit will import the data by reading it in from the data structure 
   saved to this temp file. If this option is disabled, DREAM3D-NX will try to keep the
   pipeline's data structure in memory for accessing the data arrays. **Keep in mind that 
   if you have out-of-core data, you must use the temp DREAM3D-NX file option in order to
   use the Charting Toolkit**

4. **Click the Run button** at the bottom of the Pipeline view to run
   the pipeline.

5. **Select the Charting tab** if it is not already active. In the DREAM3D-NX window containing 
   the pipeline you just ran, make sure the *Charting* tab is active.
   
6. Once your pipeline has completed, you will find the final data structure of 
   the executed pipeline loaded into the Data Structure tree view along the
   right hand side of the Charting tab. If the Charting toolkit already had 
   a data structure imported, it will reset the data structure view and 
   attempt to reload the chart data.

   
Import Data From A File
===============================
The second way to import data into the Charting toolkit is 
by dragging and dropping a .dream3d file into the charting view. To do this simply make
sure the charting tab is active and the drag and drop the file from your system into the chart area. 
The data structure from your file will now be available on the right hand side for selecting data to chart.

   
.. |image1| image:: Images/VisualizePipelineResultsOption.png
.. |image2| image:: Images/VisualizePipelineResultsOption2.png