{ "info": { "author": "Dzhoshkun Ismail Shakir", "author_email": "d.shakir@ucl.ac.uk", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Intended Audience :: End Users/Desktop", "Intended Audience :: Healthcare Industry", "Intended Audience :: Information Technology", "Intended Audience :: Science/Research", "License :: OSI Approved :: BSD License", "Operating System :: POSIX :: Linux", "Programming Language :: C++", "Programming Language :: Python", "Topic :: Multimedia :: Video", "Topic :: Multimedia :: Video :: Capture", "Topic :: Multimedia :: Video :: Conversion", "Topic :: Scientific/Engineering", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Utilities" ], "description": "IMPORTANT INSTALLATION NOTE\n===========================\n\n``pip install gift-grab`` currently works only with ``--install-option``'s.\nPlease see `this guideline on the GIFT-Grab repository`_.\n\n.. _`this guideline on the GIFT-Grab repository`: https://github.com/gift-surg/GIFT-Grab/blob/master/doc/pypi.md\n\n\nGIFT-Grab\n=========\n\nGIFT-Grab is an open-source C++ and Python API for acquiring, processing and encoding video streams in real time.\n\nGIFT-Grab supports several frame-grabber cards, standard-compliant network streams and video files.\n\nThe Python API is compatible with `NumPy`_ and `SciPy`_.\nPlease note that currently **only Python 2** is supported.\n\n.. _`SciPy`: https://www.scipy.org/\n.. _`NumPy`: http://www.numpy.org/\n\n\nFeatures\n--------\n\n* Capturing video streams using frame-grabber hardware, the following cards are supported:\n - `Epiphan DVI2PCIe Duo`_\n - `Blackmagic DeckLink SDI 4K`_\n* Capturing standard-compliant network video streams\n* Reading (decoding) video files\n* Writing (encoding) video files (including real-time encoding), the following formats are supported:\n - `Xvid`_-encoded `AVI`_\n - `HEVC (H.265)`_-encoded `MP4`_\n - `VP9`_-encoded `WebM`_\n* Video data as NumPy arrays to facilitate processing with NumPy-compatible Python libraries\n\n.. _`Epiphan DVI2PCIe Duo`: http://www.epiphan.com/products/dvi2pcie-duo/\n.. _`Blackmagic DeckLink SDI 4K`: https://www.blackmagicdesign.com/products/decklink/models\n.. _`Xvid`: https://www.xvid.com/\n.. _`AVI`: https://msdn.microsoft.com/en-us/library/windows/desktop/dd318189(v=vs.85).aspx\n.. _`HEVC (H.265)`: http://www.itu.int/ITU-T/recommendations/rec.aspx?rec=11885\n.. _`MP4`: http://www.iso.org/iso/catalogue_detail.htm?csnumber=38538\n.. _`VP9`: http://www.webmproject.org/vp9/\n.. _`WebM`: https://www.webmproject.org/users/\n\n\nGetting started\n---------------\n\n* Installation\n - `Required tools and libraries`_\n - `Building GIFT-Grab from source`_ (C++ and Python)\n - |InstallUsingPip| (only Python)\n* `Python examples with explanation`_\n* `Building a minimal GIFT-Grab with NumPy compatibility`_\n* API documentation\n - `C++ API documentation`_\n - Python API documentation: please use the C++ API documentation\n * Most Python API elements are equivalent to their C++ counterparts.\n * Differences are noted in the C++ docstrings (e.g. |VideoFrame.data|).\n* `Known issues and limitations`_\n\n.. _`Required tools and libraries`: https://github.com/gift-surg/GIFT-Grab/blob/master/doc/requirements.md\n.. _`Building GIFT-Grab from source`: https://github.com/gift-surg/GIFT-Grab/blob/master/doc/build.md\n.. |VideoFrame.data| replace:: ``data()`` method of ``VideoFrame``\n.. _VideoFrame.data: https://codedocs.xyz/gift-surg/GIFT-Grab/classgg_1_1_video_frame.html#a458e15b00b5b2d39855db76215c44055\n.. |InstallUsingPip| replace:: Installing GIFT-Grab using ``pip``\n.. _InstallUsingPip: https://github.com/gift-surg/GIFT-Grab/blob/master/doc/pypi.md\n.. _`Python examples with explanation`: http://gift-grab.rtfd.io\n.. _`C++ API documentation`: https://codedocs.xyz/gift-surg/GIFT-Grab/\n.. _`Building a minimal GIFT-Grab with NumPy compatibility`: https://github.com/gift-surg/GIFT-Grab/blob/master/doc/minimal.md\n.. _`Known issues and limitations`: https://github.com/gift-surg/GIFT-Grab/blob/master/doc/issues.md\n\n\nCiting GIFT-Grab\n----------------\n\nIf you use GIFT-Grab in your work, please cite `Shakir et al. (2017)`_:\n\n Shakir DI, Garc\u00eda-Peraza-Herrera LC, Daga P, Doel T, Clarkson MJ, Ourselin S, and Vercauteren T.\n `GIFT-Grab: Real-time C++ and Python multi-channel video capture, processing and encoding API.`_\n Journal of Open Research Software. 2017;5(1):27. DOI: `http://doi.org/10.5334/jors.169`_\n\nBibTeX entry:\n\n.. code-block:: bibtex\n\n @article{giftgrab17,\n author = {Dzhoshkun Ismail Shakir and Luis Carlos Garc\\'{i}a-Peraza-Herrera and Pankaj Daga and Tom Doel and Matthew J. Clarkson and S\\'{e}bastien Ourselin and Tom Vercauteren},\n title = {{GIFT-Grab: Real-time C++ and Python multi-channel video capture, processing and encoding API}},\n journal = {{Journal of Open Research Software}},\n year = {2017},\n number = {1},\n pages = {27},\n month = {10},\n day = {9},\n volume = {5},\n url = {http://doi.org/10.5334/jors.169},\n doi = {http://doi.org/10.5334/jors.169},\n }\n\n.. _`Shakir et al. (2017)`: http://doi.org/10.5334/jors.169\n.. _`GIFT-Grab: Real-time C++ and Python multi-channel video capture, processing and encoding API.`: http://doi.org/10.5334/jors.169\n.. _`http://doi.org/10.5334/jors.169`: http://doi.org/10.5334/jors.169\n\n\nSupport and contributing\n------------------------\n\nPlease see the `contribution guide`_ for bug reports, feature requests, and if you would like to contribute to GIFT-Grab.\n\n.. _`contribution guide`: https://github.com/gift-surg/GIFT-Grab/blob/master/CONTRIBUTING.md\n\n\nLicensing and copyright\n-----------------------\n\nCopyright (c) 2015-7, `University College London`_\n\nGIFT-Grab is available as free open-source software under the BSD-3-Clause licence.\nPlease see the `LICENSE`_ file for details.\n\nOther licences may apply for the GIFT-Grab dependencies.\nPlease see the `dependency installation guidelines`_ for the implications of using them with regards to licensing.\n\n.. _`University College London`: http://www.ucl.ac.uk\n.. _`LICENSE`: https://github.com/gift-surg/GIFT-Grab/blob/master/LICENSE\n.. _`dependency installation guidelines`: https://github.com/gift-surg/GIFT-Grab/blob/master/doc/tips.md\n\n\nAcknowledgements\n----------------\n\nGIFT-Grab was developed as part of the `GIFT-Surg`_ project at the `Translational Imaging Group`_ in the `Centre for Medical Image Computing`_ at `University College London`_ (UCL).\n\nThis work was supported through an Innovative Engineering for Health award by the `Wellcome Trust`_ [WT101957], the `Engineering and Physical Sciences Research Council`_ [NS/A000027/1] and a `National Institute for Health Research`_ Biomedical Research Centre `UCLH`_ / UCL High Impact Initiative.\n\n.. _`Wellcome Trust`: http://www.wellcome.ac.uk\n.. _`Translational Imaging Group`: http://cmictig.cs.ucl.ac.uk\n.. _`GIFT-Surg`: http://www.gift-surg.ac.uk\n.. _`Centre for Medical Image Computing`: http://cmic.cs.ucl.ac.uk\n.. _`National Institute for Health Research`: http://www.nihr.ac.uk/\n.. _`UCLH`: http://www.uclh.nhs.uk\n.. _`Engineering and Physical Sciences Research Council`: http://www.epsrc.ac.uk", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/gift-surg/GIFT-Grab", "keywords": "multi-channel,video capture,real-time video encoding,video processing,hardware-accelerated video encoding,GPU,frame-grabber hardware,network video streaming,Epiphan DVI2PCIe Duo,Blackmagic DeckLink SDI 4K,Epiphan Pearl,Xvid,H.265,H265,VP9,HEVC,C++,Python,NumPy,SciPy,GIFT-Surg", "license": "BSD-3-Clause", "maintainer": "", "maintainer_email": "", "name": "GIFT-Grab", "package_url": "https://pypi.org/project/GIFT-Grab/", "platform": "", "project_url": "https://pypi.org/project/GIFT-Grab/", "project_urls": { "Homepage": "https://github.com/gift-surg/GIFT-Grab" }, "release_url": "https://pypi.org/project/GIFT-Grab/1708.post1/", "requires_dist": null, "requires_python": "", "summary": "A C++ and NumPy-compatible Python API for acquiring, processing and encoding video streams in real time", "version": "1708.post1" }, "last_serial": 3244486, "releases": { "1703": [ { "comment_text": "", "digests": { "md5": "4ea1e1824e97b33d314e06f847f2930a", "sha256": "4eb45427f1a1bcce8df5746f037e4acbae15a53229767891b6e517a687879e4e" }, "downloads": -1, "filename": "GIFT-Grab-1703.tar.gz", "has_sig": false, "md5_digest": "4ea1e1824e97b33d314e06f847f2930a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 104073, "upload_time": "2017-03-16T10:36:26", "url": "https://files.pythonhosted.org/packages/1f/e8/010af58850c23af13ec9f21ad0409012d733b79aca24f2677a8b0d6697b4/GIFT-Grab-1703.tar.gz" } ], "1705": [ { "comment_text": "", "digests": { "md5": "d2ed26b680079ce27559fe1dbe0b4515", "sha256": "dfa38220a6bd058dbdb3b9a3ac34b9238af4f7e1e6113b19e54063a1ad231cd7" }, "downloads": -1, "filename": "GIFT-Grab-1705.tar.gz", "has_sig": false, "md5_digest": "d2ed26b680079ce27559fe1dbe0b4515", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 104602, "upload_time": "2017-05-17T11:07:08", "url": "https://files.pythonhosted.org/packages/80/1e/9a270de5475b44886da9449ba567429ccc055aab08235b30bc4b18a3d236/GIFT-Grab-1705.tar.gz" } ], "1708": [ { "comment_text": "", "digests": { "md5": "fef4c4103199bf5fb57e93763ed11d3b", "sha256": "fd1906d9eb5ee595b2cb655f8841444c2081cb6a86986bd7e9a59b4f41af1638" }, "downloads": -1, "filename": "GIFT-Grab-1708.tar.gz", "has_sig": false, "md5_digest": "fef4c4103199bf5fb57e93763ed11d3b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 108893, "upload_time": "2017-08-09T08:16:54", "url": "https://files.pythonhosted.org/packages/9f/ae/cd7dbfeac8ba3c4f83959e4fd736711f3bdcf341bfea4e79ae494b41cbfd/GIFT-Grab-1708.tar.gz" } ], "1708.post1": [ { "comment_text": "", "digests": { "md5": "06a5273194b7bce5022ecf13025fabb2", "sha256": "9cc02764072fed9bda52edbac31543fcd7f2be2acc5fc8608af340bf42cb3836" }, "downloads": -1, "filename": "GIFT-Grab-1708.post1.tar.gz", "has_sig": false, "md5_digest": "06a5273194b7bce5022ecf13025fabb2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 110375, "upload_time": "2017-10-12T07:30:50", "url": "https://files.pythonhosted.org/packages/2a/c8/39718be585b17349155b541b872ffa7114b0742c91ed05400bb591b51839/GIFT-Grab-1708.post1.tar.gz" } ], "1708rc3": [ { "comment_text": "", "digests": { "md5": "73b3c95076e368470f3b1bf5448c60f5", "sha256": "722b0d3d61367e2cdfe1870a2813997bcabc19d5f3d303647ba9e3fc691bc3ef" }, "downloads": -1, "filename": "GIFT-Grab-1708rc3.tar.gz", "has_sig": false, "md5_digest": "73b3c95076e368470f3b1bf5448c60f5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 109048, "upload_time": "2017-08-03T16:51:31", "url": "https://files.pythonhosted.org/packages/61/6e/696c6ef90f3bce26364e503f5c5b83405a34de73c8dd5c407f81f5c8b97a/GIFT-Grab-1708rc3.tar.gz" } ], "1708rc4": [ { "comment_text": "", "digests": { "md5": "3cdf065052f2eb149ce5bf3f002a158e", "sha256": "0ea5742ffe27d9c24a53906c0a49b652a1ea75d22440c1e9fb351d9b3684601c" }, "downloads": -1, "filename": "GIFT-Grab-1708rc4.tar.gz", "has_sig": false, "md5_digest": "3cdf065052f2eb149ce5bf3f002a158e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 108876, "upload_time": "2017-08-04T10:49:15", "url": "https://files.pythonhosted.org/packages/92/00/b681539b7f02387027a901ba33662a771141dc7db7af84e0431c7280cae4/GIFT-Grab-1708rc4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "06a5273194b7bce5022ecf13025fabb2", "sha256": "9cc02764072fed9bda52edbac31543fcd7f2be2acc5fc8608af340bf42cb3836" }, "downloads": -1, "filename": "GIFT-Grab-1708.post1.tar.gz", "has_sig": false, "md5_digest": "06a5273194b7bce5022ecf13025fabb2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 110375, "upload_time": "2017-10-12T07:30:50", "url": "https://files.pythonhosted.org/packages/2a/c8/39718be585b17349155b541b872ffa7114b0742c91ed05400bb591b51839/GIFT-Grab-1708.post1.tar.gz" } ] }