esl-shuffle
Quick Start
- Command:
esl-shuffle [options] <seqfile>(shuffle sequences) - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/esl-shuffle - Help: See
references/help.mdfor full options (access with-h)
When To Use This Tool
- Use
esl-shufflewhen you need randomized controls derived from existing sequences or alignments. - Default mode shuffles individual sequences;
-Aswitches to multiple-alignment shuffling;-Ggenerates de novo random sequences. - Reach for
-d,-0,-1,-w, or-rwhen you want a specific preservation model for sequence-based controls. - Use
-bor-vin-Amode for bootstrap-like or per-column randomized alignment controls.
Common Patterns
# Shuffle each input sequence while preserving monoresidue composition
esl-shuffle sequences.fa > shuffled.fa
# Preserve diresidue composition exactly
esl-shuffle -d sequences.fa > diresidue.fa
# Bootstrap alignment columns with replacement
esl-shuffle -A -b alignment.sto > bootstrap.sto
# Generate 10 random RNA sequences of length 80
esl-shuffle -G --rna -N 10 -L 80 > random-rna.fa
# Reproducible amino-acid generation
esl-shuffle -G --amino --seed 17 -N 3 -L 50 > random-aa.fa
Recommended Workflow
- Pick the correct mode first: default sequence shuffling,
-Afor alignments, or-Gfor de novo generation. - Choose the randomization scheme that matches the null model you actually need.
- Add
-N,-L, and--seedif you need multiple samples, fixed lengths, or reproducibility. - Force
--informat <fmt>when autodetection is ambiguous. - Validate a few outputs to ensure the preserved statistics match your intended control design.
Guardrails
-hworks;--helpand--versionare rejected by the local executable.- Local
-hadvertises--rnaas the default alphabet in-Gmode, but the installed man page says one of--rna,--dna, or--aminomust be selected. Pass the alphabet explicitly to avoid ambiguity. - Default mode and
-Aneed an input file;-Gdoes not. -band-vonly make sense in-Amode, while-d,-0,-1,-r, and-ware sequence-mode operations.-Ltruncates outputs as well as setting generated-sequence length, so do not enable it casually on aligned data.