# SAMBA - Sampling Algorithms with Matrix-Based Weight Allocation
SAMBA is a Python package providing sampling methods via matrix-based distance measures to mitigate autocorrelation.
## Installation and Usage
The package can be installed via pip:
```bash
$ pip install samba_sampler
```
Detailed information on the usage of the package can be found in the [documentation](https://samba.readthedocs.io/en/latest/).
For a quick start, the following example shows how to use the package:
```python
import samba_sampler as samba
sampler = samba.LanguageSampler() # Default parameters
print(sampler.sample(5))
```
## Changelog
Version 0.3 (2023-07-13)
- Initial release, following on the `arcaverborum` project.
## Community Guidelines
While the author can be contacted directly for support, it is recommended that third parties use GitHub standard features, such as issues and pull requests, to contribute, report problems, or seek support.
Contributing guidelines, including a code of conduct, can be found in the CONTRIBUTING.md file.
## Author, Citation, and Acknowledgements
The library is developed by Tiago Tresoldi (tiago@tresoldi.org).
The library is developed in the context of the Cultural Evolution of Texts project, with funding from the Riksbankens Jubileumsfond (grant agreement ID: MXM19-1087:1).
If you use `samba_sampler`, please cite it as:
> Tresoldi, Tiago (2023). SAMBA (Sampling Algorithms with Matrix-Based Weight Allocation): a Python package providing sampling methods via matrix-based distance measures to mitigate autocorrelation. Version 0.3. Uppsala: Uppsala University.
In BibTeX:
```bibtex
@misc{Tresoldi2023samba,
author = {Tresoldi, Tiago},
title = {SAMBA (Sampling Algorithms with Matrix-Based Weight Allocation): a Python package providing sampling methods via matrix-based distance measures to mitigate autocorrelation. Version 0.3.},
howpublished = {\url{https://github.com/tresoldi/samba_sampler}},
address = {Uppsala},
published = {Upssala University},
year = {2023}
}
```
Raw data
{
"_id": null,
"home_page": "https://github.com/tresoldi/samba_sampler",
"name": "samba-sampler",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "sampling algorithm,language sampling,weighted sampling,phylogenetic autocorrelation,areal autocorrelation,linguistics,typology",
"author": "Tiago Tresoldi",
"author_email": "tiago@tresoldi.org",
"download_url": "https://files.pythonhosted.org/packages/11/47/333c64d52907e1b1c6dc9be778e606524a7f10156a6c2a749b1ec07bf91b/samba_sampler-0.3.tar.gz",
"platform": null,
"description": "# SAMBA - Sampling Algorithms with Matrix-Based Weight Allocation\r\n\r\nSAMBA is a Python package providing sampling methods via matrix-based distance measures to mitigate autocorrelation.\r\n\r\n## Installation and Usage\r\n\r\nThe package can be installed via pip:\r\n\r\n```bash\r\n$ pip install samba_sampler\r\n```\r\n\r\nDetailed information on the usage of the package can be found in the [documentation](https://samba.readthedocs.io/en/latest/).\r\nFor a quick start, the following example shows how to use the package:\r\n\r\n```python\r\nimport samba_sampler as samba\r\nsampler = samba.LanguageSampler() # Default parameters\r\nprint(sampler.sample(5))\r\n```\r\n\r\n## Changelog\r\n\r\nVersion 0.3 (2023-07-13)\r\n - Initial release, following on the `arcaverborum` project.\r\n\r\n## Community Guidelines\r\n\r\nWhile the author can be contacted directly for support, it is recommended that third parties use GitHub standard features, such as issues and pull requests, to contribute, report problems, or seek support.\r\n\r\nContributing guidelines, including a code of conduct, can be found in the CONTRIBUTING.md file.\r\n\r\n## Author, Citation, and Acknowledgements\r\n\r\nThe library is developed by Tiago Tresoldi (tiago@tresoldi.org).\r\n\r\nThe library is developed in the context of the Cultural Evolution of Texts project, with funding from the Riksbankens Jubileumsfond (grant agreement ID: MXM19-1087:1).\r\n\r\nIf you use `samba_sampler`, please cite it as:\r\n\r\n> Tresoldi, Tiago (2023). SAMBA (Sampling Algorithms with Matrix-Based Weight Allocation): a Python package providing sampling methods via matrix-based distance measures to mitigate autocorrelation. Version 0.3. Uppsala: Uppsala University.\r\n\r\nIn BibTeX:\r\n\r\n```bibtex\r\n@misc{Tresoldi2023samba,\r\n author = {Tresoldi, Tiago},\r\n title = {SAMBA (Sampling Algorithms with Matrix-Based Weight Allocation): a Python package providing sampling methods via matrix-based distance measures to mitigate autocorrelation. Version 0.3.},\r\n howpublished = {\\url{https://github.com/tresoldi/samba_sampler}},\r\n address = {Uppsala},\r\n published = {Upssala University},\r\n year = {2023}\r\n}\r\n```\r\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "A Python package providing sampling methods via matrix-based distance measures to mitigate autocorrelation",
"version": "0.3",
"project_urls": {
"Documentation": "https://samba_sampler.readthedocs.io",
"Homepage": "https://github.com/tresoldi/samba_sampler"
},
"split_keywords": [
"sampling algorithm",
"language sampling",
"weighted sampling",
"phylogenetic autocorrelation",
"areal autocorrelation",
"linguistics",
"typology"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ba7e98e3e08681f05c074654180add26cd413553e7662fe3af1293aa1f15284b",
"md5": "b6277edb744888418dc296da36806f7e",
"sha256": "4f7bf31c0ad70a9e26bab7c6abcabc0c8c826687f68fa51a567a440f47066368"
},
"downloads": -1,
"filename": "samba_sampler-0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b6277edb744888418dc296da36806f7e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 79630517,
"upload_time": "2023-07-13T08:15:30",
"upload_time_iso_8601": "2023-07-13T08:15:30.622252Z",
"url": "https://files.pythonhosted.org/packages/ba/7e/98e3e08681f05c074654180add26cd413553e7662fe3af1293aa1f15284b/samba_sampler-0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1147333c64d52907e1b1c6dc9be778e606524a7f10156a6c2a749b1ec07bf91b",
"md5": "36e003caf0ccaffcd8ab05d431b73ca9",
"sha256": "1987053b81be290f0fe8a989eec29361989a8960bc55ddb0ce54a47fe21ec8d8"
},
"downloads": -1,
"filename": "samba_sampler-0.3.tar.gz",
"has_sig": false,
"md5_digest": "36e003caf0ccaffcd8ab05d431b73ca9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 79625698,
"upload_time": "2023-07-13T08:15:50",
"upload_time_iso_8601": "2023-07-13T08:15:50.923108Z",
"url": "https://files.pythonhosted.org/packages/11/47/333c64d52907e1b1c6dc9be778e606524a7f10156a6c2a749b1ec07bf91b/samba_sampler-0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-13 08:15:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tresoldi",
"github_project": "samba_sampler",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "samba-sampler"
}
JSON
