Pre-release

This release is a pre-release and may not be stable for production use. 

 __    __     ______     ______     ______     ______   __     ______     __         _____
/\ "-./  \   /\  ___\   /\  ___\   /\  __ \   /\  ___\ /\ \   /\  ___\   /\ \       /\  __-.
\ \ \-./\ \  \ \  __\   \ \___  \  \ \ \/\ \  \ \  __\ \ \ \  \ \  __\   \ \ \____  \ \ \/\ \
 \ \_\ \ \_\  \ \_____\  \/\_____\  \ \_____\  \ \_\    \ \_\  \ \_____\  \ \_____\  \ \____-
  \/_/  \/_/   \/_____/   \/_____/   \/_____/   \/_/     \/_/   \/_____/   \/_____/   \/____/

Mesofield is a PyQt6-based framework for running real-time, multi-camera neuroscience experiments. It coordinates hardware via serial connections and MicroManager (through pymmcore-plus custom MDAEngines and multi-CMMCorePlus instancing) and manages experiment configuration, acquisition orchestration, and data logging. The project is aimed at laboratory use and is not a full production package; some specialised knowledge of device hardware and MicroManager device configuration is necessary to get started.

Mesofield acquisition window

Documentation

Documentation lives at gronemeyer.github.io/mesofield and is split by audience:

  • Tutorial — the fastest path from a fresh conda env to a working acquisition on your hardware.
  • User Guide — for experimenters running acquisitions: launching the GUI, writing experiment.json, interpreting the on-disk output.
  • Developer Guide — for developers extending mesofield: custom devices, Procedure subclasses, frame processors, threading models.
  • API Reference — auto-generated from docstrings.

Quick start

conda create -n mesofield python=3.12 -y
conda activate mesofield
pip install -e .

Launch an acquisition by pointing at your rig — experiment.json is optional:

mesofield launch path/to/hardware.yaml      # rig only (author params in the GUI)
mesofield launch path/to/experiment.json    # rig + params (sibling hardware.yaml auto-detected)
mesofield launch path/to/experiment/        # a directory containing either

Scaffold a new experiment:

mesofield new my-experiment

For end-to-end setup, follow the Tutorial.

System requirements

Tested on Windows 10/11. For multi-camera acquisition with large files we recommend ≥ 32 GB RAM, a 12th-gen Intel i7 or equivalent, and fast local NVMe storage for the experiment directory.

License

MIT — see LICENSE.

Project links

Data verified by PyPI on Jun 11, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.5.0b0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ake.py from gravatar.com ake.py

Credits

Author: Jacob Gronemeyer

GitHub Statistics

Data verified by PyPI on Jun 11, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT License)

Requires

Python >=3.10

Provides Extra

test docs

Tags

imaging microscopy acquisition neuroscience

Classifiers

Report project as malware

Download files

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

Source Distribution

mesofield-0.4.1b0.tar.gz (7.4 MB view details)

Uploaded Source

Built Distribution

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

mesofield-0.4.1b0-py3-none-any.whl (7.4 MB view details)

Uploaded Python 3

File details

Details for the file mesofield-0.4.1b0.tar.gz.

File metadata

  • Download URL: mesofield-0.4.1b0.tar.gz
  • Upload date:
  • Size: 7.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for mesofield-0.4.1b0.tar.gz
Algorithm Hash digest
SHA256 6551c970f6cd78ad6b27020f9c0fcefb4e0011cc90f7fd6390d27a8c8b4ae316
MD5 64ce0f7af6db3bfd557d761819361057
BLAKE2b-256 5505a2b27b2d4cde65f260ce11fc4ea3e23ccd35016d3adbcb32a5a95fa067d6

See more details on using hashes here.

Provenance

The following attestation bundles were made for mesofield-0.4.1b0.tar.gz:

Publisher: release.yml on Gronemeyer/mesofield

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mesofield-0.4.1b0-py3-none-any.whl.

File metadata

  • Download URL: mesofield-0.4.1b0-py3-none-any.whl
  • Upload date:
  • Size: 7.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for mesofield-0.4.1b0-py3-none-any.whl
Algorithm Hash digest
SHA256 adc447e86bb3c7d997f7615ced5ed4b61143816322b8b76da57a02f21093b51f
MD5 d17d6d6bb5eee85af49f0baf92cf2067
BLAKE2b-256 e8e1de6c0fe229832a178644b9c60a485a5640bf1890bb9a229d745a0f16b10b

See more details on using hashes here.

Provenance

The following attestation bundles were made for mesofield-0.4.1b0-py3-none-any.whl:

Publisher: release.yml on Gronemeyer/mesofield

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

Pre-release

0.5.0b0

2 files

Pre-release

0.4.2b0

2 files

This release
Pre-release

0.4.1b0 This release

2 files

Pre-release

0.4.0b0

2 files

Pre-release

0.3.2b0

2 files

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