| Name | krank JSON |
| Version |
0.0.1.dev3
JSON |
| download |
| home_page | None |
| Summary | Fetch psychology datasets from remote sources. |
| upload_time | 2024-06-02 18:49:55 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | None |
| keywords |
data
datasets
text
liwc
meta-analysis
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
=====
Krank
=====
Fetch psychology datasets from remote sources.
**Krank** is a single-stop for using publicly available remote datasets. It offers simplified downloading, storing, version controlling, loading into Python, minimal/corrective pre-processing, and in some cases, data harmonization of various datasets. This project has a huge dependency on the `Pooch <https://www.fatiando.org/pooch` Python package, which makes retrieving and storing any remote file incredibly easy.
.. warning:: This project is in the planning stage of development. Don't use it.
**Krank** currently has a limited set of modules that are each dedicated to a specific type of dataset. The topical focus of these datasets is probably *psychology* or *cognitive neuroscience*. The datasets are grouped into separate modules for organizational purposes, where each module focuses on a specific type of dataset. Each module functions almost identically, and the separation of fetching functions into these separate modules is primarily for organizational purposes.
Currently implemented modules include:
* ``tables``: Fetch tables that were manually extracted from journal publications.
* ``lexicons``: Fetch lexicons that contain vocabularies with associated numerical scores.
* ``liwc``: Fetch previously published or shared LIWC scores/output.
Usage
-----
Fetch (i.e., download) the `threat` LIWC dictionary, described in `Choi et al., 2022, PNAS <https://doi.org/10.1073/pnas.2113891119>`_ and shared publicly via `Michele Gelfand's personal website <https://www.michelegelfand.com/threat-dictionary>`_.
.. code-block:: python
from krank import lexicons
df = lexicons.fetch_threat()
An identical way to fetch the same file is through krank's top-level interface, which offers a more general way to retrieve datasets and might be more convenient for looping over a large number of datasets to load them systematically.
.. code-block:: python
import krank
df = krank.fetch_lexicon("threat")
Installation
------------
.. code-block:: shell
pip install krank
Contributing
------------
Currently, Krank is developed mostly for my own personal desires for more convenient data access, more convenient data storage, a better ability to see a high-level view of all the datasets available for my projects, and better version-control over the public datasets I use and create. Making a Python package with documentation to view the datasets seemed like the best way to do this.
That being said, if anyone else finds it useful and wants to contribute, please do. Feel free to post questions, bugs, feature requests, new dataset proposals, or even new module proposals on the `Krank GitHub Issues page <https://github.com/remrama/krank/issues>`_.
Raw data
{
"_id": null,
"home_page": null,
"name": "krank",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Remington Mallett <mallett.remy@gmail.com>",
"keywords": "data, datasets, text, LIWC, meta-analysis",
"author": null,
"author_email": "Remington Mallett <mallett.remy@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/be/2a/96d3bdcb2b062ee423cb5728908e2f49d0c1309b8db49c5777ddf4d55c37/krank-0.0.1.dev3.tar.gz",
"platform": null,
"description": "=====\r\nKrank\r\n=====\r\n\r\n\r\nFetch psychology datasets from remote sources.\r\n\r\n**Krank** is a single-stop for using publicly available remote datasets. It offers simplified downloading, storing, version controlling, loading into Python, minimal/corrective pre-processing, and in some cases, data harmonization of various datasets. This project has a huge dependency on the `Pooch <https://www.fatiando.org/pooch` Python package, which makes retrieving and storing any remote file incredibly easy.\r\n\r\n\r\n.. warning:: This project is in the planning stage of development. Don't use it.\r\n\r\n\r\n**Krank** currently has a limited set of modules that are each dedicated to a specific type of dataset. The topical focus of these datasets is probably *psychology* or *cognitive neuroscience*. The datasets are grouped into separate modules for organizational purposes, where each module focuses on a specific type of dataset. Each module functions almost identically, and the separation of fetching functions into these separate modules is primarily for organizational purposes.\r\n\r\nCurrently implemented modules include:\r\n\r\n* ``tables``: Fetch tables that were manually extracted from journal publications.\r\n* ``lexicons``: Fetch lexicons that contain vocabularies with associated numerical scores.\r\n* ``liwc``: Fetch previously published or shared LIWC scores/output.\r\n\r\n\r\nUsage\r\n-----\r\n\r\nFetch (i.e., download) the `threat` LIWC dictionary, described in `Choi et al., 2022, PNAS <https://doi.org/10.1073/pnas.2113891119>`_ and shared publicly via `Michele Gelfand's personal website <https://www.michelegelfand.com/threat-dictionary>`_.\r\n\r\n.. code-block:: python\r\n\r\n from krank import lexicons\r\n\r\n df = lexicons.fetch_threat()\r\n\r\n\r\nAn identical way to fetch the same file is through krank's top-level interface, which offers a more general way to retrieve datasets and might be more convenient for looping over a large number of datasets to load them systematically.\r\n\r\n.. code-block:: python\r\n\r\n import krank\r\n\r\n df = krank.fetch_lexicon(\"threat\")\r\n\r\n\r\nInstallation\r\n------------\r\n\r\n.. code-block:: shell\r\n\r\n pip install krank\r\n\r\n\r\nContributing\r\n------------\r\n\r\nCurrently, Krank is developed mostly for my own personal desires for more convenient data access, more convenient data storage, a better ability to see a high-level view of all the datasets available for my projects, and better version-control over the public datasets I use and create. Making a Python package with documentation to view the datasets seemed like the best way to do this.\r\n\r\nThat being said, if anyone else finds it useful and wants to contribute, please do. Feel free to post questions, bugs, feature requests, new dataset proposals, or even new module proposals on the `Krank GitHub Issues page <https://github.com/remrama/krank/issues>`_.\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Fetch psychology datasets from remote sources.",
"version": "0.0.1.dev3",
"project_urls": {
"Homepage": "https://github.com/remrama/krank"
},
"split_keywords": [
"data",
" datasets",
" text",
" liwc",
" meta-analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0fa8394447ffdd72fce7aad1098a496684d9c4c58fd2f123e90b4456eb1458e2",
"md5": "0a4579af4fb3eca63b0907ed3df4003d",
"sha256": "a3d7e1926483c47873df60a8f82b8ded220a0e16f158eedcf1d36eca2aea71da"
},
"downloads": -1,
"filename": "krank-0.0.1.dev3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0a4579af4fb3eca63b0907ed3df4003d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 17885,
"upload_time": "2024-06-02T18:49:53",
"upload_time_iso_8601": "2024-06-02T18:49:53.638824Z",
"url": "https://files.pythonhosted.org/packages/0f/a8/394447ffdd72fce7aad1098a496684d9c4c58fd2f123e90b4456eb1458e2/krank-0.0.1.dev3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "be2a96d3bdcb2b062ee423cb5728908e2f49d0c1309b8db49c5777ddf4d55c37",
"md5": "119d758fcee66aab4f569b9a9dfd8e68",
"sha256": "41ef7787c6bc63f11510a7b744e1ddec51c4fa8e72fe47f16a1a5cfce4032056"
},
"downloads": -1,
"filename": "krank-0.0.1.dev3.tar.gz",
"has_sig": false,
"md5_digest": "119d758fcee66aab4f569b9a9dfd8e68",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 19877,
"upload_time": "2024-06-02T18:49:55",
"upload_time_iso_8601": "2024-06-02T18:49:55.311112Z",
"url": "https://files.pythonhosted.org/packages/be/2a/96d3bdcb2b062ee423cb5728908e2f49d0c1309b8db49c5777ddf4d55c37/krank-0.0.1.dev3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-02 18:49:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "remrama",
"github_project": "krank",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "krank"
}
