How yazbraimah/nywws works
NYWWS is a Snakemake pipeline for identifying and quantifying SARS-CoV-2 variants in New York wastewater BAM samples using Freyja. Users generate a BAM sample manifest, configure inputs, and run the workflow; Freyja variant results can be parsed into sample-level abundances. The repository also includes a results-summary script and a separate deprecated mutation-based deconvolution tool. Workflow internals are not excerpted, so links beyond the documented execution path are omitted or marked unverified.
Main entry points: Snakefile Snakemake workflow · deconvolveVariants.py Mutation deconvolution · make_bam_json_samples.py Manifest generator · samples_bam.json BAM manifest
Components 15
Inputs and configuration
- BAM samples
- Manifest generator
scripts/make_bam_json_samples.py - BAM manifest
samples_bam.json - Pipeline config
config.yml
Variant surveillance
- Snakemake workflow
Snakefile - Freyja analysis
- Reference assets
reference
Results handling
- Demix results
- Demix parser
scripts/parse_demix.py - Results summary
scripts/results_summary_outputs.R
Deprecated analysis
- Variant calls
- Variant definitions
- Mutation deconvolution
deprecated/scripts/deconvolveVariants.py - Legacy reports
Other components
- Pipeline user
Connections 16
- Pipeline user → BAM samples: provides BAMs
README.md - Pipeline user → Manifest generator: runs generator
README.md - Manifest generator → BAM manifest: writes manifest
scripts/make_bam_json_samples.py - Pipeline user → Pipeline config: configures paths
README.md - Pipeline user → Snakemake workflow: runs pipeline
README.md - Snakemake workflow → Freyja analysis: uses for quantification
README.md - Snakemake workflow → BAM manifest: reads samples
- Snakemake workflow → Pipeline config: reads settings
- Snakemake workflow → Reference assets: may use references
- Freyja analysis → Demix results: produces results
- Pipeline user → Demix parser: parses results
scripts/parse_demix.py - Demix results → Demix parser: reads demix file
scripts/parse_demix.py - Pipeline user → Results summary: generates summary
- Variant calls → Mutation deconvolution: reads calls
deprecated/scripts/deconvolveVariants.py - Variant definitions → Mutation deconvolution: loads definitions
deprecated/scripts/deconvolveVariants.py - Mutation deconvolution → Legacy reports: writes reports
deprecated/scripts/deconvolveVariants.py