Skip to main content

Command line tool for highly parallelized processing of Vizgen data

Project description

License Coverage Status

Vizgen Post-processing Tool

The Vizgen Post-processing Tool (VPT) enables users to reprocess and refine the single-cell results of MERSCOPE experiments. VPT is a command line tool that emphasizes scalable, reproducible analysis, and can be run on a workstation, a cluster, or be deployed in a cloud computing environment.

Features

  • Perform cell segmentation
    • Reproduce standard Vizgen segmentation options
    • Perform reproducible custom segmentation
  • Import cell segmentation from other tools
    • Supports geojson and hdf5 formats
  • Regenerate single cell data with new segmentation
    • Cell by gene matrix
    • Cell spatial metadata
    • Image intensity in each cell
    • Update MERSCOPE Vizualizer file (vzg)
  • Image format conversion
    • Convert large tiff files to single or multi-channel Pyramidal OME-TIFF files
  • Nextflow compatible, example pipeline provided

Installation

Install the tool through your choice of

To access in-utility help documentation run the process below in the installed environment.

  vpt --help

Usage

VPT accepts two types of inputs to specify how to run segmentation:

  • Command line parameters
    • relate to where to find the input data and are expected to vary with each experiment
  • Segmentation algorithm .json file parameters
    • describes a series of steps to perform on the input data

Using the same segmentation algorithm on a series of experiments ensures that they are processed identically and reproducibly.

In addition to the user guide, several working segmentation algorithm .json files are provided that can serve either as a robust segmentation definition or as a template for a custom workflow.

Quick start commands:

run-segmentation ​

  • Top-level interface for vpt which invokes the segmentation functionality of the tool.​

prepare-segmentation​

  • Generates a segmentation specification json file to be used for cell segmentation tasks. ​

run-segmentation-on-tile​

  • Executes the segmentation algorithm on a specific tile of the mosaic images.​

compile-tile-segmentation​

  • Combines the per-tile segmentation outputs into a single, internally-consistent parquet file containing all of the segmentation boundaries found in the experiment.​

derive-entity-metadata​

  • Uses the segmentation boundaries to calculate the geometric attributes of each Entity​

partition-transcripts​

  • Uses the segmentation boundaries to determine which Entity, if any, contains each detected transcript.​

sum-signals​

  • Uses the segmentation boundaries to find the intensity of each mosaic image in each Entity.​

update-vzg​

  • Updates an existing .vzg file with new segmentation boundaries and the corresponding expression matrix.​

convert-geometry​

  • Converts Entity boundaries produced by a different tool into a vpt compatible parquet file.​

convert-to-ome​

  • Transforms the large 16-bit mosaic tiff images produced by the MERSCOPE into a OME pyramidal tiff.​

convert-to-rgb-ome​

  • Converts up to three flat tiff images into rgb OME-tiff pyramidal images.​

For more detail on commands and arguments, please see the user guide.

Documentation

User Guide

Feedback

If you encounter issues or bugs, let us know by submitting an issue! Please include:

  • A quick issue summary
  • Steps that caused it to occur
  • The exception generated by the code, if applicable
  • Specific lines of code, if indicated in the error message

If you have any other feedback or issues, please reach out to your regional Vizgen field application scientist and CC: Vizgen Tech Support at techsupport@vizgen.com.

Please include VPT in your subject line along with the above information in the body.

Contributing & Code of Conduct

We welcome code contributions! Please refer to the contribution guide before getting started.

Authors

Logo

License

Copyright 2022 Vizgen, Inc. All Rights Reserved

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details


Download files

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

Source Distribution

vpt-1.3.0.tar.gz (195.1 kB view details)

Uploaded Source

Built Distribution

vpt-1.3.0-py3-none-any.whl (241.9 kB view details)

Uploaded Python 3

File details

Details for the file vpt-1.3.0.tar.gz.

File metadata

  • Download URL: vpt-1.3.0.tar.gz
  • Upload date:
  • Size: 195.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for vpt-1.3.0.tar.gz
Algorithm Hash digest
SHA256 796569f2cbf22f689e4512442c51276281cb36680b1eb14e68526a8b6afca691
MD5 abdc4cae7ec0ea8a47a81a2da138a106
BLAKE2b-256 8f7e36d002f21f58ddf8fbecedef35156caa24cb51d1070095245fe727ef7ad6

See more details on using hashes here.

File details

Details for the file vpt-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: vpt-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 241.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for vpt-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9f31feadb9da3a6fd299a06eefed1924c90d3f34af8b5996555256f2aa8f515e
MD5 6ebd6048aaaf07eeba6d31136c492788
BLAKE2b-256 fcd292aa3fba4a94b341909eeec7a07d056801ad1e2f99a5072e1d6b0ac0d22a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page