# 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:** 1\
**Showing post:** 2

<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)

---

_[View the full topic](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)._
