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 12, 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 12, 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.2b0.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.2b0-py3-none-any.whl (7.4 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mesofield-0.4.2b0.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.2b0.tar.gz
Algorithm Hash digest
SHA256 553d8fee5f5c49e4bf5ed56d811f3c3bf56932cbac2788eb2f58763b2f894eb3
MD5 4ef78c005081f04c55233b1b3581b991
BLAKE2b-256 017410b256dd741e52ef246205611d187ec8d329c51edf5c432e6fa3963ce131

See more details on using hashes here.

Provenance

The following attestation bundles were made for mesofield-0.4.2b0.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.2b0-py3-none-any.whl.

File metadata

  • Download URL: mesofield-0.4.2b0-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.2b0-py3-none-any.whl
Algorithm Hash digest
SHA256 8ce5e350b4d3314023ea0c9042be1d48605c6a55389bed84ef9076d86782f05d
MD5 22e30923ff7ba6ae5da492761e02a9ac
BLAKE2b-256 a1520d16948e76fb04ab9595ccc6b54431329c29f38d5039ba9a73308b4e9d07

See more details on using hashes here.

Provenance

The following attestation bundles were made for mesofield-0.4.2b0-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

This release
Pre-release

0.4.2b0 This release

2 files

Pre-release

0.4.1b0

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