.. toctree::
    :maxdepth: 1
	
Make and Run 2D Subset-DIC Input File
======================================

.. |xrarr|    unicode:: U+027F6 .. LONG RIGHTWARDS ARROW

It is assumed that you already has made the subset collection for a 2D-DIC analysis (see: :doc:`makescol2d`), and saved the subset collection as a file (*.scol)

In the :doc:`../components/gui/mainwindow` right-click on the "DIC"-node in the :doc:`../components/gui/worktree` and click **New Empty Input File**.

.. image:: ../2ddic/imgs/newinp.png
	:alt: alternate text
	:align: center
	:width: 250
	
the :doc:`../components/gui/dicinpedit` will open:

.. image:: ../components/gui/imgs/dicinpedit.png
	:height: 300
	:alt: alternate text
	:align: center
	
For a minimum subset-DIC Input File you need to specify:

* :ref:`The folder where the image sequence is located<inp_im_folder>`
* :ref:`The image indices which should be used in the analysis<inp_im_folder>`
* :ref:`The subset collection file path (*.scol)<inp_scol>`
* :ref:`How the subsets should be tracked (optimized).<inp_subset_opt_type>` This is defined under the **Subset/Edge**-tab in the :doc:`../components/gui/dicinpedit` (See image below).

.. image:: imgs/definetypetracking.png
	:height: 280
	:alt: alternate text
	:align: center

Optionally you may want to:

* :ref:`Add a log file with synchronized recordings of force, displacement, etc...<inp_log>`
* :ref:`Use multi-thread (to reduce the computational time)<inp_multithread>`
* :ref:`Use reference image updates<inp_refupdate>`
* :ref:`Use Grayvalue normalization<inp_gvnorm>`

When you are done, you can press the **Save and Close**-button.

.. note::
	All results files from a DIC analysis will be saved in the same folder as the corresponding DIC input file!
	There will be as many results files as there are images defined in the input file.
	Thus, to have control over different analyses, make a new folder each time you create and save a new input file. Preferable a sub-folder under the folder where the images are located (Example: C:/[Image Folder]/dic1/input.txt) 
	
	Also, note that whenever you run an input file, you are overwriting eventual old results from previous runs.
	
When the :doc:`../components/gui/dicinpedit` has closed, you will see the input file as a node in the :doc:`../components/gui/worktree` under the "DIC" node:

.. image:: ../2ddic/imgs/inpintree.png
	:width: 280
	:alt: alternate text
	:align: center
	
To run the Subset-DIC analysis, right-click on the input file in the :doc:`../components/gui/worktree` and press and press **Run** |xrarr| **Subset Tracking**

.. image:: imgs/runsubsetdic.png
	:width: 280
	:alt: alternate text
	:align: center
	
A console application ( :doc:`../components/console/diccoresubset` ) will appear and you can study the progress of the analysis in this console window.

.. image:: imgs/subsetdicconsole.png
	:width: 280
	:alt: alternate text
	:align: center

.. note::
	If the console application do not appear, and you get a dialogbox saying "Cannot start process...", go to menubar: Edit -> Settings, choose the "Analysis" tab.
	The path labelled "DIC Core Subset" should point to the location of the "DICCoreSubset.exe" file. This is normally located in a folder named "subset_core".
	Browse and find this folder. Click "Apply" to close the "Settings Window". Now you can try running the DIC input file as described above. 
	
Now, if the DIC analysis is running, you can go straight to :doc:`studyresults2d`. It is possible to study the results even if the analysis is running. However, there will be missing results until the analysis is done.

.. note::
	If you want to access the input file or the DIC results after you have closed and restarted eCorr, you can reload the input file from the 
	menu that appears when right-clicking the "DIC" node in :doc:`../components/gui/worktree` , and choose "Load Input File". 
	The inputfile is used to access the results from the DIC analysis, as is shown in :doc:`studyresults2d`.