Skip to main content

PIE Readme

Processing Images Easily (PIE) automatically tracks growing microcolonies in low-resolution brightfield and phase-contrast microscopy images. The program works for recognizing microcolonies in a wide range of microbes, and allows automated measurement of growth rate, lag times, and (if applicable) fluorescence across time for microcolonies founded by single cells. PIE recognizes colony outlines very robustly and accurately across a wide range of image brightnesses and focal depths, and allows simultaneous measurements of growth properties and fluorescence intensities with very high throughput (in our lab, ~100,000 colonies per experiment), including in complex, multiphase experiments.

To learn how to install and use PIE, see the PIE documentation.

To learn how PIE works, see our preprint.

To test microcolony recognition and growth tracking on your images, try our web application.

PIE Quickstart

Below is a quick reference to essential PIE functions; see the full PIE documentation for more details. If you have any questions about setting up or using PIE, we’d love to help! Feel free to contact us at pie-siegal-lab@nyu.edu or open an issue on github.

All the commands below must be run in Terminal (MacOS/Linux) / Command Prompt (Windows)

Installing PIE

PIE requires Python 3.6+, and can be installed using pip, which should come with your python installation.

In unix/macOS Terminal, run:

python -m pip install git+https://github.com/Siegallab/PIE@v1.0.1

or, in Windows Command Prompt, run:

py -m pip install git+https://github.com/Siegallab/PIE@v1.0.1

See Installing PIE for details.

Analyzing a single image

To run PIE on a single image:

pie analyze_single_image INPUT_IM_PATH OUTPUT_PATH IMAGE_TYPE

Where:

  • INPUT_IM_PATH is the path to the image you want to analyze

  • OUTPUT_PATH is a directory you’d like to store the results of the analysis in

  • IMAGE_TYPE is ‘bright’ (for cells that are brighter than the image background) or ‘dark’ (for cells that are darker than the image background)

See Running PIE single-image analysis for details on the inputs and outputs, as well as additional analysis options.

Analyzing timelapse experiments

To analyze a time lapse experiment, you need to create a setup file containing analysis parameters, and then run the analysis itself.

To interactively create a setup file:

pie run_setup_wizard

To analyze the timelapse experiment:

pie run_timelapse_analysis PATH_TO_SETUP_FILE

Where PATH_TO_SETUP_FILE is the path to the setup file created by the setup wizard.

See Running PIE timelapse experiments for information on analyzing complex, multi-phase experiments.

Creating movies

After timelapose experiments are analyzed, PIE can create movies of the output; this is helpful in understanding whether the analysis worked as expected.

To create simple movies of PIE analysis output for a single imaging position:

pie make_position_movie XY_POS PATH_TO_SETUP_FILE

Where:

  • XY_POS is the imaging position number for which the movie should be created (see Filenames for information on how to encode imaging position in filenames and the setup file)

  • PATH_TO_SETUP_FILE is the path to the setup file created by the setup wizard

See Creating movies of image analysis results for additional options and examples of more movie types that can be created from PIE output.

Metadata

Release files for PIE 1.0.1

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

Source distribution (sdist)

Source distribution for PIE 1.0.1
File Size Uploaded
PIE-1.0.1.tar.gz 101.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for PIE 1.0.1
File Interpreter ABI Platform
PIE-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 209.5 kB

Release files / PIE-1.0.1.tar.gz

Download URL PIE-1.0.1.tar.gz
Size 101.2 kB
Tags Source
SHA-256 checksum
How to use checksums
5c847b456481e97f3811f8414e4bbb5ccbe000cfd2d1ed25b18ae9c3a0d1eb65
BLAKE2b-256 checksum
How to use checksums
3402113a4043af9c8c912bf08c9a6a10f2c8df18494c673e428d579a374108f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.12

Release files / PIE-1.0.1-py3-none-any.whl

Download URL PIE-1.0.1-py3-none-any.whl
Size 108.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
51f8a9a80d6b05cf1e2e22d2871a632abe21a98c607a1fb4c79558aa6abd403e
BLAKE2b-256 checksum
How to use checksums
8285b747b6dead8520e5aa41987f4deef67012d64c75144e75d47bcdce11e2ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.12

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files

0.6

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