> For the complete documentation index, see [llms.txt](https://tbj128.gitbook.io/mian/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tbj128.gitbook.io/mian/boruta-feature-selection.md).

# Boruta (Feature Selection)

Create a random forest to select the taxonomic groups/OTUs that can differentiate the chosen categorical variable. The weights of the taxonomic groups/OTUs the algorithm considers most important according to the [Boruta feature selection algorithm](https://cran.r-project.org/web/packages/Boruta/Boruta.pdf) will be displayed.

![](/files/-M3ACSACcqkYmXGLTHnt)

### Used For

* Selecting OTUs or taxonomic groups ("OTU signature") that differentiate between two or more sample groups according to a Random Forest classifier

### Feature Selection Parameters

#### Taxonomic Level

The taxonomic level to aggregate the OTUs at. The OTUs will be grouped together (by summing the OTU values) at the selected taxonomic level before the analysis is applied.

#### Categorical Variable

Create comparative sample groups based on categorical variables uploaded in the metadata file.

Optionally create a categorical variable from a quantitative variable by using the Quantile Range feature on the Projects home page.

#### Fix Training Set Between Changes

Indicate whether the training set should remain the same every time a parameter is changed and the model is retrained.

#### Dataset Training Proportion

Define the proportion of the data that should be randomly picked to form a training dataset.

{% hint style="info" %}
You can set this value to be 1.0 if you don't plan on evaluating with a test dataset.
{% endhint %}

#### Max Epochs

The maximum number of epochs the Random Forest should train for

#### P-Value Threshold

OTUs or Taxonomic Groups with a p-value below this threshold will be shown in the results

### Interactive Elements

* Link back to boxplots

### Additional Features

* **Save Snapshot**: Save the results to the experiment notebook
* **Download**: Downloads the results as a CSV file
* **Share**: Creates a shareable link that allows you to share the results with others


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://tbj128.gitbook.io/mian/boruta-feature-selection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
