9 unstable releases (3 breaking)

0.4.0 Feb 16, 2024
0.3.0 Oct 30, 2023
0.2.5 Aug 31, 2023
0.2.4 Jul 14, 2023
0.1.0 Jun 7, 2023

#96 in Biology

25 downloads per month

MIT/Apache

120KB
2K SLoC

Align-cli

A tool to help your manual mass spec inspection workflow. With alignments, isobaric sequences, and other mass spec information.

How to install

  1. Pick the correct binary for your machine in the release
  2. Place it in a nice location on your machine
  3. If you are using a unix-based operating system (linux or mac) do not forget to chmod +x <binary>
  4. Open a terminal and use the tool
  5. If you want you can add the location of the binary to your path, this makes it so that you can use it across your whole machine

More elaborate instructions for Windows (installing another program)

How to install from source

  1. First install Rust.
  2. Install the tool using cargo (part of Rust) cargo install align-cli
  3. Use!

Quick usage overview

  1. Pairwise alignment
    • Align two sequences align <A> <B>, this shows the best alignment for these two sequences.
    • Align a single peptide to a database align <A> --file <FILE.fasta>.
    • Align a single peptide to the IMGT database align <A> --imgt.
    • Align a single peptide to the V-J-C domains in the IMGT database align <A> --domain.
    • Align a single peptide to a specific gene in IMGT database align <A> --specific-gene <GENE>.
  2. Get information about a single sequence align <sequence>, this shows many basic properties (like mass) and generates isobaric sequences to this sequence.
    • Use --fixed <MODIFICATIONS> and --variable <MODIFICATIONS> to fine tune the generated isobaric sequences.
  3. Get information about a single modification align --modification <MODIFICATION>.
    • Use a full name to list its properties eg --modification Oxidation
    • Use a formula to find all modifications with that formula eg --modification Formula:O
    • Use a mass to find all modifications with that mass eg --modification +15.995
  4. List IMGT genes align --imgt or align --specific-gene <GENE>.

For all additional options and more description use align --help.

Example usage

example of calling with pairwise alignment example of calling with complex alignment example of calling with single sequence example of calling with named modification example of calling with mass modification example of calling with mass modification

Here are the used commands for reference

> align AKTNLSHLGYGMDV AKEGGLHSIGYGMDV
> align AKTNLNHLGY BHJGYGMDV --local --context
> align GAI
> align --modification 23 --tolerance 0.5da
> align -m Oxidation
> align --species human --domain -N 1 -n 70 EVQLVESGGGLVQPGGSLRLSCAASGFNIKDTYIHWVRQAPGKGLEWVARIYPTNGYTRYADSVKGRFTISADTSKNTAYLQMNSLRAEDTAVYYCSRWGGDGFYAMDYWGQGTLVTVSSASTKGPSVFPLAPSSKSTSGGTAALGCLVKDYFPEPVTVSWNSGALTSGVHTFPAVLQSSGLYSLSSVVTVPSSSLGTQTYICNVNHKPSNTKVDKKVEPKSCDKTHTCPPCPAPELLGGPSVFLFPPKPKDTLMISRTPEVTCVVVDVSHEDPEVKFNWYVDGVEVHNAKTKPREEQYNSTYRVVSVLTVLHQDWLNGKEYKCKVSNKALPAPIEKTISKAKGQPREPQVYTLPPSREEMTKNQVSLTCLVKGFYPSDIAVEWESNGQPENNYKTTPPVLDSDGSFFLYSKLTVDKSRWQQGNVFSCSVMHEALHNHYTQKSLSLSPGK

Dependencies

~17–29MB
~251K SLoC