Metadata-Version: 2.1
Name: s3dxrd
Version: 0.0.3
Summary: Tools for intragranular strain estimation with s3dxrd data.
Home-page: https://bitbucket.org/Axiomel/gp-xrd/src/multigrain/
Author: Axel Henningsson
Author-email: nilsaxelhenningsson@gmail.com
License: UNKNOWN
Project-URL: Documentation, https://bitbucket.org/Axiomel/gp-xrd/src/multigrain/
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: scikit-image (>=0.17.2)
Requires-Dist: torch (>=1.6.0)
Requires-Dist: pickle
Requires-Dist: h5py
Requires-Dist: matplotlib
Requires-Dist: numba (>=0.53.1)
Requires-Dist: rasterio (>=1.1.6)
Requires-Dist: Shapely (>=1.7.0)
Requires-Dist: ImageD11 (>=1.9.7)
Requires-Dist: xfab (>=0.0.4)
Requires-Dist: fabio (>=0.10.2)
Requires-Dist: pyevtk (>=1.1.2)

Welcome to the s3dxrd project
===============================

This is a scientific code originally developed to adress scanning-3dxrd
strain measurements of polycrystalline materials.

Intragranular strain is computed based on a series of line integral measurements. The regression procedure involves the use of a Gaussian 
Proccess which is a statistical model that uses spatial correlation assumptions to find good fits to data. The resulting strain field is 
guaranteed to be in local static equlibrium by imposing a prior constraint on the solution function sapace.

If you want to use this code, it is strongly recomended that you have a look at the
underlying `publication`_:

    *Reconstructing intragranular strain fields in polycrystalline materials from scanning 3DXRD data, 
    Henningsson, N. A., Hall, S. A., Wright, J. P. & Hektor, J. (2020). J. Appl. Cryst. 53, 314-325.*

.. _publication: https://journals.iucr.org/j/issues/2020/02/00/nb5257/

A preprint describing the Gaussian Process regression procedure is also available `here`_:

    *Intragranular Strain Estimation in Far-Field Scanning X-ray Diffraction using a Gaussian Processes, 
    Axel Henningsson and Johannes Hendriks. (2021). arXiv Preprint.*

.. _here: https://arxiv.org/abs/2102.11018

Installation
===============================
Only manual installation is currently supported. First get the code to your local machine by:

.. code-block::

    git clone https://github.com/AxelHenningsson/scanning-xray-diffraction.git

Next go to the repository and try to install

.. code-block::

    cd scanning-xray-diffraction
    python setup build install

You will now recieve messages about dependecies that need be installed first. 
Go through these untill the build succeeds.


Documentation
===============================
Documentation is hosted seperately at `github pages`_: 

.. _github pages: https://axelhenningsson.github.io/scanning-xray-diffraction/

