pyMRAW


NamepyMRAW JSON
Version 0.33.0 PyPI version JSON
download
home_pageNone
SummaryModule for reading and writing Photron MRAW image sequences.
upload_time2025-07-11 06:16:32
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseNone
keywords photron cih cihx mraw read/write
VCS
bugtrack_url
requirements colorama nose numpy py pytest xmltodict numba build twine
Travis-CI No Travis.
coveralls test coverage No coveralls.
            pyMRAW
======

Photron MRAW File Reader.
-------------------------

`pyMRAW` is an open-source package, enabling the efficient use of the Photron MRAW video files in Python workflows.

It's main feature is the use of memory-mapped (`np.memmap`) arrays to create memory maps to locally stored raw video files and avoid loading large amounts of data into RAM. 

.. warning::
    To take advantage of pyMRAW's memory-mapping functionality, make sure to save MRAW files either in 8-bit or 16-bit formats, corresponding to standard data types `uint8` and `uint16`! Using pyMRAW to read 12-bit MRAW files is possible, but requires loading the complete image data into RAM to produce standard Numpy arrays.

To load `.mraw` - `.cihx` files, simply use the `pymraw.load_video` function::

    import pyMRAW
    images, info = pyMRAW.load_video('data/beam.cihx')

For more info, please refer to the `Showcase.ipynb` notebook.

We developed this module while working on this publication:
J. Javh, J. Slavič and M. Boltežar: The Subpixel Resolution of Optical-Flow-Based Modal Analysis,
Mechanical Systems and Signal Processing, Vol. 88, p. 89–99, 2017

Our recent research effort can be found here: http://lab.fs.uni-lj.si/ladisk/?what=incfl&flnm=research_filtered.php&keyword=optical%20methods

If you find our research useful, consider to cite us.


|pytest|

.. |pytest| image:: https://github.com/ladisk/pyMRAW/actions/workflows/python-package.yml/badge.svg
    :target: https://github.com/ladisk/pyMRAW/actions




            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "pyMRAW",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "\"Janko Slavi\u010d et al.\" <janko.slavic@fs.uni-lj.si>",
    "keywords": "Photron, cih, cihx, mraw, read/write",
    "author": null,
    "author_email": "\"Jaka Javh, Janko Slavi\u010d, Domen Gorjup\" <janko.slavic@fs.uni-lj.si>",
    "download_url": "https://files.pythonhosted.org/packages/e3/2f/eb58504aac8d049786f9a2bf06d117aa7128fda62278ae2ab0714657ab45/pymraw-0.33.0.tar.gz",
    "platform": null,
    "description": "pyMRAW\n======\n\nPhotron MRAW File Reader.\n-------------------------\n\n`pyMRAW` is an open-source package, enabling the efficient use of the Photron MRAW video files in Python workflows.\n\nIt's main feature is the use of memory-mapped (`np.memmap`) arrays to create memory maps to locally stored raw video files and avoid loading large amounts of data into RAM. \n\n.. warning::\n    To take advantage of pyMRAW's memory-mapping functionality, make sure to save MRAW files either in 8-bit or 16-bit formats, corresponding to standard data types `uint8` and `uint16`! Using pyMRAW to read 12-bit MRAW files is possible, but requires loading the complete image data into RAM to produce standard Numpy arrays.\n\nTo load `.mraw` - `.cihx` files, simply use the `pymraw.load_video` function::\n\n    import pyMRAW\n    images, info = pyMRAW.load_video('data/beam.cihx')\n\nFor more info, please refer to the `Showcase.ipynb` notebook.\n\nWe developed this module while working on this publication:\nJ. Javh, J. Slavi\u010d and M. Bolte\u017ear: The Subpixel Resolution of Optical-Flow-Based Modal Analysis,\nMechanical Systems and Signal Processing, Vol. 88, p. 89\u201399, 2017\n\nOur recent research effort can be found here: http://lab.fs.uni-lj.si/ladisk/?what=incfl&flnm=research_filtered.php&keyword=optical%20methods\n\nIf you find our research useful, consider to cite us.\n\n\n|pytest|\n\n.. |pytest| image:: https://github.com/ladisk/pyMRAW/actions/workflows/python-package.yml/badge.svg\n    :target: https://github.com/ladisk/pyMRAW/actions\n\n\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Module for reading and writing Photron MRAW image sequences.",
    "version": "0.33.0",
    "project_urls": {
        "documentation": "https://github.com/ladisk/pyMRAW",
        "homepage": "https://github.com/ladisk/pyMRAW",
        "source": "https://github.com/ladisk/pyMRAW"
    },
    "split_keywords": [
        "photron",
        " cih",
        " cihx",
        " mraw",
        " read/write"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "451e02a351015e43ca769c04f46e4c6e51524e8c5c2c70f75ee406d337b987df",
                "md5": "d5633809b0a475739c50fb0efb7906a3",
                "sha256": "e6270ded20d009f2698618c32aeb4518473880500cd172aa05f9c135173864eb"
            },
            "downloads": -1,
            "filename": "pymraw-0.33.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d5633809b0a475739c50fb0efb7906a3",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 7675,
            "upload_time": "2025-07-11T06:16:31",
            "upload_time_iso_8601": "2025-07-11T06:16:31.194166Z",
            "url": "https://files.pythonhosted.org/packages/45/1e/02a351015e43ca769c04f46e4c6e51524e8c5c2c70f75ee406d337b987df/pymraw-0.33.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "e32feb58504aac8d049786f9a2bf06d117aa7128fda62278ae2ab0714657ab45",
                "md5": "2cd751a0c768fbe99838660a8b87ff50",
                "sha256": "a1354a3cafb2faa304d5f99801cd8c0a911a1192e22e5d56c3855ebd15887305"
            },
            "downloads": -1,
            "filename": "pymraw-0.33.0.tar.gz",
            "has_sig": false,
            "md5_digest": "2cd751a0c768fbe99838660a8b87ff50",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 6415051,
            "upload_time": "2025-07-11T06:16:32",
            "upload_time_iso_8601": "2025-07-11T06:16:32.707403Z",
            "url": "https://files.pythonhosted.org/packages/e3/2f/eb58504aac8d049786f9a2bf06d117aa7128fda62278ae2ab0714657ab45/pymraw-0.33.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-11 06:16:32",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ladisk",
    "github_project": "pyMRAW",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "colorama",
            "specs": [
                [
                    ">=",
                    "0.3.7"
                ]
            ]
        },
        {
            "name": "nose",
            "specs": [
                [
                    ">=",
                    "1.3.7"
                ]
            ]
        },
        {
            "name": "numpy",
            "specs": [
                [
                    ">=",
                    "1.12.0"
                ]
            ]
        },
        {
            "name": "py",
            "specs": [
                [
                    ">=",
                    "1.4.32"
                ]
            ]
        },
        {
            "name": "pytest",
            "specs": [
                [
                    ">=",
                    "3.0.5"
                ]
            ]
        },
        {
            "name": "xmltodict",
            "specs": [
                [
                    ">=",
                    "0.12.0"
                ]
            ]
        },
        {
            "name": "numba",
            "specs": [
                [
                    ">=",
                    "0.56.4"
                ]
            ]
        },
        {
            "name": "build",
            "specs": []
        },
        {
            "name": "twine",
            "specs": []
        }
    ],
    "lcname": "pymraw"
}
        
Elapsed time: 1.55810s