# CountEst
CountEst is a Python module containing the implementation of count-based estimators, i.e., supervised learning algorithms that make predictions based on the frequency or count of specific events, categories, or values within a dataset. These estimators operate under the assumption that the distribution of counts or frequencies provides valuable information for making predictions or inferences. The classifier is inspired by "Vastu Moolak Ganit" as described in a recent Indian philosophy [Madhyasth Darshan](https://madhyasth-darshan.info) by Late Shri A Nagraj.
Currently, we have implemented count-based classifier for categorical data. It operates by learning the distribution of category counts (i.e. the number of occurrences or frequency of each distinct category within a specific feature) within each class during the training phase. It then predicts class probabilities for unseen data based on the observed counts of categories within each feature, employing a voting mechanism to handle ties.
## Installation
The package can be installed using `pip`:
```
pip install CountEst
```
## Dependencies
The installation dependency requirements are:
- Python (>= 3.9)
- NumPy (>= 1.5)
- Pandas (>= 1.1.5)
- Scikit-Learn (>=0.20.0)
These dependencies are automatically installed using the pip commands above.
## Examples
Here we show an example using the CategoricalCBC (i.e. count-based classifier for categorical data):
```
from CountEst.classifiers import CategoricalCBC
import numpy as np
X = np.random.choice(range(0,10),(100,6))
y = np.random.choice([0, 1], size=100)
estimator = CategoricalCBC()
estimator.fit(X, y)
print(estimator.predict([3, 6, 7, 2, 3, 4]))
```
## Changelog
See the [changelog](https://github.com/sanskriti-02/CountEst/blob/master/CHANGELOG.md) for a history of notable changes to CountEst.
## Development
This project is currently in its early stages. We're actively building and shaping it, and we welcome contributions from everyone, regardless of experience level. If you're interested in getting involved, we encourage you to explore the project and see where you can contribute! For specific contribution guidelines, visit our [GitHub page](https://github.com/sanskriti-02/CountEst).
Raw data
{
"_id": null,
"home_page": null,
"name": "CountEst",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "supervised learning, machine learning, count-based classifier",
"author": "Sanskriti Singh, Alok Chauhan",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/5e/3d/e4d45b931e3a56acbbdc2745586009e86954dda94de74b5a51edff28ddd3/CountEst-0.1.3.tar.gz",
"platform": null,
"description": "# CountEst\n\nCountEst is a Python module containing the implementation of count-based estimators, i.e., supervised learning algorithms that make predictions based on the frequency or count of specific events, categories, or values within a dataset. These estimators operate under the assumption that the distribution of counts or frequencies provides valuable information for making predictions or inferences. The classifier is inspired by \"Vastu Moolak Ganit\" as described in a recent Indian philosophy [Madhyasth Darshan](https://madhyasth-darshan.info) by Late Shri A Nagraj.\n\nCurrently, we have implemented count-based classifier for categorical data. It operates by learning the distribution of category counts (i.e. the number of occurrences or frequency of each distinct category within a specific feature) within each class during the training phase. It then predicts class probabilities for unseen data based on the observed counts of categories within each feature, employing a voting mechanism to handle ties. \n\n## Installation\n\nThe package can be installed using `pip`:\n\n```\npip install CountEst\n```\n\n## Dependencies\n\nThe installation dependency requirements are:\n\n- Python (>= 3.9)\n- NumPy (>= 1.5)\n- Pandas (>= 1.1.5)\n- Scikit-Learn (>=0.20.0)\n\nThese dependencies are automatically installed using the pip commands above.\n\n## Examples\n\nHere we show an example using the CategoricalCBC (i.e. count-based classifier for categorical data):\n\n```\nfrom CountEst.classifiers import CategoricalCBC\nimport numpy as np\n\nX = np.random.choice(range(0,10),(100,6))\ny = np.random.choice([0, 1], size=100)\n\nestimator = CategoricalCBC()\nestimator.fit(X, y)\n\nprint(estimator.predict([3, 6, 7, 2, 3, 4]))\n```\n\n## Changelog\n\nSee the [changelog](https://github.com/sanskriti-02/CountEst/blob/master/CHANGELOG.md) for a history of notable changes to CountEst.\n\n## Development\n\nThis project is currently in its early stages. We're actively building and shaping it, and we welcome contributions from everyone, regardless of experience level. If you're interested in getting involved, we encourage you to explore the project and see where you can contribute! For specific contribution guidelines, visit our [GitHub page](https://github.com/sanskriti-02/CountEst). \n",
"bugtrack_url": null,
"license": null,
"summary": "CountEst is a module containing the implementation of count-based estimators, i.e., supervised learning algorithms that make predictions based on the frequency or count of specific events, categories, or values within a dataset.",
"version": "0.1.3",
"project_urls": {
"Homepage": "https://github.com/sanskriti-02/CountEst",
"Issues": "https://github.com/sanskriti-02/CountEst/issues"
},
"split_keywords": [
"supervised learning",
" machine learning",
" count-based classifier"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3f3bbefd1b81779948389aa48669420e24e53a237738f93e9ad88a1f179f8d2a",
"md5": "0417f56bb27172a02192107b7e252711",
"sha256": "032cf13673b1bea7e79efc8fa2be504a07ec9ae4d6585777d951ef31625d8606"
},
"downloads": -1,
"filename": "CountEst-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0417f56bb27172a02192107b7e252711",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6482,
"upload_time": "2024-03-23T10:47:42",
"upload_time_iso_8601": "2024-03-23T10:47:42.424647Z",
"url": "https://files.pythonhosted.org/packages/3f/3b/befd1b81779948389aa48669420e24e53a237738f93e9ad88a1f179f8d2a/CountEst-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5e3de4d45b931e3a56acbbdc2745586009e86954dda94de74b5a51edff28ddd3",
"md5": "86c0e7fff343e67f6d1b125587662554",
"sha256": "92292094f4d7629f68a67c2d53f99cfcd7420f4df07210f5ef6709051c10b81b"
},
"downloads": -1,
"filename": "CountEst-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "86c0e7fff343e67f6d1b125587662554",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 6002,
"upload_time": "2024-03-23T10:47:44",
"upload_time_iso_8601": "2024-03-23T10:47:44.415458Z",
"url": "https://files.pythonhosted.org/packages/5e/3d/e4d45b931e3a56acbbdc2745586009e86954dda94de74b5a51edff28ddd3/CountEst-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-23 10:47:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sanskriti-02",
"github_project": "CountEst",
"travis_ci": true,
"coveralls": true,
"github_actions": false,
"circle": true,
"appveyor": true,
"requirements": [],
"lcname": "countest"
}
JSON
