Skip to main content

Aind.Behavior.VrForaging.Curricula

CI License ruff uv

A repository of curricula for VR foraging task.

How to run a specific curriculum?

Curricula are modules of the main package: aind_behavior_vr_foraging_curricula.<curriculum_name>.

All curricula are available via the curriculum cli entry point. Available list of commands is printed with the -h flag:

uv run curriculum -h

List available curricula

Available curricula can be listed from the cli using:

uv run curriculum list

Running a curriculum

Curricula can be run using the run subcommand of the curriculum cli entry point.

uv run curriculum run -h

The following arguments are available for the run subcommand:

  • --data-directory: Path to the session data directory that will be used to calculate metrics (required)
  • --input-trainer-state: Path to a deserialized json file with the current trainer state (required)
  • --mute-suggestion: Disables the suggestion output (optional)
  • --output-suggestion: A path to save the serialized suggestion (optional)
  • --curriculum: The name of the curriculum to run (optional)

For a quick "demo" to ensure everything is working, you can run:

uv run curriculum run --data-directory "demo" --input-trainer-state "foo.json" --curriculum "template"

For real-world applications, you may want to omit the "--curriculum" flag and let the system automatically detect the curriculum from the trainer state.

Style guide

To keep things clear, I suggest the following naming convention:

  • Policies should start with p_ (e.g., p_identity_policy)
  • Policy transitions should start with pt_
  • Stages should start with s_ (e.g., s_stage1)
  • Stage transitions should start with st_ and should be named after the stages they transition between (e.g., st_s_stage1_s_stage2)

Define the following modules:

  • metrics: Defines (or imports) metrics classes and how to calculate them from data
  • stages: Defines the different stages of the VR foraging task. This includes task settings and, optionally, policies
  • curriculum: Defines the transitions between the stages and generate entry point to the application

Contributors

Contributions to this repository are welcome! However, please ensure that your code adheres to the recommended DevOps practices below:

Linting

We use ruff as our primary linting tool.

Testing

Attempt to add tests when new features are added. To run the currently available tests, run uv run pytest from the root of the repository.

Lock files

We use uv to manage our lock files and therefore encourage everyone to use uv as a package manager as well.

Metadata

Release files for aind-behavior-vr-foraging-curricula 1.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aind-behavior-vr-foraging-curricula 1.3.3
File Size Uploaded Provenance Actions
aind_behavior_vr_foraging_curricula-1.3.3.tar.gz 41.1 kB Without provenance Details for aind_behavior_vr_foraging_curricula-1.3.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aind-behavior-vr-foraging-curricula 1.3.3
File Interpreter ABI Platform Actions
aind_behavior_vr_foraging_curricula-1.3.3-py3-none-any.whl Python 3 none any Details for aind_behavior_vr_foraging_curricula-1.3.3-py3-none-any.whl

Total release size: 107.0 kB

Release files / aind_behavior_vr_foraging_curricula-1.3.3.tar.gz

Download URL aind_behavior_vr_foraging_curricula-1.3.3.tar.gz
Size 41.1 kB
Tags Source
SHA-256 checksum
How to use checksums
27b44bd21a26745eebc1606155bb01b1fa1c44c72654347db074078cd533998b
BLAKE2b-256 checksum
How to use checksums
56d32b2014d0141e29747b693fd48d048cb9e504bb69c41829afbcf6fca7d8a6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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}

Release files / aind_behavior_vr_foraging_curricula-1.3.3-py3-none-any.whl

Download URL aind_behavior_vr_foraging_curricula-1.3.3-py3-none-any.whl
Size 65.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
35398e55b569ae81e6fee54c44879d89a0349367562dc5c3b47767fe43084819
BLAKE2b-256 checksum
How to use checksums
0b87c55c2af6f1f18ed1de9f91481a63c5cda1ccb2ba9ae9a6bcc381d0789155
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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}

Security for aind-behavior-vr-foraging-curricula 1.3.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.3.3 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page