Skip to main content

aind-vr-foraging

CI PyPI - Version License ruff uv

A repository for the VR Foraging task.


📋 General instructions

This repository follows the project structure laid out in the Aind.Behavior.Services repository.


⚙️ Generating settings files

The VR Foraging tasks is instantiated by a set of three settings files that strictly follow a DSL schema. These files are:

  • task.json
  • rig.json
  • session.json

Examples on how to generate these files can be found in the ./Examples directory of the repository. Once generated, these are the the only required inputs to run the Bonsai workflow in ./src/main.bonsai.

The workflow can thus be executed using the Bonsai CLI:

"./.bonsai/bonsai.exe" "./src/main.bonsai" -p SessionPath=<path-to-session.json> -p RigPath=<path-to-rig.json> -p TaskPath=<path-to-task.json>

[> ] CLI tools

The platform exposes a few CLI tools to facilitate various tasks. Tools are available via:

uv run vr-foraging <subcommand>

for a list of all sub commands available:

uv run vr-foraging -h

You may need to install optional dependencies depending on the sub-commands you run.

🔍 Primary data quality-control

Once an experiment is collected, the primary data quality-control script can be run to check the data for issues. This script can be launcher using:

uv run vr-foraging data-qc <path-to-data-dir>

🌉 Mapping to aind-data-schema

Once an experiment is collected, data can be mapped to aind-data-schema using the data-mapper sub-command:

uv run vr-foraging data-mapper

🔄 Regenerating schemas

DSL schemas can be modified in ./src/aind_behavior_vr_foraging/rig.py (or (...)/task_logic.py`).

Once modified, changes to the DSL must be propagated to json-schema and csharp API. This can be done by running:

uv run vr-foraging regenerate

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aind_behavior_vr_foraging-1.2.0.tar.gz (37.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aind_behavior_vr_foraging-1.2.0-py3-none-any.whl (51.5 kB view details)

Uploaded Python 3

File details

Details for the file aind_behavior_vr_foraging-1.2.0.tar.gz.

File metadata

  • Download URL: aind_behavior_vr_foraging-1.2.0.tar.gz
  • Upload date:
  • Size: 37.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for aind_behavior_vr_foraging-1.2.0.tar.gz
Algorithm Hash digest
SHA256 97b8f980c221ec79a6011d16d4c482016439d355c2acfd166834cf4b3e7ad97d
MD5 57f6aa2a5a83c071403057c32d33626a
BLAKE2b-256 69169ad00d6a63375907516320debe696ac3d491c81dfb977034692b5f5f60eb

See more details on using hashes here.

File details

Details for the file aind_behavior_vr_foraging-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: aind_behavior_vr_foraging-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 51.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for aind_behavior_vr_foraging-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 222886c5cf4349680dd877aac64d1751b3a621f96ceca1ac2deb4ec9476e08b4
MD5 89d5c3720c64b946712079616bba97f7
BLAKE2b-256 a7158e0a6787f1853f80857f18d7f2983a5bbd4720fd5217448346366efca0ed

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page