codonrs 0.2.5

Calculate relative synonymous codon usage for coding DNA sequences in a fasta file
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

use clap::Parser;
use simple_tqdm::ParTqdm;
use std::collections::HashMap;
use rayon::prelude::*;
use codonrs::analysis;

/// Command-line arguments using Clap
#[derive(Parser)]
#[command(name = "codonrs")]
#[command(version = "0.2.4")]
#[command(about = "Analyze codon usage bias in DNA sequences", long_about = None)]
struct Cli {
    /// Input coding DNA sequence file (FASTA)
    #[arg(short = 'i', long = "input")]
    input_file: String,

    /// Output filename prefix for results
    #[arg(short = 'o', long = "output")]
    output_file: String,

    /// NCBI translation table ID
    #[arg(short = 't', long = "table", default_value_t = 1)]
    translation_table: u8,

    /// Compute and output Z-score for RSCU values compared to whole-genome mean for each codon
    #[arg(short = 'z', long = "zscore", default_value_t = false)]
    compute_zscore: bool,
}

fn main() {
    let args = Cli::parse();

    let code = analysis::genetic_code_from_id(&args.translation_table);

    match analysis::read_sequences_from_fasta(&args.input_file) {
        Ok(sequences) => {
            println!("Computing RSCU values for sequences in {}...", &args.input_file);
            // Process all sequences in parallel
            let results: Vec<(String, HashMap<String, usize>, HashMap<String, usize>, HashMap<String, f64>)> =
            analysis::count_codons_for_sequences(&sequences)
                .into_par_iter()
                .tqdm()
                .filter_map(|(seq_name, codon_counts)| {
                    if codon_counts.is_empty() {
                        eprintln!(
                            "Warning: Skipping sequence '{}' (not a multiple of 3)",
                            seq_name
                        );
                        None
                    } else {
                        // Retrieve the corresponding sequence from the original vector
                        let sequence = sequences
                            .iter()
                            .find(|(name, _)| name.as_str() == seq_name.as_str())
                            .map(|(_, seq)| seq)
                            .expect("Sequence not found");

                        // Compute additional metrics for this sequence.
                        let amino_acid_counts = analysis::count_amino_acids(sequence, &code);
                        let rscu_values = analysis::compute_rscu(&codon_counts, &code);

                        Some((seq_name, codon_counts, amino_acid_counts, rscu_values))
                    }
                })
                .collect();

            // Explicitly annotate the types for output vectors.
            let mut codon_counts_list: Vec<(String, HashMap<String, usize>)> = Vec::new();
            let mut amino_acid_counts_list: Vec<(String, HashMap<String, usize>)> = Vec::new();
            let mut rscu_results: Vec<(String, HashMap<String, f64>)> = Vec::new();

            // Split the results into separate vectors for CSV output.
            for (seq_name, codon_counts, amino_acid_counts, rscu_values) in results.into_iter() {
                codon_counts_list.push((seq_name.clone(), codon_counts));
                amino_acid_counts_list.push((seq_name.clone(), amino_acid_counts));
                rscu_results.push((seq_name, rscu_values));
            }

            // Write Codon & Amino Acid Counts to CSV
            match analysis::write_codon_counts_to_csv(&args.output_file, &codon_counts_list) {
                Ok(()) => print!("Codon counts written to {}_codon.csv\n", &args.output_file),
                Err(err) => {
                    eprintln!("Error writing codon counts to CSV: {}", err);
                    std::process::exit(1);
                }
            };

            // Write Codon & Amino Acid Counts to CSV
            match analysis::write_amino_acid_counts_to_csv(&args.output_file, &amino_acid_counts_list) {
                Ok(()) => print!("Amino acid counts written to {}_amino_acids.csv\n", &args.output_file),
                Err(err) => {
                    eprintln!("Error amino acid counts to CSV: {}", err);
                    std::process::exit(1);
                }
            };

            // Write RSCU values to a single CSV file
            let rscu_filename = format!("{}_rscu.csv", args.output_file);
            analysis::write_rscu_to_csv(&rscu_filename, &rscu_results).unwrap();

            if args.compute_zscore {
                println!("\nComputing and saving RSCU Z-scores...");

                // Compute RSCU Z-scores
                let mean_rscu = analysis::compute_mean_rscu(&rscu_results);
                let std_rscu = analysis::compute_std_rscu(&rscu_results, &mean_rscu);
                let rscu_z_scores = analysis::compute_rscu_z_scores(&rscu_results, &mean_rscu, &std_rscu);

                // Write RSCU Z-scores to a CSV file
                let z_score_filename = format!("{}_rscu_z_scores.csv", args.output_file);
                analysis::write_z_scores_to_csv(&z_score_filename, &rscu_z_scores).unwrap();

                println!("RSCU Z-scores saved to {}\n", z_score_filename);
            }
        }
        Err(e) => eprintln!("Error reading file: {}", e),
    }
}