[](https://github.com/kymata-atlas/kymata-core/actions/workflows/perform-unit-tests.yml)
[](https://github.com/kymata-atlas/kymata-core/actions/workflows/lint-and-check-formatting.yml)
[](https://www.codefactor.io/repository/github/kymata-atlas/kymata-core)
<br />
<br />
<div>
<a href="https://github.com/kymata-atlas/kymata-core">
<img src="https://kymata.org/assets/img/toolbox_logo.png" alt="Logo" height="112" align="left">
</a>
<div>
<div>
<h3>Kymata Core</h3>
<p>Core codebase for the Kymata Atlas
<br>
<a href="https://kymata-atlas.github.io/kymata-core"><strong>Explore the docs »</strong></a>
</p>
</div>
</div>
</div>
<br>
<p align="center">
<a href="#About The Project">Overview</a>
·
<a href="#Getting Started">Setup</a>
·
<a href="#Citing the Codebase">Citing</a>
·
<a href="#Licence">Licence</a>
</p>
## About The Project
_Kymata Core_ is the central codebase underlying the [Kymata Atlas](https://kymata.org).[^1] It is maintained by the
[Kymata Research Group](https://kymata.org).
The central pipeline includes:
* Standard preprocessing and source localisation steps for neural sensor data (MEG, EEG, ECoG);
* Gridsearch approaches for function mapping;
* Information Processing Pathway Map[^2] generation (both offline generation and evaluation);
* Plotting functionality
The codebase is released under an MIT license to ensure the transparency of the results in the Kymata Atlas. While
comments and issues are welcomed, we are unable to prioritise installation or usage support (please see our code of
conduct).
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## Getting Started
This provides an overview of how to set Kymata Core locally.
### Prerequisites
* **Python**
Confirm you have the correct version of Python installed. Type
```sh
$ pyenv versions
```
This should confirm that python 3.11 or above is installed. If it isn't already there,
install it using `pyenv install`. You should be able to confirm
you are using the correct version using
```sh
$ python -V
```
* **Poetry**
This package uses [Poetry](https://python-poetry.org/) to manage packages. See [python-poetry.org](https://python-poetry.org/docs/#installing-with-the-official-installer) for installation instructions.
### Installation
1. Clone this repository:
```sh
$ git clone https://github.com/kymata-atlas/kymata-core.git
```
3. To install the python packages you will need to use Poetry. Assuming you have installed [Poetry](https://python-poetry.org/docs/#installing-with-the-official-installer),
type:
```sh
$ poetry install
```
to load the pakages needed.
4. At this point, you should be able to either run the xx from the terminal
```sh
$ poetry run invokers/run_gridsearch.py
```
or activate in this environment in an IDE such as PyCharm.
### Running tests, linting, and generating documentation
This will be done automatically via Github actions.
To run the tests manually, run:
```
$ poetry run pytest
```
To run linting manually, run:
```
$ poetry run ruff check
```
To serve the documentation locally, run:
```
$ poetry run mkdocs serve check
```
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- USAGE EXAMPLES -->
## Usage
Please refer to the [documentation](https://kymata-atlas.github.io/kymata-core), or see the `demos/` folder for example code, including test
data.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## Citing the codebase
Please use the following reference when citing the codebase or the `kymata` package:
> TBC
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- LICENSE -->
## Licence
Distributed under the MIT License. See `LICENSE` for more information.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- REFERENCES -->
## References
[^1]: Thwaites, Wieser, Soltan, Wingfield, Parish, Yang, Lakra, Woolgar, Zhang (2024) _The Kymata Atlas_ (In Prep.)
[^2]: Thwaites, Zhang and Woolgar (2024) _Information Processing Pathway Maps: A New Frontier in Cortical Processing_ (In Prep.)
Raw data
{
"_id": null,
"home_page": "https://kymata.org",
"name": "kymata",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>=3.11",
"maintainer_email": null,
"keywords": "neuroscience, neuroimaging",
"author": "Kymata Research Group",
"author_email": "acgt2@cam.ac.uk",
"download_url": "https://files.pythonhosted.org/packages/ef/85/5bb800f9bdca7c7f853ca6f3ca9a4a11fb77667aa3d5ecdd24c654860bec/kymata-1.0.2.tar.gz",
"platform": null,
"description": "[](https://github.com/kymata-atlas/kymata-core/actions/workflows/perform-unit-tests.yml)\n[](https://github.com/kymata-atlas/kymata-core/actions/workflows/lint-and-check-formatting.yml)\n[](https://www.codefactor.io/repository/github/kymata-atlas/kymata-core)\n<br />\n<br />\n<div>\n <a href=\"https://github.com/kymata-atlas/kymata-core\">\n <img src=\"https://kymata.org/assets/img/toolbox_logo.png\" alt=\"Logo\" height=\"112\" align=\"left\">\n </a>\n <div>\n <div>\n <h3>Kymata Core</h3>\n <p>Core codebase for the Kymata Atlas\n <br>\n <a href=\"https://kymata-atlas.github.io/kymata-core\"><strong>Explore the docs \u00bb</strong></a>\n </p>\n </div>\n </div>\n\n</div>\n<br>\n<p align=\"center\">\n <a href=\"#About The Project\">Overview</a>\n \u00b7\n <a href=\"#Getting Started\">Setup</a>\n \u00b7\n <a href=\"#Citing the Codebase\">Citing</a>\n \u00b7\n <a href=\"#Licence\">Licence</a>\n</p>\n\n## About The Project\n\n_Kymata Core_ is the central codebase underlying the [Kymata Atlas](https://kymata.org).[^1] It is maintained by the\n[Kymata Research Group](https://kymata.org).\n\nThe central pipeline includes:\n* Standard preprocessing and source localisation steps for neural sensor data (MEG, EEG, ECoG);\n* Gridsearch approaches for function mapping;\n* Information Processing Pathway Map[^2] generation (both offline generation and evaluation);\n* Plotting functionality\n\nThe codebase is released under an MIT license to ensure the transparency of the results in the Kymata Atlas. While\ncomments and issues are welcomed, we are unable to prioritise installation or usage support (please see our code of\nconduct).\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Getting Started\n\nThis provides an overview of how to set Kymata Core locally.\n\n### Prerequisites\n\n* **Python**\n\n Confirm you have the correct version of Python installed. Type\n ```sh\n $ pyenv versions\n ```\n This should confirm that python 3.11 or above is installed. If it isn't already there,\n install it using `pyenv install`. You should be able to confirm\n you are using the correct version using\n ```sh\n $ python -V\n ```\n* **Poetry**\n\n This package uses [Poetry](https://python-poetry.org/) to manage packages. See [python-poetry.org](https://python-poetry.org/docs/#installing-with-the-official-installer) for installation instructions.\n\n### Installation\n\n1. Clone this repository:\n ```sh\n $ git clone https://github.com/kymata-atlas/kymata-core.git\n ```\n3. To install the python packages you will need to use Poetry. Assuming you have installed [Poetry](https://python-poetry.org/docs/#installing-with-the-official-installer), \n type:\n ```sh\n $ poetry install\n ```\n to load the pakages needed.\n\n4. At this point, you should be able to either run the xx from the terminal\n ```sh\n $ poetry run invokers/run_gridsearch.py\n ```\n or activate in this environment in an IDE such as PyCharm.\n\n### Running tests, linting, and generating documentation\n\nThis will be done automatically via Github actions.\n\nTo run the tests manually, run:\n```\n$ poetry run pytest\n```\nTo run linting manually, run:\n```\n$ poetry run ruff check\n```\nTo serve the documentation locally, run:\n```\n$ poetry run mkdocs serve check\n```\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n<!-- USAGE EXAMPLES -->\n## Usage\n\nPlease refer to the [documentation](https://kymata-atlas.github.io/kymata-core), or see the `demos/` folder for example code, including test\ndata.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Citing the codebase\n\nPlease use the following reference when citing the codebase or the `kymata` package: \n\n> TBC\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n<!-- LICENSE -->\n## Licence\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n\n<!-- REFERENCES -->\n## References\n\n[^1]: Thwaites, Wieser, Soltan, Wingfield, Parish, Yang, Lakra, Woolgar, Zhang (2024) _The Kymata Atlas_ (In Prep.)\n[^2]: Thwaites, Zhang and Woolgar (2024) _Information Processing Pathway Maps: A New Frontier in Cortical Processing_ (In Prep.)\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Core Kymata codebase, including statistical analysis and plotting tools",
"version": "1.0.2",
"project_urls": {
"Documentation": "https://kymata-atlas.github.io/kymata-core/",
"Homepage": "https://kymata.org",
"Repository": "https://github.com/kymata-atlas/kymata-core"
},
"split_keywords": [
"neuroscience",
" neuroimaging"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "adc1e8406b17db24cb56518d3f195fca1e67c3b2c9fee84ad00fe3b7de5f61e0",
"md5": "555f46cc786f9e1ebbdd58b7e55b07b0",
"sha256": "7a9d32999f3a6191fc27e5efa73759be0674512bde7a194c4b4deef841872d6f"
},
"downloads": -1,
"filename": "kymata-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "555f46cc786f9e1ebbdd58b7e55b07b0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.11",
"size": 160813,
"upload_time": "2024-10-25T10:01:03",
"upload_time_iso_8601": "2024-10-25T10:01:03.537076Z",
"url": "https://files.pythonhosted.org/packages/ad/c1/e8406b17db24cb56518d3f195fca1e67c3b2c9fee84ad00fe3b7de5f61e0/kymata-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ef855bb800f9bdca7c7f853ca6f3ca9a4a11fb77667aa3d5ecdd24c654860bec",
"md5": "bd83acd94f4afd113a50dc9a863e0998",
"sha256": "a0c7f766b5c6acb615157bfba78595f8faca42c4231c1d4ee86168057959f59c"
},
"downloads": -1,
"filename": "kymata-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "bd83acd94f4afd113a50dc9a863e0998",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.11",
"size": 145037,
"upload_time": "2024-10-25T10:01:04",
"upload_time_iso_8601": "2024-10-25T10:01:04.649511Z",
"url": "https://files.pythonhosted.org/packages/ef/85/5bb800f9bdca7c7f853ca6f3ca9a4a11fb77667aa3d5ecdd24c654860bec/kymata-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-25 10:01:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kymata-atlas",
"github_project": "kymata-core",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "kymata"
}
JSON
