xarray-video


Namexarray-video JSON
Version 0.2.10 PyPI version JSON
download
home_pagehttps://github.com/oceanum/xarray-video
SummaryXarray accessor and zarr codec for storing and accessing time and/or space stacked video
upload_time2023-09-14 21:30:54
maintainer
docs_urlNone
authorOceanum Developers
requires_python
licenseMIT license
keywords oceanum video xarray
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
Xarray extension for working with video data.

**This project is in an early stage of development. Please be patient with any bugs. Any contributuons are welcome.**


* MIT license
* Documentation: https://xarray-video.readthedocs.io.
* Github: https://github.com/oceanum-io/xarray-video


Features
--------

* Xarray backend to read video into an xarray dataset
* Xarray accessor for time and/or space stacked video DataArrays
* Zarr video codec for efficient compression of video. Up to 100x improvement over blosc for video data.
* Xarray accessor for video Datasets for writing to zarr using the video codec
* Simple diagnostic plotting and play functions to view video


Uses
----

* Attach coordinates (for example time or location) to the video frames dimension
* Utilise Xarray selection functionality for easy subsetting of video
* Easily convert video streams and frames to other formats such as netcdf or geotiff
* Store video in an efficient chunked format within zarr
* Create massive lazy access video archives using a zarr backend
* Store multiple videos (for example stereo camera) in the same Dataset with consistent time and/or spatial coordinates.


Limitations
-----------

The library uses [PyAV](https://pyav.org) to read and write to/from video files. It will be limited to the same set of formats and codecs as your PyAV installation.

Although video file access and zarr archive access is lazy, once video data is loaded it is in uncompressed uint8 darrays. Trying to do dataset.load on large video files will exhaust your RAM very quickly.

The play preview is only intended as a diagnostic tool. It buffers the entire video as an array before display so cannot handle larger arrays. The play preview is also unlikely to play in realtime for larger videos.


Credits
-------

This package was developed by `Oceanum Numerical <https://www.oceanum.science>`_, with input from our development partners and contributors.


=======
History
=======

0.0.1 (2022-12-02)
------------------

* First release on PyPI.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/oceanum/xarray-video",
    "name": "xarray-video",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "oceanum,video,xarray",
    "author": "Oceanum Developers",
    "author_email": "developers@oceanum.science",
    "download_url": "https://files.pythonhosted.org/packages/95/9c/026f22ecf94050aa90871329669122e8d59730c766883dbb053455f76931/xarray-video-0.2.10.tar.gz",
    "platform": null,
    "description": "\nXarray extension for working with video data.\n\n**This project is in an early stage of development. Please be patient with any bugs. Any contributuons are welcome.**\n\n\n* MIT license\n* Documentation: https://xarray-video.readthedocs.io.\n* Github: https://github.com/oceanum-io/xarray-video\n\n\nFeatures\n--------\n\n* Xarray backend to read video into an xarray dataset\n* Xarray accessor for time and/or space stacked video DataArrays\n* Zarr video codec for efficient compression of video. Up to 100x improvement over blosc for video data.\n* Xarray accessor for video Datasets for writing to zarr using the video codec\n* Simple diagnostic plotting and play functions to view video\n\n\nUses\n----\n\n* Attach coordinates (for example time or location) to the video frames dimension\n* Utilise Xarray selection functionality for easy subsetting of video\n* Easily convert video streams and frames to other formats such as netcdf or geotiff\n* Store video in an efficient chunked format within zarr\n* Create massive lazy access video archives using a zarr backend\n* Store multiple videos (for example stereo camera) in the same Dataset with consistent time and/or spatial coordinates.\n\n\nLimitations\n-----------\n\nThe library uses [PyAV](https://pyav.org) to read and write to/from video files. It will be limited to the same set of formats and codecs as your PyAV installation.\n\nAlthough video file access and zarr archive access is lazy, once video data is loaded it is in uncompressed uint8 darrays. Trying to do dataset.load on large video files will exhaust your RAM very quickly.\n\nThe play preview is only intended as a diagnostic tool. It buffers the entire video as an array before display so cannot handle larger arrays. The play preview is also unlikely to play in realtime for larger videos.\n\n\nCredits\n-------\n\nThis package was developed by `Oceanum Numerical <https://www.oceanum.science>`_, with input from our development partners and contributors.\n\n\n=======\nHistory\n=======\n\n0.0.1 (2022-12-02)\n------------------\n\n* First release on PyPI.\n",
    "bugtrack_url": null,
    "license": "MIT license",
    "summary": "Xarray accessor and zarr codec for storing and accessing time and/or space stacked video",
    "version": "0.2.10",
    "project_urls": {
        "Homepage": "https://github.com/oceanum/xarray-video"
    },
    "split_keywords": [
        "oceanum",
        "video",
        "xarray"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c88ddeae012256db011ad2184f7cb508b87c1b55a806f1d965553e2e4359b74f",
                "md5": "d3de71454ca37834a1ae6238ad6498c9",
                "sha256": "a1423ea748df308d7256c51793e586fbcc1ec042924d45c8b5c6f97527fa94ea"
            },
            "downloads": -1,
            "filename": "xarray_video-0.2.10-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d3de71454ca37834a1ae6238ad6498c9",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": null,
            "size": 10534,
            "upload_time": "2023-09-14T21:30:47",
            "upload_time_iso_8601": "2023-09-14T21:30:47.627971Z",
            "url": "https://files.pythonhosted.org/packages/c8/8d/deae012256db011ad2184f7cb508b87c1b55a806f1d965553e2e4359b74f/xarray_video-0.2.10-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "959c026f22ecf94050aa90871329669122e8d59730c766883dbb053455f76931",
                "md5": "18de413faabc29a8507e86424c10ac8e",
                "sha256": "dd221b7b406c20362c33e8ad34917c14786108b82cdc83b48579d6b4a6d6e1c4"
            },
            "downloads": -1,
            "filename": "xarray-video-0.2.10.tar.gz",
            "has_sig": false,
            "md5_digest": "18de413faabc29a8507e86424c10ac8e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 32674399,
            "upload_time": "2023-09-14T21:30:54",
            "upload_time_iso_8601": "2023-09-14T21:30:54.086487Z",
            "url": "https://files.pythonhosted.org/packages/95/9c/026f22ecf94050aa90871329669122e8d59730c766883dbb053455f76931/xarray-video-0.2.10.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-09-14 21:30:54",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "oceanum",
    "github_project": "xarray-video",
    "github_not_found": true,
    "lcname": "xarray-video"
}
        
Elapsed time: 0.11551s