SeaPy: An open-source python package for the mechanical investigation of solids with unknown microstructures, using spatially resolved sequences of strain images but no constitutive equations of properties.

SeaPy is a python package for performing three main tasks that are labeled as "Stability of Elasticity Analysis"(SEA):

1. Use a sequence of spatially resolved strain images to construct an elastic "fingerprint" of incipient elastic instabilities.
2. Populate the library libΨ with "fingerprint" and mechanical properties of "training" data.
3. Use image recognition to compare fingerprints and identify corresponding probabilities for reconstructing unknown microstructures. The package includes all the necessary tools for performing SEA on a set of images. Tutorials are provided with model microstructures, libraries and plausible predictions.

Main Functions:

1. SeaPy.CollectStrainImages
2. SeaPy.FindFingerprint
3. SeaPy.FingerprintRecognition
4. SeaPy.ConstitutivePrediction

Classes:

1. StrainImageSequence
2. Fingerprint
3. LibraryPsi
4. FingerprintRecognition

How to Use This Package:

1. To install the development version of SeaPy, just Clone this repository:

$ git clone https://github.com/PapStatMechMat/SeaPy.git

2. and run the setup script.

$ python setup.py install

3. Import the package:

   >>> import SeaPy

4. Call the function by using:

>>> SeaPy.<name_of_the_function>

5. For example to find the third elastic instability mode of a set of strain images

>>> SeaPy.eim(images,3)

6. You can also use the tools provided in this package individually by importing the functions separately. For example you may use :

from SeaPy import <name_of_the_function> as <a_name>.

7. Please consult the documentation for further details.

Prerequisites:

1. Install Anaconda3

Cite SeaPy:

S. Papanikolaou, Data-Rich, Equation-Free Predictions of Plasticity and Damage in Solids, (under review in Phys. Rev. Materials) arXiv:1905.11289 (2019)

SeaPy on Github

Credits:

• SeaPy is written by:

S. Papanikolaou

Copyright (c) 2019, Stefanos Papanikolaou.