Download Alphabetical MACs

Consists of one list of all codes listed in alphabetical order. The three-letter codes are found at the end of the two-letter codes. Four-letter codes follow the three-letter codes.

Download Numerical MACs

Consists of one list of all codes listed in numerical order.

IPD-IMGT/HLA Data Base Release

Error getting IMGT HLA Releases

Download P&G group MAC associations (

This list provides the translations of P/G group designations to NMDP multiple allele code designations (MACDs) for a specific IMGT/HLA database version. The allele string corresponding to each NMDP MACDs is listed when there are multiple alleles in the MACD that differ at the protein level.

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.

Helpful Links

Be The Match Official Facebook

MAC published list

List of alleles up through the most recent version of the IMGT HLA Database

IPD-IMGT/HLA

The IPD-IMGT/HLA Database allows you to retrieve information upon a specific HLA allele as named in the WHO Nomenclature Committee Reports

GL String publication

The published article describing the Genotype List String (GL String)

HLA Nomenclature

Document describing who maintains the responsibility for naming of new HLA genes, allele sequences, and their quality control

Allele name truncations

Description of how MAC allele code names will be truncated

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.

Identify MACD's G-Group

Submit - returns G-group name(s) that the Mac Designation(s) is a part of.

Nothing has been entered. Please enter MAC Designation(s).

Example MAC Designation: B^*08:YETY

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

G-group Results: