Skip to content

Commit 4628fff

Browse files
committed
2 parents bb32b54 + 7468313 commit 4628fff

File tree

6 files changed

+1053
-255
lines changed

6 files changed

+1053
-255
lines changed

README.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,5 @@
1-
# ABaCo
2-
![img](https://raw.githubusercontent.com/Multiomics-Analytics-Group/abaco/refs/heads/main/docs/figures/overview.png)
1+
# ![ABaCo Logg](https://raw.githubusercontent.com/Multiomics-Analytics-Group/abaco/HEAD/docs/images/logo/abaco_logo.svg)
32

4-
<h1 align="center">ABaCo</h1>
53
<p align="center"><em>Batch Effect Correction framework for metagenomic data</em></p>
64

75
<p align="center">
@@ -25,6 +23,10 @@
2523

2624
The integration of metagenomic data from multiple studies and experimental conditions is essential to understand the interactions between microbial communities in complex biological systems, but the inherent diversity and biological complexity pose methodological challenges that require refined strategies for atlas-level integration. ABaCo, a family of generative models based on Variational Autoencoders (VAEs) combined with an adversarial training, aim for the integration of metagenomic data from different studies by minimizing technical heterogeneity conserving biological significance. The VAE encodes the data into a latent space, while the discriminator is trained to detect the provenance of the data, eliminating variability associated with its origin; concurrently, the data is modeled using distributions suitable for raw counts, and the latent space follows a clustering prior to ensure biological conservation.
2725

26+
An overview of the ABaCo workflow is shown in the figure below:
27+
28+
![ABaCo Abstract](https://raw.githubusercontent.com/Multiomics-Analytics-Group/abaco/HEAD/docs/images/abaco_overview.png)
29+
2830
## Table of Contents
2931

3032
- [Installation](#installation)
@@ -42,9 +44,12 @@ pip install abaco
4244
```
4345

4446
## Features
47+
4548
## Usage
49+
4650
## Documentation
4751
Tutorials and documentation are available on [Read the Docs](https://mona-abaco.readthedocs.io/)
52+
4853
## Contributing
4954
1. Fork the repository
5055
2. Clone the repository
@@ -66,4 +71,5 @@ Tutorials and documentation are available on [Read the Docs](https://mona-abaco.
6671
5. Make changes
6772
> Note: we aimt o use numpy style python docstrings [sphinx example](https://www.sphinx-doc.org/en/master/usage/extensions/example_numpy.html#example-numpy)
6873
6. Make a pull request
74+
6975
## License

docs/conf.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,8 +67,8 @@
6767
# -- Options for HTML output -------------------------------------------------
6868

6969
html_theme = "sphinx_book_theme"
70-
html_logo = "https://raw.githubusercontent.com/Multiomics-Analytics-Group/abaco/refs/heads/main/docs/figures/overview.png"
71-
html_favicon = "https://raw.githubusercontent.com/Multiomics-Analytics-Group/abaco/refs/heads/main/docs/figures/overview.png"
70+
html_logo = "https://raw.githubusercontent.com/Multiomics-Analytics-Group/abaco/HEAD/docs/images/logo/abaco_logo.svg"
71+
html_favicon = "https://raw.githubusercontent.com/Multiomics-Analytics-Group/abaco/HEAD/docs/images/logo/abaco_logo.svg"
7272
html_theme_options = {
7373
"github_url": "https://github.com/Multiomics-Analytics-Group/abaco",
7474
"repository_url": "https://github.com/Multiomics-Analytics-Group/abaco",
File renamed without changes.

docs/images/logo/abaco_logo.png

68.4 KB
Loading

0 commit comments

Comments
 (0)