You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
|**Package**|[][vuegen-pypi][][vuegen-pypi][][vuegen-docker-quay]|
-[Credits and acknowledgements](#credits-and-acknowledgements)
22
-
-[Contact](#contact)
22
+
-[Contact and feedback](#contact-and-feedback)
23
23
24
24
## About the project
25
25
VueGen automates the creation of reports based on a directory with plots, dataframes, and other files in different formats. A YAML configuration file is generated from the directory to define the structure of the report. Users can customize the report by modifying the configuration file, or they can create their own configuration file instead of passing a directory as input.
@@ -34,6 +34,8 @@ Also, the class diagram for the project is presented below to illustrate the arc
34
34
35
35

36
36
37
+
The VueGen documentation is available at [vuegen.readthedocs.io][vuegen-docs], where you can find detailed information of the package’s classes and functions, installation and execution instructions, and case studies to demonstrate its functionality.
38
+
37
39
## Installation
38
40
Vuegen is available on [PyPI][vuegen-pypi] and can be installed using pip:
39
41
@@ -51,7 +53,6 @@ pip install -e . # in case your pwd is in the vuegen directory
51
53
> [!TIP]
52
54
> It is recommended to install VueGen inside a virtual environment to manage depenendencies and avoid conflicts with existing packages. You can use the virtual environment manager of your choice, such as `poetry`, `conda`, or `pipenv`.
53
55
54
-
### Quarto installation
55
56
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:
56
57
57
58
```bash
@@ -61,6 +62,8 @@ quarto check
61
62
> [!TIP]
62
63
> If quarto is not installed, you can download the command-line interface from the [Quarto website][quarto-cli] for your operating system.
63
64
65
+
If you prefer not to install VueGen on your system, a pre-configured Docker container is available. It includes all dependencies, ensuring a fully reproducible execution environment. See the [Execution section](#execution) for details on running VueGen with Docker. The official Docker image is available at [quay.io/dtu_biosustain_dsp/vuegen][vuegen-docker-quay].
66
+
64
67
## Execution
65
68
Run VueGen using a directory with the following command:
66
69
@@ -87,6 +90,16 @@ The current report types supported by VueGen are:
87
90
* PPTX
88
91
* Jupyter
89
92
93
+
### Running VueGen with Docker
94
+
Instead of installing VueGen locally, you can run it directly from a Docker container with the following command:
VueGen’s functionality is demonstrated through two case studies:
92
105
@@ -103,26 +116,28 @@ This advanced case study demonstrates the application of VueGen in a real-world
103
116
🔗 [![Open in Colab][colab_badge]][colab_link_emp_demo]
104
117
105
118
> [!NOTE]
106
-
> An HTML report example of the current vuegen release is available [here][emp-html-demo].
119
+
> The EMP case study is available online as [HTML][emp-html-demo] and [Streamlit][emp-st-demo] reports.
107
120
108
121
## Web application deployment
109
122
Once a Streamlit report is generated, it can be deployed as a web application to make it accessible online. There are multiple ways to achieve this:
110
123
111
124
***Streamlit Community Cloud**: Deploy your report easily using [Streamlit Cloud][st-cloud], as demonstrated in the [EMP VueGen Demo][emp-st-demo]. The process involves moving the necessary scripts, data, and a requirements.txt file into a GitHub repository. Then, the app can be deployed via the Streamlit Cloud interface. The deployment example is available in the `streamlit-report-example` branch.
112
125
***Standalone Executables**: Convert your Streamlit application into a desktop app by packaging it as an executable file for different operating systems. A detailed explanation of this process can be found in this [Streamlit forum post][st-forum-exe].
113
-
*[Stlite][stlite]: Run Streamlit apps directly in the browser with stlite, a WebAssembly port of Streamlit powered by Pyodide, eliminating the need for a server. It also allows packaging apps as standalone desktop executables using stlite desktop.
126
+
***Stlite**: Run Streamlit apps directly in the browser with [stlite][stlite], a WebAssembly port of Streamlit powered by Pyodide, eliminating the need for a server. It also allows packaging apps as standalone desktop executables using stlite desktop.
114
127
115
128
These options provide flexibility depending on whether the goal is online accessibility, lightweight execution, or local application distribution.
116
129
117
130
## Credits and acknowledgements
118
131
- Vuegen was developed by the [Multiomics Network Analytics Group (MoNA)][Mona] at the [Novo Nordisk Foundation Center for Biosustainability (DTU Biosustain)][Biosustain].
132
+
- VueGen relies on the work of numerous open-source projects like [Streamlit](streamlit), [Quarto][quarto], and others. A big thank you to their authors for making this possible!
119
133
- The vuegen logo was designed based on an image created by [Scriberia][scriberia] for The [Turing Way Community][turingway], which is shared under a CC-BY licence. The original image can be found at [Zenodo][zenodo-turingway].
120
134
121
-
## Contact
122
-
If you have commentsor suggestions about this project, you can [open an issue][issues] in this repository.
135
+
## Contact and feedback
136
+
We appreciate your feedback! If you have any comments, suggestions, or run into issues while using VueGen, feel free to [open an issue][new-issue] in this repository. Your input helps us make VueGen better for everyone.
0 commit comments