Encode MAC

Encode - assigns a new MAC if one has not been assigned.

Lookup - does not assign a new MAC.

Nothing has been entered. Please enter a CAL and (or) GL string.

Example CAL: DRB1*13:02/13:36/13:67/13:96/13:109

Example GL String: HLA-DRB5*01:01/HLA-DRB5*02:02/HLA-DRB5*02:04

Encode vs Lookup

Encode

Use encode to create a MAC designation for a CAL or GL string. Encode assigns a new MAC if one has not been assigned. This function will also activate any MAC that already exists.

Example

CAL: DRB1^*13:02/13:36/13:67/13:96/13:109 = HLA-DRB1^*13:AKBAR

CAL: DPB1^*04:02/105:01/665:01 = HLA-DPB1^*04:BCREN

GL String: HLA-DRB5^*01:01/HLA-DRB5^*02:02/HLA-DRB5^* 02:04 = HLA-DRB5^*02:BZZ

GL String: HLA-DPB1^* 04:01/HLA-DPB1^*126:01 = HLA-DPB1^*04:HJMR

Lookup

Use lookup to find the MAC designation for a CAL or GL string. Look up does not assign a new MAC. If a MAC has not yet been assigned to the list, various errors will populate. This function tests for allele validity.

Example

CAL: DRB1^*13:02/13:36/13:67/13:96/13:109

CAL: DPB1^*04:02/105:01/665:01

GL String: HLA-DRB5^*01:01/HLA-DRB5^*02:02/HLA-DRB5^*02:04

GL String: HLA-DPB1^*04:01/HLA-DPB1^*126:01

Decode MAC

Decode - Shows the list for a MAC(s) at a locus and allele-family.
(This feature does not test allele validity)

Expand - Shows all possible alleles that are inferred by the MAC(s).
(This feature shows tests for allele validity)

Nothing has been entered. Please enter a MAC or MAC Designation.

Example MAC: YETY

Example MAC Designation: B^*08:YETY

Example MAC Designations: B^*08:YETY, C^*01:BJZ

Decode vs Expand

Decode

Use this function to see exactly what is represented by a MAC designation.

Decode does not check for allele validity.

Provides the numerical list associated with a MAC, or the allele list for a MAC Designation at the given locus and allele-family. This function does not test for allele validity. Decode results will not change with different IMGT HLA DB Release versions.

Decode a single MAC designation or multiple MAC designations.

Example

B^08:YETY*

B^*08:01/B^*08:19N/B^*08:109

B^08:YETY, C^01:BJZ

B^*08:01/B^*08:19N/B^*08:109

C^*01:02/C^*01:03/C^*01:04/C^*01:05/C^*01:06

Expand

Use expand to see all alleles that could be represented by a MAC Designation. This function tests for allele validity.

Provides all of the alleles that could be represented by the MAC Designation in the represented by the MAC designation in the IMGT HLA DB Release version selected. Full allele names are used exclusively. Expand results will change with different IMGT HLA DB Release versions.

Expand a single MAC designation or multiple MAC designations.

Example

B08:YETY*

B08:YETY, C01:BJZ

B^*08:01:01:01/B^*08:01:01:02/B^*08:01:01:03/B^* 08:01:01:04/B^*08:01:01:05/B^*08:01:01:06/B^* 08:01:01:07/B^*08:01:01:08/B^*08:01:01:09/B^* 08:01:01:10/B^*08:01:01:11/B^*08:01:01:12/B^* 08:01:01:13/B^*08:01:01:14/B^*08:01:01:15/B^* 08:01:01:16/B^*08:01:02/B^*08:01:03/B^*08:01:04/B^* 08:01:05/B^*08:01:06/B^*08:01:07/B^*08:01:08/B^* 08:01:09/B^*08:01:10/B^*08:01:11/B^*08:01:12/B^* 08:01:13/B^*08:01:14/B^*08:01:15/B^*08:01:16/B^* 08:01:17/B^*08:01:18/B^*08:01:19/B^*08:01:20/B^* 08:01:21/B^*08:01:22/B^*08:01:23/B^*08:01:24/B^* 08:01:25/B^*08:01:26/B^*08:01:27/B^*08:01:28/B^* 08:01:29/B^*08:01:30/B^*08:01:31/B^*08:01:32/B^* 08:01:33/B^*08:01:34/B^*08:01:35/B^*08:01:36/B^* 08:01:37/B^*08:01:38/B^*08:01:39/B^*08:01:40/B^* 08:01:41/B^*08:01:42/B^*08:01:43/B^*08:01:44/B^* 08:01:45/B^*08:01:46/B^*08:01:47/B^*08:01:48/B^* 08:01:49/B^*08:01:50/B^*08:01:51/B^*08:01:52/B^* 08:01:53/B^*08:01:54/B^*08:19N/B^*08:109

C^*01:02:01:01/C^*01:02:01:02/C^*01:02:01:03/C^* 01:02:01:04/C^*01:02:01:05/C^*01:02:01:06/C^* 01:02:01:07/C^*01:02:01:08/C^*01:02:01:09/C^* 01:02:01:10/C^*01:02:01:11/C^*01:02:01:12/C^* 01:02:02/C^*01:02:03/C^*01:02:04/C^*01:02:05/C^* 01:02:06/C^*01:02:07/C^*01:02:08/C^*01:02:09/C^* 01:02:10/C^*01:02:11/C^*01:02:12/C^*01:02:13/C^* 01:02:14/C^*01:02:15/C^*01:02:16/C^*01:02:17/C^* 01:02:18/C^*01:02:19/C^*01:02:20/C^*01:02:21/C^* 01:02:22/C^*01:02:23/C^*01:02:24/C^*01:02:25/C^* 01:02:26/C^*01:02:27/C^*01:02:28/C^*01:02:29/C^* 01:02:30:01/C^*01:02:30:02/C^*01:02:31/C^*01:02:32/C^* 01:02:33/C^*01:02:34/C^*01:02:35/C^*01:02:36/C^* 01:02:37/C^*01:02:38/C^*01:02:39/C^*01:02:40/C^* 01:02:41/C^*01:02:42/C^*01:02:43/C^*01:02:44/C^* 01:02:45/C^*01:02:46/C^*01:02:47/C^*01:02:48/C^* 01:02:49/C^*01:02:50/C^*01:02:51/C^*01:02:52/C^* 01:02:53/C^*01:02:54/C^*01:02:55/C^*01:02:56/C^* 01:02:57/C^*01:02:58/C^*01:02:59/C^*01:02:60/C^* 01:02:61/C^*01:02:62/C^*01:02:63/C^*01:03/C^* 01:04/C^*01:05/C^*01:06

Encode/Lookup Results:

Decode/Expand Results:

Enter Email to Continue:

Confirmation Activation:

You are about to submit an activation request. Are you sure you want to continue? Don't show this again.

Instructions

Welcome to the MAC Service UI!

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

new-allelecodes@nmdp.org

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

new-allelecodes@nmdp.org

Enjoy!

Logging in
- Lookup, 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.
Instructions
- Instructions for Lookup
  1) Select IMGT HLA DB Release. Choose the version number of the IMGT allele database release that was used for the allele list generated. If you don’t know, use the highest release number.
  
  2) Enter between 1 - 50 CALs or GL strings into the Encode Input box. Each CAL or GL string must be on its own line. The UI will assign a number to the CAL or GL string. This number will be used in the Encode Result box to link the request list and MAC together.
  
  3) Click the Look Up button. It will return all MAC designations for the CALs or GL strings entered but will not assign a new MAC.
  
  4) The MAC designation results will be displayed in the Encode Result box.
  
  Instructions for Decode
  1) Enter a single MAC Designation or multiple MAC Designations separated by comma
  
  2) Click Decode Results will populate with allele string(s) truncated names associated with the MAC Designation(s) requested
  
  NOTE: If MAC Designation is invalid, error messages will populate
  
  Instructions for Expand:
  1) Enter a single MAC Designation or multiple MAC Designations separated by comma
  
  2) Click Expand, system will validate the MAC Designation(s) Results will populate with allele string(s) long names associated with the MAC Designation(s) requested
  
  NOTE: If MAC Designation is invalid, error messages will populate
Error Messages
- 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.
  
  Look up and Encode result
  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.
  Decode and Expand result
  Incorrect format detected The MAC entered is not recognized.
  Returns MAC designation that was used as an input If the letters are not a valid MAC, the MAC designation that was entered in the look up will appear in the Decode Result box.