| Name | NeuralPlayground JSON |
| Version |
0.0.7
JSON |
| download |
| home_page | |
| Summary | The standardised environment for the hippocampus and entorhinal cortex models |
| upload_time | 2023-08-22 10:18:38 |
| maintainer | |
| docs_url | None |
| author | Clementine Domine |
| requires_python | >=3.8.0 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://opensource.org/licenses/MIT)
[](https://codecov.io/gh/SainsburyWellcomeCentre/NeuralPlayground)
[](https://github.com/charliermarsh/ruff)
[](https://github.com/python/black)
[](https://github.com/pre-commit/pre-commit)
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
[](#contributors)
<!-- ALL-CONTRIBUTORS-BADGE:END -->
# NeuralPlayground
## *A standardised environment for the hippocampus and entorhinal cortex models.* <a href="https://githubtocolab.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/colab_example.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
<img src="images/NPG_GH-social-preview_white-bg.jpg" alt="NeuralPlayground Logo" width="500"/>
<!-- TOC -->
- [Introduction](#introduction)
- [Installation](#installation)
- [Create a conda environment](#create-a-conda-environment)
- [Pip install](#pip-install)
- [Install for development](#install-for-development)
- [Usage](#usage)
- [Agent Arena interaction](#agent-arena-interaction)
- [Simulation Manager](#simulation-manager)
- [I want to contribute](#i-want-to-contribute)
- [Cite](#cite)
- [License](#license)
- [Contributors](#contributors)
<!-- /TOC -->
## Introduction
The abstract representation of space has been extensively studied in the hippocampus and entorhinal cortex.
A growing variety of theoretical models have been proposed
to capture the rich neural and behavioral phenomena associated with these circuits. However, objective comparison
of these theories against each other and against empirical data is challenging.
Although the significance of virtuous interaction between experiments and theory is widely recognized, the tools
available to facilitate comparison are limited. Some important challenge we aim to solve are:
1. Lack availability and accessibility of data in a standardized, labeled format.
2. Standard and easy ways to compare model output with empirical data.
3. A repository of models and data sets that are relevant for the field of hippocampus and entorhinal cortex.
To address this gap, we present an open-source standardised software framework - NeuralPlayground - to enable
comparison between the hippocampus and entorhinal cortex models. This Python software package offers a reproducible
way to compare models against a centralised library of published experimental results, including neural recordings
and animal behavior. The framework currently contains implementations of three Agents, as well as three Experiments
providing simple interfaces to publicly available neural and behavioral data. It also contains a customizable
2-dimensional Arena (continuous and discrete) able to produce common experimental environments in which the agents can
move in and interact with. Each module can also be used separately, allowing flexible access to influential
models and data sets.
We currently rely on visual comparison of a hand-selected number of outputs of the model with neural recordings as
shown in [github.com/NeuralPlayground/examples/comparison](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/comparisons_examples/comparison_from_manager.ipynb).
In the future, a set of quantitative and
qualitative measures will be added for systematic comparisons across Agents, Arenas, and Experiments.
We want to restate that this won't constitute a definitive judgment on the ability of an Agent to replicate the brain
mechanism. Instead, this allows an objective and complete comparison to the current evidence in the field, as is
typically done in publications, which can be used to guide model design and development.
Altogether, we hope our framework, offers
a foundation that the community will build upon, working toward a shared, standardized, open, and
reproducible computational understanding of the hippocampus and entorhinal cortex.
Try our short tutorial online in Colab. <a href="https://githubtocolab.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/colab_example.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
## Installation
### Create a conda environment
We advise you to install the package in a virtual environment,
to avoid conflicts with other packages. For example, using `conda`:
```python
conda create --name NPG-env python=3.10
conda activate NPG-env
conda install pip
```
### Pip install
You can use `pip` get the latest release of NeuralPlayground from PyPI.
```python
# install the latest release
pip install NeuralPlayground
# upgrade to the latest release
pip install -U NeuralPlayground
# install a particular release
pip install NeuralPlayground==0.0.5
```
> **Note**
>
> If you wish to run our implementation of the Tolman-Eichenbaum machine, there are additional dependencies to install. These can be found in the [TEM_README.md](examples/agent_examples/TEM_README.md) file.
### Install for development
If you want to contribute to the project, get the latest development version
from GitHub, and install it in editable mode, including the "dev" dependencies:
```bash
git clone https://github.com/SainsburyWellcomeCentre/NeuralPlayground/ --single-branch
cd NeuralPlayground
pip install -e .[dev]
```
> **Note**
>
> if you are using the `zsh` shell (default on macOS), replace the last command with:
> ```bash
> pip install -e '.[dev]'
> ```
## Usage
Try our package! We are gathering opinions to focus our efforts on improving aspects of the code or adding new features,
so if you tell us what you would like to have, we might just implement it 😊.
This open-source software was built to be collaborative and lasting. We hope that the framework will be simple
enough to be adopted by a great number of neuroscientists, eventually guiding the path to the computational
understanding of the HEC mechanisms. We follow reproducible, inclusive, and collaborative project design guidelines.
All relevant documents can be found in [Documents](https://github.com/ClementineDomine/NeuralPlayground/blob/main/documents/).
### Agent Arena interaction
You can pick an Agent, an Arena of your choice to run a simulation.
arenas and simulations have a simple interface to interact with each other as in [OpenAI gymnasium](https://gymnasium.farama.org/).
```python
# import an agent based on a plasticity model of grid cells
from neuralplayground.agents import Weber2018
# import a square 2D arena
from neuralplayground.arenas import Simple2D
# Initialise the agent
agent = Weber2018()
# Initialise the arena
arena = Simple2D()
```
To make the agent interact with the arena, a very simple loop can be the following:
```python
iterations = 1000
obs, state = arena.reset()
for j in range(iterations):
# Observe to choose an action
action = agent.act(obs)
# Run environment for given action
obs, state, reward = arena.step(action)
# Update agent parameters
update_output = agent.update()
```
This process is the base of our package. We provide a more detailed example in <a href="https://githubtocolab.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/colab_example.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>.
Also, specific examples of how to use each module can be found in [agent](https://github.com/ClementineDomine/NeuralPlayground/tree/main/examples/agent_examples),
[arena](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/arena_examples/arena_examples.ipynb)
and [experiment](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/experimental_examples/experimental_data_examples.ipynb) jupyter notebooks.
> **Note**
>
> Check our Tolman-Eichenbaum Machine Implementation in
[this branch](https://github.com/ClementineDomine/NeuralPlayground/tree/whittington_2020) (work in progress), you will also need to install [pytorch](https://pytorch.org/) ro run it.</strong>
### Simulation Manager
We provide some backend tools to run simulations and compare the results with experimental data in the background,
including some methods to keep track of your runs, and a comparison board to visualise the results. You can check
the details in [Simulation Manager](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/comparisons_examples/simulation_manager.ipynb)
and [Comparison Board](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/comparisons_examples/comparison_from_manager.ipynb) jupyters. In addition,
we have some [default simulations](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/neuralplayground/backend/default_simulation.py)
you can try out, for which you don't need to write much code, since they are
implemented using a [SingleSim](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/55085e792f5dc446e0c3a808cd0d9901a37484a8/neuralplayground/backend/simulation_manager.py#L211)
class. For example
```python
# Import default simulation, which is a SingleSim
from neuralplayground.backend.default_simulation import stachenfeld_in_2d
from neuralplayground.backend.default_simulation import weber_in_2d
stachenfeld_in_2d.run_sim(save_path="my_results")
```
This class allows you to run a simulation with a single line of code, and it will automatically save the results in a
folder with the name you provide, keeping track of any errors and logs. You can also use our
[Simulation Manager](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/comparisons_examples/simulation_manager.ipynb)
to run multiple simulations at once, save the results, keep run of each run and possible errors for easy debugging, and other functions.
```python
# Import Simulation Manager
from neuralplayground.backend import SimulationManager
# Initialise simulation manager
my_sims = [weber_in_2d, stachenfeld_in_2d]
my_manager = SimulationManager(simulation_list = my_sims,
runs_per_sim = 5, # Run 5 instances per simulation
manager_id = "example_simulation",
verbose = True)
my_manager.generate_sim_paths()
my_manager.run_all()
my_manager.check_run_status()
```
To compare the results, use the comparison board described in [Comparison Board](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/comparisons_examples/comparison_from_manager.ipynb) jupyter
notebook. With time, we will build an interface for easy model comparison and visualisation of the results!
<img src="images/board_diagram.jpeg" alt="NeuralPlayground Logo" width="500"/>
## I want to contribute
There are many ways to contribute to our project.
1. Implement a hippocampal and entorhinal cortex [Agent](https://github.com/ClementineDomine/NeuralPlayground/tree/main/neuralplayground/agents) of your choice.
2. Work on improving the [Arena](https://github.com/ClementineDomine/NeuralPlayground/tree/main/neuralplayground/arenas).
3. Add an [Experimental](https://github.com/ClementineDomine/NeuralPlayground/tree/main/neuralplayground/experiments) data set.
4. Implementing [metrics](https://github.com/ClementineDomine/NeuralPlayground/tree/main/neuralplayground/comparison/metrics.py) to compare the output of the Agent with the experimental data.
5. Refactor the code to improve the readability and efficiency.
All contributions should be submitted through a pull request and will be reviewed by the maintainers.
Before sending a pull request, make sure you have the done following:
1. Checked the Licensing frameworks.
2. Used the [right development environment](#install-for-development). Make sure to initialise the pre-commit hooks with ```pre-commit install``` and run ```pre-commit run -a``` to format the code and check for errors.
3. Followed the [PEP8](https://www.python.org/dev/peps/pep-0008/) and [numpy docstring](https://numpydoc.readthedocs.io/en/latest/format.html) style convention. More details found in [Style Guide](https://github.com/ClementineDomine/NeuralPlayground/tree/main/documents/style_guide.md).
4. Implemented and ran [tests](https://github.com/ClementineDomine/NeuralPlayground/tree/main/neuralplayground/tests).
5. Comment your work.
**All contributions to the repository are acknowledged through the all-contributors bot.**
Refer to the README.md files found in each of the modules for further details on how to contribute to them.
## Cite
See [Citation](https://github.com/ClementineDomine/NeuralPlayground/blob/main/documents/citation.cff) for the correct citation of this framework.
## License
⚖️ [MIT](./LICENSE)
## Contributors
Thanks go to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tbody>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/ClementineDomine"><img src="https://avatars.githubusercontent.com/u/18595111?v=4?s=100" width="100px;" alt="Clementine Domine"/><br /><sub><b>Clementine Domine</b></sub></a><br /><a href="#design-ClementineDomine" title="Design">🎨</a> <a href="#mentoring-ClementineDomine" title="Mentoring">🧑🏫</a> <a href="https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=ClementineDomine" title="Code">💻</a> <a href="#data-ClementineDomine" title="Data">🔣</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/rodrigcd"><img src="https://avatars.githubusercontent.com/u/22643681?v=4?s=100" width="100px;" alt="rodrigcd"/><br /><sub><b>rodrigcd</b></sub></a><br /><a href="#design-rodrigcd" title="Design">🎨</a> <a href="#mentoring-rodrigcd" title="Mentoring">🧑🏫</a> <a href="https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=rodrigcd" title="Code">💻</a> <a href="#data-rodrigcd" title="Data">🔣</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/LukeHollingsworth"><img src="https://avatars.githubusercontent.com/u/93782020?v=4?s=100" width="100px;" alt="Luke Hollingsworth"/><br /><sub><b>Luke Hollingsworth</b></sub></a><br /><a href="https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=LukeHollingsworth" title="Documentation">📖</a> <a href="https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=LukeHollingsworth" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://saxelab.org"><img src="https://avatars.githubusercontent.com/u/4165949?v=4?s=100" width="100px;" alt="Andrew Saxe"/><br /><sub><b>Andrew Saxe</b></sub></a><br /><a href="#mentoring-asaxe" title="Mentoring">🧑🏫</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/DrCaswellBarry"><img src="https://avatars.githubusercontent.com/u/17472149?v=4?s=100" width="100px;" alt="DrCaswellBarry"/><br /><sub><b>DrCaswellBarry</b></sub></a><br /><a href="#mentoring-DrCaswellBarry" title="Mentoring">🧑🏫</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://nikosirmpilatze.com"><img src="https://avatars.githubusercontent.com/u/20923448?v=4?s=100" width="100px;" alt="Niko Sirmpilatze"/><br /><sub><b>Niko Sirmpilatze</b></sub></a><br /><a href="#infra-niksirbi" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#maintenance-niksirbi" title="Maintenance">🚧</a> <a href="#tool-niksirbi" title="Tools">🔧</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://adamltyson.com"><img src="https://avatars.githubusercontent.com/u/13147259?v=4?s=100" width="100px;" alt="Adam Tyson"/><br /><sub><b>Adam Tyson</b></sub></a><br /><a href="#maintenance-adamltyson" title="Maintenance">🚧</a> <a href="#infra-adamltyson" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/rhayman"><img src="https://avatars.githubusercontent.com/u/5619644?v=4?s=100" width="100px;" alt="rhayman"/><br /><sub><b>rhayman</b></sub></a><br /><a href="https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=rhayman" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/JarvisDevon"><img src="https://avatars.githubusercontent.com/u/30460455?v=4?s=100" width="100px;" alt="Devon Jarvis"/><br /><sub><b>Devon Jarvis</b></sub></a><br /><a href="https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=JarvisDevon" title="Documentation">📖</a> <a href="https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=JarvisDevon" title="Code">💻</a></td>
</tr>
</tbody>
</table>
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind are welcome!
Raw data
{
"_id": null,
"home_page": "",
"name": "NeuralPlayground",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8.0",
"maintainer_email": "",
"keywords": "",
"author": "Clementine Domine",
"author_email": "Rodrigo Carrasco-Davis <rodrigo.carrasco.davis@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/87/7f/cefcc27080b7ce0c306a8656c37dcfb35383f230962850fde29f48fb1b34/NeuralPlayground-0.0.7.tar.gz",
"platform": null,
"description": "[](https://opensource.org/licenses/MIT)\n\n[](https://codecov.io/gh/SainsburyWellcomeCentre/NeuralPlayground)\n[](https://github.com/charliermarsh/ruff)\n[](https://github.com/python/black)\n[](https://github.com/pre-commit/pre-commit)\n<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->\n[](#contributors)\n<!-- ALL-CONTRIBUTORS-BADGE:END -->\n\n# NeuralPlayground \n## *A standardised environment for the hippocampus and entorhinal cortex models.* <a href=\"https://githubtocolab.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/colab_example.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>\n\n<img src=\"images/NPG_GH-social-preview_white-bg.jpg\" alt=\"NeuralPlayground Logo\" width=\"500\"/>\n\n<!-- TOC -->\n- [Introduction](#introduction)\n- [Installation](#installation)\n - [Create a conda environment](#create-a-conda-environment)\n - [Pip install](#pip-install)\n - [Install for development](#install-for-development)\n- [Usage](#usage)\n - [Agent Arena interaction](#agent-arena-interaction)\n - [Simulation Manager](#simulation-manager)\n- [I want to contribute](#i-want-to-contribute)\n- [Cite](#cite)\n- [License](#license)\n- [Contributors](#contributors)\n<!-- /TOC -->\n\n## Introduction\nThe abstract representation of space has been extensively studied in the hippocampus and entorhinal cortex. \nA growing variety of theoretical models have been proposed\nto capture the rich neural and behavioral phenomena associated with these circuits. However, objective comparison \nof these theories against each other and against empirical data is challenging.\n\nAlthough the significance of virtuous interaction between experiments and theory is widely recognized, the tools \navailable to facilitate comparison are limited. Some important challenge we aim to solve are:\n\n 1. Lack availability and accessibility of data in a standardized, labeled format.\n\n 2. Standard and easy ways to compare model output with empirical data.\n\n 3. A repository of models and data sets that are relevant for the field of hippocampus and entorhinal cortex.\n\nTo address this gap, we present an open-source standardised software framework - NeuralPlayground - to enable \ncomparison between the hippocampus and entorhinal cortex models. This Python software package offers a reproducible \nway to compare models against a centralised library of published experimental results, including neural recordings \nand animal behavior. The framework currently contains implementations of three Agents, as well as three Experiments \nproviding simple interfaces to publicly available neural and behavioral data. It also contains a customizable \n2-dimensional Arena (continuous and discrete) able to produce common experimental environments in which the agents can \nmove in and interact with. Each module can also be used separately, allowing flexible access to influential\nmodels and data sets.\n\nWe currently rely on visual comparison of a hand-selected number of outputs of the model with neural recordings as \nshown in [github.com/NeuralPlayground/examples/comparison](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/comparisons_examples/comparison_from_manager.ipynb). \nIn the future, a set of quantitative and \nqualitative measures will be added for systematic comparisons across Agents, Arenas, and Experiments. \nWe want to restate that this won't constitute a definitive judgment on the ability of an Agent to replicate the brain \nmechanism. Instead, this allows an objective and complete comparison to the current evidence in the field, as is \ntypically done in publications, which can be used to guide model design and development.\n\nAltogether, we hope our framework, offers\na foundation that the community will build upon, working toward a shared, standardized, open, and\nreproducible computational understanding of the hippocampus and entorhinal cortex.\n\nTry our short tutorial online in Colab. <a href=\"https://githubtocolab.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/colab_example.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>\n\n## Installation\n\n### Create a conda environment\nWe advise you to install the package in a virtual environment,\nto avoid conflicts with other packages. For example, using `conda`:\n\n```python\nconda create --name NPG-env python=3.10\nconda activate NPG-env\nconda install pip\n```\n\n### Pip install\n\nYou can use `pip` get the latest release of NeuralPlayground from PyPI.\n```python\n# install the latest release\npip install NeuralPlayground\n\n# upgrade to the latest release\npip install -U NeuralPlayground\n\n# install a particular release\npip install NeuralPlayground==0.0.5\n```\n> **Note**\n> \n> If you wish to run our implementation of the Tolman-Eichenbaum machine, there are additional dependencies to install. These can be found in the [TEM_README.md](examples/agent_examples/TEM_README.md) file.\n\n### Install for development\n\nIf you want to contribute to the project, get the latest development version\nfrom GitHub, and install it in editable mode, including the \"dev\" dependencies:\n\n```bash\ngit clone https://github.com/SainsburyWellcomeCentre/NeuralPlayground/ --single-branch\ncd NeuralPlayground\npip install -e .[dev]\n```\n> **Note**\n> \n> if you are using the `zsh` shell (default on macOS), replace the last command with:\n> ```bash\n> pip install -e '.[dev]'\n> ```\n\n## Usage\nTry our package! We are gathering opinions to focus our efforts on improving aspects of the code or adding new features,\nso if you tell us what you would like to have, we might just implement it \ud83d\ude0a. \nThis open-source software was built to be collaborative and lasting. We hope that the framework will be simple \nenough to be adopted by a great number of neuroscientists, eventually guiding the path to the computational \nunderstanding of the HEC mechanisms. We follow reproducible, inclusive, and collaborative project design guidelines. \nAll relevant documents can be found in [Documents](https://github.com/ClementineDomine/NeuralPlayground/blob/main/documents/).\n\n### Agent Arena interaction\n\nYou can pick an Agent, an Arena of your choice to run a simulation.\narenas and simulations have a simple interface to interact with each other as in [OpenAI gymnasium](https://gymnasium.farama.org/).\n\n```python\n# import an agent based on a plasticity model of grid cells\nfrom neuralplayground.agents import Weber2018\n# import a square 2D arena\nfrom neuralplayground.arenas import Simple2D \n\n# Initialise the agent\nagent = Weber2018()\n\n# Initialise the arena\narena = Simple2D()\n```\nTo make the agent interact with the arena, a very simple loop can be the following:\n```python\niterations = 1000\nobs, state = arena.reset()\nfor j in range(iterations):\n # Observe to choose an action\n action = agent.act(obs)\n # Run environment for given action\n obs, state, reward = arena.step(action)\n # Update agent parameters\n update_output = agent.update()\n```\nThis process is the base of our package. We provide a more detailed example in <a href=\"https://githubtocolab.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/colab_example.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>.\nAlso, specific examples of how to use each module can be found in [agent](https://github.com/ClementineDomine/NeuralPlayground/tree/main/examples/agent_examples),\n[arena](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/arena_examples/arena_examples.ipynb) \nand [experiment](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/experimental_examples/experimental_data_examples.ipynb) jupyter notebooks.\n> **Note**\n> \n> Check our Tolman-Eichenbaum Machine Implementation in\n[this branch](https://github.com/ClementineDomine/NeuralPlayground/tree/whittington_2020) (work in progress), you will also need to install [pytorch](https://pytorch.org/) ro run it.</strong>\n\n### Simulation Manager\n\nWe provide some backend tools to run simulations and compare the results with experimental data in the background,\nincluding some methods to keep track of your runs, and a comparison board to visualise the results. You can check\nthe details in [Simulation Manager](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/comparisons_examples/simulation_manager.ipynb)\nand [Comparison Board](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/comparisons_examples/comparison_from_manager.ipynb) jupyters. In addition,\nwe have some [default simulations](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/neuralplayground/backend/default_simulation.py)\nyou can try out, for which you don't need to write much code, since they are\nimplemented using a [SingleSim](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/55085e792f5dc446e0c3a808cd0d9901a37484a8/neuralplayground/backend/simulation_manager.py#L211)\nclass. For example\n\n```python\n# Import default simulation, which is a SingleSim \nfrom neuralplayground.backend.default_simulation import stachenfeld_in_2d\nfrom neuralplayground.backend.default_simulation import weber_in_2d\nstachenfeld_in_2d.run_sim(save_path=\"my_results\")\n```\nThis class allows you to run a simulation with a single line of code, and it will automatically save the results in a\nfolder with the name you provide, keeping track of any errors and logs. You can also use our \n[Simulation Manager](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/comparisons_examples/simulation_manager.ipynb)\nto run multiple simulations at once, save the results, keep run of each run and possible errors for easy debugging, and other functions.\n\n```python\n# Import Simulation Manager\nfrom neuralplayground.backend import SimulationManager\n\n# Initialise simulation manager\nmy_sims = [weber_in_2d, stachenfeld_in_2d]\nmy_manager = SimulationManager(simulation_list = my_sims,\n runs_per_sim = 5, # Run 5 instances per simulation\n manager_id = \"example_simulation\",\n verbose = True)\nmy_manager.generate_sim_paths()\nmy_manager.run_all()\nmy_manager.check_run_status()\n```\nTo compare the results, use the comparison board described in [Comparison Board](https://github.com/SainsburyWellcomeCentre/NeuralPlayground/blob/main/examples/comparisons_examples/comparison_from_manager.ipynb) jupyter\nnotebook. With time, we will build an interface for easy model comparison and visualisation of the results!\n\n<img src=\"images/board_diagram.jpeg\" alt=\"NeuralPlayground Logo\" width=\"500\"/>\n\n## I want to contribute\n\nThere are many ways to contribute to our project.\n\n1. Implement a hippocampal and entorhinal cortex [Agent](https://github.com/ClementineDomine/NeuralPlayground/tree/main/neuralplayground/agents) of your choice.\n\n2. Work on improving the [Arena](https://github.com/ClementineDomine/NeuralPlayground/tree/main/neuralplayground/arenas).\n\n3. Add an [Experimental](https://github.com/ClementineDomine/NeuralPlayground/tree/main/neuralplayground/experiments) data set.\n\n4. Implementing [metrics](https://github.com/ClementineDomine/NeuralPlayground/tree/main/neuralplayground/comparison/metrics.py) to compare the output of the Agent with the experimental data.\n\n5. Refactor the code to improve the readability and efficiency.\n\nAll contributions should be submitted through a pull request and will be reviewed by the maintainers.\nBefore sending a pull request, make sure you have the done following:\n\n1. Checked the Licensing frameworks.\n\n2. Used the [right development environment](#install-for-development). Make sure to initialise the pre-commit hooks with ```pre-commit install``` and run ```pre-commit run -a``` to format the code and check for errors.\n\n3. Followed the [PEP8](https://www.python.org/dev/peps/pep-0008/) and [numpy docstring](https://numpydoc.readthedocs.io/en/latest/format.html) style convention. More details found in [Style Guide](https://github.com/ClementineDomine/NeuralPlayground/tree/main/documents/style_guide.md).\n\n4. Implemented and ran [tests](https://github.com/ClementineDomine/NeuralPlayground/tree/main/neuralplayground/tests).\n\n5. Comment your work.\n\n**All contributions to the repository are acknowledged through the all-contributors bot.**\nRefer to the README.md files found in each of the modules for further details on how to contribute to them.\n\n\n## Cite\n\nSee [Citation](https://github.com/ClementineDomine/NeuralPlayground/blob/main/documents/citation.cff) for the correct citation of this framework.\n\n## License\n\n\u2696\ufe0f [MIT](./LICENSE)\n\n\n## Contributors\n\nThanks go to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->\n<!-- prettier-ignore-start -->\n<!-- markdownlint-disable -->\n<table>\n <tbody>\n <tr>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/ClementineDomine\"><img src=\"https://avatars.githubusercontent.com/u/18595111?v=4?s=100\" width=\"100px;\" alt=\"Clementine Domine\"/><br /><sub><b>Clementine Domine</b></sub></a><br /><a href=\"#design-ClementineDomine\" title=\"Design\">\ud83c\udfa8</a> <a href=\"#mentoring-ClementineDomine\" title=\"Mentoring\">\ud83e\uddd1\u200d\ud83c\udfeb</a> <a href=\"https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=ClementineDomine\" title=\"Code\">\ud83d\udcbb</a> <a href=\"#data-ClementineDomine\" title=\"Data\">\ud83d\udd23</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/rodrigcd\"><img src=\"https://avatars.githubusercontent.com/u/22643681?v=4?s=100\" width=\"100px;\" alt=\"rodrigcd\"/><br /><sub><b>rodrigcd</b></sub></a><br /><a href=\"#design-rodrigcd\" title=\"Design\">\ud83c\udfa8</a> <a href=\"#mentoring-rodrigcd\" title=\"Mentoring\">\ud83e\uddd1\u200d\ud83c\udfeb</a> <a href=\"https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=rodrigcd\" title=\"Code\">\ud83d\udcbb</a> <a href=\"#data-rodrigcd\" title=\"Data\">\ud83d\udd23</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/LukeHollingsworth\"><img src=\"https://avatars.githubusercontent.com/u/93782020?v=4?s=100\" width=\"100px;\" alt=\"Luke Hollingsworth\"/><br /><sub><b>Luke Hollingsworth</b></sub></a><br /><a href=\"https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=LukeHollingsworth\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=LukeHollingsworth\" title=\"Code\">\ud83d\udcbb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"http://saxelab.org\"><img src=\"https://avatars.githubusercontent.com/u/4165949?v=4?s=100\" width=\"100px;\" alt=\"Andrew Saxe\"/><br /><sub><b>Andrew Saxe</b></sub></a><br /><a href=\"#mentoring-asaxe\" title=\"Mentoring\">\ud83e\uddd1\u200d\ud83c\udfeb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/DrCaswellBarry\"><img src=\"https://avatars.githubusercontent.com/u/17472149?v=4?s=100\" width=\"100px;\" alt=\"DrCaswellBarry\"/><br /><sub><b>DrCaswellBarry</b></sub></a><br /><a href=\"#mentoring-DrCaswellBarry\" title=\"Mentoring\">\ud83e\uddd1\u200d\ud83c\udfeb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"http://nikosirmpilatze.com\"><img src=\"https://avatars.githubusercontent.com/u/20923448?v=4?s=100\" width=\"100px;\" alt=\"Niko Sirmpilatze\"/><br /><sub><b>Niko Sirmpilatze</b></sub></a><br /><a href=\"#infra-niksirbi\" title=\"Infrastructure (Hosting, Build-Tools, etc)\">\ud83d\ude87</a> <a href=\"#maintenance-niksirbi\" title=\"Maintenance\">\ud83d\udea7</a> <a href=\"#tool-niksirbi\" title=\"Tools\">\ud83d\udd27</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"http://adamltyson.com\"><img src=\"https://avatars.githubusercontent.com/u/13147259?v=4?s=100\" width=\"100px;\" alt=\"Adam Tyson\"/><br /><sub><b>Adam Tyson</b></sub></a><br /><a href=\"#maintenance-adamltyson\" title=\"Maintenance\">\ud83d\udea7</a> <a href=\"#infra-adamltyson\" title=\"Infrastructure (Hosting, Build-Tools, etc)\">\ud83d\ude87</a></td>\n </tr>\n <tr>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/rhayman\"><img src=\"https://avatars.githubusercontent.com/u/5619644?v=4?s=100\" width=\"100px;\" alt=\"rhayman\"/><br /><sub><b>rhayman</b></sub></a><br /><a href=\"https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=rhayman\" title=\"Code\">\ud83d\udcbb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/JarvisDevon\"><img src=\"https://avatars.githubusercontent.com/u/30460455?v=4?s=100\" width=\"100px;\" alt=\"Devon Jarvis\"/><br /><sub><b>Devon Jarvis</b></sub></a><br /><a href=\"https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=JarvisDevon\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"https://github.com/SainsburyWellcomeCentre/NeuralPlayground/commits?author=JarvisDevon\" title=\"Code\">\ud83d\udcbb</a></td>\n </tr>\n </tbody>\n</table>\n\n<!-- markdownlint-restore -->\n<!-- prettier-ignore-end -->\n\n<!-- ALL-CONTRIBUTORS-LIST:END -->\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind are welcome!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "The standardised environment for the hippocampus and entorhinal cortex models",
"version": "0.0.7",
"project_urls": {
"Bug tracker": "https://github.com/ClementineDomine/NeuralPlayground/issues",
"Documentation": "https://github.com/ClementineDomine/NeuralPlayground",
"Homepage": "https://github.com/ClementineDomine/NeuralPlayground",
"Source code": "https://github.com/ClementineDomine/NeuralPlayground",
"User support": "https://github.com/ClementineDomine/NeuralPlayground/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "25ae9e4504d1b8af486fecbc3e07d9e2e6c130c34f0728038cd09cc9d0f29a89",
"md5": "2f9b5e85a3a1456b455b293db5e6dc38",
"sha256": "6eb49a5ba420f4a1acf1351b6983422e069ea79b6cb3deddc06e5790474f0730"
},
"downloads": -1,
"filename": "NeuralPlayground-0.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2f9b5e85a3a1456b455b293db5e6dc38",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.0",
"size": 125625,
"upload_time": "2023-08-22T10:18:36",
"upload_time_iso_8601": "2023-08-22T10:18:36.662144Z",
"url": "https://files.pythonhosted.org/packages/25/ae/9e4504d1b8af486fecbc3e07d9e2e6c130c34f0728038cd09cc9d0f29a89/NeuralPlayground-0.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "877fcefcc27080b7ce0c306a8656c37dcfb35383f230962850fde29f48fb1b34",
"md5": "44ae2783e522470e6743c4c37949a8c8",
"sha256": "7d987456a777e23dce9345f61d2e221d4d8828a2a64d57fc738709bff50800d9"
},
"downloads": -1,
"filename": "NeuralPlayground-0.0.7.tar.gz",
"has_sig": false,
"md5_digest": "44ae2783e522470e6743c4c37949a8c8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.0",
"size": 414735,
"upload_time": "2023-08-22T10:18:38",
"upload_time_iso_8601": "2023-08-22T10:18:38.127972Z",
"url": "https://files.pythonhosted.org/packages/87/7f/cefcc27080b7ce0c306a8656c37dcfb35383f230962850fde29f48fb1b34/NeuralPlayground-0.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-22 10:18:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ClementineDomine",
"github_project": "NeuralPlayground",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "neuralplayground"
}
