The MAC Service encodes MACs from compressed allele lists (CAL) and GL strings. The service can be called programmatically or with this user interface. For more information on calling it programmatically please contact email@example.com.
The interface has four functions. Encoding MACS; finding MACs without encoding the list if there isn’t a MAC assigned yet; decoding, or finding, the allele list for a MAC and expanding the allele list for a MAC into all possible alleles.
Definitions and instructions for using these functions are provided below.
Questions? Please contact firstname.lastname@example.org.
Look up, Decode, and Expand functions are available without logging in. You must provide an email address and login if you would like to Encode a MAC.
Look up an allele list to find a MAC without encoding a new MAC
Important note – this function does not test for allele validity. It simply decodes the MAC with the locus and allele-family provided.
CAL (Compressed Allele List) An allele list short-hand. Used frequently when creating MACs. The locus is used only once.
Decode Provides the allele list for a MAC at the given locus and allele-family. This function does not test for allele validity.
Decode Result The results of a MAC designation decode will be displayed here.
Encode Use this button to find the MAC designation for a CAL or GL string. If a MAC has not yet been assigned to the list this action will automatically create one.
Encode Input Enter a CAL or GL string here to look up or encode a MAC. A number will be added to the request to connect it to the results.
Encode Result The results of a CAL or GL string look up or encode will be displayed in this box. The number listed here connects these results to the number of the request in the Encode Input box.
Expand Provides all of the alleles that could be represented by the MAC designation in the database version selected. Full allele names are shown.
Expand Result The results of a MAC designation expand will be displayed here.
GL string (Genotype list string) A machine readable method for transmitting allelic typing results that is an improvement over MACs. In addition to allowing allele ambiguities to be represented it allows allele pairing information to be retained. The full allele name with locus must be used. GL strings can be used with Gene Systems other than HLA.
Read more here: http://www.ncbi.nlm.nih.gov/pmc/articles/PMC3715123/
|Allele 1||Allele 2|
|HLA-B*57:17+ HLA-B*40:01/ HLA-B*40:07/ HLA-B*40:10/ HLA-B*40:16| HLA-B*57:57+ HLA-B*40:09/ HLA-B*40:10|
IMGT HLA DB Release The quarterly release of new HLA allele names. The most recent 5 database releases are available for creating MACs. The selection chosen in this box applies to all functions available on the MAC Service UI. More information can be found here: https://www.ebi.ac.uk/ipd/imgt/hla/.
Look up Use this button to find the MAC designation for a CAL or GL string. A MAC will not be automatically created if it doesn’t exist.
MAC (Multiple Allele Code) A combination of letters assigned to a list of alleles from an HLA typing result. The MAC system is used to compress large lists of alleles generated from HLA typing into a smaller size for display on computers and paper.
MAC designation An allele code used at a specific locus and allele-family.
MAC designation look up Enter a MAC designation here to see its allele list.
Deleted or renamed alleles
If you receive an “Invalid allele” error message for an allele you know is correct check your database version. The allele can only be used in a database version in which it was not deleted or renamed. Deleted or renamed alleles are allowed to be used in the creation of new MACs for 1 year after the database release they were renamed in.
Bad allele string The characters provided are not a properly formatted GL String or MAC.
Source string may not be null Typically, this means there’s a blank line.
Invalid allele “[Bad allele]’ at [##] The characters listed are not recognized as a valid allele name.
Incorrect format detected The MAC entered is not recognized.
Returns MAC designation that was used as an input If a the letters are not a valid MAC the MAC designation that was entered in the look up will appear in the Decode Result box.