Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -127,4 +127,6 @@ docs/images/UML_diagrams/
docs/images/Graphical_abstract/
docs/images/Nfcore_module_figure
docs/presentations/
docs/example_data/Earth_microbiome_vuegen_demo_notebook_test/
docs/vuegen_case_study_earth_microbiome test.ipynb
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

where does this come from?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I created a test directory and config file to avoid overriding the config file with the relative paths.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok. I will merge than.

test.py
42 changes: 27 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<!-- <div align="center">
<img width="300px" src="images/vuegen_logo.svg">
</div> -->
![VueGen Logo](docs/images/vuegen_logo.svg)
![VueGen Logo](https://raw.githubusercontent.com/Multiomics-Analytics-Group/vuegen/main/docs/images/vuegen_logo.svg)
-----------------
<p align="center">
VueGen is a Python library that automates the creation of scientific reports.
Expand All @@ -26,7 +26,7 @@ An overview of the VueGen workflow is shown in the figure below:
<img width="650px" src="images/vuegen_graph_abstract.png" alt="VueGen overview"/>
</figure>
</p> -->
![VueGen Abstract](docs/images/vuegen_graph_abstract.png)
![VueGen Abstract](https://raw.githubusercontent.com/Multiomics-Analytics-Group/vuegen/main/docs/images/vuegen_graph_abstract.png)

Also, the class diagram for the project is presented below to illustrate the architecture and relationships between classes:

Expand All @@ -36,33 +36,32 @@ Also, the class diagram for the project is presented below to illustrate the arc
</figure>
</p> -->

![VueGen Class Diagram](docs/images/vuegen_classdiagram_noattmeth.png)
![VueGen Class Diagram](https://raw.githubusercontent.com/Multiomics-Analytics-Group/vuegen/main/docs/images/vuegen_classdiagram_noattmeth.png)

## Installation

You can install the package for development from this repository by running the following command:
Vuegen is available on [PyPI][vuegen-pypi] and can be installed using pip:

```bash
pip install vuegen
```

You can also install the package for development from this repository by running the following command:

```bash
pip install -e path/to/vuegen # specify location
pip install -e . # in case your pwd is in the vuegen directory
```

This will both install `quarto` and `streamlit` as our backends for report generation.

### Verify quarto installation
### Quarto installation

Test your quarto installation by running the following command:
Vuegen uses [Quarto][quarto] to generate various report types. The pip insallation includes quarto using the [quarto-cli Python library][quarto-cli-pypi]. To test if quarto is installed in your computer, run the following command:

```bash
quarto check
```

If you use conda a conda environement you can install quatro from the conda-forge channel
in case it did not work.

```bash
conda install -c conda-forge quarto
```
If quarto is not installed, you can download the command-line interface from the [Quarto website][quarto-cli] for your operating system.

## Execution

Expand All @@ -83,7 +82,15 @@ It's also possible to provide a configuration file instead of a directory:
vuegen --config example_data/Earth_microbiome_vuegen_demo_notebook/Earth_microbiome_vuegen_demo_notebook_config.yaml --report_type streamlit
```

The current report types are streamlit, html, pdf, docx, odt, revealjs, pptx, and jupyter.
The current report types supported by VueGen are:
* Streamlit
* HTML
* PDF
* DOCX
* ODT
* Reveal.js
* PPTX
* Jupyter

## Acknowledgements

Expand All @@ -95,10 +102,15 @@ If you have comments or suggestions about this project, you can [open an issue][

[issues]: https://github.com/Multiomics-Analytics-Group/vuegen/issues/new
[streamlit]: https://streamlit.io/
[vuegen-pypi]: https://pypi.org/project/vuegen/
[quarto]: https://quarto.org/
[quarto-cli-pypi]: https://pypi.org/project/quarto-cli/
[quarto-cli]: https://quarto.org/docs/get-started/
[Mona]: https://multiomics-analytics-group.github.io/
[Biosustain]: https://www.biosustain.dtu.dk/
[scriberia]: https://www.scriberia.co.uk/
[turingway]: https://github.com/the-turing-way/the-turing-way
[zenodo-turingway]: https://zenodo.org/records/3695300
[issues]: https://github.com/Multiomics-Analytics-Group/vuegen/issues/new


Binary file modified docs/images/vuegen_classdiagram_noattmeth.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/vuegen_graph_abstract.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/vuegen_logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading