# Does a metadata file have to be provided to create a biom file, for subsequent analysis of beta diversity in Phinch?

**URL:** <https://help.galaxyproject.org/t/does-a-metadata-file-have-to-be-provided-to-create-a-biom-file-for-subsequent-analysis-of-beta-diversity-in-phinch/2214>\
**Category:** usegalaxy.eu support\
**Tags:** mothur\
**Created:** [October 2, 2019, 3:14pm UTC](https://help.galaxyproject.org/t/does-a-metadata-file-have-to-be-provided-to-create-a-biom-file-for-subsequent-analysis-of-beta-diversity-in-phinch/2214 "2019-10-02T15:14:40Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Erica\_Dasi](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/erica_dasi/32/958_2.png) [@Erica\_Dasi](https://help.galaxyproject.org/u/Erica_Dasi)\
**Post date:** [October 2, 2019, 3:14pm UTC](https://help.galaxyproject.org/t/does-a-metadata-file-have-to-be-provided-to-create-a-biom-file-for-subsequent-analysis-of-beta-diversity-in-phinch/2214/1 "2019-10-02T15:14:40Z")

</div>

Greetings,

I am currently using the Galaxy Europe platform to analyze 16S sequencing data, while using the 16S Microbial Analysis tutorial ([https://galaxyproject.github.io/training-material/topics/metagenomics/tutorials/mothur-miseq-sop/tutorial.html#otu-clustering](https://galaxyproject.github.io/training-material/topics/metagenomics/tutorials/mothur-miseq-sop/tutorial.html#otu-clustering)). I have reached the step where the shared output file is combined with the mouse metadata file (i.e., mouse.dpw.metadata) to create a biom file, which is subsequently used in Phinch to examine beta diversity.

From my reading, it appears that the metadata provides additional technical details about the samples (e.g., day of collection). This information can be included with the output data generated in Galaxy to form the biom file. I modified the mouse.dpw.metadata to include my samples and the days that they were collected. However, I received an error when I used the make.biom tool and included this modified file.

I was able to proceed without using the metadata file. However, I was wondering how the Phinch program takes the metadata into account? For instance, the taxonomic bar chart that is produced in Phinch does not include information on the sampling days. As a result, I’m wanted to reach out to gain a better understanding of the purpose of the metadata file and whether it is important to include in the 16S sequencing analysis.

Thank you for your time and I look forward to hearing from you. Have a wonderful day!

Sincerely,  
Erica

---

<div class="post-metadata">

**Author:** ![jennaj](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/jennaj/32/27_2.png) [@jennaj](https://help.galaxyproject.org/u/jennaj)\
**Post date:** [October 2, 2019, 11:17pm UTC](https://help.galaxyproject.org/t/does-a-metadata-file-have-to-be-provided-to-create-a-biom-file-for-subsequent-analysis-of-beta-diversity-in-phinch/2214/2 "2019-10-02T23:17:22Z")

</div>

Welcome @Erica_Dasi

> [@Erica\_Dasi](#):
>
> I’m wanted to reach out to gain a better understanding of the purpose of the metadata file and whether it is important to include in the 16S sequencing analysis.

The answer is probably yes, otherwise you won’t be able to filter down to specific groups of samples with `Mothur` tools or later `Phinch` itself.

**Where is “metadata” used?**

The `metadata` input sets allow you to filter using the “groups - Groups to include” option on the `Make.biom` tool form.

The parsed metadata information is also then included in the final `biom` dataset output later input to `Phinch`, where it can be utilized/filtered on when using that tool.

**Why is your metadata file failing?**

There is probably a format problem. Extra spaces, etc can cause problems. The data should be tab-delimited, each column’s label/data needs to be formatted correctly, and the file should not contain any extra lines. The header also needs to be correctly formatted. How to check for format problems like this are similar to the help in this post.

> [@Barcode Splitter Bug](https://help.galaxyproject.org/t/barcode-splitter-bug/2165/2):
>
> It is very important that there is no extra “whitespace” anywhere in the file, meaning no extra spaces, no extra tabs, no extra trailing blank lines, and no other hidden characters (soft returns that Excel can introduce, and the like) on any line. The tool is picky about inputs.
> 
> I would suggest downloading your barcode dataset from Galaxy and examining it to check for extra whitespace. Using the “eye” (view dataset) icon will display the data in Galaxy but sometimes extra whitespace is not easy to detect that way.

**More help:**

- Tool manual that has an example “metadata” file and explains how it is used: [Redirecting…](https://www.mothur.org/wiki/Make.biom)

- What this tutorial’s “metadata” file looks like. Source: [https://zenodo.org/record/800651/files/mouse.dpw.metadata](https://zenodo.org/record/800651/files/mouse.dpw.metadata)

- Example of a `biom` datasets, including those that incorporate `metadata` inputs. See: [The biom file format: Version 2.1 — biom-format.org](http://biom-format.org/documentation/format_versions/biom-2.1.html#example-biom-files)

- Help for using `Phinch`: [Phinch: a data visualization framework aimed at promoting novel explorations of large biological datasets.](http://phinch.org/How-to-Get-Started) && [Phinch: a data visualization framework aimed at promoting novel explorations of large biological datasets.](http://phinch.org/Tutorials)
