{ "info": { "author": "Roman Shkarin, Andrei Shkarin", "author_email": "roman.v.shkarin@gmail.com, andrei.shkarin@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 2.7", "Topic :: Scientific/Engineering :: Information Analysis" ], "description": ".. image:: docs/source/_static/logo.png\r\n :align: left\r\n\r\n-----------\r\n\r\n.. image:: https://travis-ci.org/rshkarin/quanfima.svg?branch=master \r\n :target: https://travis-ci.org/rshkarin/quanfima \r\n\r\n.. image:: https://readthedocs.org/projects/quanfima/badge/?version=latest \r\n :target: http://quanfima.readthedocs.io/en/latest/?badge=latest \r\n :alt: Documentation Status\r\n\r\n.. image:: https://zenodo.org/badge/127795855.svg\r\n :target: https://zenodo.org/badge/latestdoi/127795855\r\n\r\n\r\n\r\n\r\n*Quanfima* (**qu**\\ antitative **an**\\ alysis of **fi**\\ brous **ma**\\ terials)\r\nis a collection of useful functions for morphological analysis and visualization\r\nof 2D/3D data from various areas of material science. The aim is to simplify\r\nthe analysis process by providing functionality for frequently required tasks\r\nin the same place.\r\n\r\nMore examples of usage you can find in the documentation.\r\n\r\n- Analysis of fibrous structures by tensor-based method in 2D / 3D datasets.\r\n- Estimation of structure diameters in 2D / 3D by a ray-casting method.\r\n- Counting of particles in 2D / 3D datasets and providing a detailed report in\r\n pandas.DataFrame format.\r\n- Calculation of porosity measure for each material in 2D / 3D datasets.\r\n- Visualization in 2D / 3D using matplotlib, visvis packages.\r\n\r\nInstallation\r\n------------\r\n\r\nThe easiest way to install the latest version is by using pip::\r\n\r\n $ pip install quanfima\r\n\r\nYou may also use Git to clone the repository and install it manually::\r\n\r\n $ git clone https://github.com/rshkarin/quanfima.git\r\n $ cd quanfima\r\n $ python setup.py install\r\n\r\nUsage\r\n-----\r\nOpen a grayscale image, perform segmentation, estimate porosity, analyze fiber\r\norientation and diameters, and plot the results.\r\n\r\n.. code-block:: python\r\n\r\n import numpy as np\r\n from skimage import io, filters\r\n from quanfima import morphology as mrph\r\n from quanfima import visualization as vis\r\n from quanfima import utils\r\n\r\n img = io.imread('../data/polymer_slice.tif')\r\n\r\n th_val = filters.threshold_otsu(img)\r\n img_seg = (img > th_val).astype(np.uint8)\r\n\r\n # estimate porosity\r\n pr = mrph.calc_porosity(img_seg)\r\n for k,v in pr.items():\r\n print 'Porosity ({}): {}'.format(k, v)\r\n\r\n # prepare data and analyze fibers\r\n data, skeleton, skeleton_thick = utils.prepare_data(img_seg)\r\n cskel, fskel, omap, dmap, ovals, dvals = \\\r\n mrph.estimate_fiber_properties(data, skeleton)\r\n\r\n # plot results\r\n vis.plot_orientation_map(omap, fskel, min_label=u'0\u00b0', max_label=u'180\u00b0',\r\n figsize=(10,10),\r\n name='2d_polymer',\r\n output_dir='/path/to/output/dir')\r\n vis.plot_diameter_map(dmap, cskel, figsize=(10,10), cmap='gist_rainbow',\r\n name='2d_polymer',\r\n output_dir='/path/to/output/dir')\r\n\r\n.. code-block:: python\r\n\r\n >> Porosity (Material 1): 0.845488888889\r\n\r\n.. image:: docs/source/_static/2d_polymer_data.png\r\n :align: center\r\n\r\n.. image:: docs/source/_static/2d_polymer_orientation_map_600px.png\r\n :align: center\r\n\r\n.. image:: docs/source/_static/2d_polymer_diameter_map_600px.png\r\n :align: center\r\n\r\n\r\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/rshkarin/quanfima", "keywords": "biomaterials fiber analysis material science visualization", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "quanfima", "package_url": "https://pypi.org/project/quanfima/", "platform": "", "project_url": "https://pypi.org/project/quanfima/", "project_urls": { "Homepage": "http://github.com/rshkarin/quanfima" }, "release_url": "https://pypi.org/project/quanfima/0.1a3/", "requires_dist": [ "matplotlib (==2.0.2)", "numpy (>=1.13.3)", "pandas (>=0.19.2)", "scikit-image (>=0.12.3)", "scikit-learn (>=0.18.1)", "scipy (>=0.19.0)", "imageio (>=2.3.0)" ], "requires_python": ">=2.6,<3", "summary": "The package for morphological analysis and visualization of fibrous materials.", "version": "0.1a3" }, "last_serial": 3739275, "releases": { "0.1a1": [ { "comment_text": "", "digests": { "md5": "7d649af3d90b45819af76d2495301770", "sha256": "c19c65f2922fdd123e04d67e184233d4c6a79c432e3dc1d9542e694b65d9dda0" }, "downloads": -1, "filename": "quanfima-0.1a1-py2-none-any.whl", "has_sig": false, "md5_digest": "7d649af3d90b45819af76d2495301770", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": ">=2.6,<3", "size": 28397, "upload_time": "2018-04-02T18:21:11", "url": "https://files.pythonhosted.org/packages/8e/a0/b2ab4ef24e69e8ec779646f9a7c8f21e4e90abafd803d7fb1c8c611d5cf8/quanfima-0.1a1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "95d5f1b68f8164fb6f16ad7c13d1d7bc", "sha256": "264861635ead9388f8394be07db9051c86a36f447cbbc4470f6a15bf5462a92a" }, "downloads": -1, "filename": "quanfima-0.1a1.zip", "has_sig": false, "md5_digest": "95d5f1b68f8164fb6f16ad7c13d1d7bc", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.6,<3", "size": 31141, "upload_time": "2018-04-05T10:21:02", "url": "https://files.pythonhosted.org/packages/b7/55/b387c434c750171f520d791c01c471622b921ed493a57d171bea98748182/quanfima-0.1a1.zip" } ], "0.1a2": [ { "comment_text": "", "digests": { "md5": "726ad9137029c894f686245162cbaff4", "sha256": "30d203afffb931da2fd329fe90d0aed447766f443622cf214d851e1e4ac83a14" }, "downloads": -1, "filename": "quanfima-0.1a2-py2-none-any.whl", "has_sig": false, "md5_digest": "726ad9137029c894f686245162cbaff4", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": ">=2.6,<3", "size": 28865, "upload_time": "2018-04-05T10:28:11", "url": "https://files.pythonhosted.org/packages/84/0b/034fb0306e686b0ee44eab713d1b9ddd145d4025b8db419880626ad0de7a/quanfima-0.1a2-py2-none-any.whl" } ], "0.1a3": [ { "comment_text": "", "digests": { "md5": "dc2183e395057acd2fff316456a9dafd", "sha256": "5047e4b4abe726ebd05b98fe5cb4132c824265b97b1af37f13dfe58423c47d7c" }, "downloads": -1, "filename": "quanfima-0.1a3-py2-none-any.whl", "has_sig": false, "md5_digest": "dc2183e395057acd2fff316456a9dafd", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": ">=2.6,<3", "size": 4989148, "upload_time": "2018-04-05T22:12:11", "url": "https://files.pythonhosted.org/packages/2f/de/94930d6ea2922cbabe982764974632ea8e26003e9cbb3d17b9e7ad915e17/quanfima-0.1a3-py2-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "dc2183e395057acd2fff316456a9dafd", "sha256": "5047e4b4abe726ebd05b98fe5cb4132c824265b97b1af37f13dfe58423c47d7c" }, "downloads": -1, "filename": "quanfima-0.1a3-py2-none-any.whl", "has_sig": false, "md5_digest": "dc2183e395057acd2fff316456a9dafd", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": ">=2.6,<3", "size": 4989148, "upload_time": "2018-04-05T22:12:11", "url": "https://files.pythonhosted.org/packages/2f/de/94930d6ea2922cbabe982764974632ea8e26003e9cbb3d17b9e7ad915e17/quanfima-0.1a3-py2-none-any.whl" } ] }