MEME Minimal Motif Format

Description

A motif is a sequence pattern that occurs repeatedly in a group of related protein or DNA sequences. Motifs in the MEME Suite are represented as position-dependent letter-probability matrices that describe the probability of each possible letter at each position in the pattern. Individual MEME motifs do not contain gaps. Patterns with variable-length gaps are split by MEME into two or more separate motifs.

The MEME minimal motif format is a simple text format for motifs that is accepted by the programs in the MEME Suite. The format is a plain text (ASCII) format that can easily be created by hand using a text editor (e.g., emacs, vi, TextEdit) or a word processor (e.g., MSWord, but make sure to export as plain text). However, before hand-crafting any motifs you might want to first check if there is a conversion script that can do the job for you.

A text file in MEME minimal motif format can contain more than one motif, and also (optionally) specifies the motif alphabet, background frequencies of the letters in the alphabet, and strand information (for DNA motifs), as illustrated in the example files below.

Format Specification

The minimal MEME format contains following sections:

  1. Version (required)
  2. Alphabet (recommended)
  3. Strands (optional)
  4. Background frequencies (recommended)
  5. Motifs (required)

For each motif in the motifs section there are the sub-sections:

  1. Motif name (required)
  2. Motif letter-probability matrix (required)
  3. Motif URL (optional)

As well as the documentation you can also refer to these examples.

MEME version line (required)

The MEME Suite requires this line to be certain that it really is reading a MEME motif file and not just something that looks slightly like it. This line must appear before any other sections in the file.

MEME version version number

The version number should be the MEME Suite version you are targeting.

For example to target MEME Suite version 4 and above:

MEME version 4

Alphabet line (recommended)

The alphabet line tells the MEME Suite what alphabet to expect the motifs to be in. If this line is not present then the MEME Suite can attempt to detect this from the background or the motifs themselves.

ALPHABET= alphabet

The alphabet can be ACGT for DNA or ACDEFGHIKLMNPQRSTVWY for protein.

For example using a DNA alphabet:

ALPHABET= ACGT

Strands line (optional)

The strands line only has meaning for DNA motifs and indicates if motifs were created from sites on both the given and the reverse complement strands of the DNA sequences. If this line is not supplied then the MEME Suite will assume that DNA motifs were created from both strands.

strands: which strands

The which strands can be replaced with + to indicate only the given strand and + - to indicate both strands.

For example to indicate only the given strand was used:

strands: +

Background frequencies lines (recommended)

The background frequencies tell the MEME Suite how prevalent each letter of the motif alphabet was in the source sequences that were used to create the motifs. If the background frequencies are not supplied then the MEME Suite will assume uniform background frequencies. The MEME Suite uses this background to automatically create the log-odds matrices for MAST.

Background letter frequencies (from source):
letter 1 frequency 1 letter 2 frequency 2 ... (repeated) ... letter n-1 frequency n-1 letter n frequency n

The source is not required and if you wish you can leave off then end of the first line after "Background letter frequencies". On the next line is listed each letter in the alphabet followed by its frequency. The letters must be listed in the same order as in the alphabet line and the frequencies should sum to 1.

An example of uniform DNA frequencies:

Background letter frequencies A 0.25 C 0.25 G 0.25 T 0.25

An example of protein frequencies with a source listed:

Background letter frequencies (from lipocalin.s): A 0.071 C 0.029 D 0.069 E 0.077 F 0.043 G 0.057 H 0.026 I 0.048 K 0.085 L 0.087 M 0.018 N 0.053 P 0.032 Q 0.029 R 0.031 S 0.058 T 0.048 V 0.069 W 0.017 Y 0.050

Motif name line (required)

The motif name line indicates the start of a new motif and designates an identifier for it that must be unique to the file. It also allows for an alternate name that does not have to be unique.

MOTIF identifier alternate name

For example:

MOTIF MA0002.1 RUNX1

Motif letter-probability matrix lines (required)

The letter probability matrix is a table of probabilities where the rows are positions in the motif and the columns are letters in the alphabet. The columns are ordered alphabetically so for DNA the first column is A, the second is C, the third is G and the last is T. For protein motifs the columns come in the order A, C, D, E, F, G, H, I, K, L, M, N, P, Q, R, S, T, V, W and Y. As each row contains the probability of each letter in the alphabet the probabilities in the row must sum to 1.

letter-probability matrix: alength= alphabet length w= motif length nsites= source sites E= source E-value
... (letter-probability matrix goes here) ...

All the "key= value" pairs after the "letter-probability matrix:" text are optional. The "alength= alphabet length" and "w= motif length" can be derived from the matrix if they are not specified, provided there is an empty line following the letter probability matrix. The "nsites= source sites" will default to 20 if it is not provided and the "E= source E-value" will default to zero. The source sites is used to apply pseudocounts to the motif and the source E-value is used for filtering the motifs input to some MEME Suite programs (see MAST's -mev option).

An example of a DNA motif's letter-probability matrix:

letter-probability matrix: alength= 4 w= 18 nsites= 18 E= 1.1e-006 0.611111 0.000000 0.055556 0.333333 0.555556 0.000000 0.111111 0.333333 0.222222 0.166667 0.222222 0.388889 0.000000 0.111111 0.000000 0.888889 0.000000 0.055556 0.944444 0.000000 0.111111 0.000000 0.000000 0.888889 0.055556 0.000000 0.888889 0.055556 0.833333 0.111111 0.055556 0.000000 0.111111 0.388889 0.277778 0.222222 0.333333 0.055556 0.500000 0.111111 0.111111 0.222222 0.111111 0.555556 0.277778 0.222222 0.222222 0.277778 0.111111 0.055556 0.722222 0.111111 0.388889 0.166667 0.055556 0.388889 0.055556 0.000000 0.111111 0.833333 0.055556 0.777778 0.000000 0.166667 0.777778 0.000000 0.222222 0.000000 0.277778 0.611111 0.055556 0.055556

Motif URL line (optional)

The URL line specifies a web-page to link to when mentioning the motif in results.

URL web page URL

For example:

URL http://jaspar.genereg.net/cgi-bin/jaspar_db.pl?ID=MA0002.1&rm=present&collection=CORE

Other MEME Motif Formats

The motif discovery tools in the MEME Suite output motifs in several more complex formats. All of these formats are also accepted by programs in the MEME Suite that take motifs as input. The HTML formats are designed for viewing by humans, whereas the text (.txt) and XML (.xml) formats are primarily designed to make it easier for third-party applications to post-process the output of MEME Suite tools.