Introduction
============

a repository for the py3dic a Digital Image Correlation (DIC) package written in python 3 developed at materials lab of the  `Mechanical Engineering Department`_  at `HMU`_. Release v |release|


It contains:

*  Support and Tools from different Tensile testing machines :
  
  *  Imada MX2 universal testing machine
  *  Janin UT-10 universal testing machine

There are several tools for processing and analysing force - displacement data from these machines.
  * a classes and tool for conveting the data from the machines to a machine agnostic format used by the py3dic package.
  *  a quick calculation utility based on a matplotlib window, 
  *  and a tk_mvc controller window with more capabilities)


* Digital image correlation:

A full DIC analysis package with the following features:

*  full gui for (offline) dic analysis using camera data
  *  selecting ROI throught the gui
  *  selecting strain type (Green-Lagrange, Cauchy, etc.)
  *  selecting interpolation method (nearest, bilinear, bicubic, etc.)
  *  selecting grid size and correlation window
  *  a set of plugins for processing and analysing DIC data (remove border, taken only a certain number of points, etc.


*  a set of classes for processing online DIC data (still in development)

The package also includes several entry points for easy access to the tools:

  *  ``tk_dic_analysis``: a tkinter based GUI for DIC analysis using only camera data (can calculate strain maps, displacement maps, etc.)
  *  ``tk_dic_merge`` : a tkinter based GUI for merging and synchronizing DIC data from cameras and tensile testing machines (this needs tk_dic_analysis to be run first and produce results)
  *  ``tk_dic_viewer``: a tkinter used for producing offline graphs for the results of the DIC analysis (grid, markers, strain maps, displacement maps, etc.)
  *  ``tk_dic_full``: a tkinter based GUI for the full (camera + machine) DIC analysis (this is a superset of the above two and its still in develpent)

Additionally the package includes a set of command line tools related to  processing and analysing DIC data: 

  * ``py3dic_jinan_converter``: a command line tool for converting data from Janin UT-10 universal testing machine to the machine agnostic format (autd)



Author: Nikolaos Papadakis

.. _HMU: https://www.hmu.gr/
.. _Mechanical Engineering Department: https://mech.hmu.gr/