# Metaphlan(4.0.6) reported an error while running humann(3.6.1)

**URL:** <https://forum.biobakery.org/t/metaphlan-4-0-6-reported-an-error-while-running-humann-3-6-1/5005>\
**Category:** HUMAnN\
**Created:** [March 22, 2023, 12:47pm UTC](https://forum.biobakery.org/t/metaphlan-4-0-6-reported-an-error-while-running-humann-3-6-1/5005 "2023-03-22T12:47:51Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![jian-zo](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/jian-zo/32/2056_2.png) [@jian-zo](https://forum.biobakery.org/u/jian-zo)\
**Post date:** [March 22, 2023, 12:47pm UTC](https://forum.biobakery.org/t/metaphlan-4-0-6-reported-an-error-while-running-humann-3-6-1/5005/1 "2023-03-22T12:47:51Z")

</div>

I’m a novice.

humann -i demo.fastq -o lx  
Output files will be written to: /home/zhoujian/02.SoftWare/humann/examples/lx

Running metaphlan …

ERROR: The MetaPhlAn taxonomic profile provided was not generated with the database version v3 or vJan21 . Please update your version of MetaPhlAn to at least v3.0 or if you are using MetaPhlAn v4 please use the database vJan21.

my humann and metaphlan version

humann --version  
humann v3.6.1

metaphlan -v  
MetaPhlAn version 4.0.6 (1 Mar 2023)

I am install humann with conda .And I can run metaphaln alone.

metaphlan demo.fastq --input\_type fastq -o pro.txt  
WARNING: The metagenome profile contains clades that represent multiple species merged into a single representant.  
An additional column listing the merged species is added to the MetaPhlAn output.

run metaphlan I can get result. But run humann, I get a error. So what should I do

---

<div class="post-metadata">

**Author:** ![rda](https://avatars.discourse-cdn.com/v4/letter/r/c2a13f/32.png) [@rda](https://forum.biobakery.org/u/rda)\
**Post date:** [March 24, 2023, 5:08pm UTC](https://forum.biobakery.org/t/metaphlan-4-0-6-reported-an-error-while-running-humann-3-6-1/5005/2 "2023-03-24T17:08:56Z")

</div>

```auto
$ humann --version
humann v3.6.1
$ metaphlan --version
MetaPhlAn version 4.0.6 (1 Mar 2023)
$ biobakery_workflows --version
biobakery_workflows v3.1

```

I seem to have the same problem, here are some of the specific (which I posted previously on hte biobakery mailing list):

When running:

```auto
humann --input /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data3/kneaddata/main/HD32R1_subsample.fastq.gz --output /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data3/humann/main --o-log /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data3/humann/main/HD32R1_subsample.log --threads 1 --taxonomic-profile /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data3/metaphlan/main/HD32R1_subsample_taxonomic_profile.tsv

```

I get:

```auto
ERROR: The MetaPhlAn taxonomic profile provided was not generated with the database version v3 or vJan21 . Please update your version of MetaPhlAn to at least v3.0 or if you are using MetaPhlAn v4 please use the database vJan21.

```

Indeed when downloading the metaphlan DB with:

`metaphlan --install`

the db installed is: vOct22

this is a consequence of: [http://cmprod1.cibio.unitn.it/biobakery4/metaphlan\_databases/mpa\_latest](http://cmprod1.cibio.unitn.it/biobakery4/metaphlan_databases/mpa_latest) containing:

```auto
mpa_vOct22_CHOCOPhlAnSGB_202212

```

I downloaded the precomputed version of the bt2 database from: [http://cmprod1.cibio.unitn.it/biobakery4/metaphlan\_databases/bowtie2\_indexes/mpa\_vJan21\_CHOCOPhlAnSGB\_202103\_bt2.tar](http://cmprod1.cibio.unitn.it/biobakery4/metaphlan_databases/bowtie2_indexes/mpa_vJan21_CHOCOPhlAnSGB_202103_bt2.tar) (as suggested in [How to install the latest metaphlan reference DB? - #13 by aitor.blancomiguez](https://forum.biobakery.org/t/how-to-install-the-latest-metaphlan-reference-db/3522/13) and I untarred the file and placed the bt2l files in the methaplan\_databases directory but even after doing so I still get the same error.

**Question** : I see that vJan21 is hardcoded in many files humann and metaphlan (e.g., humann/config.py, humann-3.6.1-py3.9.egg-info/SOURCES.txt, MetaPhlAn-4.0.6.dist-info/METADATA, etc.), shouldn’t accordingly mpa\_latest in [Index of /biobakery4/metaphlan\_databases](http://cmprod1.cibio.unitn.it/biobakery4/metaphlan_databases/) point to vJan21 and not vOct22 or the version be updated in humann and metaphlan?

Even after downloading the DB with the --index, the step:

```auto
$ humann --input /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/kneaddata/main/HD32R1_subsample.fastq.gz --output /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/humann/main --o-log /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/humann/main/HD32R1_subsample.log --threads 1 --taxonomic-profile /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/metaphlan/main/HD32R1_subsample_taxonomic_profile.tsv

```

still fails with error:

```auto
ERROR: The MetaPhlAn taxonomic profile provided was not generated with the database version v3 or vJan21 . Please update your version of MetaPhlAn to at least v3.0 or if you are using MetaPhlAn v4 please use the database vJan21.

```

I think is caused by the fact that when computing the taxonomic profile metaphlan chooses the version of the DB as declared in mpa\_latest, I am not sure how to correct this step (especially when it occurs from within biobakery\_workflow).

Please see below the first few lines of the tsv file:

```auto
$ head /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/metaphlan/main/HD32R1_subsample_taxonomic_profile.tsv
#mpa_vOct22_CHOCOPhlAnSGB_202212
#/u/local/apps/PYTHON-VIRT-ENVS/3.9.6/biobakery/bin/metaphlan /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/kneaddata/main/HD32R1_subsample.fastq.gz --input_type fastq --output_file /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/metaphlan/main/HD32R1_subsample_taxonomic_profile.tsv --samout /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/metaphlan/main/HD32R1_subsample_bowtie2.sam --nproc 1 --no_map --tmp_dir /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/metaphlan/main
#34596 reads processed
#SampleID	Metaphlan_Analysis
#clade_name	NCBI_tax_id	relative_abundance	additional_species
k__Bacteria	2	100.0	
k __Bacteria|p__ Bacteroidetes	2|976	76.7975	
k __Bacteria|p__ Firmicutes	2|1239	18.81751	
k __Bacteria|p__ Actinobacteria	2|201174	4.38499	
k __Bacteria|p__ Bacteroidetes|c__Bacteroidia	2|976|200643	76.7975

```

Any suggestion would be appreciated.

Thanks

RD

---

<div class="post-metadata">

**Author:** ![Vikas](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/vikas/32/2816_2.png) [@Vikas](https://forum.biobakery.org/u/Vikas)\
**Post date:** [March 27, 2023, 10:23am UTC](https://forum.biobakery.org/t/metaphlan-4-0-6-reported-an-error-while-running-humann-3-6-1/5005/3 "2023-03-27T10:23:32Z")

</div>

Hello,  
Run metaphlan separately and provide the metaphlan output while running humann3.  
More importantly, download the vJan21 version of chocophlan,

metaphlan --install --index mpa\_vJan21\_CHOCOPhlAnSGB\_202103

save it to a folder and provide the path to the database in the metaphlan command with

–bowtie2db DIRECTORY\_PATH --index mpa\_vJan21\_CHOCOPhlAnSGB\_202103

I hope this helps.

---

<div class="post-metadata">

**Author:** ![nbat64](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/nbat64/32/1967_2.png) [@nbat64](https://forum.biobakery.org/u/nbat64)\
**Post date:** [March 28, 2023, 2:25pm UTC](https://forum.biobakery.org/t/metaphlan-4-0-6-reported-an-error-while-running-humann-3-6-1/5005/4 "2023-03-28T14:25:35Z")

</div>

Hello,

Thanks for the explanation. Same here tried running humann (version 3.6.1 with metaphlan 4.0.6 and chocophlan vJan21) without success, get the error message

```auto
The MetaPhlAn taxonomic profile provided was not generated with the database version v3 or vJan21 . Please update your version of MetaPhlAn to at least v3.0 or if you are using MetaPhlAn v4 please use the database vJan21.

```

So you run independently Metaphlan and then humann3. As argument to Humann you add

```auto
 --bypass-prescreen

```

Thanks for the helps.

---

<div class="post-metadata">

**Author:** ![rda](https://avatars.discourse-cdn.com/v4/letter/r/c2a13f/32.png) [@rda](https://forum.biobakery.org/u/rda)\
**Post date:** [March 30, 2023, 1:34am UTC](https://forum.biobakery.org/t/metaphlan-4-0-6-reported-an-error-while-running-humann-3-6-1/5005/5 "2023-03-30T01:34:51Z")

</div>

@Vikas thanks for your answer, to be cleat I did install the DB with: `--index mpa_vJan21_CHOCOPhlAnSGB_202103`, as from below:

```auto
$ metaphlan --install --index mpa_vJan21_CHOCOPhlAnSGB_202103 --bowtie2db /u/local/apps/PYTHON-VIRT-ENVS/3.9.6/biobakery/lib/python3.9/site-packages/metaphlan/metaphlan_databases

```

but the problem persists.

@nbat64 adding `--bypass-prescreen` did not seem to help either:

```auto
$ humann --bypass-prescreen --input /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/kneaddata/main/HD32R1_subsample.fastq.gz --output /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/humann/main --o-log /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/humann/main/HD32R1_subsample.log --threads 1 --taxonomic-profile /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/metaphlan/main/HD32R1_subsample_taxonomic_profile.tsv

```

but I still get:

```auto
Output files will be written to: /u/home/staff1/cusgunx/ATS-TEST/biobakery/output_data4/humann/main
Decompressing gzipped file ...

ERROR: The MetaPhlAn taxonomic profile provided was not generated with the database version v3 or vJan21 . Please update your version of MetaPhlAn to at least v3.0 or if you are using MetaPhlAn v4 please use the database vJan21.

```

Also, I am trying to use biobakery\_workflows so adding a flag to humann would not be practical in that context.

Any ideas?

Thanks

---

<div class="post-metadata">

**Author:** ![nbat64](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/nbat64/32/1967_2.png) [@nbat64](https://forum.biobakery.org/u/nbat64)\
**Post date:** [March 30, 2023, 10:38am UTC](https://forum.biobakery.org/t/metaphlan-4-0-6-reported-an-error-while-running-humann-3-6-1/5005/6 "2023-03-30T10:38:32Z")

</div>

Hi,  
I was able to run the demo.fastq data using this:

Conda env with MetaPhlan\_v4.0.6 HUMAnN\_v3.6.1 Diamond\_v2.0.5

code

```auto
humann -i $INPUTFILE1 \
--metaphlan-options "-t rel_ab --index mpa_vJan21_CHOCOPhlAnSGB_202103 --bowtie2db $DB/MetaPhlAn_mpa_vJan21" \
-o ${RUN}_Humann3/ \
--threads 24 \
--nucleotide-database $DBHNuc \
--protein-database $DBHPro \
--verbose \
--o-log ${INPUTFILE1%.*}_humann3.log

```

---

<div class="post-metadata">

**Author:** ![jian-zo](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/jian-zo/32/2056_2.png) [@jian-zo](https://forum.biobakery.org/u/jian-zo)\
**Post date:** [March 31, 2023, 3:32am UTC](https://forum.biobakery.org/t/metaphlan-4-0-6-reported-an-error-while-running-humann-3-6-1/5005/7 "2023-03-31T03:32:02Z")

</div>

thank you very much,I I have downloaded metaphlan(3.0) in conda virtual environment,and then run metaphlan,they will download the database theivef.in this enveronment donwnloaded humann.That solves the problem.

---

<div class="post-metadata">

**Author:** ![jian-zo](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/jian-zo/32/2056_2.png) [@jian-zo](https://forum.biobakery.org/u/jian-zo)\
**Post date:** [March 31, 2023, 3:35am UTC](https://forum.biobakery.org/t/metaphlan-4-0-6-reported-an-error-while-running-humann-3-6-1/5005/8 "2023-03-31T03:35:22Z")

</div>

Try downloading and running metaphlan3.0 first

---

<div class="post-metadata">

**Author:** ![soniaflower\_fx](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/soniaflower_fx/32/2704_2.png) [@soniaflower\_fx](https://forum.biobakery.org/u/soniaflower_fx)\
**Post date:** [February 9, 2024, 4:29pm UTC](https://forum.biobakery.org/t/metaphlan-4-0-6-reported-an-error-while-running-humann-3-6-1/5005/9 "2024-02-09T16:29:58Z")

</div>

@rda Hello, has your problem been solved? I also encountered the same problem, but I still don’t know where the root of the problem lies. Can you give me your help?  
MetaPhlAn version 4.0.6 (1 Mar 2023)  
humann v3.6  
ERROR: The MetaPhlAn taxonomic profile provided was not generated with the database version v3 or vJan21 . Please update your version of MetaPhlAn to at least v3.0 or if you are using MetaPhlAn v4 please use the database vJan21.
