Skip to main content

Segzoo

Introduction

Segzoo is a tool designed to automate various genomic analyses on segmentations obtained using Segway. It provides detailed results for each analysis and a comprehensive visualization summarizing the outcomes.

The tool has specific dependencies, including segtools, bedtools, and various Python packages. However, these dependencies will be automatically handled during the installation process.

Installation and Quick Start

We recommend installing Segzoo using the mamba package manager.

  1. To install Segzoo in a separate environment, open a terminal and execute mamba create -c bioconda -n segzooenv segzoo -y.
  2. Once the installation is complete, activate the Segzoo environment by running mamba activate segzooenv.
  3. To test Segzoo, download the segmentation file and the GMTK parameters, and place them in a directory named, for example, segzoo.
  4. After the files are in place, execute segzoo segway.bed.gz --parameters params.params.
  5. After approximately 30 minutes, the resulting visualization will be stored in the outdir/plots folder within the current directory.

Usage

To access the help and learn how to run Segzoo, execute segzoo -h or segzoo --help. Here are the available command-line arguments:

  • --version: Check the currently installed version of Segzoo.
  • --parameters: Specify a params.params file generated from Segway's training to obtain GMTK parameters in the final visualization. If not specified, GMTK parameters will not be displayed.
  • --prefix: Specify the location where all necessary data, such as genome assembly, should be downloaded (default: the installation environment's directory).
  • -o or --outdir: Specify the folder where all the results and the final visualization will be created (default: outdir).
  • -j: Specify the number of cores to utilize (default: 1).
  • --species and --build: Specify the species and build for which the segmentation was created (default: Homo_sapiens and hg38).
  • --download-only: This option is designed to support cluster use. Running Segzoo with this argument will only execute the downloading rules of the pipeline and store the data using the specified prefix. Subsequently, runs on nodes without internet access can be performed by specifying the same prefix.
  • --mne: Specify an mne file to translate segment labels and track names shown on the figure. Refer to the 'Using mne files' section for details.
  • --normalize-gmtk: Allow row-wise normalization of GMTK parameters table.
  • --dendrogram: Perform hierarchical clustering of GMTK parameters row-wise.

If you are interested in obtaining information on gene biotypes other than protein coding and lincRNA, which are the default, modify the gene_biotypes.py file in the installation folder of Segzoo accordingly. Similarly, the final visualization can be customized by modifying specific variables in visualization.py.

Once the segzoo command is executed, specifying the segmentation file and any desired optional arguments, the pipeline will commence. It will download all necessary data, run various analyses, and generate the final visualization. Please note that this execution may take some time.

Results

Upon completion of the execution, a new directory will be created (default name: outdir). The following folders will be available:

  • data: Contains the results for all the tools' analyses.
  • results: Contains the processed result tables used in the visualization.
  • plots: Contains the final visualization, which will resemble the example below:

Plot

In the visualization:

  • The y-axis represents the labels of the segmentation for all the heatmaps.
  • The x-axis displays the different results obtained for each of them.
  • The left section showcases the learned parameters during the Segway training.
  • Subsequently, a heatmap is displayed, with each column normalized to the color map's limits.
  • The aggregation tables are presented in the specified order from gene_biotypes.py, potentially containing duplicates.
  • The aggregation results for each label represent the percentage of counts in one component compared to all the idealized genes. Each row's values sum up to 100.
  • The number of genes found for each biotype is provided after the biotype's name.

Using MNE Files

The mne file can be utilized to translate segment labels and track names in the final figure. The file is tab-delimited and should contain three columns in any order:

  • old: The original label or track name displayed when running segzoo with default parameters. Values in this column serve as keys in a Python dictionary or lookup table.
  • new: Replace the old value with the corresponding new value from this column.
  • type: Indicate whether the row should be used to translate a track or a label. This is especially useful when tracks and labels have the same old name.

The file header is mandatory and should include the three fields: old, new, and type.

Please note that only the tracks and labels defined in the mne file will be updated. Unused tracks and labels will remain unchanged. Here is an example of an mne file:

old    new    type
0      Quiescent    label
1      TSS    label
H3K4me3_robust_peaks    H3K4me3    track

Metadata

Release files for segzoo 1.0.13

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

Source distribution (sdist)

Source distribution for segzoo 1.0.13
File Size Uploaded Provenance Actions
segzoo-1.0.13.tar.gz 28.1 kB Without provenance Details for segzoo-1.0.13.tar.gz

Built distribution (wheel)

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

Total release size: 57.7 kB

Release files / segzoo-1.0.13.tar.gz

Download URL segzoo-1.0.13.tar.gz
Size 28.1 kB
Tags Source
SHA-256 checksum
How to use checksums
03903414891982e4d296f253119cf404a525844abdc84b02285923866926a708
BLAKE2b-256 checksum
How to use checksums
644d3bd8a8aae41c84095fc0796668d3896b64ecc9e62f06e3d294760fc372ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.8.18

Release files / segzoo-1.0.13-py3-none-any.whl

Download URL segzoo-1.0.13-py3-none-any.whl
Size 29.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9b47a0e05aabb38523dd77617ba55ca67022e788cdb127aa8d42a382160b5232
BLAKE2b-256 checksum
How to use checksums
56da8ee14afd2cfc2a8cfa16fea298d847a78057038f2a7540e0dacefe3bb838
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.8.18

Security for segzoo 1.0.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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