How do I make a CrossProductAlphabet such as a codon Alphabet? - Cookbook - BioSharp

CrossProductAlphabets are used to represent groups of Symbols as a single Symbol. This is very useful for treating things like codons as single Symbols. Sometimes however, you might want to covert the Symbols back into their component Symbols. The following recipe demonstrates how this can be done.

The Symbols from a CrossProductAlphabet are implementations of the AtomicSymbol interface. The prefix 'Atomic' suggests that the Symbols cannot be divided so one might ask, 'how can an indivisible Symbol be divided into it's component parts?'. The full definition of the AtomicSymbol is that it cannot be divided into a simpler Symbol that is still part of the same Alphabet. The component parts of an AtomicSymbol from a CrossProductAlphabet are not members of the same Alphabet so the 'Atomic' definition still stands. A codon would be from the (DNA x DNA x DNA) Alphabet whereas the components of the codon Symbol are from the DNA alphabet.

Contrast this with the definition of a BasisSymbol. A BasisSymbol can be validly divided into components that are still part of the same Alphabet. In this way a BasisSymbol can be ambiguous. For further discussion of BasisSymbol follow this link.


using System;
using System.Collections.Generic;
 
using BioSharp.Core.Utils;
using BioSharp.Core.Bio.Symbol;
using BioSharp.Core.Bio.Seq;
 
 
namespace Cookbook.Alphabets
{
    class BreakingComponents
    {
        public static void Main(string[] args)
        {
            // Make the 'codon' alphabet
            EquatableList<IAlphabet> l = new EquatableList<IAlphabet>();
            l.Add(DNATools.DNA);
            l.Add(DNATools.DNA);
            l.Add(DNATools.DNA);
 
            IAlphabet alpha = AlphabetManager.GetCrossProductAlphabet(l);
 
            // Get the first symbol in the alphabet
            IEnumerator<ISymbol> iter = ((IFiniteAlphabet)alpha).GetEnumerator();
            iter.MoveNext();
            IAtomicSymbol codon = (IAtomicSymbol)iter.Current;
            Console.Write(codon.Name + " is made of:");
 
            // List out its components
            foreach (ISymbol sym in codon.Symbols)
            {
                Console.Write(" " + sym.Name);
            }
 
            Console.WriteLine();
        }
    }
}

Main Links

Documentation

Source Code

How do I make a CrossProductAlphabet such as a codon Alphabet? - Cookbook - BioSharp