Skip to main content

Simulate

Struct Simulate 

Source
pub struct Simulate {
Show 20 fields pub reference: ReferenceOptions, pub vcf: VcfOptions, pub bed: BedOptions, pub output: OutputPrefixOptions, pub seed: SeedOptions, pub coverage: f64, pub read_length: usize, pub fragment_mean: usize, pub fragment_stddev: usize, pub min_fragment_length: usize, pub single_end: bool, pub adapter_r1: String, pub adapter_r2: String, pub min_error_rate: f64, pub max_error_rate: f64, pub golden_bam: bool, pub golden_vcf: bool, pub simple_names: bool, pub compression: u8, pub threads: usize,
}
Expand description

Simulate sequencing reads from a reference genome.

Generates paired-end or single-end FASTQ files with optional ground-truth BAM and VCF outputs for benchmarking alignment and variant calling pipelines. Variants are applied from an input VCF to construct haplotype sequences, and reads are sampled with a position-dependent Illumina error model.

Fields§

§reference: ReferenceOptions§vcf: VcfOptions§bed: BedOptions§output: OutputPrefixOptions§seed: SeedOptions§coverage: f64

Mean sequencing coverage depth.

§read_length: usize

Length of each read in bases.

§fragment_mean: usize

Mean insert size (outer distance between read pair ends).

§fragment_stddev: usize

Standard deviation of the insert size distribution.

§min_fragment_length: usize

Minimum fragment length in bases; sampled lengths below this are clamped up. Fragments shorter than the read length are padded with adapter sequence. Must be at least 1.

§single_end: bool

Generate single-end reads instead of paired-end.

§adapter_r1: String

Adapter sequence appended to read 1 when the fragment is shorter than the read length.

§adapter_r2: String

Adapter sequence appended to read 2 when the fragment is shorter than the read length.

§min_error_rate: f64

Minimum per-base error rate, applied at the start of reads.

§max_error_rate: f64

Maximum per-base error rate, applied at the end of reads.

§golden_bam: bool

Write a ground-truth BAM file with correct alignments.

§golden_vcf: bool

Write a ground-truth VCF annotated with simulated coverage.

§simple_names: bool

Use simple read names (holodeck:N) instead of encoding truth coordinates in the read name.

§compression: u8

BGZF compression level (0-12). Lower values are faster with larger output files; higher values produce smaller files at the cost of speed. Level 0 is no compression; 1 is fastest; 12 is maximum compression.

§threads: usize

Number of threads for parallel BGZF output compression.

Trait Implementations§

Source§

impl Args for Simulate

Source§

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments
Source§

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut Read more
Source§

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut Read more
Source§

impl Command for Simulate

Source§

fn execute(&self) -> Result<()>

Execute the command. Read more
Source§

impl CommandFactory for Simulate

Source§

fn command<'b>() -> Command

Build a Command that can instantiate Self. Read more
Source§

fn command_for_update<'b>() -> Command

Build a Command that can update self. Read more
Source§

impl Debug for Simulate

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl FromArgMatches for Simulate

Source§

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed. Read more
Source§

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed. Read more
Source§

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.
Source§

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.
Source§

impl Parser for Simulate

Source§

fn parse() -> Self

Parse from std::env::args_os(), exit on error.
Source§

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.
Source§

fn parse_from<I, T>(itr: I) -> Self
where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.
Source§

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>
where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.
Source§

fn update_from<I, T>(&mut self, itr: I)
where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error. Read more
Source§

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>
where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V