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.
- To install Segzoo in a separate environment, open a terminal and execute
mamba create -c bioconda -n segzooenv segzoo -y. - Once the installation is complete, activate the Segzoo environment by running
mamba activate segzooenv. - To test Segzoo, download the segmentation file and the GMTK parameters, and place them in a directory named, for example,
segzoo. - After the files are in place, execute
segzoo segway.bed.gz --parameters params.params. - After approximately 30 minutes, the resulting visualization will be stored in the
outdir/plotsfolder 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 aparams.paramsfile 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).-oor--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).--speciesand--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 anmnefile 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:
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 runningsegzoowith default parameters. Values in this column serve as keys in a Python dictionary or lookup table.new: Replace theoldvalue with the correspondingnewvalue 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 sameoldname.
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.