avelde
Phagocytosis Analyzer

Every bacterium eaten, found and timed.

Open a time-lapse microscopy film and the Analyzer finds each bacterium taken up by a cell, follows it, and tells you whether the cell killed it — and how long that took — or failed to. You review; it does the counting.

Apple silicon and Intel Macs · macOS 13 or newer · runs entirely on your Mac

Phagocytosis Analyzer — film.tif
Simulation — illustrative, not real data

Built for the way a lab scores a film

The same events a person would mark by hand, in the same shape — without the hours.

Finds every uptake

Cells are segmented by a deep-learning model running on your Mac's GPU and tracked through the film; bacteria are detected and followed frame by frame.

Kills, timed

A kill is a bacterium that goes inside and is broken down. You get the frame it entered, the frame it was gone, and the time in between.

Failed kills, too

A cell still holding its bacterium when the film ends is a result, not noise. Failed kills are found from the cell, so a crowded field does not hide them.

You stay the judge

Events are ranked by how clear they are. Confirm, reject, correct the frames or add one that was missed; your review is saved beside the film.

How it works

Four steps, all on your Mac. Pick one to see it in the film.

Step 1 — Detect the bacteria
Simulation

A workbook you can use

The same columns as a hand-scored sheet, plus the outcome as a number you can count and average.

Xfilm-events.xlsx — Confirmed events
EventFrame startFrame endDuration (frames)Duration (min)OutcomeOutcome code
11227157.5Killed1
231241210105.0Failed kill0
34859115.5Killed1

Rows here come from the simulation above as it runs. Illustrative only.

Your films stay on your Mac

All analysis runs locally. No film, image, file name or result is ever sent anywhere. The program reports only anonymous usage counts and checks its licence — exactly what, and why.

Download

Apple silicon M1, M2, M3, M4

Download for Apple silicon version 0.6.1 · 218 MB

Intel most Macs from 2019 and earlier

Download for Intel version 0.6.1 · 309 MB

Which one? Apple menu → About This Mac. If it says Chip: Apple M…, take Apple silicon; if it says Processor: … Intel …, take Intel. The wrong one will not open ("not supported on this Mac") but does no harm.

macOS 13 or newer. 8 GB of memory is enough; more is faster. On Intel Macs the analysis runs on the processor and takes longer. A licence is needed to run it — ask us for one.

Installing

  1. Open the downloaded .dmg and drag Phagocytosis Analyzer into Applications.
  2. Open it. The app is signed and notarised by Apple, so it opens without a security warning.
  3. Click Choose licence file… and select the licence.key you were sent.

A renewed licence is installed the same way, from Help → Install new licence…

Settings

Event Joining

The Event Joining menu: Normal, Aggressive, Super aggressive, Testing

Sometimes the program loses a bacterium inside a cell for a while and reports one event as two. Event Joining puts them back together.

OptionWhat it does
NormalLeaves the events as they are found.
AggressiveJoins two events in the same cell when they are at most 50 frames apart and a bacterium is seen in that cell in at least 70% of the frames between them.
Super aggressive defaultSame as Aggressive, and also joins events that Shared Cells would remove. Shared Cells then checks the joined event as a whole.
TestingJoins nothing. Colours the event list to show what Aggressive and Super aggressive would do.

After changing it, press Re-detect Events. Two events joined that should not be? Select it, go to the frame where the second one starts and press Split.

Shared Cells

The Shared Cells settings: Max in a row, Max in total, Other counts if

An event is removed when another bacterium is in the same cell for too long, because then you cannot tell which one was killed. Going over either limit removes it.

SettingDefaultWhat it does
Max in a row3 framesHow many frames in a row another bacterium may be in the cell. Raise it if good events are removed because a bacterium only passed through.
Max in total10% of eventHow much of the event another bacterium may be in the cell, in total. 100% turns this limit off.
Other counts ifInside, 20% deepHow far inside the cell the other bacterium has to be before it counts. From Touching the cell (strictest) to Inside, 40% deep.

After changing them, press Re-detect Events.

Bacteria Detection

The Bacteria Detection settings: Bright core only, Core must reach White
SettingWhat it does
Bright core only defaultFinds a bacterium by its bright core and the red, orange and yellow around it. The blue glow is ignored.
Whole glowThe older method, which includes the glow. For films without a blue glow, where bacteria are harder to see.
Core must reachHow bright the centre of a bacterium must be: White (default), Yellow, Orange or Red. Lower it if bacteria you can see are not found.

After changing Core must reach, press Recalculate Bacteria. After switching between Bright core only and Whole glow, press Run Analysis.

Run Analysis, Recalculate Bacteria, Re-detect Events

The buttons Run Analysis, Recalculate Bacteria and Re-detect Events
ButtonRecalculatesUse after changing
Run AnalysisCells, bacteria and events. The slowest. A new film, Cell Accuracy, Bright core only / Whole glow
Recalculate BacteriaBacteria and events. Keeps the cells. Bacteria Detection, Bacteria Tracking
Re-detect EventsOnly the events. Takes seconds. Event Joining, Shared Cells

Choose your settings before you start confirming events. With other settings, different events can be found and some of your decisions may no longer match.

Contact

For a licence, a question, or a film that does not analyse the way you expect.

[email protected] If the program reports a problem, Help → Show log files opens the folder with the report to attach.