Skip to main content

Software for the practical analysis of materials

Project description

https://img.shields.io/badge/license-GPLv3-blue.svg https://gricad-gitlab.univ-grenoble-alpes.fr/ttk/spam/badges/master/pipeline.svg https://gricad-gitlab.univ-grenoble-alpes.fr/ttk/spam/badges/master/coverage.svg https://badge.fury.io/py/spam.svg https://joss.theoj.org/papers/10.21105/joss.02286/status.svg

Spam is a piece of Python software built upon NumPy and SciPy for the analysis and manipulation of 3D and 2D data sets in material science, be they from x-ray tomography, random fields or any other source.

A number of common functions are provided that are either lacking or slow in Numpy and Scipy, which are expected to be used by users within new python scripts. These functions are in the tools/ directory, and include tools to work with random fields, morphological operations, digital image correlation, and labelled images. Some of spam’s functions transparently call C/C++ functions for speed.

Some user-callable scipts are also provided – they are more complex pieces of code that combine a number of functions and which have a command-line interface. For the moment the clients are 3 different image correlation techniques.

Please have a look at our online documentation for:

If you find bugs, need help, or want to talk to the developers, we use a riot/matrix.org chat room for organisation, please join it here and come and talk to us – it is easy, there is a chat client that can run in your web broswer. All you need to do is choose a user name!

Changelog

Version

Date

Notes

Version 0.5.2.1

2020-07-20

This is the version in the JOSS paper. Making python 3.8 package for PyPI, along with classifiers. Python 2.7 dropped

Version 0.5.2

2020-06-03

Big improvements in spam-mmr and spam-mmr-graphical, all TSVs im1->im2 and gradients always computed in im2

Version 0.5.1.5

2020-05-28

Don’t recompute Jacobian in register if not needed. Safety in pixel search

Version 0.5.1.4

2020-05-16

Fix spam-deformImageFromField, C++14

Version 0.5.1.3

2020-04-20

Fix spam-mmr and improvements to pixel search in spam-ddic

Version 0.5.1.2

2020-04-20

Fix and test for large initial guesses in register(), spam-mmr-graphical revived

Version 0.5.1.1

2020-04-08

Fix for running spam-ldic for pixel search

Version 0.5.1

2020-04-07

Fix for running spam-ddic with mpi, implementation of S. Brisard’s Directional Erosion

Version 0.5.0

2020-03-27

Big rename of scripts, functions, variables, parameters, with some backwards compatibility in TSV file reading. Some examples:

  • spam.correlate.lucasKanade -> spam.correlate.register

  • spam.helpers.readTSV -> spam.helpers.readCorrelationTSV

New framework for the calculation of strains, where the computation of F is separated from its decomposition. Output fields from correlation with prefixes “SubPix” and “SubPixel” become prefixless In TSV outputs from correlation the components like “F12” are now called “Fzy”

Version 0.4.3

2020-01-16

Various fixes to graphical clients (able to save TSV from spam-mmr-graphical and do a last, precise run with spam-mmr). Improvement to triangulation (now with CGAL alpha shapes) and discrete strain calculator (tested results)

Version 0.4.2

2019-09-25

spam-mmr-graphical now working, improvements in spam-mmr.

Version 0.4.1

2019-09-13

spam-mmr-graphical now working (c-python type error). Various bugfixes in clients. spam-ITKwatershed now accepts markers

Version 0.4.0

2019-07-18

c++ now bound with pybind11. New graphical script spam-mmr-graphical for multi-modal registration. New graphical script spam-ereg for eye (manual) registration. Python3 upgrade recommended for all users

Version 0.3.3.1

2019-05-27

Binning 2^31 fix, remove lines for immediate prints that are not py3 compatible First version with CGAL triangulation

Version 0.3.2.1

2019-05-14

Update pip documentation and changelog

Version 0.3.2

2019-04-30

Fix segfault with images larger than 2^31 voxels, and output both subtracted and original fields in spam-ldic

Version 0.3.1

2019-04-08

Fix a number of forgotten spam.DIC.transformationOperator functions

Version 0.3.0

2019-03-28

Consistent naming in DIC: Phi is 4x4 homogeneous deformation function and F is its internal 3x3 displacement gradient

Version 0.2.2.2

2019-03-21

First version on pip with complete dependencies. This version of spam runs fully in a venv with pip install spam

Version 0.2.2.1

2019-03-20

Pull in requirements.txt into setup.py automatically. This aligns the build from git with the build from pip.

Version 0.2.2

2019-02-21

Approximate python3 compatibility

Version 0.2.1

2019-02-18

Add PyPI documentation to pip in RST

Version 0.2.0

2019-02-18

Add PyPI documentation to README.rst to appear on pip. Note that the build status and coverage badges won’t appear until access to gitlab is opened

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

spam-0.5.2.1-cp38-cp38-manylinux2014_x86_64.whl (25.2 MB view details)

Uploaded CPython 3.8

spam-0.5.2.1-cp37-cp37m-manylinux2014_x86_64.whl (24.7 MB view details)

Uploaded CPython 3.7m

spam-0.5.2.1-cp36-cp36m-manylinux2014_x86_64.whl (24.7 MB view details)

Uploaded CPython 3.6m

spam-0.5.2.1-cp35-cp35m-manylinux2014_x86_64.whl (24.7 MB view details)

Uploaded CPython 3.5m

File details

Details for the file spam-0.5.2.1-cp38-cp38-manylinux2014_x86_64.whl.

File metadata

  • Download URL: spam-0.5.2.1-cp38-cp38-manylinux2014_x86_64.whl
  • Upload date:
  • Size: 25.2 MB
  • Tags: CPython 3.8
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.7.8

File hashes

Hashes for spam-0.5.2.1-cp38-cp38-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 d6c1c1c53a988b3daf44c1865d40f86de48665639bfbd5eea1317eb083638a3a
MD5 6af0b2992c8348a4ad1af435e4b998c8
BLAKE2b-256 26bb978cd5f32bed323866fb11b49c2d6ca4709dfb21abb978256cb3ad0d9297

See more details on using hashes here.

File details

Details for the file spam-0.5.2.1-cp37-cp37m-manylinux2014_x86_64.whl.

File metadata

  • Download URL: spam-0.5.2.1-cp37-cp37m-manylinux2014_x86_64.whl
  • Upload date:
  • Size: 24.7 MB
  • Tags: CPython 3.7m
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.7.8

File hashes

Hashes for spam-0.5.2.1-cp37-cp37m-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 b2027ae1fe7beaedf9b1e38286af9e5cc216a55cd0f2c8c10d2a594d5d816702
MD5 04364ac39259902c54f1cf9cbb070922
BLAKE2b-256 266ade915298cdd568f0f15489e1e29c4489d95b13307e8aa80234a914414693

See more details on using hashes here.

File details

Details for the file spam-0.5.2.1-cp36-cp36m-manylinux2014_x86_64.whl.

File metadata

  • Download URL: spam-0.5.2.1-cp36-cp36m-manylinux2014_x86_64.whl
  • Upload date:
  • Size: 24.7 MB
  • Tags: CPython 3.6m
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.7.8

File hashes

Hashes for spam-0.5.2.1-cp36-cp36m-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 46e2bf67c56b0eff17e91817032bc8b73bf1c3e5204d9b20678b5fadf3ce585d
MD5 2b167df975760c4ae965c082f4441758
BLAKE2b-256 65fb375244c091b9756f357dcd2bd574176e7868a94f139243d7c2e749b0392a

See more details on using hashes here.

File details

Details for the file spam-0.5.2.1-cp35-cp35m-manylinux2014_x86_64.whl.

File metadata

  • Download URL: spam-0.5.2.1-cp35-cp35m-manylinux2014_x86_64.whl
  • Upload date:
  • Size: 24.7 MB
  • Tags: CPython 3.5m
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.7.8

File hashes

Hashes for spam-0.5.2.1-cp35-cp35m-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 907f852b0dae1cd92462c1cb1cdd4723f0a0356b384e87b9d80d85f89cec79f3
MD5 cf2cc7279a2529c5b105dfeefb684caa
BLAKE2b-256 0ce6fe241fb09373c470b965e8ef7af1ac4762060a66c2b931c9ebc0c380d909

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page