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"
}