Skip to content

Commit 2f4ae11

Browse files
committed
Update Complex-Models.md
Upload MixtureFinder options
1 parent f8f145b commit 2f4ae11

1 file changed

Lines changed: 32 additions & 0 deletions

File tree

doc/Complex-Models.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,38 @@ Mixture models can be combined with rate heterogeneity, e.g.:
146146

147147
Here, we specify two mixture components and four Gamma rate categories. Effectively, this means that there are eight mixture components. Each site has a probability belonging to either `JC` or `HKY` and to one of the four rate categories.
148148

149+
### MixtureFinder
150+
151+
MixtureFinder is an approach to select the optimum number of classes for a mixture model of Q matrices. To run MixtureFinder:
152+
153+
iqtree -s example.phy -m MF+MIX
154+
155+
Here, we estimate the optimal Q mixture model. To select mixture model and then do the tree search:
156+
157+
iqtree -s example.phy -m MFP+MIX
158+
159+
Likelihood ratio test (LRT) with p-value = 0.05 is the default method to assess the number of classes in the Q mixture model. To change the p-value:
160+
161+
iqtree -s example.phy -m MF+MIX -lrt 0.01
162+
163+
Here, we change the LRT p-value to 0.01. To use information criteria instead of LRT to assess the number of classes:
164+
165+
iqtree -s example.phy -m MF+MIX -lrt 0 -merit BIC
166+
167+
Here, `-lrt 0` means turn of the LRT, then `-merit BIC` means using BIC to assess the number of classes. (Note that: `-merit` also decides the creterion for selecting subtitution model type in each classes. If using LRT for assessing the number of classes, the default creterion for selecting subtitution model type is BIC.)
168+
169+
Options for ModelFinder also work for MixtureFinder, e.g.:
170+
171+
iqtree -s example.phy -m MF+MIX -mset HKY,GTR -mrate E,I,G,I+G
172+
173+
The `-mset HKY,GTR` means we select subtitution model type among only `HKY` and `GTR` substitution models. The `-mrate E,I,G,I+G` means we select the rate heterogeneity across sites models among `+E`, `+I`, `G` and `+I+G` models.
174+
175+
Other options for MixtureFinder:
176+
| Model option | Description |
177+
| ------------- | -------------------------------------------------------------------------------------------------------------- |
178+
| `-qmax` | Maximum number of Q-mixture classes (default: 10). Specify a number after the option (e.g., `-qmax 5`). |
179+
| `-mate-twice` | estimate the rate heterogeneity across sites models again after select the best Q-mixture model (default: off) |
180+
149181

150182
### Profile mixture models
151183

0 commit comments

Comments
 (0)