SigProfilerAssignment 0.2.0__tar.gz → 0.2.2__tar.gz

{sigprofilerassignment-0.2.0/SigProfilerAssignment.egg-info → sigprofilerassignment-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: SigProfilerAssignment
-Version: 0.2.0
+Version: 0.2.2
 Summary: Mutational signatures attribution and decomposition tool
 Home-page: https://github.com/AlexandrovLab/SigProfilerAssignment.git
 Author: Raviteja Vangara
@@ -17,7 +17,7 @@ Requires-Dist: sigProfilerPlotting>=1.4.0
 Requires-Dist: reportlab>=3.5.42
 Requires-Dist: pypdf>=5.0.0
 Requires-Dist: alive_progress>=2.4.1
-Requires-Dist: PyMuPDF>=1.21.0
+Requires-Dist: pdf2image>=1.16.0
 Provides-Extra: tests
 Requires-Dist: pytest; extra == "tests"
 Dynamic: author
@@ -26,6 +26,7 @@ Dynamic: description
 Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: license
+Dynamic: license-file
 Dynamic: provides-extra
 Dynamic: requires-dist
 Dynamic: requires-python
@@ -67,6 +68,12 @@ $ python
 from SigProfilerMatrixGenerator import install as genInstall
 genInstall.install('GRCh37')
 ```
+
+If you plan to use `sample_reconstruction_plots='png'` or `'both'`, the external `poppler` binary is required. You can install it using one of the following commands:
+
+- For Conda-based environments:
+  `conda install -c conda-forge poppler`
+
 ## <a name="running"></a> Running
 
 Assignment of known mutational signatures to individual samples is performed using the `cosmic_fit` function. Input samples are provided using the `samples` parameter in the form of mutation calling files (VCFs, MAFs, or simple text files), segmentation files or mutational matrices. COSMIC mutational signatures v3.4 are used as the default reference signatures, although previous COSMIC versions and custom signature databases are also supported using the `cosmic_version` and `signature_database` parameters. Results will be found in the folder specified in the `output` parameter.
@@ -99,7 +106,7 @@ Analyze.cosmic_fit(samples, output, input_type="matrix", context_type="96",
 | export_probabilities | Boolean | Defines if the probability matrix per mutational context for all samples is created. The default value is True. |
 | export_probabilities_per_mutation | Boolean | Defines if the probability matrices per mutation for all samples are created. Only available when `input_type` is "vcf". The default value is False. |
 | make_plots | Boolean | Toggle on and off for making and saving plots. The default value is True. |
-| sample_reconstruction_plots | String | Select the output format for sample reconstruction plots. Valid inputs are {'pdf', 'png', 'both', None}. The default value is None. |
+| sample_reconstruction_plots | String | Select the output format for sample reconstruction plots. Valid inputs are {'pdf', 'png', 'both', 'none'}. The default value is 'none'. If set to 'png' or 'both', the external binary `poppler` must be installed. Install via `conda install -c conda-forge poppler` or `brew install poppler` on macOS. |
 | verbose | Boolean | Prints detailed statements. The default value is False. |
 | volume | String | Path to SigProfilerAssignment volumes. Used for Docker/Singularity. Environmental variable "SIGPROFILERASSIGNMENT_VOLUME" takes precedence. Default value is None. |
 

{sigprofilerassignment-0.2.0 → sigprofilerassignment-0.2.2}/README.md

@@ -34,6 +34,12 @@ $ python
 from SigProfilerMatrixGenerator import install as genInstall
 genInstall.install('GRCh37')
 ```
+
+If you plan to use `sample_reconstruction_plots='png'` or `'both'`, the external `poppler` binary is required. You can install it using one of the following commands:
+
+- For Conda-based environments:
+  `conda install -c conda-forge poppler`
+
 ## <a name="running"></a> Running
 
 Assignment of known mutational signatures to individual samples is performed using the `cosmic_fit` function. Input samples are provided using the `samples` parameter in the form of mutation calling files (VCFs, MAFs, or simple text files), segmentation files or mutational matrices. COSMIC mutational signatures v3.4 are used as the default reference signatures, although previous COSMIC versions and custom signature databases are also supported using the `cosmic_version` and `signature_database` parameters. Results will be found in the folder specified in the `output` parameter.
@@ -66,7 +72,7 @@ Analyze.cosmic_fit(samples, output, input_type="matrix", context_type="96",
 | export_probabilities | Boolean | Defines if the probability matrix per mutational context for all samples is created. The default value is True. |
 | export_probabilities_per_mutation | Boolean | Defines if the probability matrices per mutation for all samples are created. Only available when `input_type` is "vcf". The default value is False. |
 | make_plots | Boolean | Toggle on and off for making and saving plots. The default value is True. |
-| sample_reconstruction_plots | String | Select the output format for sample reconstruction plots. Valid inputs are {'pdf', 'png', 'both', None}. The default value is None. |
+| sample_reconstruction_plots | String | Select the output format for sample reconstruction plots. Valid inputs are {'pdf', 'png', 'both', 'none'}. The default value is 'none'. If set to 'png' or 'both', the external binary `poppler` must be installed. Install via `conda install -c conda-forge poppler` or `brew install poppler` on macOS. |
 | verbose | Boolean | Prints detailed statements. The default value is False. |
 | volume | String | Path to SigProfilerAssignment volumes. Used for Docker/Singularity. Environmental variable "SIGPROFILERASSIGNMENT_VOLUME" takes precedence. Default value is None. |
 

{sigprofilerassignment-0.2.0 → sigprofilerassignment-0.2.2}/SigProfilerAssignment/SigProfilerAssignment_CLI.py

@@ -13,7 +13,7 @@ def main_function():
 
     if len(sys.argv) < 2 or sys.argv[1].lower() not in commands:
         print_usage(commands)
-        sys.exit(1)
+        return
 
     command = sys.argv[1].lower()
     args = sys.argv[2:]

{sigprofilerassignment-0.2.0 → sigprofilerassignment-0.2.2}/SigProfilerAssignment/controllers/cli_controller.py

@@ -135,6 +135,19 @@ def parse_arguments_common(args: List[str], description: str) -> argparse.Namesp
         default=None,
         help="User specified directory for saving/loading template files. Note: The environment variable SIGPROFILERASSIGNMENT_VOLUME takes precedence over this parameter.",
     )
+    parser.add_argument(
+        "--sample_reconstruction_plots",
+        type=str.lower,
+        choices=["none", "pdf", "both", "png"],
+        default="none",
+        help=(
+            "Output format for sample reconstruction plots. "
+            "Options: 'none' (default, disables plotting), "
+            "'pdf' (generate only PDF), "
+            "'both' (PDF + PNG), or "
+            "'png' (PNG only, PDF removed)."
+        )
+    )
 
     return parser.parse_args(args)
 
@@ -226,5 +239,5 @@ class CliController:
             context_type=parsed_args.context_type,
             export_probabilities=parsed_args.export_probabilities,
             export_probabilities_per_mutation=parsed_args.export_probabilities_per_mutation,
-            sample_reconstruction_plots=False,
+            sample_reconstruction_plots=parsed_args.sample_reconstruction_plots,
         )

{sigprofilerassignment-0.2.0 → sigprofilerassignment-0.2.2}/SigProfilerAssignment/decomposition.py

@@ -25,7 +25,7 @@ from sigProfilerPlotting import sigProfilerPlotting as sigPlot
 import sigProfilerPlotting
 import os, sys
 from pypdf import PdfWriter, PdfReader
-import fitz
+from pdf2image import convert_from_path
 import time
 from pathlib import Path
 
@@ -60,21 +60,32 @@ def get_storage_dir(volume=None):
 
 
 def convert_PDF_to_PNG(input_file_name, output_directory, page_names):
-    pdf_doc = fitz.open(input_file_name)
-    zoom = 3
-    magnify = fitz.Matrix(zoom, zoom)
+    """
+    Converts each page of the PDF to a PNG image with names from page_names.
+    Requires the 'pdf2image' Python package and the 'poppler' binary.
+
+    Parameters:
+    - input_file_name (str): Path to the input PDF file.
+    - output_directory (str): Directory where PNGs will be saved.
+    - page_names (List[str]): List of names (without extensions) to name PNGs.
+    """
+    if not os.path.exists(output_directory):
+        os.makedirs(output_directory)
+
+    # Convert PDF pages to PIL images
+    try:
+        images = convert_from_path(input_file_name, dpi=300)
+    except Exception as e:
+        raise RuntimeError(f"Error converting PDF to images: {e}")
 
-    if pdf_doc.page_count != len(page_names):
+    if len(images) != len(page_names):
         raise ValueError(
             "Error: The number of samples and number of plots do not match."
         )
-    if not os.path.exists(output_directory):
-        os.makedirs(output_directory)
 
-    for sample_name, page in zip(page_names, pdf_doc):
-        pix = page.get_pixmap(matrix=magnify)
-        out_file_name = os.path.join(output_directory, sample_name + ".png")
-        pix.save(out_file_name)
+    for image, sample_name in zip(images, page_names):
+        output_path = os.path.join(output_directory, sample_name + ".png")
+        image.save(output_path, "PNG")
 
 
 # Create sample reconstruction plots
@@ -263,6 +274,7 @@ def spa_analyze(
         genome_build = A string. The reference genome build. List of supported genomes: "GRCh37", "GRCh38", "mm9", "mm10" and "rn6". The default value is "GRCh37". If the selected genome is not in the supported list, the default genome will be used.
         verbose = Boolean. Prints statements. Default value is False.
         exome = Boolean. Defines if the exome renormalized signatures will be used. The default value is False.
+        sample_reconstruction_plots (str): Select output format for sample reconstruction plots. Valid options are {'pdf', 'png', 'both', 'none'}. Default is 'none'.
 
     Values:
         The files below will be generated in the output folder.
@@ -1061,7 +1073,8 @@ def spa_analyze(
     recon_output_types = ["png", "pdf", "both"]
     # Generate sample reconstruction plots
     if (
-        sample_reconstruction_plots in recon_output_types
+        isinstance(sample_reconstruction_plots, str)
+        and sample_reconstruction_plots.lower() in recon_output_types
         and mutation_type == "96"
         and signature_database is None
     ):

sigprofilerassignment-0.2.2/SigProfilerAssignment/version.py

@@ -0,0 +1,8 @@
+
+# THIS FILE IS GENERATED FROM SigProfilerAssignment SETUP.PY
+short_version = '0.2.2'
+version = '0.2.2'
+Update = 'v0.2.2: Fix bug in CLI returning non-zero exit code'
+
+    
+    

{sigprofilerassignment-0.2.0 → sigprofilerassignment-0.2.2/SigProfilerAssignment.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: SigProfilerAssignment
-Version: 0.2.0
+Version: 0.2.2
 Summary: Mutational signatures attribution and decomposition tool
 Home-page: https://github.com/AlexandrovLab/SigProfilerAssignment.git
 Author: Raviteja Vangara
@@ -17,7 +17,7 @@ Requires-Dist: sigProfilerPlotting>=1.4.0
 Requires-Dist: reportlab>=3.5.42
 Requires-Dist: pypdf>=5.0.0
 Requires-Dist: alive_progress>=2.4.1
-Requires-Dist: PyMuPDF>=1.21.0
+Requires-Dist: pdf2image>=1.16.0
 Provides-Extra: tests
 Requires-Dist: pytest; extra == "tests"
 Dynamic: author
@@ -26,6 +26,7 @@ Dynamic: description
 Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: license
+Dynamic: license-file
 Dynamic: provides-extra
 Dynamic: requires-dist
 Dynamic: requires-python
@@ -67,6 +68,12 @@ $ python
 from SigProfilerMatrixGenerator import install as genInstall
 genInstall.install('GRCh37')
 ```
+
+If you plan to use `sample_reconstruction_plots='png'` or `'both'`, the external `poppler` binary is required. You can install it using one of the following commands:
+
+- For Conda-based environments:
+  `conda install -c conda-forge poppler`
+
 ## <a name="running"></a> Running
 
 Assignment of known mutational signatures to individual samples is performed using the `cosmic_fit` function. Input samples are provided using the `samples` parameter in the form of mutation calling files (VCFs, MAFs, or simple text files), segmentation files or mutational matrices. COSMIC mutational signatures v3.4 are used as the default reference signatures, although previous COSMIC versions and custom signature databases are also supported using the `cosmic_version` and `signature_database` parameters. Results will be found in the folder specified in the `output` parameter.
@@ -99,7 +106,7 @@ Analyze.cosmic_fit(samples, output, input_type="matrix", context_type="96",
 | export_probabilities | Boolean | Defines if the probability matrix per mutational context for all samples is created. The default value is True. |
 | export_probabilities_per_mutation | Boolean | Defines if the probability matrices per mutation for all samples are created. Only available when `input_type` is "vcf". The default value is False. |
 | make_plots | Boolean | Toggle on and off for making and saving plots. The default value is True. |
-| sample_reconstruction_plots | String | Select the output format for sample reconstruction plots. Valid inputs are {'pdf', 'png', 'both', None}. The default value is None. |
+| sample_reconstruction_plots | String | Select the output format for sample reconstruction plots. Valid inputs are {'pdf', 'png', 'both', 'none'}. The default value is 'none'. If set to 'png' or 'both', the external binary `poppler` must be installed. Install via `conda install -c conda-forge poppler` or `brew install poppler` on macOS. |
 | verbose | Boolean | Prints detailed statements. The default value is False. |
 | volume | String | Path to SigProfilerAssignment volumes. Used for Docker/Singularity. Environmental variable "SIGPROFILERASSIGNMENT_VOLUME" takes precedence. Default value is None. |
 

{sigprofilerassignment-0.2.0 → sigprofilerassignment-0.2.2}/SigProfilerAssignment.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 LICENSE.txt
 MANIFEST.in
 README.md
+pyproject.toml
 setup.py
 SigProfilerAssignment/Analyzer.py
 SigProfilerAssignment/SigProfilerAssignment_CLI.py

{sigprofilerassignment-0.2.0 → sigprofilerassignment-0.2.2}/SigProfilerAssignment.egg-info/requires.txt

@@ -6,7 +6,7 @@ sigProfilerPlotting>=1.4.0
 reportlab>=3.5.42
 pypdf>=5.0.0
 alive_progress>=2.4.1
-PyMuPDF>=1.21.0
+pdf2image>=1.16.0
 
 [tests]
 pytest

sigprofilerassignment-0.2.2/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=61", "wheel", "build"]
+build-backend = "setuptools.build_meta"

{sigprofilerassignment-0.2.0 → sigprofilerassignment-0.2.2}/setup.py

@@ -6,7 +6,7 @@ import os
 if os.path.exists("dist"):
     shutil.rmtree("dist")
 
-VERSION = "0.2.0"
+VERSION = "0.2.2"
 
 
 def write_version_py(filename="SigProfilerAssignment/version.py"):
@@ -15,7 +15,7 @@ def write_version_py(filename="SigProfilerAssignment/version.py"):
 # THIS FILE IS GENERATED FROM SigProfilerAssignment SETUP.PY
 short_version = '%(version)s'
 version = '%(version)s'
-Update = 'v0.2.0: Require Pandas and Numpy >= 2.0.0 and Python >= 3.9'
+Update = 'v0.2.2: Fix bug in CLI returning non-zero exit code'
 
     
     """
@@ -41,7 +41,8 @@ requirements = [
     "reportlab>=3.5.42",
     "pypdf>=5.0.0",
     "alive_progress>=2.4.1",
-    "PyMuPDF>=1.21.0",  # required for package "fitz"
+    "pdf2image>=1.16.0",  # replacing PyMuPDF
+    # Note: 'poppler' is required as a system dependency for pdf2image
 ]
 
 write_version_py()

{sigprofilerassignment-0.2.0 → sigprofilerassignment-0.2.2}/tests/test_cli.py

@@ -42,6 +42,8 @@ def test_argument_parsing():
             "True",
             "--exome",
             "True",
+            "--sample_reconstruction_plots",
+            "png",
         ],
         "Test argument parsing",
     )
@@ -56,6 +58,7 @@ def test_argument_parsing():
     assert args.export_probabilities == False
     assert args.export_probabilities_per_mutation == True
     assert args.exome == True
+    assert args.sample_reconstruction_plots == "png"
 
 
 def test_boolean_conversion():

sigprofilerassignment-0.2.0/SigProfilerAssignment/version.py

@@ -1,8 +0,0 @@
-
-# THIS FILE IS GENERATED FROM SigProfilerAssignment SETUP.PY
-short_version = '0.2.0'
-version = '0.2.0'
-Update = 'v0.2.0: Require Pandas and Numpy >= 2.0.0 and Python >= 3.9'
-
-    
-