{ "info": { "author": "Y.-Y. Yang, S.-C. Lee, Y.-A. Chung, T.-E. Wu, H.-T. Lin", "author_email": "b01902066@csie.ntu.edu.tw, b01902010@csie.ntu.edu.tw, b01902040@csie.ntu.edu.tw, r00942129@ntu.edu.tw, htlin@csie.ntu.edu.tw", "bugtrack_url": null, "classifiers": [ "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Scientific/Engineering", "Topic :: Scientific/Engineering :: Artificial Intelligence" ], "description": "# libact: Pool-based Active Learning in Python\n\nauthors: Yao-Yuan Yang, Shao-Chuan Lee, Yu-An Chung, Tung-En Wu, Si-An Chen, [Hsuan-Tien Lin](http://www.csie.ntu.edu.tw/~htlin)\n\n[![Build Status](https://travis-ci.org/ntucllab/libact.svg)](https://travis-ci.org/ntucllab/libact)\n[![Documentation Status](https://readthedocs.org/projects/libact/badge/?version=latest)](http://libact.readthedocs.org/en/latest/?badge=latest)\n[![PyPI version](https://badge.fury.io/py/libact.svg)](https://badge.fury.io/py/libact)\n[![codecov.io](https://codecov.io/github/ntucllab/libact/coverage.svg?branch=master)](https://codecov.io/github/ntucllab/libact?branch=master)\n\n# Introduction\n\n`libact` is a Python package designed to make active learning easier for\nreal-world users. The package not only implements several popular active learning strategies, but also features the [active-learning-by-learning](http://www.csie.ntu.edu.tw/~htlin/paper/doc/aaai15albl.pdf)\nmeta-algorithm that assists the users to automatically select the best strategy\non the fly. Furthermore, the package provides a unified interface for implementing more strategies, models and application-specific labelers. The package is open-source along with issue trackers on github, and can be easily installed from Python Package Index repository.\n\n# Documentation\n\nThe technical report associated with the package is on [arXiv](https://arxiv.org/abs/1710.00379), and the documentation for the latest release is available on [readthedocs](http://libact.readthedocs.org/en/latest/).\nComments and questions on the package is welcomed at `libact-users@googlegroups.com`. All contributions to the documentation are greatly appreciated!\n\n# Basic Dependencies\n\n* Python 2.7, 3.3, 3.4, 3.5, 3.6\n\n* Python dependencies\n```\npip install -r requirements.txt\n```\n\n* Debian (>= 7) / Ubuntu (>= 14.04)\n```\nsudo apt-get install build-essential gfortran libatlas-base-dev liblapacke-dev python3-dev\n```\n\n* Arch\n```\nsudo pacman -S lapacke\n```\n\n* macOS\n```\nbrew install openblas\n```\n\n# Installation\n\nAfter resolving the dependencies, you may install the package via pip (for all users):\n```\nsudo pip install libact\n```\n\nor pip install in home directory:\n```\npip install --user libact\n```\n\nor pip install from github repository for latest source:\n```\npip install git+https://github.com/ntucllab/libact.git\n```\n\nTo build and install from souce in your home directory:\n```\npython setup.py install --user\n```\n\nTo build and install from souce for all users on Unix/Linux:\n```\npython setup.py build\nsudo python setup.py install\n```\n\n## Installation Options\n\n- `LIBACT_BUILD_HINTSVM`: set this variable to 1 if you would like to build\n hintsvm c-extension. If set to 0, you will not be able to use the HintSVM\n query strategy. Default=1.\n- `LIBACT_BUILD_VARIANCE_REDUCTION`: set this variable to 1 if you would like to\n build variance reduction c-extension. If set to 0, you will not be able to use\n the VarianceReduction query strategy. Default=1.\n\nExample:\n```\nLIBACT_BUILD_HINTSVM=1 pip install git+https://github.com/ntucllab/libact.git\n```\n\n# Usage\n\nThe main usage of `libact` is as follows:\n\n```python\nqs = UncertaintySampling(trn_ds, method='lc') # query strategy instance\n\nask_id = qs.make_query() # let the specified query strategy suggest a data to query\nX, y = zip(*trn_ds.data)\nlb = lbr.label(X[ask_id]) # query the label of unlabeled data from labeler instance\ntrn_ds.update(ask_id, lb) # update the dataset with newly queried data\n```\n\nSome examples are available under the `examples` directory. Before running, use\n`examples/get_dataset.py` to retrieve the dataset used by the examples.\n\nAvailable examples:\n\n - [plot](examples/plot.py) : This example performs basic usage of libact. It splits\n a fully-labeled dataset and remove some label from dataset to simulate\n the pool-based active learning scenario. Each query of an unlabeled dataset is then equivalent to revealing one labeled example in the original data set.\n - [label_digits](examples/label_digits.py) : This example shows how to use libact in the case\n that you want a human to label the selected sample for your algorithm.\n - [albl_plot](examples/albl_plot.py): This example compares the performance of ALBL\n with other active learning algorithms.\n - [multilabel_plot](examples/multilabel_plot.py): This example compares the performance of\n algorithms under multilabel setting.\n - [alce_plot](examples/alce_plot.py): This example compares the performance of\n algorithms under cost-sensitive multi-class setting.\n\n# Running tests\n\nTo run the test suite:\n\n```\npython setup.py test\n```\n\nTo run pylint, install pylint through ```pip install pylint``` and run the following command in root directory:\n\n```\npylint libact\n```\n\nTo measure the test code coverage, install coverage through ```pip install coverage``` and run the following commands in root directory:\n\n```\ncoverage run --source libact --omit */tests/* setup.py test\ncoverage report\n```\n\n# Citing\nIf you find this package useful, please cite the original works (see Reference of each strategy) as well as the following\n\n```\n@techreport{YY2017,\n author = {Yao-Yuan Yang and Shao-Chuan Lee and Yu-An Chung and Tung-En Wu and Si-An Chen and Hsuan-Tien Lin},\n title = {libact: Pool-based Active Learning in Python},\n institution = {National Taiwan University},\n url = {https://github.com/ntucllab/libact},\n note = {available as arXiv preprint \\url{https://arxiv.org/abs/1710.00379}},\n month = oct,\n year = 2017\n}\n```\n\n\n# Acknowledgments\n\nThe authors thank Chih-Wei Chang and other members of the [Computational Learning Lab](https://learner.csie.ntu.edu.tw/) at National Taiwan University for valuable discussions and various contributions to making this package better.", "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/ntucllab/libact", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "libact", "package_url": "https://pypi.org/project/libact/", "platform": "", "project_url": "https://pypi.org/project/libact/", "project_urls": { "Homepage": "https://github.com/ntucllab/libact" }, "release_url": "https://pypi.org/project/libact/0.1.6/", "requires_dist": null, "requires_python": "", "summary": "Pool-based active learning in Python", "version": "0.1.6" }, "last_serial": 5837711, "releases": { "0.1": [], "0.1.1": [ { "comment_text": "", "digests": { "md5": "63b73b3049abacba0fc0b8cea09292e1", "sha256": "d30352bbfaaaec435bcf6486aec290813af8bc5defc973d511993ea473a6d447" }, "downloads": -1, "filename": "libact-0.1.1.tar.gz", "has_sig": false, "md5_digest": "63b73b3049abacba0fc0b8cea09292e1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 79036, "upload_time": "2016-03-06T11:08:35", "url": "https://files.pythonhosted.org/packages/71/28/5ef80e435f7e1b829fa5aa50d5ca81df09af11975314dcbf43a6ec1759a4/libact-0.1.1.tar.gz" } ], "0.1.1.post1": [ { "comment_text": "", "digests": { "md5": "7560394ea5c6c54f1156903d6d9de8ca", "sha256": "d9e2e768d243426cef57fdeb10f803d26e0b8588cc61da99e3ccf39f442915b2" }, "downloads": -1, "filename": "libact-0.1.1.post1.tar.gz", "has_sig": false, "md5_digest": "7560394ea5c6c54f1156903d6d9de8ca", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 79051, "upload_time": "2016-03-06T11:26:32", "url": "https://files.pythonhosted.org/packages/cf/71/7167d6590158281036451291ff04aadfe59f0e2ee12ae8a93f9322fa2c3b/libact-0.1.1.post1.tar.gz" } ], "0.1.1.post2": [ { "comment_text": "", "digests": { "md5": "d329ae5b94891c5228fa5a5b74a3779c", "sha256": "b08e00e7b069a517e799f4357495d91738c775b6aae343232ebdcfa3afc171d1" }, "downloads": -1, "filename": "libact-0.1.1.post2.tar.gz", "has_sig": false, "md5_digest": "d329ae5b94891c5228fa5a5b74a3779c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 79057, "upload_time": "2016-03-06T11:29:24", "url": "https://files.pythonhosted.org/packages/78/0b/4cfce9527d60ae2b53b7710e6b2c1b43a0bf433d0b51266cac6c2f29a246/libact-0.1.1.post2.tar.gz" } ], "0.1.1.post3": [ { "comment_text": "", "digests": { "md5": "53f82cf56976b29a061e28dbffcfdabe", "sha256": "bf233f997e84e77d8333b6d7df685220dd3229003e53649d1aef1f4360cffcd9" }, "downloads": -1, "filename": "libact-0.1.1.post3.tar.gz", "has_sig": false, "md5_digest": "53f82cf56976b29a061e28dbffcfdabe", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 79931, "upload_time": "2016-03-06T11:34:54", "url": "https://files.pythonhosted.org/packages/3e/bf/8f9b8ae546d3fc4b058c32d5f5a141aa95e896f33b61f8f8429d5008ded8/libact-0.1.1.post3.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "10749df02f8afaa6a1d04b5c961e4da2", "sha256": "62387379fc89708816a3acc4b46a347adb99c9d363adbab4fc415d2c5f6084e6" }, "downloads": -1, "filename": "libact-0.1.2.tar.gz", "has_sig": false, "md5_digest": "10749df02f8afaa6a1d04b5c961e4da2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 83715, "upload_time": "2016-05-05T10:46:37", "url": "https://files.pythonhosted.org/packages/de/f4/459463bbc0f562b5027c8cea319a43293c187614ba7c4b7028bcb4681abc/libact-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "6ce9f7f30848aaa9e52d2fe455745a96", "sha256": "7e4b63d5b23f2b89d6444141817a459b17e86691f6b31831f3e3575727aebec9" }, "downloads": -1, "filename": "libact-0.1.3.tar.gz", "has_sig": false, "md5_digest": "6ce9f7f30848aaa9e52d2fe455745a96", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 104520, "upload_time": "2017-05-17T09:53:26", "url": "https://files.pythonhosted.org/packages/16/eb/2f649f4115d75076b7d09d0db0d6eb2696509a7de0480e0d899ead0d3119/libact-0.1.3.tar.gz" } ], "0.1.3b0": [ { "comment_text": "", "digests": { "md5": "32be62f0b1e08cc4040bdef9836ef090", "sha256": "ba6117e2e0daf3c9170fb020a29002635f15a7760bf84e16c79fa4b34ecba087" }, "downloads": -1, "filename": "libact-0.1.3b0.tar.gz", "has_sig": false, "md5_digest": "32be62f0b1e08cc4040bdef9836ef090", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 101091, "upload_time": "2017-03-20T00:26:17", "url": "https://files.pythonhosted.org/packages/56/a2/11d7f8d80c2d4e5f0b64c1786ca072da7cb51703d59688a2cd908727b120/libact-0.1.3b0.tar.gz" } ], "0.1.3b1": [ { "comment_text": "", "digests": { "md5": "e3f13ae6e34e5a3599afec3e31295e6c", "sha256": "4bfdc3808507dd43265318d7601386bc790a12c6f3358d6bc966b0fd7e7cae99" }, "downloads": -1, "filename": "libact-0.1.3b1.tar.gz", "has_sig": false, "md5_digest": "e3f13ae6e34e5a3599afec3e31295e6c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 104439, "upload_time": "2017-04-08T02:42:28", "url": "https://files.pythonhosted.org/packages/97/f9/d62a6885c5dc8bca832ef4697fed106cf962a2d659f980f53c277e760daf/libact-0.1.3b1.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "0741c1f3b2f9a5f7332c485159d705fd", "sha256": "f1735cc5c006040fa83a59f218b952033a2a2e97bb0c2965a06cd83490ce7440" }, "downloads": -1, "filename": "libact-0.1.4.tar.gz", "has_sig": false, "md5_digest": "0741c1f3b2f9a5f7332c485159d705fd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 115404, "upload_time": "2019-06-21T04:22:05", "url": "https://files.pythonhosted.org/packages/9c/cd/3cbdacb569adfbfd4136b9707049f2ef56bf7612ab7c82f53561388c4a24/libact-0.1.4.tar.gz" } ], "0.1.4a0": [ { "comment_text": "", "digests": { "md5": "9cc83492ca0c068252175784882e95ef", "sha256": "bffbb51a6ae9239244ef197656c2b5fec810038a757879863894d5ea93c79c52" }, "downloads": -1, "filename": "libact-0.1.4a0.tar.gz", "has_sig": false, "md5_digest": "9cc83492ca0c068252175784882e95ef", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 104531, "upload_time": "2017-07-20T03:31:20", "url": "https://files.pythonhosted.org/packages/f8/65/b1b0658701c5d060079a9235595c9d30a4a3f56ee288d751921de07c25f5/libact-0.1.4a0.tar.gz" } ], "0.1.5": [ { "comment_text": "", "digests": { "md5": "5e5e24be3b64265844ec24b892f3c997", "sha256": "e78e98d7bc29159efddb4d685ecd8d67270f3d85dbcce6ecf004bfda9b91b2d1" }, "downloads": -1, "filename": "libact-0.1.5.tar.gz", "has_sig": false, "md5_digest": "5e5e24be3b64265844ec24b892f3c997", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 118504, "upload_time": "2019-09-16T18:25:05", "url": "https://files.pythonhosted.org/packages/95/ba/13182579ac2b4a58bdb1f6109821a9c929a8031b728f8217b294ffe74655/libact-0.1.5.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "3dffe962fdd61c942065179b8d9e3373", "sha256": "7cf02805d289985fc0d1006bf50d2ebf4dc45180fc6a6e855a3890fa7157a218" }, "downloads": -1, "filename": "libact-0.1.6.tar.gz", "has_sig": false, "md5_digest": "3dffe962fdd61c942065179b8d9e3373", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 118520, "upload_time": "2019-09-16T18:50:23", "url": "https://files.pythonhosted.org/packages/4b/8c/1f57cbe9e6b647afa14f8446c20caa2343fa26153be179e5a89060cd6ec2/libact-0.1.6.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "3dffe962fdd61c942065179b8d9e3373", "sha256": "7cf02805d289985fc0d1006bf50d2ebf4dc45180fc6a6e855a3890fa7157a218" }, "downloads": -1, "filename": "libact-0.1.6.tar.gz", "has_sig": false, "md5_digest": "3dffe962fdd61c942065179b8d9e3373", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 118520, "upload_time": "2019-09-16T18:50:23", "url": "https://files.pythonhosted.org/packages/4b/8c/1f57cbe9e6b647afa14f8446c20caa2343fa26153be179e5a89060cd6ec2/libact-0.1.6.tar.gz" } ] }