.. User_Guide documentation master file, created by
   sphinx-quickstart on Mon Sep 20 12:44:16 2021.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

******************
MatCal Users Guide
******************

Welcome to the MatCal Users' Guide. If this is your
first time using MatCal, start at :ref:`Introduction` to learn 
what MatCal is and what it can do for material model calibrations. 
The remaining chapters provide details on the tools 
available within MatCal including general overviews on what they can be used for, 
some light background on theory and implementation details. Many 
of these chapters also include verification and user examples.
The final chapter is the User API Documentation that gives standard API 
documentation for user facing tools.

To run MatCal at Sandia see :ref:`Running MatCal at Sandia`.
We also allow you to import MatFit. See :ref:`Running MatFit`.

If you have any problems or feedback, feel free to reach out to the MatCal developers 
by email. Also, email us to be added to the matcal-users-group metagroup for 
emails about updates and new releases.


Active developers
-----------------
| Kyle Karlson 
| Matt Kury 
| Reese Jones 

Contributors
------------
Denielle Ricciardi, Guy Bergel, Michael Antoun, Troy Hoffa


Contact and Help
----------------
matcal-help@sandia.gov

Sandia National Laboratories is a multimission laboratory managed and operated by 
National Technology & Engineering Solutions of Sandia, LLC, a wholly owned 
subsidiary of Honeywell International Inc., for the U.S. Department of 
Energy’s National Nuclear Security Administration under contract DE-NA0003525.

.. toctree::
   :maxdepth: 3
   :caption: Contents:

   Introduction
   MatCal Features and Objects
   Setting Up MatCal
   Sensitivity Analysis
   Calibration
   Uncertainty Quantification
   Surrogates
   Full-field Data Tools
   introduction_examples/index
   advanced_examples/index
   User API Documentation
   Bibliography
   How to cite MatCal
.. include:: site_includes.rst

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`