{
"info": {
"author": "Chenjie Xu",
"author_email": "cxuscience@gmail.com",
"bugtrack_url": null,
"classifiers": [
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"Intended Audience :: Education",
"Intended Audience :: Science/Research",
"License :: OSI Approved :: MIT License",
"Programming Language :: Python :: 3",
"Topic :: Software Development :: Libraries",
"Topic :: Software Development :: Libraries :: Python Modules"
],
"description": "# Selective Search\n[](https://github.com/ChenjieXu/selective_search/releases/)\n[](https://pypi.org/project/selective-search/)\n[](https://travis-ci.org/ChenjieXu/selective_search)\n[](https://www.codacy.com/manual/ChenjieXu/selective_search)\n\nThis is a full implementation of selective search in Python. The implementation is typically based on this paper[[1]](#Uijlings). It have three selective search modes according to various diversification strategies as in the paper.\n\n## Installation\nInstalling from [PyPI](https://pypi.org/project/selective-search/) is recommended :\n```\n$ pip install selective-search\n```\nIt is also possible to install the latest version from [Github source](https://github.com/ChenjieXu/selective_search/):\n```\n$ git clone https://github.com/ChenjieXu/selective_search.git\n$ cd selective_search\n$ python setup.py install\n```\n\n## Quick Start\n\n```python\nimport skimage.io\nfrom selective_search import selective_search\n\n# Load image as NumPy array from image files\nimage = skimage.io.imread('path/to/image')\n\n# Run selective search using single mode\nboxes = selective_search(image, mode='single', random=False)\n```\nFor detailed examples, refer [this](https://github.com/ChenjieXu/selective_search/tree/master/examples) part of the repository.\n\n## Parameters\n\n### Mode\n\nThree modes correspond to various combinations of diversification strategies. The appoach to combine different diversification strategies, say, color spaces, similarity measures, starting regions is listed in the following table[[1]](#Uijlings).\n\n| Mode | Color Spaces | Similarity Measures | Starting Regions (k) | Number of Combinations |\n|---------|---------------------|---------------------|----------------------|------------------------|\n| single | HSV | CTSF | 100 | 1 |\n| fast | HSV, Lab | CTSF, TSF | 50, 100 | 8 |\n| quality | HSV, Lab, rgI, H, I | CTSF, TSF, F, S | 50, 100, 150, 300 | 80 |\n\n* **Color Space** [[Source Code]](https://github.com/ChenjieXu/selective_search/blob/master/selective_search/util.py#L23) \n Initial oversegmentation algorithm and our subsequent grouping algorithm are performed in this colour space.\n\n* **Similarity Measure** [[Source Code]](https://github.com/ChenjieXu/selective_search/blob/master/selective_search/measure.py#L101) \n 'CTSF' means the similarity measure is aggregate of color similarity, texture similarity, size similarity, and fill similarity.\n\n* **Starting Region** [[Source Code]](https://github.com/ChenjieXu/selective_search/blob/master/selective_search/util.py#L9) \n A parameter of initial grouping algorithm[[2]](#Felzenszwalb), which yields high quality starting locations efficiently. A larger k causes a preference for larger components of initial strating regions.\n\n### Random\n\nIf random set to True, function will carry out pseudo random sorting. It only alters sequences of bounding boxes, instead of locations, which prevents heavily emphasis on large regions as combing proposals from up to 80 different strategies[[1]](#Uijlings). This only has a significant impact when selecting a subset of region proposals with high rankings, as in RCNN.\n\n## References\n\n\\[1\\] [J. R. R. Uijlings et al., Selective Search for Object Recognition, IJCV, 2013](https://ivi.fnwi.uva.nl/isis/publications/bibtexbrowser.php?key=UijlingsIJCV2013&bib=all.bib) \n\\[2\\] [Felzenszwalb, P. F. et al., Efficient Graph-based Image Segmentation, IJCV, 2004](https://ivi.fnwi.uva.nl/isis/publications/bibtexbrowser.php?key=UijlingsIJCV2013&bib=all.bib) \n\\[3\\] [Segmentation as Selective Search for Object Recognition](https://www.koen.me/research/selectivesearch/)\n\n\n",
"description_content_type": "text/markdown",
"docs_url": null,
"download_url": "",
"downloads": {
"last_day": -1,
"last_month": -1,
"last_week": -1
},
"home_page": "https://github.com/ChenjieXu/selective_search",
"keywords": "rcnn",
"license": "MIT",
"maintainer": "",
"maintainer_email": "",
"name": "selective-search",
"package_url": "https://pypi.org/project/selective-search/",
"platform": "",
"project_url": "https://pypi.org/project/selective-search/",
"project_urls": {
"Homepage": "https://github.com/ChenjieXu/selective_search"
},
"release_url": "https://pypi.org/project/selective-search/0.1.1/",
"requires_dist": [
"numpy",
"scikit-image",
"scipy",
"joblib"
],
"requires_python": "",
"summary": "Selective Search in Python",
"version": "0.1.1"
},
"last_serial": 5964255,
"releases": {
"0.1.0a0": [
{
"comment_text": "",
"digests": {
"md5": "41efa707da83b70312a3ee367de1f7be",
"sha256": "b7f868332aa55b83773f081680831e2a88580cc8f4335dd2412711beac759ffa"
},
"downloads": -1,
"filename": "selective_search-0.1.0a0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "41efa707da83b70312a3ee367de1f7be",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8269,
"upload_time": "2019-10-10T15:44:08",
"url": "https://files.pythonhosted.org/packages/28/7b/fb1718dd6099a0568cbf9fd36f4c947b2c9fb62947d03c162984a43c0ac3/selective_search-0.1.0a0-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "a3d40fa70e86955304536883e2713421",
"sha256": "6bf2dee0975c90e3ff3d1c1f66081aa3ae2341f0d70aefe6db9a9564f2370e6f"
},
"downloads": -1,
"filename": "selective_search-0.1.0a0.tar.gz",
"has_sig": false,
"md5_digest": "a3d40fa70e86955304536883e2713421",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6869,
"upload_time": "2019-10-10T15:44:09",
"url": "https://files.pythonhosted.org/packages/25/6c/b7b3ceba63afe84db7f3db0ccdf3cd5dd1c563b9f20db4a17f647042a044/selective_search-0.1.0a0.tar.gz"
}
],
"0.1.1": [
{
"comment_text": "",
"digests": {
"md5": "d016d79bdf3d34e78152daa6ba22dd57",
"sha256": "2a1dfa2ff1cbbbc6b0f1694e49ea5dbd78c23b387e6a8e09d9a6cf60266b36e5"
},
"downloads": -1,
"filename": "selective_search-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d016d79bdf3d34e78152daa6ba22dd57",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8874,
"upload_time": "2019-10-12T13:19:51",
"url": "https://files.pythonhosted.org/packages/4c/c6/81f7ac1a4cb4d2a79aa1570303481ec3acaf784e60a5c093215c6bb1cdd4/selective_search-0.1.1-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "21d3fd18e7127e4d4648e555a9dab293",
"sha256": "f14ef3c99815bc5907deaf9613b42ebae951e793c1669a84a5952fc6b9f982cd"
},
"downloads": -1,
"filename": "selective_search-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "21d3fd18e7127e4d4648e555a9dab293",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7469,
"upload_time": "2019-10-12T13:19:53",
"url": "https://files.pythonhosted.org/packages/80/a1/b46739d897751a0665ac2490105333c3a3a84d08ad6ad94e766eb2d355fb/selective_search-0.1.1.tar.gz"
}
]
},
"urls": [
{
"comment_text": "",
"digests": {
"md5": "d016d79bdf3d34e78152daa6ba22dd57",
"sha256": "2a1dfa2ff1cbbbc6b0f1694e49ea5dbd78c23b387e6a8e09d9a6cf60266b36e5"
},
"downloads": -1,
"filename": "selective_search-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d016d79bdf3d34e78152daa6ba22dd57",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8874,
"upload_time": "2019-10-12T13:19:51",
"url": "https://files.pythonhosted.org/packages/4c/c6/81f7ac1a4cb4d2a79aa1570303481ec3acaf784e60a5c093215c6bb1cdd4/selective_search-0.1.1-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "21d3fd18e7127e4d4648e555a9dab293",
"sha256": "f14ef3c99815bc5907deaf9613b42ebae951e793c1669a84a5952fc6b9f982cd"
},
"downloads": -1,
"filename": "selective_search-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "21d3fd18e7127e4d4648e555a9dab293",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7469,
"upload_time": "2019-10-12T13:19:53",
"url": "https://files.pythonhosted.org/packages/80/a1/b46739d897751a0665ac2490105333c3a3a84d08ad6ad94e766eb2d355fb/selective_search-0.1.1.tar.gz"
}
]
}