Skip to main content

SuSiE Fine-Mapping Workflow

Pipeline VersionDate UpdatedDocumentation AuthorQuestions or Feedback
aou_9.1.0August, 2026WARP PipelinesFile an issue

Introduction to the SuSiE Fine-Mapping workflow

susieR_workflow.wdl performs cis-window fine-mapping using SuSiE from TensorQTL outputs and dosage matrices.

Given an InputMappingTsv (one row per ancestry) and a target Ancestry, the workflow first looks up the ancestry-specific genotype dosage, covariate, sample list, phenotype BED, and TensorQTL permutation file paths, subsets those phenotype/genotype inputs for a target phenotype ID, then runs an R-based SuSiE script to produce parquet outputs including credible set summaries and full fine-mapping tables.

Inputs

Input descriptions

Input variable nameDescriptionType
InputMappingTsvTab-separated file, one row per ancestry, providing gs:// paths for GenotypeDosage, GenotypeDosagei, PhenotypePCsOut, PlinkAF, QtlCovariates, Sample_list, VCF, cis_qtl, genotype_pcs, pgen, phenotype_bed, and psam, keyed by a mapping_inputs_id ancestry code (AFR, AMR, COMB, EUR, SAS, EAS, MID).File
AncestryAncestry code used to select the row of InputMappingTsv to use for this run.String
CisDistanceCis-window distance parameter.Int
susie_rscriptSuSiE runner script path; see 20251210_rfast_removed_susie.R in warp-tools.File
memoryRuntime memory (GB).Int
NumPremptRuntime preemptible count.Int
OutputPrefixGeneral output prefix.String
PhenotypeIDTarget phenotype ID for subsetting and fine-mapping.String

Outputs

Output variable nameFilename, if applicableOutput format and description
SusieParquet<PhenotypeID>.parquetPrimary SuSiE fine-mapping parquet output.
SusielbfParquet<PhenotypeID>.lbf_variable.parquetVariant-level log-Bayes-factor parquet output.
FullSusieParquet<PhenotypeID>.full_susie.parquetExpanded full SuSiE results parquet.
SubsetBed<PhenotypeID>.bed.bgzPhenotype-specific subset bed used during run.
SubsetDosages<PhenotypeID>.dose.tsv.gzDosage matrix subset for selected phenotype interval.
SubsetDosagesIndex<PhenotypeID>.dose.tsv.gz.tbiTabix index for SubsetDosages.

Workflow and WDL

Versioning

All susieR_workflow releases are documented in the changelog.

Feedback

Please help us make our tools better by filing an issue in WARP; we welcome pipeline-related suggestions or questions.